InventoryHistory

Minecraft 版本： 1.21.8 1.21.9 1.21.10 1.21.11

平台： bukkit paper spigot

标签： game-mechanics management

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

Aliases: /inventoryhistory, /invhist, /ih

Permissions

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.