📦 OpenInv Plugin – Advanced Inventory Management

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 0.9 takes server management to the next level by completely redesigning the interactive UI, adding strict "View-Only" security modes, and introducing a built-in Modrinth Auto-Update Checker to keep your server running the latest features!

---

🚀 What Can It Do?

🎒 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, seamlessly integrating three brand new fast-action buttons:
  • Ender Chest Link: Click a button to instantly swap to viewing their Ender Chest without closing the menu!
  • Clear Inventory: Instantly wipe a player's items with one click.
  • 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!

🛡️ Advanced Security (New!)

• Strict "View-Only" Mode: Need to give junior moderators the ability to investigate players, but don't trust them with giving/taking items? Without the openinv.modify permission, staff are locked into a secure "View-Only" mode. They can see everything, but physically dragging, dropping, or stealing items is completely blocked!
• The "Master Key": The openinv.admin permission is now a true global Master Key wildcard that grants instant access to every single plugin feature automatically!

💤 Edit Offline Players

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

🕒 Time Machine (Data Backups)

• Automatic Saves: The plugin 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 their lost items!

❄️ Stop & Search (Investigations)

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

---

📡 Smart Auto-Updater (New!)

Never miss a feature! OpenInv now hooks natively into the Modrinth API. When your server boots up, it automatically checks if you are running the latest code. If a new version of OpenInv is released here, the plugin drops a direct download link in your server console, and actively alerts joined Admins directly in the game chat!

---

🌍 Massive Multi-Language Support

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

• 20+ Languages Included: The plugin comes pre-packaged with 20 different language .yml files right out of the box!
• 100% Customizable: Change the text format, colors, and layout perfectly to match your server's aesthetic.

---

⚡ 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 physically restore old item backups.
• /openinv offlineinv <player> - Edit an offline player's inventory.
• /openinv offlineec <player> - Edit an offline player's Ender Chest.
• /openinv freeze <player> - Lock a player's ability to use items.
• /openinv search <item> <player> - Checks if a player has a specific item.
• /openinv reload - Immediately reload configs without a reboot.

---

⚙️ Performance & Compatibility

• Zero Lag Verification: Heavy tasks (like backing up data and syncing offline profiles) happen completely in the background via asynchronous logic, keeping your Server TPS flawless.
• Auto-Cleanup: Old item backups are automatically purged to save server disk space.
• Safe Shutdowns: Actively refuses to lose your data on shutdown by dynamically waiting for background threads to finish protecting items!

📌 Server Requirements

• Minecraft Versions: Fully supports 1.16 all the way up to the latest versions (1.21+).
• Java Version: Java 17 or newer.
• Server Software: Spigot, Paper, bukkit or similar custom forks.

---

🔐 Permissions Guide (For Admins)

• openinv.admin – The Master Key: Gives full access to every command!
• openinv.use – Base permission allowing the plugin to run.
• openinv.modify – Critical! Gives physical permission to actually add/remove items. Without this, staff are locked into View-Only mode!
• openinv.check – Allows viewing live inventories.
• openinv.enderchest – Allows viewing live Ender Chests.
• openinv.offlinecheck – Allows editing offline player inventories.
• openinv.offlineecheck – Allows editing offline player Ender Chests.
• openinv.history – Grants access to the Time Machine/backup viewer.
• openinv.freeze – Allows freezing/unfreezing players.
• openinv.search – Allows searching for items.

---

Developed with ❤️ by INFIE03. Thank you for using OpenInv!