📦 OpenInv – Advanced Inventory & Staff Management (v1.2)

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—even when players are completely offline!

Now updated to Version 1.2, OpenInv features rock-solid stability for modern PaperMC servers (1.21+) and flawless, lag-free database backups! With a highly secure permission system, interactive GUIs, and a "Time Machine" backup system, OpenInv is the only inventory management suite your server will ever need.

---

⭐ What’s New in v1.2? (The Stability Update)

• Modern Server Support: Flawless compatibility and support for the latest Minecraft versions (up to 1.21+) and modern PaperMC forks.
• Bulletproof Database Engine: We completely rewrote the internal SQLite database engine. Background inventory auto-saves are now perfectly synchronized, eliminating lag spikes and guaranteeing zero data corruption during server restarts and shutdowns.

---

🛡️ Unbreakable Staff Security & Protections

💎 Multi-Layered Permission Security

Stop accidental item deletion and staff abuse instantly. We use a strict two-key validation system 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 player inventories (openinv.modify.inv) while strictly blocking them from touching Ender Chests (openinv.modify.ec).

💂 Rank Exemption System (Protect Your Admins)

You can now mark specific players or ranks as "Exempt" to prevent rogue 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 your 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!

---

🚀 Core Administration Features

🎒 Complete Inventory Control (Interactive GUI)

• Live Editing: Open any online player’s inventory and watch their changes happen live.
• Sleek Administration Dashboard: Your administration menus feature cleanly mapped armor grids and fast-action buttons:
  • Ender Chest Link: Instantly swap to viewing their Ender Chest without closing the menu.
  • Clear Inventory (Confirmed): Wipes a player's items—now features a Confirmation GUI to prevent accidental deletions!
• Seamless Shulker Editing: Right-click any Shulker Box inside a GUI to magically peek into its contents without placing it down!
• Standalone Shulker View: Hold a shulker box and type /openinv container to inspect it instantly.

💤 Offline Player Editing

Need to remove an illegal item or issue a refund while the player is offline? No problem!

• Use /openinv offlineinv <player> or /offlineec <player> to edit their offline storage.
• Smart Syncing: All offline edits are securely queued in the background and applied the literal millisecond the player logs back in!

🕒 Time Machine (Snapshot Backups)

• Automatic Saves: Silently backs up player inventories in the background while they play.
• 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 green glass pane 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!
• Find Items Fast: Need to check who has an illegal sword? Scan their inventory for it using /openinv search <item> <player>.

---

📡 Smart Auto-Updater & Translations

• Modrinth Integration: OpenInv hooks natively into the Modrinth API. When your server boots up, it automatically alerts joined Admins if a new update is available.
• 20+ Languages Included: OpenInv is built for global servers. Pre-packaged with over 20 language files right out of the box, and 100% customizable to match your server's style.

---

⚡ 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.

---

⚙️ Performance & Compatibility

• Zero Lag Verification: Heavy tasks (backups and offline syncing) happen asynchronously on background threads, keeping your TPS at a flawless 20.0.
• Auto-Cleanup: Old item backups are automatically purged to save server disk space.
• 📌 Requirements: Supports Minecraft 1.16 through 1.21+, Java 17+, and standard Spigot/Paper/Purpur forks. Requires LuckPerms (or any Vault-compatible permission plugin) for the advanced security features.

---

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