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 [item]	View paginated alert history, optionally filtered by material	staffitemalert.admin	/ia
/itemalert check <player|all> [material|list] [online|offline|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

/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 first run:

# List of items to monitor for alerts
monitored-items:
  - DIAMOND
  - NETHERITE_INGOT
  - ELYTRA

# Toggle specific tracking events
track-container-inserts: true
track-despawns: true
track-item-destruction: true

# Max number of alerts to keep in memory for /ia log
alert-history-limit: 200

# Alert message format (supports Minecraft color codes)
# Placeholders: {player}, {action}, {item}, {amount}, {location}
alert-message: "&5&l[StaffItemAlert] &d{player} &7{action} &d{item} &7x{amount} at &d{location}"

# Default scope for check command when not specified
# Options: online, offline, all
auto-scope: all