InventoryBackup v1

Why You Might Need This ? (Real Server Scenarios)

• Items "vanish" after death / teleport / world change: You need a traceable record, not just player stories.

  
  

• Disputes, mistakes, griefing: You need evidence of what a player actually had at that time.

  
  

• Suspected item duplication / packet abuse: You need historical snapshots to audit and take action confidently.

  
  

• Concerned about server lag: Snapshots are taken on the main thread, while compression and file writes run asynchronously to minimize impact.

  
  

InventoryBackup creates backups of players' inventories and ender chests via scheduled tasks and configurable trigger events, allowing you to search by time and click to preview records.

• One command to start: /ib help shows usage and which triggers are currently enabled (read live from config.yml).

  
  

• Click to preview: Search results are clickable and open an in-game GUI preview (console only shows a summary).

  
  

• Controlled event triggers: Each trigger can be enabled/disabled and has its own cooldown (prevents burst writes).

  
  

• Cross-version compatibility for Pickup event: Automatically adapts to different event classes across server versions.

  
  

• Editable translations: Built-in en_US, zh_CN, etc. You can edit messages in the plugin's data folder.

  
  

1. Drop the JAR file into plugins/ and restart the server.

   
   

2. In-game: Run /ib help.

   
   

3. Optional: Adjust the schedule interval and event cooldowns in config.yml.

   
   

First run generates:

• plugins/InventoryBackup/config.yml

  
  

• plugins/InventoryBackup/lang.yml

  
  

• plugins/InventoryBackup/lang/*.yml

  
  

• /ib help

  • Usage guide + list of enabled triggers.

    
    

• /ib sc <playerId> <time> [page]

  • Search Inventory backups (click entries to preview).

    
    

• /ib se <playerId> <time> [page]

  • Search Ender Chest backups (click entries to preview).

    
    

PlayerId Notes

• Player name: Support offline players.

  
  

Time Formats (Search Range)

• Month: yyyy-M (e.g., 2026-1)

  
  

• Day: yyyy-M-d (e.g., 2026-1-28)

  
  

• Minute: yyyy-M-d-H-m (e.g., 2026-1-28-12-30)

  
  

(Togglable & Configurable in config.yml)

These triggers store a "reason" and display it in the search list:

• PlayerDeathEvent

  
  

• PlayerChangedWorldEvent

  
  

• PlayerJoinEvent

  
  

• PlayerQuitEvent

  
  

• PlayerTeleportEvent

  
  

• PlayerDropItemEvent

  
  

• PlayerPickupItemEvent (auto cross-version adaptation)

  
  

• PlayerInteractEvent (right-click blocks, configurable whitelist)

  
  

Also included:

• Scheduled backups: backup.enabled + backup.intervalSeconds + backup.maxPlayersPerSecond

  
  

• inventorybackup.command (default: op)