InventoryRestore — Minecraft Plugin
───────────────────────────────────────────────
A Spigot/Paper plugin made for staff management and player recovery.
It automatically saves player inventories during critical events such as death, teleportation, disconnection, and world changes.
Staff can easily view or restore these inventories through an intuitive and modern GUI system.
───────────────────────────────────────────────
✨ Features
───────────────────────────────────────────────
• Automatic inventory snapshots on:
→ Player death
→ World change
→ Teleportation
→ Disconnection / reconnection
• Restore GUI system to browse and recover inventories.
• Live inventory viewer (similar to /invsee).
• Safe and asynchronous database operations.
• Multi-language messages (English and Spanish).
• Fully configurable menu layouts (YAML-based).
• Automatic cleanup of old snapshots after a set number of days.
• Works perfectly on both Spigot and Paper servers.
───────────────────────────────────────────────
Demonstration
──────────────────────────────────────────────
───────────────────────────────────────────────
Commands
───────────────────────────────────────────────
All commands start with /invrestore
/invrestore restore <player> → Opens the restore GUI for the player's saved inventories
/invrestore view <player> → Opens a live view of the target player's inventory
/invrestore reload → Reloads all configuration and message files
/invrestore help → Displays help and available subcommands
───────────────────────────────────────────────
Permissions
───────────────────────────────────────────────
inventoryrestore.use → Base permission for /invrestore
inventoryrestore.restore → Allows restoring inventories from the GUI
inventoryrestore.view → Allows viewing player inventories live
inventoryrestore.view.use → Allows editing live inventories
inventoryrestore.reload → Allows reloading configuration files
(Default: OP)
───────────────────────────────────────────────
️ Configuration Files
───────────────────────────────────────────────
config.yml → General settings (language, cleanup time, database)
invconfig.yml → GUI layout and slot configuration
inventories.yml → Visual definitions for stored inventories
messages/en.yml → English language file
messages/es.yml → Spanish language file
data.db → Local storage for serialized inventories
───────────────────────────────────────────────
️ How It Works
───────────────────────────────────────────────
1. Place InventoryRestore.jar into your /plugins/ folder.
2. Start the server to generate the configuration files.
3. Configure layouts and settings in YAML files.
4. The plugin will automatically save player inventories when they die, teleport, change world, or disconnect.
5. Use /invrestore restore <player> to open a GUI with all stored snapshots.
6. Click a record to view, restore, or delete it.
7. Use /invrestore view <player> to inspect live inventories in real time.
───────────────────────────────────────────────
✅ Ideal For
───────────────────────────────────────────────
• Survival and faction servers
• Roleplay or RPG servers
• Staff teams that handle lost item reports
• Any server needing reliable inventory recovery and inspection tools
───────────────────────────────────────────────
Created with performance, reliability, and staff utility in mind.
InventoryRestore ensures no item loss goes unresolved — simple, visual, and safe.