StaffLens

# 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. (https://img.shields.io/badge/Support%20StaffLens-Ko--fi-29C7FF?style=for-the-badge&logo=kofi&logoColor=white&labelColor=101826)](https://ko-fi.com/erotoro) --- ## ✨ 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 1. Download the latest **StaffLens** JAR from Modrinth. 2. Drop it into your `plugins` folder. 3. Start the server. 4. Edit `plugins/StaffLens/config.yml`. 5. 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> ` | actions performed by a staff member | | `/sl who <player> ` | actions performed against a target | | `/sl search <text> ` | search the log | | `/sl today ` | actions performed today | | `/sl stats <player> ` | 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 (https://bstats.org) for anonymous usage statistics. Opt out with `metrics: false` in `config.yml` or globally in `plugins/bStats/config.yml`. --- **Tags:** staff logger, staff audit,