# InventoryRestore<\/p>\n
\n
\n
\n<\/p>\n
**InventoryRestore** backs up player inventories and lets staff inspect, restore, and document refunds\u2014with optional MySQL, crash recovery, autosave, and a Discord webhook for refund confirmations.<\/p>\n
—<\/p>\n
## Features<\/p>\n
### Backups & storage<\/p>\n
– **Automatic saves** when players **join**, **quit**, **die**, **change worlds**, **crashes**, and on a configurable **autosave** interval<\/p>\n
– **Force backup** for one online player or **everyone online** (`\/ir forcebackup`).
\n– **YAML** (default) or **MySQL** for centralized storage.
\n– Per-player limits per save type (`max-saves`: join, quit, death, world-change, force, crash).
\n“`
\n## Maximum saves a backup will hold per type per user.
\nmax-saves:
\n join: 10
\n quit: 10
\n death: 50
\n world-change: 10
\n force: 10
\n crash: 20
\n“`
\n– **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.
\n“`
\n## Materials (Bukkit names) excluded from backups and not stored. Example: [DIRT, STONE]
\n## Empty list = nothing ignored.
\nbackup-ignore-materials: []
\n“`
\n– **Offline restores & inventory viewing**<\/p>\n
– **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.<\/p>\n
### Staff GUIs<\/p>\n
– **Main menu** \u2014 browse players (restore mode shows names; refund mode can hide names for privacy).
\n<\/p>\n
– **Player menu** \u2014 choose backup category (join, quit, death, world change, force, crash).
\n<\/p>\n
| Joins | Quits | Deaths |
\n|——-|——-|——–|
\n|  |  |  |<\/p>\n
| World changes | Force saves | Crashes |
\n|—————|————-|———|
\n|  |  |  |<\/p>\n
– **Rollback list** \u2014 paginated list of snapshots with timestamps (timezone\/format configurable).<\/p>\n
<\/p>\n
– **Main inventory backup** \u2014 full **36-slot preview**, **armor & off-hand** in the same layout as vanilla, plus actions:
\n
\n – Restore main inventory + armor + off-hand (with **overwrite warning** when the target still has items; skipped if their inventory is **completely empty** when detectable).
\n – **Ender chest** backup view and restore.
\n – **Hunger** and **XP** restore (when target is online).
\n – **Teleport** to saved backup location (permission `inventoryrestore.restore.teleport`).
\n – **Export to storage** (extract items for manual handling).
\n – **Backup activity** \u2014 who opened or restored a snapshot (audit trail).
\n– **Overwrite warning** \u2014 shows the target\u2019s **current** inventory (or last saved layout offline) including **armor & off-hand** before confirming a full restore.
\n<\/p>\n
#### Screenshots \u2014 restore actions & tools<\/p>\n
| Teleport to backup coords | Ender chest | Ender chest |
\n|—————————|—————–|—————–|
\n|  |  |  |<\/p>\n
| Restore food | Restore XP | Restore offline |
\n|————–|————|—————–|
\n|  |  |  |<\/p>\n
| Export (chest) | Export (bundle) |
\n|—————-|—————–|
\n|  |  |<\/p>\n
<\/p>\n
| Refund \/ restore history (1) | Refund \/ restore history (2) |
\n|——————————|——————————|
\n|  |  |<\/p>\n
### Commands & safety<\/p>\n
– **`\/restore`** \/ **`\/ir restore [player|uuid]`** \u2014 open restore GUI; supports **UUID** or name tab-complete.
\n– **`\/refund`** \/ **`\/ir refund [player|uuid]`** \u2014 refund GUI + ledger context.
\n– **`\/ir enable`**, **`\/ir disable`**, **`\/ir reload`**, **`\/ir version`**, **`\/ir help`**.
\n– **`\/ir import confirm`** \u2014 one-time migration from legacy backup data (requires **`inventoryrestore.import`**; grant via your permissions plugin if needed).
\n– Configurable **death event ordering** vs other plugins (`allow-other-plugins-edit-death-inventory`).
\n– **`loadbefore`** several death-chest style plugins to reduce ordering conflicts.<\/p>\n
### Integrations & ops<\/p>\n
– Optional **Discord refund webhook** when a full restore is confirmed from the refund GUI (`refund-webhook` in `config.yml`).
\n– **Update checker** on startup (configurable).
\n– **Sounds** for restore, teleport, food, hunger, and XP (each togglable).<\/p>\n
—<\/p>\n
## Commands<\/p>\n
| Command | Permission | Description | Child permission **`inventoryrestore.restore.teleport`** \u2014 allows teleporting to the backup\u2019s saved world\/coords from the GUI.<\/p>\n Full permission tree is in **`plugin.yml`**.<\/p>\n —<\/p>\n ## Configuration (`config.yml`)<\/p>\n | Option | What it does | —<\/p>\n ## \ud83d\udcca bStats<\/p>\n <\/p>\n","protected":false},"excerpt":{"rendered":" InventoryRestore backs up player inventories and lets staff inspect and restore with crash recovery, autosave, and a Discord webhook & in game logging system<\/p>\n","protected":false},"featured_media":85867,"template":"","meta":{"_minecraft_slug":"inventoryrestore","_minecraft_project_id":"iVK0fIKs","_minecraft_author":"not.authorised","_minecraft_license":"MIT","_minecraft_downloads":53,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"inventoryrestore.zip","_minecraft_size_bytes":1093868,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T21:01:31.459213Z","_minecraft_date_created":"2026-04-10T21:41:31.783729Z","_minecraft_date_modified":"2026-03-25T20:40:12.226205Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/inventoryrestore","_minecraft_icon_attachment_id":85867,"_minecraft_imported_at":"2026-06-04T21:41:13+00:00","_minecraft_import_hash":"d6f985683aae6e75f8817be2d218c6a5","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,125,89,126,127,128,129,91,92],"mod_loader":[130,131,132,133,134],"minecraft_version":[438,446,449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-85866","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-folia","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-storage","mod_category-utility","mod_loader-bukkit","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n|——–|————|————-|
\n| `\/restore [player]` | `inventoryrestore.viewbackups` | Open restore GUI (optional target). |
\n| `\/refund [player]` | `inventoryrestore.refund` | Open refund GUI. |
\n| `\/ir restore [player]` | `inventoryrestore.viewbackups` | Same as `\/restore`. |
\n| `\/ir refund [player]` | `inventoryrestore.refund` | Same as `\/refund`. |
\n| `\/ir forcebackup all` | `inventoryrestore.forcebackup` | Force-save all online players. |
\n| `\/ir forcebackup player
\n| `\/ir enable` | `inventoryrestore.enable` | Turn plugin on. |
\n| `\/ir disable` | `inventoryrestore.disable` | Turn plugin off. |
\n| `\/ir reload` | `inventoryrestore.reload` | Reload config. |
\n| `\/ir version` | `inventoryrestore.version` | Version info. |
\n| `\/ir help` | `inventoryrestore.help` | In-game command list. |
\n| `\/ir import confirm` | `inventoryrestore.import` | Import legacy backups (destructive; confirm only). |<\/p>\n
\n|——–|—————-|
\n| `enabled` | Master switch. |
\n| `max-saves` | Caps per type per player. |
\n| `backup-lines-visible` | Rows visible on rollback list (max 5). |
\n| `folder-location` | Data path or `DEFAULT`. |
\n| `mysql` | Enable DB + pool settings. |
\n| `sounds.*.enabled` | Toggle feedback sounds. |
\n| `time-zone` \/ `time-format` | Backup timestamp display. |
\n| `allow-other-plugins-edit-death-inventory` | Death save timing vs other plugins. |
\n| `restore-to-player-button` | Show full-restore button. |
\n| `save-empty-inventories` | Whether empty snapshots are kept. |
\n| `backup-ignore-materials` | Bukkit material names to skip. |
\n| `refund-webhook` | Discord POST on refund-path full restore. |
\n| `autosave-*` | Interval autosave + crash recovery behavior. |
\n| `update-checker` | GitHub Releases update notice (`vanillaxtra\/inventoryrestore`). |
\n| `bStats` | Anonymous metrics (see below). |
\n| `debug` | Extra console logging. |<\/p>\n