# InvRewind<\/p>\n
Highly configurable inventory backup and restore plugin for Paper, Purpur, and Folia.<\/p>\n
For server owners and admins who want to backup player inventories and restore them when players lose items.<\/p>\n
—<\/p>\n
## Why Use This Plugin?<\/p>\n
**Protect Your Players’ Progress**
\n– Never lose items due to bugs, glitches, or accidents
\n– Restore inventories after server crashes or rollbacks
\n– Recover from duplication exploits or inventory wipes<\/p>\n
**Flexible & Powerful**
\n– Multiple database options (YAML, SQLite, MySQL)
\n– Export and import backups between formats
\n– Automatic fallback if database fails
\n– Works on Paper, Purpur, and Folia servers<\/p>\n
**Easy to Use**
\n– Intuitive GUI for browsing and restoring backups
\n– Selective restore – choose exactly what to restore
\n– Async operations – no server lag
\n– Console and in-game command support<\/p>\n
**Actively Maintained**
\n– Frequent updates with new features
\n– Bug fixes as they’re discovered
\n– Community-driven improvements
\n– Open source on GitHub<\/p>\n
—<\/p>\n
## Features<\/p>\n
### Core Functionality
\n– **Automatic Backups** – Capture player inventories on death, world change, join, quit, and scheduled intervals
\n– **Force Backups** – Create manual backups on demand via command
\n– **GUI-Based Restoration** – Intuitive interface for browsing and restoring backups
\n– **Selective Restore** – Restore specific items: inventory, armor, offhand, ender chest, XP, or location
\n– **Database Migration** – Export and import backups between YAML, SQLite, and MySQL formats<\/p>\n
### Technical Features
\n– **Folia Compatible** – Full support for Folia’s region-based threading
\n– **Multi-Database Support** – Choose between YAML, SQLite, or MySQL
\n– **Database Fallback** – Automatic fallback to YAML if database connection fails
\n– **Async Operations** – All database operations run asynchronously to prevent lag
\n– **Backup Limits** – Automatic cleanup of old backups per type
\n– **Pagination** – Handle large player counts and backup lists efficiently
\n– **Duplicate Detection** – Skip duplicate backups on import<\/p>\n
### Backup Types
\n– **Death** – Automatic backup when player dies
\n– **World Change** – Backup when switching worlds (including custom dimensions)
\n– **Join** – Backup when player joins the server
\n– **Quit** – Backup when player leaves the server
\n– **Scheduled** – Automatic backups at regular intervals
\n– **Force** – Manual backups created by admins<\/p>\n
—<\/p>\n
## Commands<\/p>\n
| Command | Description | Permission | —<\/p>\n ## Configuration<\/p>\n ### Database Options<\/p>\n “`yaml – **YAML** – File-based, easy to backup, good for small servers ### Auto-Backup Settings<\/p>\n “`yaml scheduled: ### Backup Limits<\/p>\n “`yaml ### Features<\/p>\n “`yaml ### Migration Settings<\/p>\n “`yaml ### GUI Sounds<\/p>\n “`yaml —<\/p>\n ## Database Migration<\/p>\n ### Export Backups<\/p>\n Export your current database to any format:<\/p>\n “` **Export locations:** ### Import Backups<\/p>\n Import backups from any format:<\/p>\n “` **Import locations:** **Features:** —<\/p>\n ## Permissions<\/p>\n | Permission | Description | Default | —<\/p>\n ## Support & Development<\/p>\n This plugin is actively maintained with frequent updates, new features, and bug fixes as they’re discovered. More features are planned for future releases.<\/p>\n – **Discord**: Join our Discord —<\/p>\n ## License<\/p>\n This project is licensed under the GNU General Public License v3.0.<\/p>\n","protected":false},"excerpt":{"rendered":" Highly configurable inventory backup and restore plugin for Paper, Purpur, and Folia.<\/p>\n","protected":false},"featured_media":86185,"template":"","meta":{"_minecraft_slug":"invrewind","_minecraft_project_id":"PGOGAl6O","_minecraft_author":"mukulx","_minecraft_license":"GPL-3.0-only","_minecraft_downloads":17,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"invrewind.zip","_minecraft_size_bytes":1148856,"_minecraft_version_count":5,"_minecraft_updated_at":"2026-05-15T22:42:55.403809Z","_minecraft_date_created":"2026-05-05T20:54:41.238705Z","_minecraft_date_modified":"2026-04-26T14:40:46.442955Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/invrewind","_minecraft_icon_attachment_id":86185,"_minecraft_imported_at":"2026-06-04T22:09:29+00:00","_minecraft_import_hash":"a88e771cf24bd61a2a46a9c105216452","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[125,126,127,128,91,92],"mod_loader":[131,132,133],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-86184","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-folia","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-storage","mod_category-utility","mod_loader-folia","mod_loader-paper","mod_loader-purpur","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","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\n|———|————-|————|
\n| `\/invrewind` or `\/ir` | Open player selection GUI | `invrewind.admin` |
\n| `\/invrewind reload` | Reload configuration | `invrewind.admin` |
\n| `\/invrewindforce
\n| `\/invrewind export [yaml|sqlite|mysql]` | Export backups to specified format | `invrewind.export` |
\n| `\/invrewind import
\ndatabase:
\n type: yaml # yaml, sqlite, or mysql
\n“`<\/p>\n
\n– **SQLite** – File-based database, better performance for medium servers
\n– **MySQL** – External database, best for large\/multi-server setups<\/p>\n
\nauto-backup:
\n on-death: true
\n on-world-change: true
\n on-join: true
\n on-quit: true<\/p>\n
\n enabled: false
\n interval: 30 # minutes
\n require-movement: true
\n min-items: 1
\n“`<\/p>\n
\nauto-backup:
\n limits:
\n enabled: true
\n max-per-type:
\n death: 50
\n world-change: 30
\n join: 20
\n quit: 20
\n scheduled: 40
\n force: 100
\n“`<\/p>\n
\nfeatures:
\n save-inventory: true
\n save-armor: true
\n save-offhand: true
\n save-enderchest: true
\n save-health: true
\n save-hunger: true
\n save-xp: true
\n save-location: true
\n“`<\/p>\n
\nmigration:
\n # Delete source file\/folder after successful import
\n delete-source-after-import: false
\n“`<\/p>\n
\ngui:
\n sounds-enabled: true # Enable\/disable all GUI sounds
\n“`<\/p>\n
\n\/invrewind export # Export to current database type
\n\/invrewind export yaml # Export to YAML folder structure
\n\/invrewind export sqlite # Export to SQLite .db file
\n\/invrewind export mysql # Export to MySQL .sql dump
\n“`<\/p>\n
\n– YAML: `plugins\/InvRewind\/exports\/yaml\/export_TIMESTAMP\/`
\n– SQLite: `plugins\/InvRewind\/exports\/sqlite\/export_TIMESTAMP.db`
\n– MySQL: `plugins\/InvRewind\/exports\/mysql\/export_TIMESTAMP.sql`<\/p>\n
\n\/invrewind import yaml
\n\/invrewind import sqlite
\n\/invrewind import mysql
\n“`<\/p>\n
\n– YAML: Place folders in `plugins\/InvRewind\/imports\/yaml\/`
\n– SQLite: Place .db files in `plugins\/InvRewind\/imports\/sqlite\/`
\n– MySQL: Place .sql files in `plugins\/InvRewind\/imports\/mysql\/`<\/p>\n
\n– Async processing to prevent server lag
\n– Progress logging every 100 backups
\n– Automatic duplicate detection and skipping
\n– Tab completion for available import files
\n– Works from console and in-game<\/p>\n
\n|————|————-|———|
\n| `invrewind.admin` | Full admin access to all features | OP |
\n| `invrewind.use` | Access to restore own inventory | OP |
\n| `invrewind.restore.others` | Restore other players’ inventories | OP |
\n| `invrewind.forcebackup` | Create force backups | OP |
\n| `invrewind.export` | Export backups to different formats | OP |
\n| `invrewind.import` | Import backups from different formats | OP |<\/p>\n
\n– **Issues**: GitHub Issues
\n– **Source Code**: GitHub Repository
\n– **Feature Requests**: Open an issue on GitHub<\/p>\n