📦 OpenInv Plugin – Advanced Inventory Management (v1.0)

OpenInv is your server's ultimate administration toolkit. Designed to give you absolute control, it lets you view, edit, audit, and manage player items in real-time—and now, even when players are completely offline!

Version 1.0 is our massive milestone release, transforming the plugin into a high-security surveillance and protection suite. We have completely redesigned the interactive UI, added granular "Master Key" security, and implemented a robust Exemption system to protect Staff and Admins from unauthorized edits.

🛡️ What’s New in v1.0? (The Security Release)

💎 Multi-Layered Permission Security

We have completely overhauled the modification logic. Staff now require a two-key validation to edit items:

The Master Key (openinv.modify): The global switch that enables editing capability. Without this, staff are locked into a secure "View-Only" mode. They can see everything, but dragging or stealing items is blocked.
Granular Targets: Staff only get access to what they need. You can allow a moderator to edit inventories (openinv.modify.inv) while strictly blocking them from touching Ender Chests (openinv.modify.ec).

💂 Rank Exemption & Override System (Staff Protection)

Stop Admin Abuse Instantly. You can now mark specific players or ranks as "Exempt" to prevent other staff from touching their stuff.

openinv.exempt.modify: Apply this to Owners and Admins. Even staff with full edit permissions will be hard-blocked from touching their items.
openinv.override.modify: Reserved for your most trusted Head-Admins to bypass these protections in emergencies.
openinv.exempt: Prevents the player's inventory from even being opened by others. Staff would need openinv.override to bypass this.

🚀 Core Features

🎒 Complete Inventory Control (Revamped GUI!)

Live Inventory Editing: Open any online player’s inventory and watch changes happen instantly.
Redesigned Interactive UI: Your administration GUIs now feature a sleek glass divider and cleanly mapped armor grids, integrating three fast-action buttons:
- Ender Chest Link: Click a button to instantly swap to viewing their Ender Chest without closing the menu!
- Clear Inventory (Confirmed): Wipes a player's items. Now includes a Confirmation GUI to prevent accidental deletions!
- Safe Exit: A dedicated close button.
Seamless Shulker Editing: Right-click any Shulker Box inside a GUI to magically open its contents without placing it down! Now fully protected by the exemption system.
Standalone Shulker View: Use /openinv container to inspect a shulker held in your hand.

💤 Edit Offline Players

Fix Problems Anytime: Need to remove an illegal item or issue a refund while the player is offline? No problem.
- /openinv offlineinv <player>: Opens and edits their offline inventory.
- /openinv offlineec <player>: Opens and edits their offline Ender Chest.
Smart Syncing: All offline edits are securely queued in the background and applied the literal moment the player logs back into the server!

🕒 Time Machine (Snapshot Backups)

Automatic Saves: Automatically backs up player inventories while they play, guaranteeing data safety even during sudden server shutdowns.
Death Saves: Automatically captures a perfect snapshot of a player's inventory the exact second they die.
One-Click Restores: Use /openinv history <player> to open a visual menu of past saves. Click a snapshot to instantly restore lost items!

❄️ Stop & Search (Investigations)

Freeze Players: Use /openinv freeze <player> to lock their inventory. Rule-breakers cannot move, drop, or use items while frozen!
Unfreeze: /openinv unfreeze <player> restores normal gameplay instantly.
Find Items Fast: Need to check who has an illegal sword? Scan for it using /openinv search <item> <player>.

📡 Smart Auto-Updater

Never miss a feature! OpenInv hooks natively into the Modrinth API. When your server boots up, it automatically checks for new versions. If an update is found, the plugin drops a direct download link in your console and alerts joined Admins directly in the game chat!

🌍 Massive Multi-Language Support

OpenInv is built for global servers! Every single message can be fully translated.

20+ Languages Included: Pre-packaged with over 20 language .yml files right out of the box!
100% Customizable: Change text formats, colors, and layouts to match your server's aesthetic perfectly.

⚡ Commands Cheat Sheet

/openinv <player> (Alias: /inv) - Open a player's live inventory.
/openinv echeck <player> (Alias: /invec) - Open their live Ender Chest.
/openinv history <player> - View or restore old item backups.
/openinv offlineinv <player> - Edit an offline player's inventory.
/openinv offlineec <player> - Edit an offline player's Ender Chest.
/openinv container (Alias: /shulker) - Inspect a held shulker box.
/openinv freeze <player> - Lock a player's ability to use items.
/openinv unfreeze <player> - Restore item usage to a player.
/openinv search <item> <player> - Checks if a player has a specific item.
/openinv reload - Immediately reload configs without a reboot.
/openinv help - Shows the interactive help menu.

⚙️ Performance & Compatibility

Zero Lag Verification: Heavy tasks (backups and offline syncing) happen asynchronously on background threads, keeping your TPS flawless.
Auto-Cleanup: Old item backups are automatically purged to save server disk space.
Safe Shutdowns: Actively protects your data on shutdown by waiting for background threads to finish protecting items.
📌 Requirements: Supports Minecraft 1.16 through 1.21+, Java 17+, and standard Spigot/Paper/Paper forks.

🔐 Permissions Guide (The Complete v1.0.0 Map)

Wildcards

openinv.* – The Full Wildcard: Grants access to everything below!
openinv.modify.* – Grants access to edit both Inventories and Ender Chests.

Core Interaction

openinv.admin – The Staff Master Key: Gives full access to every command and override!
openinv.use – Base permission allowing the plugin to run.
openinv.modify – Critical! Global permission to add/remove items. Without this, staff are locked in View-Only mode.
openinv.modify.inv – Permission to modify player inventories.
openinv.modify.ec – Permission to modify player Ender Chests.
openinv.silent – Allows performing all administrative actions silently.

Exemption & Override

openinv.exempt – Prevents others from opening your inventory.
openinv.override – Allows staff to bypass the viewing exemption.
openinv.exempt.modify – Protects your items from being edited by other staff.
openinv.override.modify – Allows staff to bypass the modification exemption.

Command Specifics

openinv.check – Permission for /invsee.
openinv.enderchest – Permission for /invec.
openinv.offlinecheck / openinv.offlineecheck – Permissions for offline editing.
openinv.history – Grants access to the Time Machine/history menu.
openinv.freeze / openinv.unfreeze – Permission to freeze/unfreeze players.
openinv.search – Permission to search for items.
openinv.container – Permission to use the Shulker Inspector.
openinv.self – Permission to view your own history/backups.
openinv.others – Permission to view other players' data.

Developed with ❤️ by INFIE03. Ensuring your server economy and staff integrity since 2024.

Open Inventory