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:
database:
type: "sqlite" # sqlite | mysql
Developer API
**qSecuritySystem** includes a powerful public API that allows other plugins and external systems to integrate with its core features.
You can:
Access punishments and player data
Work with reports and checks
Perform moderation actions
Build addons and custom integrations
Features:
The API is stable, well-structured, and designed for long-term compatibility.
Perfect for:
Plugin developers
Web panel integrations
Custom server systems
