StaffLens — 员工审计、日志记录与反滥用
StaffLens 是一款轻量但功能强大的 员工审计与反滥用插件,适用于 Paper、Spigot 和 Folia 服务器,支持 Minecraft 1.21 – 26.1。
它记录所有员工管理和操作行为,将其存储在 SQLite 或 MySQL 中,并让管理员在游戏中即时访问。除了被动的员工命令日志记录外,StaffLens 主动检测可疑行为并保护审计日志免受篡改——让您始终清楚了解员工的所作所为。
发现员工滥用行为,保留可验证的审计追踪,并在几秒钟内审查管理历史。
✨ 主要功能
- ? 员工操作日志记录至 SQLite 或 MySQL
- ? 完整上下文:每项操作的世界、坐标、执行者 IP 和服务器名称(非常适合网络/代理环境)
- ? 异常检测——标记员工滥用行为:自我授予 OP/权限/物品、大规模惩罚、重复检查背包、创造模式→给予物品
- ? 防篡改日志——SHA-256 哈希链 +
/sl verify 检测数据库中直接编辑或删除的条目
- ? Discord Webhook 警报:针对关键操作和异常情况
- ? 强大过滤器——
action:、time:、target:、staff:、flagged
- ? 按员工统计:使用
/sl stats
- ⌨️ Tab 补全:支持命令、玩家和过滤器
- ? 自定义命令跟踪——通过配置文件将任何插件的命令映射为操作,无需编写代码
- ? 导出历史记录为文本文件
- ? 游戏中通知:针对关键操作
- ♻️ 重新加载配置而无需重启服务器
? 集成
开箱即用,兼容最受欢迎的管理和管理员插件:
- Vanilla(命令解析器 + 自定义映射)
- LiteBans
- BanManager
- AdvancedBan
- EssentialsX
- CMI
- LuckPerms(准确的执行者归属)
- LibsDisguises(伪装 / 解除伪装)
- SuperVanish / PremiumVanish(隐身)
所有集成均可在配置文件中切换启用。
? 记录的操作
ban, unban, mute, unmute, kick, warn, grant/remove OP, permission & group changes, teleports, fly, god, vanish, disguise, socialspy, inventory & ender chest inspection, item giving, inventory clearing, heal, feed, repair, jail, unjail, nick, sudo, broadcast, lookup commands (seen, history), gamemode changes, and more — see ActionType for the full list.
⚙️ 要求
- Java 21
- Paper / Spigot / Folia 1.21.x – 26.1
? 安装
- 从 Modrinth 下载最新的 StaffLens JAR 文件。
- 将其放入您的
plugins 文件夹。
- 启动服务器。
- 编辑
plugins/StaffLens/config.yml。
- 如需,运行
/sl reload。
?️ 数据库
支持 SQLite(默认,零设置)和 MySQL。表、索引和列迁移会自动创建——从旧版本升级是安全的。
对于 MySQL,请在 config.yml 中设置 database.type: mysql 以及 database.mysql.* 的值。
? 命令
主命令:/stafflens(别名 /sl)
| 命令 |
描述 |
/sl log <player> [page] [filters] |
某位员工执行的操作 |
/sl who <player> [page] [filters] |
针对某个目标执行的操作 |
/sl search <text> [filters] |
搜索日志 |
/sl today [filters] |
今天执行的操作 |
/sl stats <player> [time:..] |
某位员工操作的摘要 |
/sl export <player> |
将历史记录导出为文件 |
/sl verify |
检查日志完整性(哈希链) |
/sl reload |
重新加载配置和集成 |
过滤器(可自由组合):action:BAN, time:7d, target:Steve, staff:Alex, flagged
示例:/sl log Alex action:op_give time:30d
? 权限
| 权限 |
描述 |
stafflens.use |
查看日志和统计数据 |
stafflens.export |
导出日志 |
stafflens.admin |
/sl reload 和 /sl verify |
stafflens.notify |
关键操作的通知 |
stafflens.alerts |
检测到异常的警报 |
所有权限默认为 OP。
?️ 异常检测与日志完整性
StaffLens 将原始日志转化为主动监督:
- 可疑操作会被标记,向拥有
stafflens.alerts 权限的员工广播,记录在案,并可选择发送至 Discord。
- 每个条目都通过 SHA-256 哈希链接。如果有人在数据库中进行了篡改,
/sl verify 会重新遍历哈希链并报告具体是哪个条目出了问题——非常适合可信审计。
? 本地化
locale 文件夹中的语言文件:en.yml, ru.yml, ua.yml。通过 locale 选项选择语言。
? 指标
StaffLens 使用 bStats 进行匿名使用统计。可在 config.yml 中设置 metrics: false 或在 plugins/bStats/config.yml 中全局禁用。
标签: staff logger, staff audit, anti-abuse, moderation logs, command logger, admin monitor, staff activity, audit trail, Paper, Folia
StaffLens — Staff Audit, Logging & Anti-Abuse
StaffLens is a lightweight yet powerful staff audit and anti-abuse plugin for Paper, Spigot and Folia servers, supporting Minecraft 1.21 – 26.1.
It logs every staff moderation and administration action, stores them in SQLite or MySQL, and gives admins instant access in-game. Beyond passive staff command logging, StaffLens actively detects suspicious behaviour and protects the audit log from tampering — so you always know exactly what your staff is doing.
Catch staff abuse, keep a verifiable audit trail, and review moderation history in seconds.
✨ Key Features
- ? Staff action logging to SQLite or MySQL
- ? Full context for every action: world, coordinates, executor IP, and server name (great for networks/proxies)
- ? Anomaly detection — flags staff abuse: self-granting OP/permissions/items, mass punishments, repeated inventory checks, creative→give
- ? Tamper-evident log — SHA-256 hash chain +
/sl verify detects entries edited or deleted directly in the database
- ? Discord webhook alerts for critical actions and anomalies
- ? Powerful filters —
action:, time:, target:, staff:, flagged
- ? Per-staff statistics with
/sl stats
- ⌨️ Tab completion for commands, players and filters
- ? Custom command tracking — map any plugin's commands to actions via config, no code needed
- ? Export history to a text file
- ? In-game notifications for critical actions
- ♻️ Reload configuration without restarting
? Integrations
Works out of the box with the most popular moderation and admin plugins:
- Vanilla (command parser + custom mapping)
- LiteBans
- BanManager
- AdvancedBan
- EssentialsX
- CMI
- LuckPerms (accurate executor attribution)
- LibsDisguises (disguise / undisguise)
- SuperVanish / PremiumVanish (vanish)
Every integration can be toggled in the config.
? Logged Actions
ban, unban, mute, unmute, kick, warn, grant/remove OP, permission & group changes, teleports, fly, god, vanish, disguise, socialspy, inventory & ender chest inspection, item giving, inventory clearing, heal, feed, repair, jail, unjail, nick, sudo, broadcast, lookup commands (seen, history), gamemode changes, and more — see ActionType for the full list.
⚙️ Requirements
- Java 21
- Paper / Spigot / Folia 1.21.x – 26.1
? Installation
- Download the latest StaffLens JAR from Modrinth.
- Drop it into your
plugins folder.
- Start the server.
- Edit
plugins/StaffLens/config.yml.
- Run
/sl reload if needed.
?️ Database
Supports SQLite (default, zero setup) and MySQL. Tables, indexes and column migrations are created automatically — upgrading from older versions is safe.
For MySQL, set database.type: mysql and the database.mysql.* values in config.yml.
? Commands
Main command: /stafflens (alias /sl)
| Command |
Description |
/sl log <player> [page] [filters] |
actions performed by a staff member |
/sl who <player> [page] [filters] |
actions performed against a target |
/sl search <text> [filters] |
search the log |
/sl today [filters] |
actions performed today |
/sl stats <player> [time:..] |
summary of a staff member's actions |
/sl export <player> |
export history to a file |
/sl verify |
check log integrity (hash chain) |
/sl reload |
reload configuration and integrations |
Filters (combine freely): action:BAN, time:7d, target:Steve, staff:Alex, flagged
Example: /sl log Alex action:op_give time:30d
? Permissions
| Permission |
Description |
stafflens.use |
view logs and statistics |
stafflens.export |
export logs |
stafflens.admin |
/sl reload and /sl verify |
stafflens.notify |
notifications for critical actions |
stafflens.alerts |
alerts for detected anomalies |
All permissions default to OP.
?️ Anomaly Detection & Log Integrity
StaffLens turns raw logs into active oversight:
- Suspicious actions are flagged, broadcast to staff with
stafflens.alerts, logged, and optionally sent to Discord.
- Every entry is chained with a SHA-256 hash.
/sl verify re-walks the chain and reports the exact entry if someone tampered with the database — perfect for trustworthy audits.
? Localization
Locale files in the locale folder: en.yml, ru.yml, ua.yml. Choose the language with the locale option.
? Metrics
StaffLens uses bStats for anonymous usage statistics. Opt out with metrics: false in config.yml or globally in plugins/bStats/config.yml.
Tags: staff logger, staff audit, anti-abuse, moderation logs, command logger, admin monitor, staff activity, audit trail, Paper, Folia
评论 0
登录后参与评分
还没有评论,来抢沙发吧