?️ StaffSuite
专为现代 Minecraft 服务器打造的终极管理员管理套件
? 目录
✨ 功能特性
? 核心管理
- GUI 驱动的管理界面 – 直观基于点击的界面,覆盖所有操作
- 覆盖原版命令 – 无缝集成
/ban、/kick、/mute 等命令
- 惩罚阶梯 – 自动升级处罚(针对作弊、破坏、诈骗行为)
- 静默集成 – 可与 LiteBans 和 AdvancedBan 并存工作
- 历史记录追踪 – 完整审计日志记录每一项操作
- 跨网络同步 – 通过 Redis 实现所有服务器间的数据实时同步
? 工作人员工具
- 工作人员模式 – 保存背包/游戏模式/位置后切换开启
- 旁观者 / 冒险 / 创造模式
- 可选自动隐身
- 自定义工具:指南针、处罚书、玩家选择器、冻结冰、面包屑标记、菜单箱子
- 隐身系统 – 完全不可见,并支持可见层级控制
- 冻结系统 – 限制可疑玩家的移动,并启用私聊
- 目标选择 – 支持点击、视线或 GUI 选择,带有粒子光效
- 内部备注 – 分类:WARNING(警告)、INFO(信息)、FOLLOWUP(跟进)、PRAISE(表扬)
? 高级分析
? 交易历史
- 追踪所有经济事件(存款、取款、购买、出售、转账)
- 来源追踪(Vault, ShopGUI+, 命令触发)
- 余额快照和净流量计算
- 24小时交易量摘要
? 命令历史
- 执行过的每条命令的完整日志
- 可配置的排除项(可筛选工作人员命令)
- 结果追踪:SUCCESS(成功)、DENIED(拒绝)、ERROR(错误)、CANCELLED(取消)
- 常用命令分析
⛏️ 挖掘统计
- 方块破坏追踪,包含工具类型和耐久度损耗
- 附魔捕获(时运、精准采集、效率)
- 世界/环境分类
- 每日聚合数据和材料细分
- 钻石/绿宝石/远古残骸的实时计数
- 顶级矿工排行榜
? 活动指标
- 方块破坏与实体击杀
- 聊天消息与命令执行
- 死亡与传送
- 物品拾取与丢弃事件
- 合成与钓鱼
- 等级变化与重生
- PvP 击杀与死亡
- 热力图风格的时间线视图
? 安全附加模块
- X-Ray 检测 – 可配置的矿石阈值,点击即传送报警
- CPS 检测 – 自动点击器检测(上限 18 CPS)
- AFK 看门狗 – 5分钟空闲检测
- 经济监控 – 异常余额激增检测(25万阈值,4倍乘数)
- ShopGUI+ 挂钩 – 商店交易验证
- Dispatch 扫描 – 一键扫描非法物品
- Quickcraft 防护 – 防止 Java 和基岩版上的 Shift+点击合成复制漏洞。完全可开关。
? 举报系统
- 玩家举报 –
/report <player> <reason> 创建工单
- 工作人员 GUI – 认领/解决并通过聊天会话处理
- 实时通知 – 游戏内 + Discord 机器人 webhook
- 状态追踪 – OPEN(开放)、CLAIMED(已认领)、RESOLVED(已解决)
? 网络功能
- 工作人员聊天桥接 – 跨所有服务器使用
/staffchat(支持 BungeeCord/Velocity)
- 跨服查找 –
/staff connect <player> 定位并传送
- 全网工作人员列表 – 查看全球所有在线的工作人员
- MySQL/Redis 同步 – 通过代理桥接共享数据
?️ Discord 集成
多种 webhook 路由(可单独开关):
default – 主日志
staff-chat – 工作人员消息
punishments – 封禁/静音/踢出事件
teleports – 工作人员传送
alerts – 安全通知
security – XRay/CPS/AFK 警报
reports – 新工单
analytics – 会话数据
staff-mode – 进入/退出工作人员模式事件
头像 URL 模板:https://mc-heads.net/avatar/{uuid}
? 配置
所有功能均可细粒度配置:
- 数据库类型(SQLite/MySQL)
- Redis 连接设置
- 隐身模式(内部/Essentials)
- 工作人员模式物品及槽位
- 冻结超时与聊天前缀
- 惩罚阈值与自动处罚
- 安全检测器参数
- Webhook 路由
- 会话分析上限
- GUI 标题与描述文本
- 语言系统(lang.yml)
- Geyser/Floodgate 兼容性
- ItemsAdder 支持
- Quickcraft 防护选项(启用、绕过权限)
? 依赖项
必需(内置阴影)
| Library |
Version |
Purpose |
| HikariCP |
5.1.0 |
数据库连接池 |
| Jedis |
5.1.3 |
Redis 客户端 |
| Kyori Adventure |
4.17.0+ |
现代文本组件库 |
| Adventure Platform Bukkit |
4.3.3 |
Bukkit 集成 |
可选(由服务器提供)
| Plugin |
Purpose |
Integration |
| PlaceholderAPI |
记分板/Tab 栏占位符 |
16+ 扩展插件 |
| DiscordSRV |
Discord 聊天桥接 |
转发工作人员聊天 |
| Vault |
经济抽象层 |
交易追踪 |
| ShopGUI+ |
商店经济集成 |
余额监控 |
| LiteBans |
封禁同步 |
静默同步模式 |
| AdvancedBan |
替代封禁系统 |
静默同步模式 |
| EssentialsX |
隐身回退方案 |
内部/Essentials 模式 |
⚙️ 运行要求
| 组件 |
版本 |
| Minecraft Server |
Paper 1.21.11(或衍生版) |
| Java Runtime |
Java 21 (OpenJDK/Corretto) |
| Database |
SQLite(内置)或 MySQL 8.0+ / MariaDB 10.5+ |
| Redis (Network) |
Redis 7.0+(可选) |
| Folia |
支持(异步任务处理) |
? 安装
- 下载 最新的
StaffSuite-3.6.0.jar
- 放置 到服务器的
plugins/ 文件夹中
- 启动 服务器
- 按需配置
plugins/StaffSuite/config.yml
- 重载 使用
/staffsuite reload 或重启服务器
- 分配 权限给工作人员组
就这样。无需其他额外设置。
? 配置
主配置文件 (config.yml)
# ============================================
# 数据库
# ============================================
database:
type: "sqlite" # "sqlite" 或 "mysql"
mysql:
host: "localhost"
port: 3306
database: "staffsuite"
username: "root"
password: ""
# ============================================
# Redis (跨服同步)
# ============================================
redis:
enabled: false
host: "localhost"
port: 6379
password: ""
# ============================================
# 隐身设置
# ============================================
vanish:
mode: "internal" # "internal" 或 "essentials"
levels:
enabled: false
default_level: 1
# ============================================
# 工作人员模式
# ============================================
staffmode:
save_inventory: true
save_flight: true
auto_vanish_on_staffmode: true
mode_style: "creative" # "spectator", "adventure", "creative"
items:
random_teleport_compass:
enabled: true
slot: 0
punishment_book:
enabled: true
slot: 1
player_selector:
enabled: true
slot: 2
staff_menu:
enabled: true
slot: 4
freeze_ice:
enabled: true
slot: 5
breadcrumb_tool:
enabled: true
slot: 7
exit_barrier:
enabled: true
slot: 8
# ============================================
# 冻结系统
# ============================================
freeze:
prevent_commands: true
prevent_movement: true
freeze_chat_prefix: "<dark_red><bold>已冻结</bold> <gray>»</gray>"
auto_unfreeze_seconds: 300
# ============================================
# 惩罚
# ============================================
punishments:
warn_threshold: 3
warn_auto_punishment: "mute 1h"
broadcast_punishments: true
ladders:
enabled: true
"作弊/开挂":
- "30d"
- "90d"
- "perm"
"破坏/盗窃":
- "7d"
- "30d"
- "perm"
"诈骗/钓鱼":
- "14d"
- "90d"
- "perm"
integration:
litebans:
enabled: false
silent: true
advancedban:
enabled: false
silent: true
# ============================================
# 举报
# ============================================
reports:
discord_webhook_url: ""
notify_staff_ingame: true
# ============================================
# 快照
# ============================================
snapshots:
auto_snapshot_interval_minutes: 30
max_entries: 12
shulker_export: false
shulker_blacklisted_materials:
- "BARRIER"
- "COMMAND_BLOCK"
death_logs:
enabled: true
max_entries: 10
# ============================================
# 安全检测
# ============================================
security:
xray:
enabled: true
ore_threshold: 15
time_window_seconds: 60
tracked_ores:
- DIAMOND_ORE
- DEEPSLATE_DIAMOND_ORE
- EMERALD_ORE
- DEEPSLATE_EMERALD_ORE
- ANCIENT_DEBRIS
cps:
enabled: true
window_seconds: 5
max_cps: 18
min_clicks: 25
afk:
enabled: true
idle_threshold_seconds: 300
economy:
enabled: true
absolute_threshold: 250000
multiplier: 4.0
check_interval_seconds: 45
shopgui_plus:
enabled: false
threshold: 150000
# ============================================
# Webhook
# ============================================
webhooks:
default: ""
staff-chat: ""
punishments: ""
teleports: ""
alerts: ""
security: ""
reports: ""
analytics: ""
staff-mode: ""
avatar_url: "https://mc-heads.net/avatar/{uuid}"
# ============================================
# 会话分析
# ============================================
session_analytics:
enabled: true
history_cap: 40
risk_profile: true
# ============================================
# GUI 自定义
# ============================================
gui:
enabled: true
titles:
staff_control: "<gradient:#5e9eff:#1e3a8a>Staff Control</gradient> <dark_gray>»</dark_gray> <white>Panel"
player_selector: "<green>在线玩家"
reports: "<yellow>举报"
history: "<aqua>历史记录"
notes: "<aqua>备注"
items:
lore_enabled: true
# ============================================
# 追踪(新功能)
# ============================================
tracking:
transactions:
enabled: true
track_vault: true
track_shopgui_plus: true
track_commands: true
retention_days: 90
command_history:
enabled: true
track_all_commands: true
track_staff_commands: true
retention_days: 30
excluded_commands:
- "/staff"
- "/staffmode"
- "/vanish"
- "/mute"
- "/ban"
- "/kick"
- "/warn"
- "/freeze"
- "/unfreeze"
mining_stats:
enabled: true
track_block_breaks: true
track_tool_info: true
track_enchantments: false
retention_days: 90
auto_save_interval_minutes: 10
ores_only: false
activity_metrics:
enabled: true
track_block_breaks: true
track_entity_kills: true
track_chat: true
track_command_executions: true
track_deaths: true
track_teleports: true
track_item_pickup_drop: true
retention_days: 7
# ============================================
# 兼容性
# ============================================
compatibility:
geyser:
enabled: false
bedrock_prefix_stripping: true
itemsadder:
enabled: false
custom_items: false
? 命令与权限
命令参考
| 命令 |
权限节点 |
描述 |
别名 |
/staff |
staffsuite.mod |
打开主管理 GUI |
– |
/staffmode [mode] |
staffsuite.staffmode |
切换管理员模式 |
sm |
/vanish |
staffsuite.vanish |
切换隐身状态 |
v |
/ban <player> [time] [reason] |
staffsuite.ban |
封禁一名玩家 |
– |
/ipban <player> [reason] |
staffsuite.ban |
IP 封禁一名玩家 |
– |
/kick <player> [reason] |
staffsuite.kick |
踢出一名玩家 |
– |
/mute <player> [time] [reason] |
staffsuite.mute |
禁言一名玩家 |
– |
/warn <player> [reason] |
staffsuite.warn |
警告一名玩家 |
– |
/freeze <player> |
staffsuite.freeze |
冻结/解冻一名玩家 |
– |
/unfreeze <player> |
staffsuite.freeze |
解冻一名玩家 |
– |
/history <player> |
staffsuite.history |
查看玩家完整历史 |
– |
/transactions <player> |
staffsuite.transactions |
查看交易历史 |
– |
/cmdhistory <player> |
staffsuite.cmdhistory |
查看命令历史 |
– |
/miningstats <player> |
staffsuite.miningstats |
查看挖矿统计 |
– |
/activity <player> |
staffsuite.activity |
查看活跃度指标 |
– |
/report <player> <reason> |
staffsuite.reports |
提交举报 |
reports |
/reports |
staffsuite.reports |
打开举报 GUI |
– |
/report claim <id> |
staffsuite.reports |
认领一份举报 |
– |
/report resolve <id> |
staffsuite.reports |
解决一份举报 |
– |
/notes add <player> <note> |
staffsuite.mod |
添加玩家备注 |
– |
/notes remove <id> |
staffsuite.mod |
删除一条备注 |
– |
/notes list <player> |
staffsuite.mod |
列出玩家备注 |
– |
/stafflogs [player] |
staffsuite.logs |
查看原始操作日志 |
– |
/audit <staff> |
staffsuite.audit |
查看管理员的操作记录 |
– |
/staffchat [message] |
staffsuite.mod |
切换管理员聊天频道 |
sc |
/freezechat |
staffsuite.mod |
切换冻结玩家的聊天访问权限 |
– |
/alerts |
staffsuite.alerts |
切换个人警报 |
– |
/breadcrumb |
staffsuite.staffmode |
传送至保存的位置 |
– |
/sweep |
staffsuite.admin |
扫描并移除黑名单物品 |
– |
/economyaudit <player> |
staffsuite.admin |
检查玩家余额 |
– |
/shulkerexport <player> |
staffsuite.history |
将快照导出至潜影盒 |
– |
/close |
staffsuite.mod |
关闭举报聊天会话 |
– |
/staffsuite reload |
staffsuite.reload |
重载配置 |
– |
/staffsuite license <key> |
op |
激活许可证密钥 |
– |
权限节点
staffsuite.*:
description: "所有 StaffSuite 权限"
children:
staffsuite.mod: true
staffsuite.ban: true
staffsuite.mute: true
staffsuite.kick: true
staffsuite.warn: true
staffsuite.freeze: true
staffsuite.reports: true
staffsuite.reports.notify: true
staffsuite.history: true
staffsuite.transactions: true
staffsuite.cmdhistory: true
staffsuite.miningstats: true
staffsuite.activity: true
staffsuite.staffmode: true
staffsuite.staffmode.builder: false
staffsuite.vanish: true
staffsuite.audit: true
staffsuite.logs: true
staffsuite.reload: true
staffsuite.notify: true
staffsuite.alerts: true
staffsuite.admin: false
staffsuite.bypass.xray: false
staffsuite.bypass.cps: false
staffsuite.bypass.afk: false
staffsuite.bypass.economy: false
? PlaceholderAPI
StaffSuite 提供 20 多个占位符,可用于记分板、标签页列表和插件。
| 占位符 |
返回值 |
示例 |
%staffsuite_staffmode_enabled% |
true / false |
true |
%staffsuite_staffmode_mode% |
spectator / adventure / creative |
spectator |
%staffsuite_vanished% |
true / false |
false |
%staffsuite_frozen% |
true / false |
false |
%staffsuite_punishments_total% |
当前生效的惩罚总数 |
5 |
%staffsuite_punishments_bans% |
当前封禁数 |
2 |
%staffsuite_punishments_mutes% |
当前禁言数 |
1 |
%staffsuite_punishments_warns% |
当前警告数 |
1 |
%staffsuite_punishments_kicks% |
总踢出次数 |
3 |
%staffsuite_staff_online% |
在线管理员数量 |
4 |
%staffsuite_reports_open% |
未处理的举报工单数 |
2 |
%staffsuite_frozen_count% |
当前被冻结的玩家数 |
0 |
%staffsuite_total_playtime% |
总游戏时长(分钟) |
12543 |
%staffsuite_risk_score% |
风险评分 |
12 |
%staffsuite_staffmode_count% |
处于管理员模式的玩家数 |
3 |
%staffsuite_server_name% |
配置文件中的服务器名称 |
lobby |
%staffsuite_warns_<player>% |
特定玩家的警告数 |
0 |
%staffsuite_transactions_last24h% |
交易量(过去 24 小时) |
5 |
%staffsuite_transactions_volume% |
净交易额 |
1,250.50 |
%staffsuite_commands_last24h% |
执行的命令数(过去 24 小时) |
142 |
%staffsuite_mining_diamonds_last24h% |
挖掘钻石数(过去 24 小时) |
3 |
%staffsuite_mining_total_last24h% |
挖掘方块总数(过去 24 小时) |
478 |
%staffsuite_activity_score_last24h% |
活跃度积分(过去 24 小时) |
86 |
动态玩家专属占位符:
%staffsuite_warns_Steve%
%staffsuite_transactions_last24h_Steve%
%staffsuite_mining_diamonds_last24h_Steve%
? Discord 集成
Webhook 设置
- 在您的 Discord 服务器设置中创建 Webhook
- 将 URL 粘贴到
config.yml 的 webhooks: 部分下
- 根据需要启用
log-<feature> 开关
webhooks:
punishments: "https://discord.com/api/webhooks/..."
reports: "https://discord.com/api/webhooks/..."
security: "https://discord.com/api/webhooks/..."
staff-chat: "https://discord.com/api/webhooks/..."
DiscordSRV Bridge
如果安装了 DiscordSRV,通过 /staffchat 发送的管理员聊天消息将自动转发到配置的 Discord 频道。
? Database Setup
SQLite (Default)
无需配置。数据库文件:plugins/StaffSuite/database.db
优点: 简单,零配置,适合单服务器设置。
缺点: 不建议用于多服务器网络。
MySQL / MariaDB
database:
type: "mysql"
mysql:
host: "localhost"
port: 3306
database: "staffsuite"
username: "staffsuite_user"
password: "secure_password"
创建数据库:
CREATE DATABASE staffsuite CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
GRANT ALL PRIVILEGES ON staffsuite.* TO 'staffsuite_user'@'localhost' IDENTIFIED BY 'secure_password';
FLUSH PRIVILEGES;
连接池 (HikariCP):
- 最大连接数: 10
- 最小空闲连接数: 2
- 连接超时: 5秒
- 空闲超时: 5分钟
- 最大生命周期: 10分钟
? Redis (Network)
多服务器设置(BungeeCord / Velocity 代理)必需。
Configuration
redis:
enabled: true
host: "localhost"
port: 6379
password: "" # if set
Channels
staffsuite:bridge – 管理员聊天、封禁、隐身的主要频道
- 额外的发布/订阅用于实时同步
Proxy Setup
- 在所有服务器上安装 StaffSuite(大厅、生存、KitPvP 等)
- 在每个服务器上启用 Redis,使用相同的主机/端口
- 在 config.yml 中设置
server-name 以区分每个服务器
- 重启所有服务器
注意: 数据存储在 MySQL 中(如果不使用网络数据库,则每台服务器单独使用 SQLite)。对于真正的跨网络数据,请配置所有服务器均可访问的 MySQL 主机。
?️ GUI Overview
Main Menu (/staff)
┌─────────────────────────────────────┐
│ ?️ Staff Control Panel │
├─────────────────────────────────────┤
│ ? Online Players │
│ ⚖️ Active Punishments │
│ ? Reports │
│ ? History │
│ ?️ Staff Mode Toggle │
│ ❄️ Freeze Manager │
│ ? Security Center │
│ ? Analytics │
│ ? Notes │
│ ? Staff Chat │
│ ⚙️ Settings │
└─────────────────────────────────────┘
Player Action GUI
点击玩家 → 操作菜单按钮:
| Slot |
Button |
Action |
| 10 |
? Ban |
打开封禁原因对话框 |
| 11 |
⚫ IP-Ban |
IP封禁并附带原因 |
| 12 |
? Kick |
踢出并附带原因 |
| 13 |
? Mute |
静音时长选择器 |
| 14 |
⚠️ Warn |
发送警告 |
| 15 |
❄️ Freeze / Unfreeze |
切换冻结状态 |
| 16 |
? Inspect |
查看物品栏和统计信息 |
| 20 |
? Transactions |
查看经济历史记录 |
| 21 |
? Notes |
管理备注 |
| 22 |
? History |
完整历史记录视图 |
| 24 |
⌨️ Cmd History |
命令日志 |
| 30 |
⛏️ Mining Stats |
方块挖掘数据 |
| 31 |
? Activity |
活动指标 |
| 23 |
? Close |
退出 GUI |
History GUI
带有筛选按钮的组合时间线视图:
- ALL – 显示所有条目
- PUNISHMENT – 封禁、静音、警告
- REPORT – 举报工单
- NOTE – 管理员备注
- ACTION – 审计日志
条目按时间戳排序,分页显示(每页 36 条)。
Reports GUI
开放工单列表,带有颜色编码:
- ? Open – 白色纸张图标
- ? Claimed – 黄色纸张图标
- ? Resolved – 红色屏障图标
点击认领/解决并与举报者开启私密聊天。
? Security Features
X-Ray Detection
security:
xray:
enabled: true
ore_threshold: 15 # Ores in 60 seconds triggers
time_window_seconds: 60
tracked_ores:
- DIAMOND_ORE
- DEEPSLATE_DIAMOND_ORE
- EMERALD_ORE
- DEEPSLATE_EMERALD_ORE
- ANCIENT_DEBRIS
警报格式:
[XRAY ALERT] Player found 15 DIAMOND_ORE in 58s [Click to TP]
在控制台或游戏内(如果使用现代客户端)点击消息以传送至嫌疑人。
CPS Detection
cps:
enabled: true
window_seconds: 5
max_cps: 18
min_clicks: 25
当玩家在 5 秒窗口内点击次数 >18 CPS 且至少 25 次点击时触发。
AFK Watchdog
afk:
enabled: true
idle_threshold_seconds: 300 # 5 minutes
超过 5 分钟未移动的玩家将被标记。使用 /alerts 切换警报。
Economy Monitor
economy:
enabled: true
absolute_threshold: 250000 # $250k in short time
multiplier: 4.0 # 4x normal gain
check_interval_seconds: 45
shopgui_plus:
enabled: false
threshold: 150000
通过 Vault 或 ShopGUI+ 检测可疑余额激增。
? Feature Deep Dive
Transaction History
追踪内容:
- 通过 Vault 进行的每次存款/取款
- 商店购买/销售(ShopGUI+)
/pay 命令(EssentialsX)
- 来自
/economyaudit 的余额快照
Database Table: transactions
| Column |
Type |
Description |
id |
INT |
Auto-increment PK |
player_uuid |
VARCHAR(36) |
Player UUID |
player_name |
VARCHAR(36) |
Player name at time |
amount |
DOUBLE |
+/- amount |
balance_after |
DOUBLE |
Balance after transaction |
type |
VARCHAR(16) |
DEPOSIT, WITHDRAWAL, PURCHASE, SALE, TRANSFER, OTHER |
source |
VARCHAR(64) |
VAULT, SHOPGUI_PLUS, /pay, BALANCE_AUDIT |
target_uuid |
VARCHAR(36) |
For transfers |
timestamp |
BIGINT |
Epoch millis |
GUI Features:
- 分页列表(每页 36 条)
- 按类型着色(绿色 = 收入,红色 = 支出)
- 显示累计余额
- 通过配置保留期进行日期范围筛选
Command History
记录内容:
- 玩家执行的所有命令(支持配置排除项)
- 命令名称、原始参数、时间戳
- 结果状态(通过 Bukkit 的命令处理机制捕获)
数据库表: command_logs
| 列名 |
类型 |
描述 |
id |
INT |
主键 (PK) |
player_uuid |
VARCHAR(36) |
|
player_name |
VARCHAR(36) |
|
command |
VARCHAR(256) |
不含斜杠的命令名 |
args |
TEXT |
以空格分隔的参数 |
result |
VARCHAR(32) |
SUCCESS, DENIED_PERMISSION, ERROR, CANCELLED, SYNTAX_ERROR |
timestamp |
BIGINT |
|
GUI 功能:
- 列出所有命令并显示带颜色的结果
- 按玩家筛选
- 命令数量分析
挖矿统计
记录内容:
- 每次方块破坏(可配置)
- 使用的工具(如 diamond_pickaxe, netherite_pickaxe 等)
- 工具耐久损耗值(如果可用)
- 附魔(Fortune, Silk Touch, Efficiency – 可选 JSON 格式)
- 世界类型(NORMAL, NETHER, END)
- 每日聚合数据
数据库表: mining_stats
| 列名 |
类型 |
描述 |
id |
INT |
主键 (PK) |
player_uuid |
VARCHAR(36) |
|
material |
VARCHAR(64) |
方块材料名称 |
count |
INT |
挖掘数量 |
tool_type |
VARCHAR(32) |
使用的工具 |
tool_damage |
INT |
当前耐久损耗 |
enchantments |
TEXT |
JSON 对象(可选) |
world_type |
VARCHAR(32) |
NORMAL/NETHER/END |
date |
DATE |
YYYY-MM-DD |
last_updated |
BIGINT |
上次更新的时间戳 |
示例查询:
SELECT material, SUM(count) as total
FROM mining_stats
WHERE player_uuid = '...' AND last_updated > ?
GROUP BY material ORDER BY total DESC;
GUI 功能:
- 显示带有图标的材料
- 每种方块的总数量
- 过去 24 小时摘要
- 特定矿石的顶级矿工排行榜
活动指标
记录的活动:
| 类型 |
触发器 |
详情 JSON |
| BLOCK_BREAK |
BlockBreakEvent |
{"block":"DIAMOND_ORE"} |
| ENTITY_KILL |
EntityDeathEvent (非 PvP) |
{"entity":"ZOMBIE"} |
| CHAT |
AsyncPlayerChatEvent |
– |
| COMMAND |
PlayerCommandPreprocessEvent |
– |
| DEATH |
PlayerDeathEvent |
– |
| TELEPORT |
PlayerTeleportEvent |
{"cause":"NETHER_PORTAL"} |
| PVP_KILL |
EntityDeathEvent (玩家对玩家) |
{"target":"Steve"} |
| PV_DEATH |
PvP 死亡 |
{"killer":"Alex"} |
| ITEM_PICKUP |
PlayerItemPickupEvent |
{"item":"DIAMOND","amount":3} |
| ITEM_DROP |
PlayerDropItemEvent |
{"item":"DIRT","amount":1} |
| CRAFT |
InventoryClickEvent (CRAFT 动作) |
{"item":"STONE_PICKAXE"} |
| FISH |
PlayerFishEvent (CAUGHT_FISH) |
{"caught":"COD"} |
| INTERACT |
PlayerInteractEvent (限流 2 秒) |
– |
| RESPAWN |
PlayerRespawnEvent |
– |
| LEVEL_CHANGE |
PlayerLevelChangeEvent |
{"old":5,"new":6} |
数据库表: activity_metrics
| 列名 |
类型 |
描述 |
id |
INT |
主键 (PK) |
player_uuid |
VARCHAR(36) |
|
session_id |
VARCHAR(36) |
游戏会话 UUID |
activity_type |
VARCHAR(32) |
ActivityType 枚举 |
details |
TEXT |
可选的 JSON 负载 |
count |
INT |
通常每条记录为 1 |
timestamp |
BIGINT |
|
GUI 功能:
- 时间线视图(最新优先)
- 按活动类型着色
- 可展开的详情(lore 中的 JSON)
- 24 小时摘要,按类型统计总数
? 支持
如需帮助、提交 Bug 报告或功能请求,请加入我们的 Discord 服务器。
Discord:
我们的支持团队将协助您解决任何问题。
? 致谢
BitRift.de Staff team – 开发与维护
由 BitRift.de Staff team 用 ☕ 制作
?️ StaffSuite
The ultimate staff moderation suite for modern Minecraft servers
? Table of Contents
✨ Features
? Core Moderation
- GUI-Driven Moderation – Intuitive click-based interfaces for all actions
- Override Vanilla Commands – Seamless integration with
/ban, /kick, /mute, etc.
- Punishment Ladder – Automated escalating punishments (Hacking, Griefing, Scamming)
- Silent Integration – Works alongside LiteBans & AdvancedBan
- Historical Tracking – Complete audit logs for every action
- Cross-Network Sync – Redis-powered real-time data across all servers
? Staff Utilities
- Staff Mode – Toggle with inventory/gamemode/position save
- Spectator / Adventure / Creative modes
- Auto-vanish option
- Customizable tools: Compass, Punishment Book, Player Selector, Freeze Ice, Breadcrumb, Menu Chest
- Vanish System – Complete invisibility with visible levels
- Freeze System – Immobilize suspicious players with private chat
- Target Selection – Click, look, or GUI select with particle glow
- Internal Notes – Categories: WARNING, INFO, FOLLOWUP, PRAISE
? Advanced Analytics
? Transaction History
- Track all economy events (deposits, withdrawals, purchases, sales, transfers)
- Source tracking (Vault, ShopGUI+, commands)
- Balance snapshots and net flow calculations
- 24-hour volume summaries
? Command History
- Complete log of every command executed
- Configurable exclusions (staff commands filterable)
- Result tracking: SUCCESS, DENIED, ERROR, CANCELLED
- Top commands analytics
⛏️ Mining Statistics
- Block break tracking with tool type and damage
- Enchantment capture (Fortune, Silk Touch, Efficiency)
- World/environment classification
- Daily aggregates and material breakdowns
- Real-time diamond/emerald/ancient debris counts
- Top miners leaderboard
? Activity Metrics
- Block breaks & entity kills
- Chat messages & command executions
- Deaths & teleports
- Item pickup & drop events
- Crafting & fishing
- Level changes & respawns
- PvP kills & deaths
- Heatmap-style timeline view
? Security Addon
- X-Ray Detection – Configurable ore thresholds, click-to-teleport alerts
- CPS Detection – Auto-clicker detection (18 CPS limit)
- AFK Watchdog – 5-minute idle detection
- Economy Monitoring – Suspicious balance spikes (250k threshold, 4x multiplier)
- ShopGUI+ Hook – Transaction validation for shops
- Dispatch Scan – One-click sweep for illegal items
- Quickcraft Safeguard – Prevents shift‑click crafting duplication exploits on Java & Bedrock. Fully toggleable.
? Reporting System
- Player Reports –
/report <player> <reason> creates ticket
- Staff GUI – Claim/resolve with chat session
- Real-time Notifications – In-game + Discord webhook
- Status Tracking – OPEN, CLAIMED, RESOLVED
? Network Features
- Staff Chat Bridge –
/staffchat across all servers (BungeeCord/Velocity)
- Cross-Server Find –
/staff connect <player> locates and teleports
- Network Staff List – See all online staff globally
- MySQL/Redis Sync – Shared data via proxy bridge
?️ Discord Integration
Multiple webhook routes (individually toggleable):
default – Main log
staff-chat – Staff messages
punishments – Ban/mute/kick events
teleports – Staff teleports
alerts – Security notifications
security – XRay/CPS/AFK alerts
reports – New tickets
analytics – Session data
staff-mode – Enter/exit events
Avatar URL templating: https://mc-heads.net/avatar/{uuid}
? Configuration
All features granularly configurable:
- Database type (SQLite/MySQL)
- Redis connection settings
- Vanish mode (internal/Essentials)
- Staff mode items & slots
- Freeze timeout & chat prefix
- Punishment thresholds & auto-punishment
- Security detector parameters
- Webhook routing
- Session analytics caps
- GUI titles & lore
- Language system (lang.yml)
- Geyser/Floodgate compatibility
- ItemsAdder support
- Quickcraft Safeguard options (enabled, bypass permission)
? Dependencies
Required (Shaded)
| Library |
Version |
Purpose |
| HikariCP |
5.1.0 |
Database connection pooling |
| Jedis |
5.1.3 |
Redis client |
| Kyori Adventure |
4.17.0+ |
Modern text components |
| Adventure Platform Bukkit |
4.3.3 |
Bukkit integration |
Optional (Provided)
| Plugin |
Purpose |
Integration |
| PlaceholderAPI |
Placeholders for scoreboards/tab lists |
16+ expansions |
| DiscordSRV |
Discord chat bridge |
Staff chat forwarding |
| Vault |
Economy abstraction |
Transaction tracking |
| ShopGUI+ |
Shop economy integration |
Balance monitoring |
| LiteBans |
Ban synchronisation |
Silent sync mode |
| AdvancedBan |
Alternative ban system |
Silent sync mode |
| EssentialsX |
Vanish fallback |
Internal/Essentials modes |
⚙️ Requirements
| Component |
Version |
| Minecraft Server |
Paper 1.21.11 (or fork) |
| Java Runtime |
Java 21 (OpenJDK/Corretto) |
| Database |
SQLite (built-in) or MySQL 8.0+ / MariaDB 10.5+ |
| Redis (Network) |
Redis 7.0+ (optional) |
| Folia |
Supported (async task handling) |
? Installation
- Download the latest
StaffSuite-3.6.0.jar
- Place it in your server's
plugins/ folder
- Start your server
- Configure
plugins/StaffSuite/config.yml as needed
- Reload with
/staffsuite reload or restart
- Assign permissions to your staff groups
That's it. No additional setup required.
? Configuration
Main Config (config.yml)
# ============================================
# DATABASE
# ============================================
database:
type: "sqlite" # "sqlite" or "mysql"
mysql:
host: "localhost"
port: 3306
database: "staffsuite"
username: "root"
password: ""
# ============================================
# REDIS (Cross-server sync)
# ============================================
redis:
enabled: false
host: "localhost"
port: 6379
password: ""
# ============================================
# VANISH SETTINGS
# ============================================
vanish:
mode: "internal" # "internal" or "essentials"
levels:
enabled: false
default_level: 1
# ============================================
# STAFF MODE
# ============================================
staffmode:
save_inventory: true
save_flight: true
auto_vanish_on_staffmode: true
mode_style: "creative" # "spectator", "adventure", "creative"
items:
random_teleport_compass:
enabled: true
slot: 0
punishment_book:
enabled: true
slot: 1
player_selector:
enabled: true
slot: 2
staff_menu:
enabled: true
slot: 4
freeze_ice:
enabled: true
slot: 5
breadcrumb_tool:
enabled: true
slot: 7
exit_barrier:
enabled: true
slot: 8
# ============================================
# FREEZE SYSTEM
# ============================================
freeze:
prevent_commands: true
prevent_movement: true
freeze_chat_prefix: "<dark_red><bold>FROZEN</bold> <gray>»</gray>"
auto_unfreeze_seconds: 300
# ============================================
# PUNISHMENTS
# ============================================
punishments:
warn_threshold: 3
warn_auto_punishment: "mute 1h"
broadcast_punishments: true
ladders:
enabled: true
"Hacking/Cheating":
- "30d"
- "90d"
- "perm"
"Griefing/Theft":
- "7d"
- "30d"
- "perm"
"Scamming/Phishing":
- "14d"
- "90d"
- "perm"
integration:
litebans:
enabled: false
silent: true
advancedban:
enabled: false
silent: true
# ============================================
# REPORTS
# ============================================
reports:
discord_webhook_url: ""
notify_staff_ingame: true
# ============================================
# SNAPSHOTS
# ============================================
snapshots:
auto_snapshot_interval_minutes: 30
max_entries: 12
shulker_export: false
shulker_blacklisted_materials:
- "BARRIER"
- "COMMAND_BLOCK"
death_logs:
enabled: true
max_entries: 10
# ============================================
# SECURITY DETECTION
# ============================================
security:
xray:
enabled: true
ore_threshold: 15
time_window_seconds: 60
tracked_ores:
- DIAMOND_ORE
- DEEPSLATE_DIAMOND_ORE
- EMERALD_ORE
- DEEPSLATE_EMERALD_ORE
- ANCIENT_DEBRIS
cps:
enabled: true
window_seconds: 5
max_cps: 18
min_clicks: 25
afk:
enabled: true
idle_threshold_seconds: 300
economy:
enabled: true
absolute_threshold: 250000
multiplier: 4.0
check_interval_seconds: 45
shopgui_plus:
enabled: false
threshold: 150000
# ============================================
# WEBHOOKS
# ============================================
webhooks:
default: ""
staff-chat: ""
punishments: ""
teleports: ""
alerts: ""
security: ""
reports: ""
analytics: ""
staff-mode: ""
avatar_url: "https://mc-heads.net/avatar/{uuid}"
# ============================================
# SESSION ANALYTICS
# ============================================
session_analytics:
enabled: true
history_cap: 40
risk_profile: true
# ============================================
# GUI CUSTOMIZATION
# ============================================
gui:
enabled: true
titles:
staff_control: "<gradient:#5e9eff:#1e3a8a>Staff Control</gradient> <dark_gray>»</dark_gray> <white>Panel"
player_selector: "<green>Online Players"
reports: "<yellow>Reports"
history: "<aqua>History"
notes: "<aqua>Notes"
items:
lore_enabled: true
# ============================================
# TRACKING (New Features)
# ============================================
tracking:
transactions:
enabled: true
track_vault: true
track_shopgui_plus: true
track_commands: true
retention_days: 90
command_history:
enabled: true
track_all_commands: true
track_staff_commands: true
retention_days: 30
excluded_commands:
- "/staff"
- "/staffmode"
- "/vanish"
- "/mute"
- "/ban"
- "/kick"
- "/warn"
- "/freeze"
- "/unfreeze"
mining_stats:
enabled: true
track_block_breaks: true
track_tool_info: true
track_enchantments: false
retention_days: 90
auto_save_interval_minutes: 10
ores_only: false
activity_metrics:
enabled: true
track_block_breaks: true
track_entity_kills: true
track_chat: true
track_command_executions: true
track_deaths: true
track_teleports: true
track_item_pickup_drop: true
retention_days: 7
# ============================================
# COMPATIBILITY
# ============================================
compatibility:
geyser:
enabled: false
bedrock_prefix_stripping: true
itemsadder:
enabled: false
custom_items: false
? Commands & Permissions
Command Reference
| Command |
Permission |
Description |
Aliases |
/staff |
staffsuite.mod |
Open main staff GUI |
– |
/staffmode [mode] |
staffsuite.staffmode |
Toggle staff mode |
sm |
/vanish |
staffsuite.vanish |
Toggle vanish |
v |
/ban <player> [time] [reason] |
staffsuite.ban |
Ban a player |
– |
/ipban <player> [reason] |
staffsuite.ban |
IP ban a player |
– |
/kick <player> [reason] |
staffsuite.kick |
Kick a player |
– |
/mute <player> [time] [reason] |
staffsuite.mute |
Mute a player |
– |
/warn <player> [reason] |
staffsuite.warn |
Warn a player |
– |
/freeze <player> |
staffsuite.freeze |
Freeze/unfreeze a player |
– |
/unfreeze <player> |
staffsuite.freeze |
Unfreeze a player |
– |
/history <player> |
staffsuite.history |
View full player history |
– |
/transactions <player> |
staffsuite.transactions |
View transaction history |
– |
/cmdhistory <player> |
staffsuite.cmdhistory |
View command history |
– |
/miningstats <player> |
staffsuite.miningstats |
View mining statistics |
– |
/activity <player> |
staffsuite.activity |
View activity metrics |
– |
/report <player> <reason> |
staffsuite.reports |
Submit a report |
reports |
/reports |
staffsuite.reports |
Open reports GUI |
– |
/report claim <id> |
staffsuite.reports |
Claim a report |
– |
/report resolve <id> |
staffsuite.reports |
Resolve a report |
– |
/notes add <player> <note> |
staffsuite.mod |
Add note to player |
– |
/notes remove <id> |
staffsuite.mod |
Remove a note |
– |
/notes list <player> |
staffsuite.mod |
List player notes |
– |
/stafflogs [player] |
staffsuite.logs |
View raw staff action log |
– |
/audit <staff> |
staffsuite.audit |
View staff member's actions |
– |
/staffchat [message] |
staffsuite.mod |
Toggle staff chat channel |
sc |
/freezechat |
staffsuite.mod |
Toggle frozen chat access |
– |
/alerts |
staffsuite.alerts |
Toggle personal alerts |
– |
/breadcrumb |
staffsuite.staffmode |
Teleport to saved location |
– |
/sweep |
staffsuite.admin |
Scan & remove blacklisted items |
– |
/economyaudit <player> |
staffsuite.admin |
Check player balance |
– |
/shulkerexport <player> |
staffsuite.history |
Export snapshots to chest |
– |
/close |
staffsuite.mod |
Close report chat session |
– |
/staffsuite reload |
staffsuite.reload |
Reload configuration |
– |
/staffsuite license <key> |
op |
Activate license key |
– |
Permission Nodes
staffsuite.*:
description: "All StaffSuite permissions"
children:
staffsuite.mod: true
staffsuite.ban: true
staffsuite.mute: true
staffsuite.kick: true
staffsuite.warn: true
staffsuite.freeze: true
staffsuite.reports: true
staffsuite.reports.notify: true
staffsuite.history: true
staffsuite.transactions: true
staffsuite.cmdhistory: true
staffsuite.miningstats: true
staffsuite.activity: true
staffsuite.staffmode: true
staffsuite.staffmode.builder: false
staffsuite.vanish: true
staffsuite.audit: true
staffsuite.logs: true
staffsuite.reload: true
staffsuite.notify: true
staffsuite.alerts: true
staffsuite.admin: false
staffsuite.bypass.xray: false
staffsuite.bypass.cps: false
staffsuite.bypass.afk: false
staffsuite.bypass.economy: false
? PlaceholderAPI
StaffSuite provides 20+ placeholders for scoreboards, tab lists, and plugins.
| Placeholder |
Returns |
Example |
%staffsuite_staffmode_enabled% |
true / false |
true |
%staffsuite_staffmode_mode% |
spectator / adventure / creative |
spectator |
%staffsuite_vanished% |
true / false |
false |
%staffsuite_frozen% |
true / false |
false |
%staffsuite_punishments_total% |
Total active punishments |
5 |
%staffsuite_punishments_bans% |
Active bans |
2 |
%staffsuite_punishments_mutes% |
Active mutes |
1 |
%staffsuite_punishments_warns% |
Active warns |
1 |
%staffsuite_punishments_kicks% |
Total kicks |
3 |
%staffsuite_staff_online% |
Local staff count |
4 |
%staffsuite_reports_open% |
Open report tickets |
2 |
%staffsuite_frozen_count% |
Currently frozen players |
0 |
%staffsuite_total_playtime% |
Total minutes played |
12543 |
%staffsuite_risk_score% |
Risk profile score |
12 |
%staffsuite_staffmode_count% |
Players in staff mode |
3 |
%staffsuite_server_name% |
Server name from config |
lobby |
%staffsuite_warns_<player>% |
Specific player's warns |
0 |
%staffsuite_transactions_last24h% |
Transactions (24h) |
5 |
%staffsuite_transactions_volume% |
Net transaction volume |
1,250.50 |
%staffsuite_commands_last24h% |
Commands executed (24h) |
142 |
%staffsuite_mining_diamonds_last24h% |
Diamonds mined (24h) |
3 |
%staffsuite_mining_total_last24h% |
Total blocks mined (24h) |
478 |
%staffsuite_activity_score_last24h% |
Activity points (24h) |
86 |
Dynamic Player-Specific Placeholders:
%staffsuite_warns_Steve%
%staffsuite_transactions_last24h_Steve%
%staffsuite_mining_diamonds_last24h_Steve%
? Discord Integration
Webhook Setup
- Create webhooks in your Discord server settings
- Paste URLs into
config.yml under webhooks: section
- Enable
log-<feature> toggles as needed
webhooks:
punishments: "https://discord.com/api/webhooks/..."
reports: "https://discord.com/api/webhooks/..."
security: "https://discord.com/api/webhooks/..."
staff-chat: "https://discord.com/api/webhooks/..."
DiscordSRV Bridge
If DiscordSRV is installed, staff chat messages sent via /staffchat are automatically forwarded to a configured Discord channel.
? Database Setup
SQLite (Default)
No configuration needed. Database file: plugins/StaffSuite/database.db
Pros: Simple, zero configuration, good for single-server setups.
Cons: Not recommended for multi-server networks.
MySQL / MariaDB
database:
type: "mysql"
mysql:
host: "localhost"
port: 3306
database: "staffsuite"
username: "staffsuite_user"
password: "secure_password"
Create Database:
CREATE DATABASE staffsuite CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
GRANT ALL PRIVILEGES ON staffsuite.* TO 'staffsuite_user'@'localhost' IDENTIFIED BY 'secure_password';
FLUSH PRIVILEGES;
Connection Pool (HikariCP):
- Max Pool Size: 10
- Min Idle: 2
- Connection Timeout: 5s
- Idle Timeout: 5 min
- Max Lifetime: 10 min
? Redis (Network)
Required for multi-server setups (BungeeCord / Velocity proxy).
Configuration
redis:
enabled: true
host: "localhost"
port: 6379
password: "" # if set
Channels
staffsuite:bridge – Primary channel for staff chat, bans, vanishes
- Additional pub/sub used for real-time sync
Proxy Setup
- Install StaffSuite on all servers (lobby, survival, kitpvp, etc.)
- Enable Redis on each server with same host/port
- Set
server-name in config.yml to differentiate each server
- Restart all servers
Note: Data is stored in MySQL (or SQLite per-server if not using network DB). For true network-wide data, configure MySQL host accessible by all servers.
?️ GUI Overview
Main Menu (/staff)
┌─────────────────────────────────────┐
│ ?️ Staff Control Panel │
├─────────────────────────────────────┤
│ ? Online Players │
│ ⚖️ Active Punishments │
│ ? Reports │
│ ? History │
│ ?️ Staff Mode Toggle │
│ ❄️ Freeze Manager │
│ ? Security Center │
│ ? Analytics │
│ ? Notes │
│ ? Staff Chat │
│ ⚙️ Settings │
└─────────────────────────────────────┘
Player Action GUI
Click a player → Action menu with buttons:
| Slot |
Button |
Action |
| 10 |
? Ban |
Open ban reason dialog |
| 11 |
⚫ IP-Ban |
IP-ban with reason |
| 12 |
? Kick |
Kick with reason |
| 13 |
? Mute |
Mute duration selector |
| 14 |
⚠️ Warn |
Send warning |
| 15 |
❄️ Freeze / Unfreeze |
Toggle freeze |
| 16 |
? Inspect |
View inventory & stats |
| 20 |
? Transactions |
View economy history |
| 21 |
? Notes |
Manage notes |
| 22 |
? History |
Full history view |
| 24 |
⌨️ Cmd History |
Command log |
| 30 |
⛏️ Mining Stats |
Block mining data |
| 31 |
? Activity |
Activity metrics |
| 23 |
? Close |
Exit GUI |
History GUI
Combined timeline view with filter buttons:
- ALL – Show all entries
- PUNISHMENT – Bans, mutes, warns
- REPORT – Report tickets
- NOTE – Staff notes
- ACTION – Audit log
Entries sorted by timestamp, paginated (36 per page).
Reports GUI
List of open tickets with color coding:
- ? Open – White paper icon
- ? Claimed – Yellow paper icon
- ? Resolved – Red barrier icon
Click to claim/resolve and open private chat with reporter.
? Security Features
X-Ray Detection
security:
xray:
enabled: true
ore_threshold: 15 # Ores in 60 seconds triggers
time_window_seconds: 60
tracked_ores:
- DIAMOND_ORE
- DEEPSLATE_DIAMOND_ORE
- EMERALD_ORE
- DEEPSLATE_EMERALD_ORE
- ANCIENT_DEBRIS
Alert format:
[XRAY ALERT] Player found 15 DIAMOND_ORE in 58s [Click to TP]
Click the message in console or in-game (if using modern clients) to teleport to suspect.
CPS Detection
cps:
enabled: true
window_seconds: 5
max_cps: 18
min_clicks: 25
Triggers when a player clicks >18 CPS with at least 25 clicks in a 5-second window.
AFK Watchdog
afk:
enabled: true
idle_threshold_seconds: 300 # 5 minutes
Players not moving for 5 minutes are flagged. Toggle alerts with /alerts.
Economy Monitor
economy:
enabled: true
absolute_threshold: 250000 # $250k in short time
multiplier: 4.0 # 4x normal gain
check_interval_seconds: 45
shopgui_plus:
enabled: false
threshold: 150000
Detects suspicious balance spikes via Vault or ShopGUI+.
? Feature Deep Dive
Transaction History
What it tracks:
- Every deposit/withdrawal via Vault
- Shop purchases/sales (ShopGUI+)
/pay command (EssentialsX)
- Balance snapshots from
/economyaudit
Database Table: transactions
| Column |
Type |
Description |
id |
INT |
Auto-increment PK |
player_uuid |
VARCHAR(36) |
Player UUID |
player_name |
VARCHAR(36) |
Player name at time |
amount |
DOUBLE |
+/- amount |
balance_after |
DOUBLE |
Balance after transaction |
type |
VARCHAR(16) |
DEPOSIT, WITHDRAWAL, PURCHASE, SALE, TRANSFER, OTHER |
source |
VARCHAR(64) |
VAULT, SHOPGUI_PLUS, /pay, BALANCE_AUDIT |
target_uuid |
VARCHAR(36) |
For transfers |
timestamp |
BIGINT |
Epoch millis |
GUI Features:
- Paginated list (36 per page)
- Color-coded by type (green = credit, red = debit)
- Shows running balance
- Date range filtering via config retention
Command History
What it tracks:
- Every command executed by players (with configurable exclusions)
- Command name, raw args, timestamp
- Result status (captured via Bukkit's command handling)
Database Table: command_logs
| Column |
Type |
Description |
id |
INT |
PK |
player_uuid |
VARCHAR(36) |
|
player_name |
VARCHAR(36) |
|
command |
VARCHAR(256) |
Command without slash |
args |
TEXT |
Space-separated arguments |
result |
VARCHAR(32) |
SUCCESS, DENIED_PERMISSION, ERROR, CANCELLED, SYNTAX_ERROR |
timestamp |
BIGINT |
|
GUI Features:
- List all commands with colored results
- Filter by player
- Command count analytics
Mining Statistics
What it tracks:
- Every block break (configurable)
- Tool used (diamond_pickaxe, netherite_pickaxe, etc.)
- Tool damage value (if available)
- Enchantments (Fortune, Silk Touch, Efficiency – optional JSON)
- World type (NORMAL, NETHER, END)
- Daily aggregation
Database Table: mining_stats
| Column |
Type |
Description |
id |
INT |
PK |
player_uuid |
VARCHAR(36) |
|
material |
VARCHAR(64) |
Block material name |
count |
INT |
Quantity mined |
tool_type |
VARCHAR(32) |
Tool used |
tool_damage |
INT |
Current durability loss |
enchantments |
TEXT |
JSON object (optional) |
world_type |
VARCHAR(32) |
NORMAL/NETHER/END |
date |
DATE |
YYYY-MM-DD |
last_updated |
BIGINT |
Timestamp of last increment |
Example Query:
SELECT material, SUM(count) as total
FROM mining_stats
WHERE player_uuid = '...' AND last_updated > ?
GROUP BY material ORDER BY total DESC;
GUI Features:
- Shows material with icon
- Total count for each block type
- Last 24h summary
- Top miners leaderboard for specific ores
Activity Metrics
Tracked Activities:
| Type |
Trigger |
Details JSON |
| BLOCK_BREAK |
BlockBreakEvent |
{"block":"DIAMOND_ORE"} |
| ENTITY_KILL |
EntityDeathEvent (non-PvP) |
{"entity":"ZOMBIE"} |
| CHAT |
AsyncPlayerChatEvent |
– |
| COMMAND |
PlayerCommandPreprocessEvent |
– |
| DEATH |
PlayerDeathEvent |
– |
| TELEPORT |
PlayerTeleportEvent |
{"cause":"NETHER_PORTAL"} |
| PVP_KILL |
EntityDeathEvent (player vs player) |
{"target":"Steve"} |
| PV_DEATH |
PvP death |
{"killer":"Alex"} |
| ITEM_PICKUP |
PlayerItemPickupEvent |
{"item":"DIAMOND","amount":3} |
| ITEM_DROP |
PlayerDropItemEvent |
{"item":"DIRT","amount":1} |
| CRAFT |
InventoryClickEvent (CRAFT action) |
{"item":"STONE_PICKAXE"} |
| FISH |
PlayerFishEvent (CAUGHT_FISH) |
{"caught":"COD"} |
| INTERACT |
PlayerInteractEvent (throttled 2s) |
– |
| RESPAWN |
PlayerRespawnEvent |
– |
| LEVEL_CHANGE |
PlayerLevelChangeEvent |
{"old":5,"new":6} |
Database Table: activity_metrics
| Column |
Type |
Description |
id |
INT |
PK |
player_uuid |
VARCHAR(36) |
|
session_id |
VARCHAR(36) |
UUID of play session |
activity_type |
VARCHAR(32) |
ActivityType enum |
details |
TEXT |
Optional JSON payload |
count |
INT |
Usually 1 per record |
timestamp |
BIGINT |
|
GUI Features:
- Timeline view (most recent first)
- Color-coded by activity type
- Expandable details (JSON in lore)
- 24-hour summary with totals per type
? Support
For assistance, bug reports, or feature requests, please join our Discord server.
Discord:
Our support team will help you with any issues.
? Credits
BitRift.de Staff team – Development & Maintenance
Made with ☕ by the BitRift.de Staff team
评论 0
登录后参与评分
还没有评论,来抢沙发吧