inventoryrestore

# InventoryRestore (https://img.shields.io/discord/1480618281189773314?label=Discord&logo=discord&logoColor=white&color=5865F2)](https://discord.gg/qdmSv7usbJ) (https://img.shields.io/badge/GitHub-inventoryrestore-181717?logo=github)](https://github.com/vanillaxtra/inventoryrestore) (https://img.shields.io/badge/Minecraft-1.13--1.21.x-62B47A)](https://github.com/vanillaxtra/Dinventoryrestore) (https://img.shields.io/badge/Folia-Supported-blue)](https://github.com/vanillaxtra/inventoryrestore) **InventoryRestore** backs up player inventories and lets staff inspect, restore, and document refunds—with optional MySQL, crash recovery, autosave, and a Discord webhook for refund confirmations. --- ## Features ### Backups & storage - **Automatic saves** when players **join**, **quit**, **die**, **change worlds**, **crashes**, and on a configurable **autosave** interval - **Force backup** for one online player or **everyone online** (`/ir forcebackup`). - **YAML** (default) or **MySQL** for centralized storage. - Per-player limits per save type (`max-saves`: join, quit, death, world-change, force, crash). ``` ## Maximum saves a backup will hold per type per user. max-saves: join: 10 quit: 10 death: 50 world-change: 10 force: 10 crash: 20 ``` - **Material ignore list** so chosen items are never stored (`backup-ignore-materials`) this is so that item is not taking up lots of storage for example string if you have a `/string` plugin. ``` ## Materials (Bukkit names) excluded from backups and not stored. Example: ## Empty list = nothing ignored. backup-ignore-materials: ``` - **Offline restores & inventory viewing** - **Export restores to shulkers, chests, bundles & drop** Incase you dont want to restore someones current inventory you can put chests at their base, put a bundle in their inventory etc. ### Staff GUIs - **Main menu** — browse players (restore mode shows names; refund mode can hide names for privacy). !(https://raw.githubusercontent.com/vanillaxtra/inventoryrestore/refs/heads/main/assets/mainmenu.png) - **Player menu** — choose backup category (join, quit, death, world change, force, crash). !(https://raw.githubusercontent.com/vanillaxtra/inventoryrestore/refs/heads/main/assets/backupmenu.png) | Joins | Quits | Deaths | |-------|-------|--------| | !(https://raw.githubusercontent.com/vanillaxtra/inventoryrestore/refs/heads/main/assets/joins.png) | !(https://raw.githubusercontent.com/vanillaxtra/inventoryrestore/refs/heads/main/assets/quits.png) | !(https://raw.githubusercontent.com/vanillaxtra/inventoryrestore/refs/heads/main/assets/deaths.png) | | World changes | Force saves | Crashes | |---------------|-------------|---------| | !(https://raw.githubusercontent.com/vanillaxtra/inventoryrestore/refs/heads/main/assets/worldchanges.png) | !(https://raw.githubusercontent.com/vanillaxtra/inventoryrestore/refs/heads/main/assets/forcesaves.png) | !(https://raw.githubusercontent.com/vanillaxtra/inventoryrestore/refs/heads/main/assets/crashes.png) | - **Rollback list** — paginated list of snapshots with timestamps (timezone/format configurable). !(https://raw.githubusercontent.com/vanillaxtra/inventoryrestore/refs/heads/main/assets/rollbacklist.png) - **Main inventory backup** — full **36-slot preview**, **armor & off-hand** in the same layout as vanilla, plus actions: !(https://raw.githubusercontent.com/vanillaxtra/inventoryrestore/refs/heads/main/assets/restoremenu.png) - Restore main inventory + armor + off-hand (with **overwrite warning** when the target still has items; skipped if their inventory is **completely empty** when detectable). - **Ender chest** backup view and restore. - **Hunger** and **XP** restore (when target is online). - **Teleport** to saved backup location (permission `inventoryrestore.restore.teleport`). - **Export to storage** (extract items for manual handling). - **Backup activity** — who opened or restored a snapshot (audit trail). - **Overwrite warning** — shows the target’s **current** inventory (or last saved layout offline) including **armor & off-hand** before confirming a full restore. !(https://raw.githubusercontent.com/vanillaxtra/inventoryrestore/refs/heads/main/assets/overwritewarning.png) #### Screenshots — restore actions & tools | Teleport to backup coords | Ender chest | Ender chest | |---------------------------|-----------------|-----------------| | !(https://raw.githubusercontent.com/vanillaxtra/inventoryrestore/refs/heads/main/assets/restorecoords.png) | !(https://raw.githubusercontent.com/vanillaxtra/inventoryrestore/refs/heads/main/assets/restoreenderchest1.png) | !(https://raw.githubusercontent.com/vanillaxtra/inve