StaffItemAlert

# StaffItemAlert **Advanced inventory monitoring and real-time item tracking for Minecraft servers** StaffItemAlert is a powerful and lightweight administrative plugin designed for server staff who need comprehensive control over restricted, high-value, or dangerous items. Get instant, clickable notifications when monitored items are interacted with, track down illicit goods with advanced scanning, and review detailed alert logs directly in-game. ## Key Features ### Real-Time Monitoring - **Comprehensive tracking** - Instant notifications when monitored items are picked up, dropped, or inserted into containers (chests, barrels, shulkers) - **World events** - Tracking for when monitored items naturally despawn or are destroyed by lava or fire - **Smart alerts** - Customizable chat alerts sent automatically to online staff members - **Clickable teleportation** - Interactive chat alerts that silently and instantly teleport you to the exact interaction location - **Console logging** - Complete audit trail of all item movements for offline review ### Alert Management and Logging - **In-game alert history** - In-memory history of recent alerts viewable directly in-game - **Paginated logs** - Easy browsing through historical events that occurred while you were offline - **Smart filtering** - Log filtering by specific materials to trace the history of a particular item - **Personal toggles** - Independent alert preferences for each staff member to prevent chat spam ### Advanced Inventory Scanning - **Interactive GUI** - Inventory viewer with player head icons for online players - **Online and offline scanning** - GUI item confiscation for online players and read-only text checks for offline players - **Smart filtering** - Server-wide searches for specific materials or monitored item lists - **Flexible scoping** - Targeted individual player checks or server-wide sweeps to track down illicit goods - **Item removal** - Direct confiscation of items from online players' inventories with a simple click - **Summary and detail views** - Multi-player scans with clickable player heads to view matching items and slot information ### Configuration and Quality of Life - **In-game management** - Seamless addition or removal of items from the monitoring list via commands - **Event toggling** - Configurable tracking features to toggle container insertions or despawn tracking on and off - **Persistent settings** - Configuration and personal alert preferences that automatically save across server restarts - **Wide compatibility** - Full support for Minecraft 1.16.5 through 1.21.11+ ## Commands | Command | Description | Permission | Aliases | |---------|-------------|------------|---------| | `/itemalert add <item>` | Add an item to the monitoring list | `staffitemalert.admin` | `/ia` | | `/itemalert remove <item>` | Remove an item from monitoring | `staffitemalert.admin` | `/ia` | | `/itemalert list` | View all currently monitored items | `staffitemalert.admin` | `/ia` | | `/itemalert log ` | View paginated alert history, optionally filtered by material | `staffitemalert.admin` | `/ia` | | `/itemalert check <player\|all> ` | Scan player inventories for items (opens GUI for players, text for console) | `staffitemalert.check` | `/ia` | | `/itemalert help` | Display comprehensive help information | `staffitemalert.admin` | `/ia` | | `/alerttoggle` | Toggle item alerts on or off for yourself | `staffitemalert.receive` | `/at`, `/togglealerts` | ### Command Examples ```text /ia check Steve → Scan Steve's inventory (online + offline) for monitored items /ia check all NETHERITE_INGOT → Scan all players for netherite ingots /ia check Steve list offline → Scan Steve's offline data for monitored items /ia log bedrock → View the alert history specifically for bedrock ``` **Default Behaviors:** - **Target scope:** Uses `all` to check both online and offline players. - **Filter:** Uses `list` to apply your monitored items list. - **GUI vs Console:** Opens interactive GUI for players, and shows text output for console or command blocks. ## Permissions | Permission | Description | Default | |------------|-------------|---------| | `staffitemalert.admin` | Manage items, logs, and access all plugin features | OP | | `staffitemalert.receive` | Receive real-time item alerts and use clickable teleportation | OP | | `staffitemalert.check` | Scan player inventories (online and offline) | OP | **Note:** `staffitemalert.admin` grants access to all features including the check and log commands. ## Installation 1. **Download** the latest release JAR file. 2. **Place** the JAR file in your server's `plugins/` folder. 3. **Start** or restart your server. 4. **Configure** monitored items and events in `plugins/StaffItemAlert/config.yml`. 5. **Enjoy!** ## Configuration The plugin automatically creates `config.yml` in `plugins/StaffItemAlert/` on the f