Space Moderation System

SpaceModeratorSystem is a full-featured moderation and administration plugin for Minecraft servers. Reports, punishments, anonymous cheat-checks, spectating, staff chat, and a fully customizable themed admin panel — all in one clean, gradient-styled package with bilingual support.

───────────────────────────────────

Features

📋 Report System

• Any player can report others via a GUI menu (/reports)
• Reports display reporter name, reason, and timestamp
• Staff receive instant notifications with sound and a clickable action bar button
• Resolve or reopen reports directly from the menu — no chat commands needed
• Configurable cooldown between reports from the same player

🔨 Punishment System

• Mute / Unmute — with reason, duration, and appeal prompt
• Ban / Unban — with reason, duration, and a formatted ban screen with appeal link
• Report-Mute — block a player from filing reports without muting them
• Kick — with a clean formatted kick screen showing reason and appeal
• All punishments support configurable durations (30m, 2h, 7d, permanent)
• Time suffixes work in both English and Russian

🔎 Anonymous Cheat Check

• /check <player> teleports them to a private check location
• Player is frozen — movement blocked, damage cancelled, food frozen, enderpearl disabled
• Auto-ban on disconnect during check — configurable duration
• Anonymous chat via /checkchat or /cc — the player never sees who is checking
• /check end to finish, /check setloc to set the location

👁️ Spectate Mode

• Teleport to a player and follow them invisibly
• Tab-list hidden — the checked player never sees the moderator
• Original location saved for a safe one-click exit

💬 Staff Chat

• /sc <message> — dedicated staff-only channel
• Toggle mode: enable once and all your messages go to staff chat
• Optional ping sound for incoming messages
• Gradient labels, plain-white player names

🖥️ Admin Menu (/adminmenu)

• Central dashboard with all tools in one place
• Punishment actions — ban, mute, kick, spectate, report-mute
• Check settings submenu — freeze behavior, auto-ban duration, appeal link
• Language switcher — Russian and English with one click
• Theme selector — 16 vanilla glass colors + custom HEX palette
• Tag editor — change the message prefix directly in-game
• All menus with gradient borders matching the active theme

🎨 Custom Theme

• Pick two HEX colors for your gradients and menu borders
• First click selects the glass color, Shift+Click opens HEX input via chat
• Glass panes automatically match the closest vanilla glass color using RGB distance
• Saved permanently — survives server restarts

📜 Punishment History

• /history <player> [page] — all past punishments for any player
• 8 entries per page with navigation arrows
• Automatic cleanup of records older than 90 days on server startup

🔊 Sound & Visual Feedback

• Every menu open, click, success, error, and alert has a matching sound
• New report notification — Ding sound + action bar message
• All sounds configurable or toggleable in config.yml

💾 Reliability

• All settings stored in config.yml, punishments in data.yml
• Works on Paper 1.21+ and Folia out of the box
• LuckPerms integration with ready-made group setup commands

---

Commands

Command	Description
/report <player> <reason>	Send a report
/reports [page]	Open the report menu
/spectate <player|off>	Invisible spectating
/check <player>	Start a cheat-check
/check end	End the check
/check setloc	Set the check location
/checkchat <message>	Anonymous chat with checked player
/mute <player> <time> [reason]	Mute
/unmute <player>	Unmute
/ban <player> <time|permanent> [reason]	Ban
/unban <player>	Unban
/reportmute <player> <time> [reason]	Block reports
/unreportmute <player>	Restore report access
/kick <player> [reason]	Kick
/sc <message>	Staff chat
/history <player> [page]	Punishment history
/adminmenu	Admin panel
/sms reload	Reload configs

---

Permissions (LuckPerms)

Node	Default	Description
sms.report	true	Use /report
sms.reports.view	op	View and moderate reports
sms.reports.notify	op	Receive new report notifications
sms.spectate	op	Spectate players silently
sms.staffchat	op	Staff chat
sms.history	op	View punishment history
sms.mute	op	Mute players
sms.unmute	op	Unmute players
sms.reportmute	op	Block reports
sms.unreportmute	op	Restore report access
sms.kick	op	Kick players
sms.check	op	Run cheat-checks
sms.check.setloc	op	Set check location
sms.ban	op	Ban players (limited duration)
sms.ban.permanent	op	Permanent bans
sms.admin.menu	op	Admin menu
sms.admin.reload	op	Reload plugin

Composite nodes:

• sms.moderator — all moderation permissions
• sms.admin — all permissions including admin-only