🎒 InventoryBackups

Never lose your items again! Automatic inventory and ender chest backup and restoration system for Minecraft servers.

📖 Overview

InventoryBackups is a powerful server-side mod that automatically saves player inventories and ender chests at regular intervals and on important events (death, login, logout, ender chest opening). Server administrators can easily restore, view, or copy any previous state with simple commands and an intuitive chat interface. Works with both online and offline players!

Perfect for:

🛡️ Server Protection - Recover from rollbacks, bugs, or glitches
👮 Admin Tools - Investigate duplication or item loss issues
🔧 Player Support - Help players who lost items due to bugs
📊 Activity Monitoring - Track inventory changes over time
🎯 Live Inspection - View and edit player inventories in real-time

✨ Features

🔄 Automatic Inventory Backups

⏰ Periodic Saves - Every 10 minutes (configurable)
💀 Death Saves - Captures inventory before death processing
➡️ Login Saves - Records inventory when player joins
⬅️ Logout Saves - Records inventory when player quits
🧹 Smart Deduplication - Skips saving if inventory hasn't changed
🗑️ Auto-Cleanup - Removes backups older than 7 days (configurable)

🎁 Automatic Ender Chest Backups

⏰ Periodic Saves - Every 10 minutes (uses same interval as inventory)
💀 Death Saves - Captures ender chest contents on death
➡️ Login Saves - Records ender chest when player joins
⬅️ Logout Saves - Records ender chest when player quits
📦 Open Saves - Optional: save when player opens ender chest (disabled by default)
🧹 Smart Deduplication - Only saves when contents change

🎮 Inventory Commands

All commands require OP level 2 for security and work with both online and offline players!

/inventory player <player>

NEW! Opens the player's current inventory in an editable chest GUI (online players only). Changes sync automatically when you close the interface.

/inventory list <player> [filter] [page]

Browse backups with pagination (10 per page), quick filters, and inline action buttons. Works for offline players!

/inventory view <player> <backup>

Opens a read-only chest GUI showing the backed-up inventory. Works for offline players!

/inventory set <player> <backup>

Restores player's inventory to the specified backup (requires player to be online).

/inventory copy <player> <backup>

Copies backup items to your own inventory (great for investigations). Works for offline players!

🎁 Ender Chest Commands

Complete ender chest management with the same intuitive interface!

/enderchest player <player>

Opens the player's current ender chest in an editable GUI (online players only). Changes sync automatically.

/enderchest list <player> [filter] [page]

Browse ender chest backups with pagination and filters. Works for offline players!

/enderchest view <player> <backup>

Opens a read-only preview of an ender chest backup. Works for offline players!

/enderchest set <player> <backup>

Restores player's ender chest to the specified backup (requires player to be online).

/enderchest copy <player> <backup>

Copies ender chest backup items to your inventory. Works for offline players!

🎭 Curios API Support

Optional integration with Curios API for saving accessory slots automatically.

⚙️ Fully Configurable

Located at: config/inventory/InventoryBackups.toml

Inventory Settings:

Enable/disable each save type individually
Adjust save intervals (default: 600 seconds)
Configure retention period (1-365 days)

Ender Chest Settings:

Master enable/disable switch
Independent controls for periodic, death, join, quit, and open saves
Shares retention period with inventory backups

🎯 Usage Examples

View and edit a player's current inventory:

/inventory player Steve

Open Steve's inventory, add or remove items, then close to save changes.

Restore a player who died to a bug:

/inventory list Steve death

Click the restore button next to the death save you want.

Check offline player's ender chest backups:

/enderchest list Alex

Browse Alex's ender chest backups even when they're offline!

Investigate suspected duplication:

/inventory list PlayerName 2025-01

Browse through January backups, use /inventory view to inspect items.

Restore ender chest from yesterday:

/enderchest list Steve

Use the "Yesterday" quick filter button, then restore the backup you need.

Help a player who lost items:

/inventory list PlayerName today

View recent backups and restore the correct one.

📁 File Storage

Inventory backups are stored in:

InventoryLog/inventory/<player-uuid>/<timestamp>.json

Ender chest backups are stored in:

InventoryLog/enderchest/<player-uuid>/<timestamp>.json

Filename format: yyyy-MM-dd-HH-mm-ss[-suffix].json

Suffixes:

-death = Saved on death
-join = Saved on login
-quit = Saved on logout
-open = Saved when opening ender chest (if enabled)
(no suffix) = Periodic auto-save

🌍 Offline Player Support

One of the most powerful features - view backups for any player, even if they're not currently online!

✅ Works offline:

/inventory list <offline-player>
/inventory view <offline-player> <backup>
/inventory copy <offline-player> <backup>
/enderchest list <offline-player>
/enderchest view <offline-player> <backup>
/enderchest copy <offline-player> <backup>

❌ Requires online:

/inventory player <player> - needs live connection
/inventory set <player> <backup> - needs player online
/enderchest player <player> - needs live connection
/enderchest set <player> <backup> - needs player online

🐛 Bug Reports & Suggestions

Found a bug or have a feature request? Please report it on our GitHub Issues page!

📄 License

This mod is released under the MIT License. Free to use, modify, and redistribute!

❤️ Support

If you enjoy this mod, please:

⭐ Leave a review on CurseForge
💬 Share it with your friends
🐛 Report bugs to help improve it

Made with ❤️ for the Minecraft community