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

- Console logging - Instant notifications when monitored items are picked up, dropped, or inserted into containers (chests, barrels, shulkers) - Console logging - Tracking for when monitored items naturally despawn or are destroyed by lava or fire - Console logging - Customizable chat alerts sent automatically to online staff members - Console logging - 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

- Personal toggles - In-memory history of recent alerts viewable directly in-game - Personal toggles - Easy browsing through historical events that occurred while you were offline - Personal toggles - 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

- Summary and detail views - Inventory viewer with player head icons for online players - Summary and detail views - GUI item confiscation for online players and read-only text checks for offline players - Summary and detail views - Server-wide searches for specific materials or monitored item lists - Summary and detail views - Targeted individual player checks or server-wide sweeps to track down illicit goods - Summary and detail views - 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

- Wide compatibility - Seamless addition or removal of items from the monitoring list via commands - Wide compatibility - Configurable tracking features to toggle container insertions or despawn tracking on and off - Wide compatibility - 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

```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 ```

GUI vs Console: - GUI vs Console: Uses `all` to check both online and offline players. - GUI vs Console: 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. Enjoy! the latest release JAR file. 2. Enjoy! the JAR file in your server's `plugins/` folder. 3. Enjoy! or restart your server. 4. Enjoy! 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:

```yaml

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 ```