Inventory Rollback

Inventory Rollback Plugin

A comprehensive Paper Minecraft plugin for snapshotting and restoring player inventories with time-based rollback capabilities.

Installation

1. Download `InventoryRollback-1.0.0.jar` 2. Place in `plugins/` folder 3. Restart server 4. Configure in `plugins/InventoryRollback/config.yml` 5. Reload: `/invrollback reload`

Commands

| Command | Description | Permission | |---------|-------------|------------| | `/ir restore <player> [time]` | Restore player inventory | `invrollback.restore` | | `/ir restore world <world> <time>` | Restore entire world | `invrollback.restore.world` | | `/ir restore server <time>` | Restore entire server | `invrollback.restore.server` | | `/ir list <player>` | List snapshots | `invrollback.list` | | `/ir backup <player>` | Manual backup | `invrollback.backup` | | `/ir cleanup` | Cleanup old snapshots | `invrollback.cleanup` | | `/ir confirm` | Confirm operation | - | | `/ir cancel` | Cancel operation | - |

Aliases: `/invrollback`, `/ir`, `/invr`

Configuration

Snapshot Settings

```yaml snapshots: interval: 300 # 5 minutes max-per-player: 50 events: on-death: true on-quit: true ```

Storage

```yaml storage: mode: HYBRID # MEMORY, DISK, or HYBRID compression: enabled: true level: 6 # 1-9 ```

Rollback

```yaml rollback: max-time: 3600 # 1 hour in seconds current-inventory-action: BACKUP # BACKUP, DROP, or CLEAR ```

Usage Examples

Restore Single Player

``` /ir restore Steve 30m ``` Restores Steve's inventory to 30 minutes ago

Restore Entire World

``` /ir restore world world_nether 1h /ir confirm ``` Restores all players in Nether to 1 hour ago (requires confirmation)

List Snapshots

``` /ir list Steve ``` Shows all available snapshots for Steve

Manual Backup

``` /ir backup Steve ``` Creates immediate snapshot for Steve

Time Format

- `30s` or `30` - 30 seconds - `5m` - 5 minutes - `1h` - 1 hour - `2h30m` - 2 hours 30 minutes

Storage Modes

MEMORY

- Fast access - Lost on restart - Periodic disk backup - Takes RAM

DISK

- Persistent - Slower access - Compressed storage - Takes Storage

HYBRID

- Memory cache + disk persistence - Best of both - Automatic sync

Safety Features

- Corruption Detection: Dangerous operations need `/ir confirm` - Corruption Detection: Backup before restore - Corruption Detection: World/server restores in batches to avoid lag - Corruption Detection: Auto-removes corrupted files

Permissions

| Permission | Default | Description | |------------|---------|-------------| | `invrollback.admin` | op | Full access | | `invrollback.restore` | op | Restore inventories | | `invrollback.restore.others` | op | Restore others | | `invrollback.restore.world` | op | Restore inventories for users in a world | | `invrollback.restore.server` | op | Restore inventories for everyone in the server |

Support

For issues, check: 1. `/ir status` for plugin info 2. Enable debug in config 3. Check console logs 4. Join our Discord Server