StaffItemAlert

Advanced inventory monitoring and real-time item tracking for Minecraft servers!

StaffItemAlert is a powerful yet lightweight plugin designed for server administrators who need comprehensive control over valuable items. Get instant notifications when monitored items are moved, and use advanced inventory scanning tools to check any player's inventory online or offline with an intuitive GUI interface.

Key Features

Real-Time Monitoring

• Live Item Alerts - Instant notifications when monitored items are picked up or dropped
• OP Player Notifications - All operators receive alerts automatically
• Console Logging - Complete audit trail of all item movements
• Personal Toggles - Each player can enable/disable their own alert preferences

Advanced Inventory Scanning

• Interactive GUI - Inventory viewer with player head icons
• Online & Offline Scanning - Check inventories of any player, regardless of online status
• Smart Filtering - Scan for specific materials or use your monitored items list
• Flexible Scoping - Target individual players or scan all players at once
• Item Removal - Remove items directly from online players' inventories through the GUI
• Console Support - Run scans from console with detailed text output
• Summary View - Multi-player scan results show clickable player heads
• Detail View - Click any player to see their matching items with slot information

Quality of Life

• Tab Completion - Smart autocomplete for all commands and materials
• Persistent Settings - Configuration and preferences save across server restarts
• Default Behaviors - Automatically checks both online and offline, uses monitored list when no filter specified
• Wide Compatibility - Works on 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 check <player|all> [material|list] [online|offline|all]	Scan player inventories for items. Opens GUI when run by a player, shows text output when run from console.	staffitemalert.check	/ia
/itemalert help	Display comprehensive help information	staffitemalert.admin	/ia
/alerttoggle	Toggle item alerts on/off for yourself	staffitemalert.receive	/at, /togglealerts

Check Command Examples

/ia check Steve                    → Scan Steve's inventory (online + offline) for monitored items
/ia check all                      → Scan all players for monitored items
/ia check Steve DIAMOND            → Scan Steve's inventory for diamonds only
/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 check all ELYTRA online        → Scan only online players for elytras

Default Behaviors:

• Target scope: all (checks both online and offline players)
• Filter: list (uses your monitored items list)
• GUI vs Console: Opens interactive GUI for players, shows text output for console/command blocks

Permissions

Permission	Description	Default
staffitemalert.admin	Manage monitored items and access all plugin features	OP
staffitemalert.receive	Receive real-time item pickup/drop alerts	OP
staffitemalert.check	Scan player inventories (online and offline)	OP

Note: staffitemalert.admin grants access to all features including the check command.

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 in plugins/StaffItemAlert/config.yml
5. Enjoy!

Configuration

The plugin automatically creates config.yml in plugins/StaffItemAlert/ on first run:

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

# 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