
Open Inventory
OpenInv is a powerful Minecraft admin plugin that lets staff view and edit player inventories and ender chests using /inv commands, featuring a modern GUI, database-backed inventory snapshots, rollback support, and multiple Minecraft version support.
- Загрузки
- 35K
- Подписчики
- 52
- Обновлён
- 25 июня 2026 г.
- Лицензия
- AGPL-3.0-or-later
Опубликован 3 марта 2025 г.
🎒 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? (The Premium GUI & Logging Update)
- Ender Chest GUI Overhaul: The Ender Chest viewer (
/invec) has been fully upgraded! It now features quick-access buttons to switch to the player's inventory, clear the Ender Chest, and exit. - Advanced Command Logging: Security is paramount. We've introduced a dedicated
/logs/folder. Every OpenInv command executed by staff is now strictly logged with timestamps, the executor's name, and their exact location, ensuring 100% staff accountability. - Premium
/openinv infoMenu: A brand-new, beautifully styled in-game info command. It features interactive links and a dynamic version checker that automatically alerts you if an update is available! - Enhanced Background Auto-Save: Optimized MySQL and SQLite auto-saving logic ensures that any live edits made to inventories or Ender Chests are securely saved without ever lagging the main server thread.
⭐ Core Features
🎒 Advanced GUI Management
- Live Interactive Editing: Watch items move in real-time as a player organizes their inventory.
- Native Multi-World Support: Track and edit inventories for different worlds natively without external bridges.
- Shulker Box Peeking: Right-click any Shulker Box inside an OpenInv GUI to see its contents without placing it down.
🕒 Snapshot Time Machine
- Automatic Backups: Silently saves player inventories in the background at configurable intervals.
- Death Captures: Automatically takes a perfect snapshot of a player's inventory the exact second they die.
- Visual History: Use
/openinv history <player>to open a menu of past saves. Click a backup to instantly restore lost items.
🛡️ Unbreakable Security & Protections
- Master Modify Key: Only staff with
openinv.modifycan move items. Others are locked in "View-Only" mode. - Rank Exemption: Apply
openinv.exemptto Admins to prevent lower-ranked staff from opening their inventory. - The Override System: High-ranking Head Admins can use
openinv.overrideto bypass exemptions in emergencies.
❄️ Investigation Tools
- Inventory Freeze: Use
/openinv freeze <player>to lock a player's inventory. - Global Item Search: Use
/openinv search <item> <player>to instantly find if a player is hiding specific or illegal items.
⚡ Commands Cheat Sheet
Here is every single command available in OpenInv.
Base Commands & Aliases
| Command | Description |
|---|---|
/openinv |
The main command to access all sub-features. |
/invsee |
A direct alias for /openinv. |
/inv <player> |
Shortcut for /openinv check (Opens an online player's inventory). |
/invec <player> |
Shortcut for /openinv echeck (Opens an online player's Ender Chest). |
/offlineinv <player> [world] |
Shortcut for /openinv offlineinv (Opens an offline player's inventory). |
/offlineec <player> [world] |
Shortcut for /openinv offlineec (Opens an offline player's Ender Chest). |
/invhistory <player> |
Shortcut for /openinv invhistory (View inventory backup history). |
/echistory <player> |
Shortcut for /openinv echistory (View Ender Chest backup history). |
Subcommands (/openinv <subcommand>)
| Subcommand | Description |
|---|---|
help |
Displays the help menu with hover descriptions. |
info |
View plugin info, version update status, and quick links. |
check <player> |
Open a live player's inventory. |
echeck <player> |
Open a live player's Ender Chest. |
offlineinv <player> [world] |
Open an offline player's inventory. |
offlineec <player> [world] |
Open an offline player's Ender Chest. |
invhistory <player> |
Open the visual snapshot history for a player's inventory. |
echistory <player> |
Open the visual snapshot history for a player's Ender Chest. |
search <item> <player> |
Search for a specific item in a player's inventory. |
freeze <player> |
Lock a player's inventory (prevents usage/drops/movement). |
unfreeze <player> |
Unlock a player's inventory. |
preview <id> |
Preview a specific inventory snapshot by its database ID. |
reload |
Reloads config.yml, messages.yml, and reconnects the database if needed. |
🔑 Permissions Breakdown
Every single permission node is documented here for granular setup (e.g., with LuckPerms).
Global Access
openinv.*: Gives access to absolutely all OpenInv commands and features.openinv.admin: Gives access to all administrative commands (freeze, history, search, override).
Usage Permissions
openinv.use: Basic access required to use the base command and help menu.openinv.check: Permission to use/invor/openinv check.openinv.enderchest: Permission to use/invecor/openinv echeck.openinv.offlinecheck: Permission to use/offlineinv.openinv.offlineecheck: Permission to use/offlineec.openinv.self: Allows a player to view their own inventory/enderchest via the GUI.openinv.history: Permission to use/invhistoryand/echistory.openinv.search: Permission to use/openinv search.openinv.freeze: Permission to freeze a player's inventory.openinv.unfreeze: Permission to unfreeze a player.openinv.preview: Permission to preview snapshots directly via ID.openinv.container: Permission to open Shulker Boxes inside the GUI by right-clicking.openinv.silent: Allows silent inventory operations (prevents notifications).
Modification Permissions
openinv.modify: Master modification permission (allows moving/clicking items in all GUIs).openinv.modify.*: Explicitly grants bothinvandecmodify permissions.openinv.modify.inv: Specifically allows editing standard inventories.openinv.modify.ec: Specifically allows editing Ender Chests.
Protection & Exemptions
openinv.exempt: Prevents the player's inventory from being opened by others.openinv.override: Allows staff to bypass theopeninv.exemptprotection and open their inventory anyway.openinv.exempt.modify: Prevents the player's inventory from being modified by others (can be viewed, but not touched).openinv.override.modify: Allows staff to bypass theopeninv.exempt.modifyprotection.
⚙️ Technical Details
- Asynchronous Processing: Heavy tasks like database saves and offline sync happen on background threads, ensuring 20.0 TPS even on high-population servers.
- Database Engine: Supports local SQLite (standard) or network-wide MySQL.
- Auto-Cleanup: Automatically purges old snapshots to save disk space based on your config settings.
- Global Support: Pre-packaged with 20+ language files. Fully customizable
messages.ymlandconfig.yml. - Modern Compatibility: Full support for Minecraft 1.16.x through 1.21.x. Requires Java 17 or higher.
Developed with ❤️ by INFIE03. Ensuring staff integrity and inventory security since 2025.
Ченджлог
1.4.1Релиз26.1.1, 26.1.2, 26.2 · 25 июня 2026 г.
OpenInv v1.4.1 - Critical Bug Fix Update
🔧 Bug Fixes:
- Fixed a critical data-loss bug related to
/openinv offlineec. Previously, if an administrator used the offline Ender Chest command on a player who had never generated offline backup data (common on fresh plugin installs), the plugin would accidentally save an empty GUI as their new state. This caused the player's live Ender Chest to be permanently wiped upon their next login. The command now safely aborts and warns the admin if no backup data exists, completely preventing accidental wipes.
1.4Релиз26.1.1, 26.1.2, 26.2 · 20 июня 2026 г.
🚀 OpenInv v1.4 Release Notes (The Premium GUI & Logging Update)
✨ What’s New
- Ender Chest GUI Overhaul: The Ender Chest viewer (
/invecand/offlineec) has been fully upgraded with quick-access buttons!- [NEW] Open Inventory: Seamlessly switch from viewing a player's Ender Chest to their main inventory with a single click.
- [NEW] Clear EnderChest: A dedicated button to completely wipe a player's Ender Chest (requires confirmation to prevent accidents).
- [NEW] Close Button: Cleanly exit the menu.
- Premium
/openinv infoMenu: Added a brand-new, beautifully styled in-game info command. It features an interactive Modrinth button and a Dynamic Version Checker that alerts you in-game if you're running the latest version! - Advanced Command Logging: Security is paramount. We've introduced a dedicated
/logs/folder inside the plugin directory. Every OpenInv command executed by staff is now strictly logged with timestamps, the executor's name, and their exact location, ensuring 100% staff accountability. - Enhanced Background Auto-Save: Optimized MySQL and SQLite auto-saving logic ensures that any live edits made to inventories or Ender Chests are securely saved without ever lagging the main server thread.
🐛 Bug Fixes & Tweaks
- Refined color schemes and formatting across several menus to provide a more premium "gray and gold" aesthetic.
- Improved the Offline Player data loader to handle edge cases when loading an offline player's Ender Chest.
1.3Релиз26.1, 26.1.1, 26.1.2 · 5 мая 2026 г.
✨ OpenInv v1.3 - Changelog
🌍 Different Worlds, Different Items
The plugin now perfectly supports servers with multiple worlds!
- Per-World Saving: If a player has different items in your "Survival" world and your "Creative" world, the plugin now remembers them separately.
- Auto-Save on Teleport: Whenever a player moves from one world to another, the plugin instantly saves their items so you always see the most recent data.
- Smart Editing: If you edit a player's inventory for a world they aren't currently in, the changes will "wait" for them and apply automatically the next time they enter that world.
🛠️ Smarter Commands
We’ve made the commands much easier to use:
- Unified
/inv: You can now use/inv <player> [world]to check anyone. If they are online, it shows their live items. If you want to check a specific world they aren't in, it automatically shows you their saved items for that world.
⌨️ Faster Typing (Tab-Complete)
Typing commands is now much faster:
- Online vs. Offline: When you type
/inv, it will only suggest players who are actually online. When you type/offlineinv, it will only suggest players who are offline. This keeps your list clean! - World Suggestions: When you are typing an inventory command, you can now press
TABto see a list of all your server's worlds (likeworld,world_nether, etc.) so you don't have to remember the exact names.
🚀 Other Improvements
- More Reliable: We fixed several small bugs to make sure player items are always saved safely and never get mixed up between worlds.
1.2Релиз26.1, 26.1.1, 26.1.2 · 24 апреля 2026 г.
OpenInv — 1.2 Changelog
This update contains important stability fixes for modern Paper servers and SQLite database connections.
🐛 Bug Fixes & Improvements
Fixed Startup Errors on Modern Paper Servers 🔧 Resolved an issue where the plugin would completely fail to load on newer versions of PaperMC due to an "Unsupported API version" error. The plugin now properly recognizes and supports Minecraft 1.21+.
Fixed Database Errors During Server Shutdown 💾 Fixed a scary-looking database error (
SQLITE_READONLY_DBMOVED) that would sometimes appear in the console when stopping or restarting your server. This was caused by the plugin trying to save multiple players' inventories at the exact same time as the database was closing. We've smoothed out this shutdown process so all player data is saved safely, securely, and completely error-free!
1.1Релиз26.1, 26.1.1, 26.1.2 · 17 апреля 2026 г.
OpenInv — 1.1 Changelog
This update focuses on fixing permission bugs, improving staff tools, and making the plugin more reliable for server owners.
✨ New Features & Improvements
Clean Console Experience 🛡️ Hidden all messy initialization logs (like database connections and module status lines). The console now only shows the premium dashboard and critical warnings, making it much cleaner for server owners.
Refined Command Security 🔐 To improve server safety, all the commands now require the base
openinv.usepermission as a prerequisite. This ensures staff have been granted fundamental access before using administrative tools.Hierarchical Modification System 🏗️ The modification permissions now follow a strict structure:
openinv.modify.*acts as a master wildcard (grants everything).- Specific edits now require the master key (
openinv.modify) plus a granular node (.invor.ec).
/openinv historyGUI Updates 🟢 Slots containing saved data now use Green Stained Glass Panes, providing immediate visual feedback on which backups are available.Translation Updates 🌍 Updated the success message for
/openinv reloadacross all 20+ supported languages. It now includes a clear reminder that some configuration changes require a server restart to apply.
🐛 Bug Fixes
Offline player protection now actually works. When a player was offline, their
openinv.exemptprotection was being ignored. This is now fixed — offline players are properly protected from unauthorized viewing.The
openinv.modify.*shortcut permission now works correctly. Giving a staff memberopeninv.modify.*in LuckPerms now correctly grants full edit access to both inventories and Ender Chests even without the basemodifynode.Resolve "No Perm" spam in chat. When clicking protected items, the error message now only shows once every 2 seconds to avoid flooding the player's chat.
Staff inventory locking issue. Fixed a bug where staff members in "View-Only" mode would find their own inventory locked after closing a target's GUI.
openinv.adminnow truly unlocks everything. Fixed several sub-commands that were still returning "no permission" errors even for players withopeninv.admin. It is now a complete bypass.Resolved a crash during startup (NPE). Fixed a rare issue where the plugin would crash if it tried to display the console logo before the configuration files were fully loaded.
📋 Full Permission Reference (What Changed)
| Permission | What it does |
|---|---|
openinv.admin |
Full access to everything — no other permissions needed |
openinv.use |
Required to use viewing commands (/inv, /offlineinv, etc.) |
openinv.exempt |
Protects YOUR inventory from being opened by others |
openinv.override |
Lets staff bypass exempt protection |
openinv.modify |
Master key required to edit ANY inventory |
openinv.modify.inv |
Allows editing player inventories |
openinv.modify.ec |
Allows editing Ender Chests |
openinv.modify.* |
Shortcut — allows editing both inv and EC |
openinv.exempt.modify |
Protects YOUR items from being moved |
openinv.override.modify |
Lets staff bypass edit protection |
openinv.freeze |
Allows using /openinv freeze |
openinv.unfreeze |
Allows using /openinv unfreeze |
openinv.history |
Allows viewing inventory backup history |
1.0Релиз1.21.9, 1.21.10, 1.21.11 · 13 апреля 2026 г.
🚀 OpenInv v1.0 – The Security Update
[Major Security Overhaul]
- Multi-Layered Permission Logic: Transitioned to a strict "Two-Key" system. Staff now require both the master
openinv.modifykey AND a target key (.invor.ec) to edit items. - Rank Exemption System: Introduced
openinv.exempt.modifyto allow Admins and Owners to protect their inventories from being edited by lower-ranking staff. - Administrative Overrides: Added
openinv.override.modifyto allow trusted high-level staff to bypass modification exemptions. - Bypass Permissions Hierarchy: Decoupled permission inheritance in
plugin.ymlto prevent accidental permission "leaks" fromopstatus.
[Bug Fixes & Security Hardening]
- Shulker Viewer Lockdown: Fixed a critical security leak where staff could still edit items inside an Admin's Shulker Box even if the Admin was protected.
- Drag Interaction Security: Fixed a bug where clicking and dragging items could bypass modification checks.
- Inventory Synchronization: Resolved an issue where offline edits didn't always reflect perfectly during a high-speed login event.
[UX & Performance Improvements]
- Message Throttling: Implemented a 2-second cooldown on permission denial messages to prevent chat spam during failed interactions.
- Dynamic Console Logging: Updated system startup logs to automatically pull the correct version from
plugin.yml(no more hardcoded version strings!). - Clear Inventory Confirmation: Refined the safe-clear GUI to ensure accidental clicks don't result in lost data.
- Wildcard Support: Fully populated
openinv.*andopeninv.modify.*in theplugin.ymlfor easier permissions setup.
0.9.1Релиз1.21.9, 1.21.10, 1.21.11 · 30 марта 2026 г.
🌟 OpenInv v0.9.1 Changelog Bug Fixes & Improvements:
- Fixed Ender Chest Saving: Resolved an issue that prevented offline player Ender Chest backups from saving correctly on servers using MySQL/MariaDB.
- Fixed Console Errors During Cleanup: Fixed a bug that would occasionally cause errors in the console when the plugin tried to automatically delete older, outdated inventory backups.
- Safe Upgrading: Upgrading to this version is perfectly safe! Any older inventory or Ender Chest backups you already have saved will continue to load without issues.
- Under-the-hood Improvements: Improved how the database stores tracking data behind the scenes to prevent future saving errors and crashes.
0.9Релиз1.21.9, 1.21.10, 1.21.11 · 28 марта 2026 г.
🚀 OpenInv v0.9 Changelog
💎 New Features & GUI Revamp
- Massive GUI Redesign: The
/openinv checkand/openinv offlineinvmenus have been beautifully redesigned! We built a clean dark glass divider row, and completely reorganized the armor and offhand equipment slots to fit perfectly in the bottom right corner! - Fast-Action Buttons: Added brand-new interactive buttons seamlessly integrated into the bottom-left of the player's inventory GUI:
- Ender Chest Shortcut: Instantly swap to viewing the player's Ender Chest without leaving the GUI!
- Auto-Update Notifier: OpenInv now talks directly to Modrinth! The plugin securely checks the Modrinth API on server startup and immediately alerts your console and any joining Admins via chat if a new plugin version is available, complete with the direct download link!
🛡️ Permissions & Security Upgrades
- Strict "View-Only" Mode: Major security buff! If a staff member does not have the
openinv.modifypermission, the plugin now locks them into a strict "View-Only" mode. They can see the full inventory, but dragging, dropping, adding, or stealing items is hardware-blocked! - The "Master Key" Perm: We completely revamped the internal command router. The
openinv.adminpermission now acts as a true global Master Key. Giving a player this single permission completely bypasses the need for the other 10 individual nodes (openinv.freeze,openinv.search, etc.)!
🧹 Cleanups
- Ghost Perm Scrubbing: Completely scrubbed the codebase of confusing, unused fallback permissions (like
openinv.silentandopeninv.container) and dead legacy commands to keep your LuckPerms editor incredibly organized and clean!
Комментарии
Загружаем…