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 = 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: "🛡 *<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