inventoryrestore

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: [DIRT, STONE]
## 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).
  

• Player menu — choose backup category (join, quit, death, world change, force, crash).
  

• Rollback list — paginated list of snapshots with timestamps (timezone/format configurable).

• Main inventory backup — full 36-slot preview, armor & off-hand in the same layout as vanilla, plus actions:
  
  • 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.
  

Screenshots — restore actions & tools

Commands & safety

• /restore / /ir restore [player|uuid] — open restore GUI; supports UUID or name tab-complete.
• /refund / /ir refund [player|uuid] — refund GUI + ledger context.
• /ir enable, /ir disable, /ir reload, /ir version, /ir help.
• /ir import confirm — one-time migration from legacy backup data (requires inventoryrestore.import; grant via your permissions plugin if needed).
• Configurable death event ordering vs other plugins (allow-other-plugins-edit-death-inventory).
• loadbefore several death-chest style plugins to reduce ordering conflicts.

Integrations & ops

• Optional Discord refund webhook when a full restore is confirmed from the refund GUI (refund-webhook in config.yml).
• Update checker on startup (configurable).
• Sounds for restore, teleport, food, hunger, and XP (each togglable).

---

Commands

Child permission inventoryrestore.restore.teleport — allows teleporting to the backup’s saved world/coords from the GUI.

Full permission tree is in plugin.yml.

---

Configuration (config.yml)

---

📊 bStats