InventoryHistory - PaperMC Plugin

A PaperMC 1.21.1 plugin that tracks player inventory history and allows administrators to view, restore, and duplicate inventory snapshots.

Features

• Automatic Inventory Tracking: Saves inventory snapshots every 5 minutes for all online players
• Disconnect Snapshots: Saves a final snapshot when players log out
• History Viewing: View any player's inventory history with pagination and clickable links
• GUI Interface: Interactive inventory GUI to browse snapshot contents
• Inventory Restoration: Restore a player's inventory from any historical snapshot
• Item Duplication: Copy items from a snapshot to your own inventory
• Automatic Cleanup: Snapshots older than 1 month are automatically removed
• SQLite Database: Lightweight, file-based storage - no external database required

Requirements

• PaperMC 1.21.1 or later
• Java 21 or later

Installation

1. Download the JAR file
2. Place it in your server's plugins folder
3. Start the server
4. The plugin creates a database at plugins/InventoryHistory/inventory_history.db

Commands

Command	Description	Permission
/invhist <player> [page]	View player's inventory history	inventoryhistory.view
/invhist open <player> <id>	Open snapshot in GUI	inventoryhistory.view
/invhist restore <player> <id>	Restore player's inventory	inventoryhistory.restore
/invhist duplicate <player> <id>	Copy items to your inventory	inventoryhistory.duplicate
/invhist cleanup	Delete old snapshots	inventoryhistory.admin

Aliases: /inventoryhistory, /invhist, /ih

Permissions

Permission	Description	Default
inventoryhistory.view	View inventory history	OP
inventoryhistory.restore	Restore inventories	OP
inventoryhistory.duplicate	Duplicate inventory items	OP
inventoryhistory.admin	Full admin access	OP

Usage Examples

View a player's inventory history

/invhist Notch
/invhist Notch 2

Shows a paginated list with clickable links to view, restore, or copy each snapshot.

Open a snapshot in GUI

/invhist open Notch 123

Opens an interactive inventory showing all items, armor, and off-hand slot with action buttons.

Restore a player's inventory

/invhist restore Notch 123

Restores Notch's inventory to exactly how it was in snapshot #123. Player must be online.

Copy items to your inventory

/invhist duplicate Notch 123

Copies all items from the snapshot to your inventory. Overflow drops on the ground.

Cleanup old snapshots

/invhist cleanup

Manually deletes snapshots older than 30 days.

How It Works

• Snapshots are saved every 5 minutes for online players
• A final snapshot is saved when players disconnect
• Snapshots older than 30 days are automatically deleted hourly
• Data is stored in SQLite at plugins/InventoryHistory/inventory_history.db

License

This plugin is provided as-is for personal and server use.