# StaffLens<\/p>\n
**StaffLens** is a moderation audit plugin for **Paper 1.21** servers.<\/p>\n
The plugin records staff moderation and administration actions, stores them in **SQLite or MySQL**, and allows quick access through commands.
\nBoth built-in commands and supported plugin integrations are logged.<\/p>\n
—<\/p>\n
## Features<\/p>\n
* Log staff actions into a database
\n* View history by staff member
\n* View actions performed on a specific player
\n* Search through the moderation log
\n* View actions performed today
\n* Export history to a text file
\n* In-game notifications for critical actions
\n* Reload configuration without restarting the server<\/p>\n
—<\/p>\n
## Logged Actions<\/p>\n
The plugin can record:<\/p>\n
* ban, unban, mute, unmute, kick, warn
\n* giving and removing OP
\n* permission\/group changes
\n* teleports and staff movement
\n* fly, god, vanish, socialspy
\n* inventory and ender chest inspection
\n* giving items, clearing inventory, heal, feed, repair
\n* jail, unjail, nick, sudo, broadcast
\n* lookup commands such as `seen` and `history`
\n* gamemode changes<\/p>\n
The exact list of logged actions is defined in the code through **ActionType**.<\/p>\n
—<\/p>\n
## Supported Integrations<\/p>\n
* Vanilla
\n* LiteBans
\n* BanManager
\n* AdvancedBan
\n* Essentials
\n* CMI
\n* LuckPerms<\/p>\n
Each integration can be enabled or disabled in the configuration.<\/p>\n
—<\/p>\n
## Requirements<\/p>\n
* **Java 21**
\n* **Paper 1.21.x**<\/p>\n
—<\/p>\n
## Installation<\/p>\n
1. Build the plugin JAR.
\n2. Place it in the `plugins` folder.
\n3. Start the server.
\n4. Configure `plugins\/StaffLens\/config.yml`.
\n5. Run `\/sl reload` if needed.<\/p>\n
—<\/p>\n
## Database<\/p>\n
Supported databases:<\/p>\n
* **SQLite**
\n* **MySQL**<\/p>\n
SQLite is used by default.<\/p>\n
—<\/p>\n
### SQLite Setup<\/p>\n
No additional setup is required.
\nThe database will be automatically created in the plugin folder.<\/p>\n
—<\/p>\n
### MySQL Setup<\/p>\n
Configure the following values in `config.yml`:<\/p>\n
“`
\ndatabase.type: mysql
\ndatabase.mysql.host
\ndatabase.mysql.port
\ndatabase.mysql.database
\ndatabase.mysql.username
\ndatabase.mysql.password
\n“`<\/p>\n
The table and indexes are created automatically on startup.<\/p>\n
—<\/p>\n
## Commands<\/p>\n
Main command:<\/p>\n
“`
\n\/stafflens
\n\/sl
\n“`<\/p>\n
Subcommands:<\/p>\n
“` —<\/p>\n ## Permissions<\/p>\n “` Allows viewing logs.<\/p>\n “` Allows exporting logs.<\/p>\n “` Allows using `\/sl reload`.<\/p>\n “` Receive notifications about critical actions.<\/p>\n All permissions are granted to **OP** by default.<\/p>\n —<\/p>\n ## Configuration<\/p>\n File: `plugins\/StaffLens\/config.yml`<\/p>\n “` database: log: notify: integrations: —<\/p>\n ## Configuration Options<\/p>\n * **locale** \u2014 language used for messages —<\/p>\n ## Localization<\/p>\n Localization files are located in the `locale` folder:<\/p>\n * `en.yml` The language is selected using the `locale` setting in the configuration.<\/p>\n —<\/p>\n ## Export<\/p>\n The command<\/p>\n “` creates a text file in:<\/p>\n “` The file contains:<\/p>\n * generation time —<\/p>\n ## Notifications<\/p>\n If an action is listed in `notify.critical-actions`, players with the permission:<\/p>\n “` will receive an in-game notification.<\/p>\n —<\/p>\n ## Log Storage<\/p>\n When the plugin starts, it removes records older than `retention-days`.<\/p>\n Indexes are automatically created for **SQLite** and **MySQL** to improve query performance.<\/p>\n When the plugin reloads, it waits for the logging queue to finish before closing the database connection.<\/p>\n","protected":false},"excerpt":{"rendered":" A plugin that logs server staff actions. Folia Supported.<\/p>\n","protected":false},"featured_media":0,"template":"","meta":{"_minecraft_slug":"stafflens","_minecraft_project_id":"U42khYED","_minecraft_author":"denfry","_minecraft_license":"MIT","_minecraft_downloads":5,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"stafflens.zip","_minecraft_size_bytes":18641822,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T12:37:08.135461Z","_minecraft_date_created":"2026-03-12T20:42:51.369655Z","_minecraft_date_modified":"2026-03-10T23:07:22.237115Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/stafflens","_minecraft_icon_attachment_id":0,"_minecraft_imported_at":"2026-06-08T21:04:57+00:00","_minecraft_import_hash":"0fad02f47b7c472bd6f025493f2cf66c","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[125,126,127,129,92],"mod_loader":[131,132,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-147876","mod","type-mod","status-publish","hentry","mod_category-folia","mod_category-management","mod_category-paper","mod_category-spigot","mod_category-utility","mod_loader-folia","mod_loader-paper","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n\/sl log
\n\/sl who
\n\/sl search
\n\/sl today [page] – view actions performed today
\n\/sl export
\n\/sl reload – reload configuration and integrations
\n“`<\/p>\n
\nstafflens.use
\n“`<\/p>\n
\nstafflens.export
\n“`<\/p>\n
\nstafflens.admin
\n“`<\/p>\n
\nstafflens.notify
\n“`<\/p>\n
\nlocale: en<\/p>\n
\n type: sqlite
\n mysql:
\n host: localhost
\n port: 3306
\n database: minecraft
\n username: root
\n password: “”<\/p>\n
\n retention-days: 90
\n page-size: 15<\/p>\n
\n critical-actions:
\n – OP_GIVE
\n – PERMISSION_ADD
\n – GROUP_ADD<\/p>\n
\n LiteBans: true
\n BanManager: true
\n AdvancedBan: true
\n Essentials: true
\n CMI: true
\n LuckPerms: true
\n Vanilla: true
\n“`<\/p>\n
\n* **database.type** \u2014 database type (`sqlite` or `mysql`)
\n* **log.retention-days** \u2014 how long logs are stored (in days)
\n* **log.page-size** \u2014 number of entries per page in commands
\n* **notify.critical-actions** \u2014 actions that trigger notifications
\n* **integrations.*** \u2014 enable or disable specific integrations<\/p>\n
\n* `ru.yml`
\n* `ua.yml`<\/p>\n
\n\/sl export
\nplugins\/StaffLens\/exports
\n“`<\/p>\n
\n* list of actions
\n* target player
\n* reason
\n* additional details<\/p>\n
\nstafflens.notify
\n“`<\/p>\n