InventoryHistory

# 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> ` | 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.