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 &amp;amp;lt;player&amp;amp;gt; [duration] [reason] [-s]`	`qsecurity.ban`
Mute player	`/mute &amp;amp;lt;player&amp;amp;gt; [duration] [reason] [-s]`	`qsecurity.mute`
Kick player	`/kick &amp;amp;lt;player&amp;amp;gt; [reason] [-s]`	`qsecurity.kick`
Unban player	`/unban &amp;amp;lt;player&amp;amp;gt; [reason]`	`qsecurity.unban`
Unmute player	`/unmute &amp;amp;lt;player&amp;amp;gt; [reason]`	`qsecurity.unmute`
IP ban	`/ipban &amp;amp;lt;ip\|player&amp;amp;gt; [reason]`	`qsecurity.ipban`
Unban IP	`/unipban &amp;amp;lt;ip&amp;amp;gt;`	`qsecurity.unipban`
Punishment history	`/hist &amp;amp;lt;player&amp;amp;gt; [BAN\|MUTE\|KICK\|ALL] [page]`	`qsecurity.history`
Check ban info	`/checkban &amp;amp;lt;player&amp;amp;gt;`	`qsecurity.checkban`
Check mute info	`/checkmute &amp;amp;lt;player&amp;amp;gt;`	`qsecurity.checkmute`
AnyDesk check	`/check &amp;amp;lt;player&amp;amp;gt;`	`qsecurity.check`
Confession flow	`/check confession`	`qsecurity.check`
Spectate player	`/spec &amp;amp;lt;player&amp;amp;gt;`	`qsecurity.spec`
Toggle vanish	`/v`	`qsecurity.vanish`
Staff list	`/stafflist`	`qsecurity.stafflist`
Reports GUI	`/reports [open\|closed]`	`qsecurity.reports`
Report player	`/report &amp;amp;lt;player&amp;amp;gt; &amp;amp;lt;reason&amp;amp;gt;`	`qsecurity.report`
Help menu	`/qhelp`	—
Reload config	`/qsecurity reload`	`qsecurity.reload`

Duration Format

/ban and /mute support:

s = seconds
m = minutes
h = hours
d = 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: "🛡 *&lt;action&gt;*\n*Mod:* &lt;moderator&gt;\n*Target:* &lt;target&gt;\n&lt;details_lines&gt;"
    check: "🕵 *&lt;action&gt;*\n*Mod:* &lt;moderator&gt;\n*Player:* &lt;target&gt;\n&lt;note_line&gt;"
    report: "📨 *&lt;action&gt;*\n*Mod:* &lt;moderator&gt;\n*Reporter:* &lt;reporter&gt;\n*Player:* &lt;reported&gt;\n*Reason:* &lt;reason&gt;\n&lt;note_line&gt;"

Database

Supports both:

SQLite (default)
MySQL

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