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

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

Storage

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

Rollback

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

• Confirmation Required: Dangerous operations need /ir confirm
• Current Inventory Handling: Backup before restore
• Batch Processing: 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