StaffItemAlert
用于 Minecraft 服务器的先进库存监控与实时物品追踪
StaffItemAlert 是一款功能强大且轻量级的管理插件,专为需要全面管控受限、高价值或危险物品的服务器管理人员设计。当受监控的物品被交互时,你会收到即时且可点击的通知;通过高级扫描追踪非法物品,并直接在游戏内查看详细的警报日志。
主要特性
实时监控
- 全面追踪 - 当受监控的物品被拾取、丢弃或放入容器(箱子、 barrels、潜影盒)时,立即发送通知
- 世界事件 - 追踪受监控物品自然消失或被岩浆/火焰销毁的情况
- 智能警报 - 自动向在线工作人员发送可自定义的聊天警报
- 可点击传送 - 交互式聊天警报,使你无声且瞬间传送到确切的交互位置
- 控制台记录 - 所有物品移动的完整审计轨迹,供离线审查
警报管理与日志
- 游戏内警报历史 - 在游戏内直接查看内存中最近的警报历史记录
- 分页日志 - 轻松浏览你离线期间发生的历史事件
- 智能过滤 - 按特定材料过滤日志,以追踪特定物品的历史
- 个人开关 - 每位工作人员独立的警报偏好设置,防止聊天刷屏
高级库存扫描
- 交互式 GUI - 带有在线玩家头像图标的库存查看器
- 在线与离线扫描 - 对在线玩家进行 GUI 物品没收,对离线玩家进行只读文本检查
- 智能过滤 - 针对特定材料或受监控物品列表的全服搜索
- 灵活范围 - 针对单个玩家的检查或全服扫描,以追踪非法物品
- 物品移除 - 只需单击即可直接从在线玩家的库存中没收物品
- 摘要与详细视图 - 多玩家扫描结果中包含可点击的玩家头像,可查看匹配物品和槽位信息
配置与便利性
- 游戏内管理 - 通过命令无缝地从监控列表中增加或移除物品
- 事件切换 - 可配置的追踪功能,允许开启或关闭容器插入追踪或消失追踪
- 持久设置 - 配置和个人警报偏好设置会在服务器重启后自动保存
- 广泛兼容性 - 完全支持 Minecraft 1.16.5 至 1.21.11+
命令
| 命令 |
描述 |
权限 |
别名 |
/itemalert add <item> |
将物品添加到监控列表 |
staffitemalert.admin |
/ia |
/itemalert remove <item> |
从监控列表中移除物品 |
staffitemalert.admin |
/ia |
/itemalert list |
查看所有当前受监控的物品 |
staffitemalert.admin |
/ia |
/itemalert log [item] |
查看分页的警报历史,可按材料筛选 |
staffitemalert.admin |
/ia |
/itemalert check <player|all> [material|list] [online|offline|all] |
扫描玩家库存中的物品(为玩家打开 GUI,为控制台显示文本) |
staffitemalert.check |
/ia |
/itemalert help |
显示综合帮助信息 |
staffitemalert.admin |
/ia |
/alerttoggle |
开启或关闭你自己的物品警报 |
staffitemalert.receive |
/at, /togglealerts |
命令示例
/ia check Steve → 扫描 Steve 的库存(在线 + 离线)以查找受监控物品
/ia check all NETHERITE_INGOT → 扫描所有玩家寻找下界合金锭
/ia check Steve list offline → 扫描 Steve 的离线数据以查找受监控物品
/ia log bedrock → 查看专门针对基岩的警报历史
默认行为:
- 目标范围: 使用
all 检查在线和离线玩家。
- 过滤器: 使用
list 应用你的受监控物品列表。
- GUI vs 控制台: 为玩家打开交互式 GUI,为控制台或命令方块显示文本输出。
权限
| 权限 |
描述 |
默认 |
staffitemalert.admin |
管理物品、日志并访问所有插件功能 |
OP |
staffitemalert.receive |
接收实时物品警报并使用可点击传送功能 |
OP |
staffitemalert.check |
扫描玩家库存(在线和离线) |
OP |
注意: staffitemalert.admin 授予对所有功能的访问权限,包括检查和日志命令。
安装
- 下载 最新发布的 JAR 文件。
- 放置 JAR 文件到你的服务器的
plugins/ 文件夹中。
- 启动 或重启服务器。
- 配置
plugins/StaffItemAlert/config.yml 中的监控物品和事件。
- 享受!
配置
插件在首次运行时会自动在 plugins/StaffItemAlert/ 中创建 config.yml:
# 要监控警报的物品列表
monitored-items:
- DIAMOND
- NETHERITE_INGOT
- ELYTRA
# 切换特定的追踪事件
track-container-inserts: true
track-despawns: true
track-item-destruction: true
# 保存在内存中以供 /ia log 使用的最大警报数量
alert-history-limit: 200
# 警报消息格式(支持 Minecraft 颜色代码)
# 占位符:{player}, {action}, {item}, {amount}, {location}
alert-message: "&5&l[StaffItemAlert] &d{player} &7{action} &d{item} &7x{amount} at &d{location}"
# 未指定时的 check 命令默认范围
# 选项:online, offline, all
auto-scope: all
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
- Download the latest release JAR file.
- Place the JAR file in your server's
plugins/ folder.
- Start or restart your server.
- Configure monitored items and events in
plugins/StaffItemAlert/config.yml.
- 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
评论 0
登录后参与评分
还没有评论,来抢沙发吧