Open Inventory

# OpenInv – Ultimate Multi-World Inventory Suite **OpenInv** is a professional-grade administration plugin designed for Paper, Spigot, and Bukkit servers. It provides staff members with absolute control over player data through a sleek, interactive GUI system. Whether a player is online in another world or completely offline, OpenInv ensures you can always manage their items with precision and security. --- ## What’s New in v1.4.2 This update brings major features for history, logging, private vaults, and autosaves. - **New `/openinv drop` command** allows admins to force-drop items from a player's inventory, Ender Chest, or both. - **New `/openinv clear` command** allows admins to clear inventories, armor, or Ender Chests with confirmable execution. - **Rewritten `/openinv history` command** now uses a redesigned GUI that supports multiple snapshots in a single interface. - **Private Vault support** for the PriVault plugin — OpenInv can now manage private vault contents when PriVault is installed. - **Config rewrite:** `config.yml` has been redesigned for better clarity and easier customization. - **Offline snapshot preview** support lets staff view saved history even when the target player is offline. - **Autosave enhancements** now save player inventory snapshots on both join and quit. --- ## Key Features - GUI-based inventory and Ender Chest management for online and offline players. - Snapshot history with preview, restore, and multi-snapshot browsing. - Admin commands for `drop`, `clear`, `freeze`, `search`, and vault management. - PriVault integration for private vault inspection and snapshots. - Permission-driven view/modify/exempt system with flexible role control. - Async database support for SQLite/MySQL and full localization. --- ## Core Features ### Advanced GUI Management - **Live Interactive Editing:** Modify player inventories in real time with a responsive GUI. - **Native Multi-World Support:** Inspect player data across worlds without bridges or external tools. - **Shulker Box Peeking:** Right-click any Shulker Box in the GUI to preview its contents instantly. - **Private Vault Management:** When PriVault is installed, OpenInv can open and manage player private vaults as a first-class data source. ### Snapshot Time Machine - **Automatic Backups:** OpenInv automatically saves inventory snapshots in the background. - **Join/Quit Autosave:** The plugin saves snapshots when players join and when they quit. - **Optimized History GUI:** The history interface now displays multiple snapshots in one window, making recovery faster. - **Offline Preview:** Preview saved snapshots even if the player is currently offline. ### Security & Permissions - **Master Modify Key:** Only users with `openinv.modify` can move items in GUIs. - **Role-Based Exemptions:** `openinv.exempt` protects staff and VIP inventories from being opened by lower-ranked staff. - **Override Support:** `openinv.override` allows trusted admins to bypass exemption protection in emergencies. - **Command Logging:** Every OpenInv command can be recorded for staff accountability. ### Investigation & Admin Tools - **Freeze Inventories:** Lock a player's inventory using `/openinv freeze <player>`. - **Global Item Search:** Search a player's inventory for illegal or hidden items with `/openinv search <item> <player>`. - **Snapshot Preview:** Preview saved inventory states directly from IDs. - **Vault Inspection:** Manage player vaults and view vault backups when PriVault is available. --- ## Commands Cheat Sheet ### Base Commands & Aliases | Command | Description | | :--- | :--- | | `/openinv` | Main OpenInv command with access to all subcommands. | | `/invsee` | Alias for `/openinv`. | | `/inv <player>` | Shortcut for `/openinv check` to open an online player's inventory. | | `/invec <player>` | Shortcut for `/openinv echeck` to open an online player's Ender Chest. | | `/offlineinv <player> ` | Open an offline player's inventory. | | `/offlineec <player> ` | Open an offline player's Ender Chest. | ### Subcommands (`/openinv <subcommand>`) | Subcommand | Description | | :--- | :--- | | `help` | Displays the help menu with hover descriptions. | | `info` | Shows plugin information, version status, and quick links. | | `check <player>` | Open the inventory of an online player. | | `echeck <player>` | Open the Ender Chest of an online player. | | `offlineinv <player> ` | Open an offline player's inventory. | | `offlineec <player> ` | Open an offline player's Ender Chest. | | `history <player>` | Open a player's unified snapshot history. | | `search <item> <player>` | Search a player's inventory for a specific item. | | `freeze <player>` | Freeze a player's inventory so it cannot be used or moved. | | `unfreeze <player>` | Unfreeze a player's inventory. | | `preview <player> <id>` | Preview a saved snapshot by ID. | | `vault` | Open the player's private vault via PriVault integration. | | `drop` | Fo