# InventoryHistory – PaperMC Plugin<\/p>\n
A PaperMC 1.21.1 plugin that tracks player inventory history and allows administrators to view, restore, and duplicate inventory snapshots.<\/p>\n
## Features<\/p>\n
– **Automatic Inventory Tracking**: Saves inventory snapshots every 5 minutes for all online players
\n– **Disconnect Snapshots**: Saves a final snapshot when players log out
\n– **History Viewing**: View any player’s inventory history with pagination and clickable links
\n– **GUI Interface**: Interactive inventory GUI to browse snapshot contents
\n– **Inventory Restoration**: Restore a player’s inventory from any historical snapshot
\n– **Item Duplication**: Copy items from a snapshot to your own inventory
\n– **Automatic Cleanup**: Snapshots older than 1 month are automatically removed
\n– **SQLite Database**: Lightweight, file-based storage – no external database required<\/p>\n
## Requirements<\/p>\n
– PaperMC 1.21.1 or later
\n– Java 21 or later<\/p>\n
## Installation<\/p>\n
1. Download the JAR file
\n2. Place it in your server’s `plugins` folder
\n3. Start the server
\n4. The plugin creates a database at `plugins\/InventoryHistory\/inventory_history.db`<\/p>\n
## Commands<\/p>\n
| Command | Description | Permission | **Aliases**: `\/inventoryhistory`, `\/invhist`, `\/ih`<\/p>\n ## Permissions<\/p>\n | Permission | Description | Default | ## Usage Examples<\/p>\n ### View a player’s inventory history ### Open a snapshot in GUI ### Restore a player’s inventory ### Copy items to your inventory ### Cleanup old snapshots ## How It Works<\/p>\n – Snapshots are saved every 5 minutes for online players ## License<\/p>\n This plugin is provided as-is for personal and server use.<\/p>\n","protected":false},"excerpt":{"rendered":" Records inventory history of players, especially useful for laggy servers where players false-die often.<\/p>\n","protected":false},"featured_media":85857,"template":"","meta":{"_minecraft_slug":"inventoryhistory","_minecraft_project_id":"9f5fHs3k","_minecraft_author":"BlockPlacer2026","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":58,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"inventoryhistory.zip","_minecraft_size_bytes":27524,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T20:52:16.840601Z","_minecraft_date_created":"2026-02-16T23:17:04.025818Z","_minecraft_date_modified":"2026-02-16T06:27:24.368793Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/inventoryhistory","_minecraft_icon_attachment_id":85857,"_minecraft_imported_at":"2026-06-04T21:40:26+00:00","_minecraft_import_hash":"2f47704519177ce8e48312562f64fcec","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,89,126,127,129],"mod_loader":[130,132,134],"minecraft_version":[40,41,81,82],"class_list":["post-85856","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_category-spigot","mod_loader-bukkit","mod_loader-paper","mod_loader-spigot","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n|———|————-|————|
\n| `\/invhist
\n| `\/invhist open
\n| `\/invhist restore
\n| `\/invhist duplicate
\n| `\/invhist cleanup` | Delete old snapshots | `inventoryhistory.admin` |<\/p>\n
\n|————|————-|———|
\n| `inventoryhistory.view` | View inventory history | OP |
\n| `inventoryhistory.restore` | Restore inventories | OP |
\n| `inventoryhistory.duplicate` | Duplicate inventory items | OP |
\n| `inventoryhistory.admin` | Full admin access | OP |<\/p>\n
\n“`
\n\/invhist Notch
\n\/invhist Notch 2
\n“`
\nShows a paginated list with clickable links to view, restore, or copy each snapshot.<\/p>\n
\n“`
\n\/invhist open Notch 123
\n“`
\nOpens an interactive inventory showing all items, armor, and off-hand slot with action buttons.<\/p>\n
\n“`
\n\/invhist restore Notch 123
\n“`
\nRestores Notch’s inventory to exactly how it was in snapshot #123. Player must be online.<\/p>\n
\n“`
\n\/invhist duplicate Notch 123
\n“`
\nCopies all items from the snapshot to your inventory. Overflow drops on the ground.<\/p>\n
\n“`
\n\/invhist cleanup
\n“`
\nManually deletes snapshots older than 30 days.<\/p>\n
\n– A final snapshot is saved when players disconnect
\n– Snapshots older than 30 days are automatically deleted hourly
\n– Data is stored in SQLite at `plugins\/InventoryHistory\/inventory_history.db`<\/p>\n