qSecuritySystem
Powerful all-in-one moderation plugin for Spigot/Paper 1.16.5 – 1.21.4.
qSecuritySystem provides a complete moderation workflow for real servers: punishments, player checks, reports GUI, audit logging, and optional Telegram alerts.
Why qSecuritySystem?
- Full moderation toolkit in one plugin
- Punishment history with filters and pagination
- Reports workflow with GUI actions (open / approve / reject)
- Persistent audit trail (
audit-log.jsonl) - Optional Telegram notifications for punishments, checks, and reports
- No required external plugins
Core Features
| Feature | Command | Permission |
|---|---|---|
| Ban player | /ban <player> [duration] [reason] [-s] |
qsecurity.ban |
| Mute player | /mute <player> [duration] [reason] [-s] |
qsecurity.mute |
| Kick player | /kick <player> [reason] [-s] |
qsecurity.kick |
| Unban player | /unban <player> [reason] |
qsecurity.unban |
| Unmute player | /unmute <player> [reason] |
qsecurity.unmute |
| IP ban | /ipban <ip|player> [reason] |
qsecurity.ipban |
| Unban IP | /unipban <ip> |
qsecurity.unipban |
| Punishment history | /hist <player> [BAN|MUTE|KICK|ALL] [page] |
qsecurity.history |
| Check ban info | /checkban <player> |
qsecurity.checkban |
| Check mute info | /checkmute <player> |
qsecurity.checkmute |
| AnyDesk check | /check <player> |
qsecurity.check |
| Confession flow | /check confession |
qsecurity.check |
| Spectate player | /spec <player> |
qsecurity.spec |
| Toggle vanish | /v |
qsecurity.vanish |
| Staff list | /stafflist |
qsecurity.stafflist |
| Reports GUI | /reports [open|closed] |
qsecurity.reports |
| Report player | /report <player> <reason> |
qsecurity.report |
| Help menu | /qhelp |
— |
| Reload config | /qsecurity reload |
qsecurity.reload |
Duration Format
/ban and /mute support:
s= secondsm= minutesh= hoursd= days- no suffix = days
Examples:
/ban Steve 30m Spam
/ban Steve 7d Cheats -s
/mute Alex 1h Flooding
/ban notch
AnyDesk Check System
The /check command starts a player verification flow. The checked player is restricted and receives instructions in chat.
Outcomes:
/check confession→ confession punishment- disconnect during check → disconnect punishment
- timeout → check ends cleanly
Audit Log
All moderation actions are written to:
plugins/qSecuritySystem/audit-log.jsonl
Telegram Notifications (Optional)
Telegram integration is configured in:
plugins/qSecuritySystem/telegram.yml
Default template config:
telegram:
enabled: false
bot-token: ""
chat-id: ""
send-check-events: true
parse-mode: "MarkdownV2" # MarkdownV2 | Markdown | HTML | none
messages:
audit: "🛡 *<action>*\n*Mod:* <moderator>\n*Target:* <target>\n<details_lines>"
check: "🕵 *<action>*\n*Mod:* <moderator>\n*Player:* <target>\n<note_line>"
report: "📨 *<action>*\n*Mod:* <moderator>\n*Reporter:* <reporter>\n*Player:* <reported>\n*Reason:* <reason>\n<note_line>"
Database
Supports both:
- SQLite (default)
- MySQL
database:
type: "sqlite" # sqlite | mysql
