StaffLens
A plugin that logs server staff actions. Folia Supported.
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 verifydetects 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
pluginsfolder. - Start the server.
- Edit
plugins/StaffLens/config.yml. - Run
/sl reloadif 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 verifyre-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