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

Subcommands (/openinv <subcommand>)

🔑 Permissions Breakdown

Global Access

• openinv.* — Grants access to every OpenInv command and feature.
• openinv.admin — Grants access to all admin-focused commands and actions.

Usage Permissions

• openinv.use — Required to use the root command and /openinv help.
• openinv.usen — Used by the /invsee alias to access OpenInv features.
• openinv.check — Allows /inv and /openinv check.
• openinv.enderchest — Allows /invec and /openinv echeck.
• openinv.offlinecheck — Allows /offlineinv.
• openinv.offlineecheck — Allows /offlineec.
• openinv.history — Allows /openinv history.
• openinv.search — Allows /openinv search.
• openinv.container — Allows opening Shulker Boxes inside GUIs.
• openinv.preview — Allows /openinv preview <player> <id>.
• openinv.clear — Allows /openinv clear.
• openinv.clear.all — Allows /openinv clear all.
• openinv.drop — Allows /openinv drop.
• openinv.drop.all — Allows /openinv drop all.
• openinv.vault — Allows opening the vault selection menu.
• openinv.vault.edit — Allows editing a player's private vault.
• openinv.vault.snapshot — Allows viewing vault snapshots.
• openinv.vault.restore — Allows restoring vault snapshots.
• openinv.silent — Allows silent inventory operations.
• openinv.freeze — Allows /openinv freeze.
• openinv.unfreeze — Allows /openinv unfreeze.
• openinv.self — Allows viewing your own inventory/Ender Chest via GUI.

Modification Permissions

• openinv.modify — Master permission for moving items in GUIs.
• openinv.modify.* — Grants both inventory and Ender Chest modification.
• openinv.modify.inv — Grants normal inventory modification.
• openinv.modify.ec — Grants Ender Chest modification.

Protection & Exemptions

• openinv.exempt — Prevents others from opening your inventory.
• openinv.override — Bypasses openinv.exempt protection.
• openinv.exempt.modify — Prevents others from modifying your inventory.
• openinv.override.modify — Bypasses openinv.exempt.modify protection.

⚙️ Technical Details

• Asynchronous Processing: Background tasks such as database saves and offline loads run off the main server thread.
• Database Support: Local SQLite and networked MySQL are both supported.
• Snapshot Cleanup: Old snapshots can be auto-purged based on configuration settings.
• Localization: Includes support for over 20 language files and fully configurable messages.
• Compatibility: Works with Minecraft 1.16.x through 1.21.x and requires Java 17+.

Developed with ❤️ by INFIE03. Ensuring staff integrity and inventory security since 2025.