MODGUARD

MODGUARD

Premium Moderation Core | PC Check | Spectate | Anti-Xray

MODGUARD is a full moderation suite with cinematic punish screens, a head-based GUI, and practical staff tooling for live investigations.

This version upgrades MODGUARD into a complete moderation and control package: punishments, PC check, spectate tools, and anti-xray protection in one plugin.

FEATURES

- Styled punishment messages for ban, mute, kick, and warn - Multi-theme system (`violet`, `cyan`, `ocean`, `red`, `orange`, `yellow`, `ember`, `lime`) - Tiny-text visual style for premium UI formatting - Head-based moderation GUI with one-click actions - Fast command flow for live staff operations

PUNISHMENT COMMANDS

- `/ban <player> <reason>` - `/tempban <player> <duration> <reason>` - `/unban <player>` - `/mute <player> <reason>` - `/tempmute <player> <duration> <reason>` - `/unmute <player>` - `/mgkick <player> <reason>` - `/warn <player> <reason>` - `/unwarn <player> <warnId>` - `/warns <player>` - `/jail <player> [duration] [reason]` - `/unjail <player>` - `/setjail` - `/clearchat` - `/chatmute [on|off|toggle]`

PC CHECK WORKFLOW

- `/pccheck <player> [seconds]` starts a timed PC check - Fullscreen title and actionbar timer shown every second - `/pcchat <player> <message>` sends direct staff to player message - Player messages during active PC check are routed to staff-only channel - `/pccancel <player>` ends active check

Auto Punish on Logout During PC Check

If a player disconnects during active PC check, MODGUARD applies: - `tempban 3d` - reason: `Left during active PC check`

All values are configurable in `config.yml`.

SPECTATE TOOLS

- `/spectate <player>` enters spectator mode on target - `/back` returns to saved location and original game mode

ANTI-XRAY

- Ore-ratio behavior detection in configurable time window - Temporary ore lock and mining fatigue on suspicious mining patterns - Anti-xray stays ON at all times - Runtime status: - `/antixray status`

ADMIN HAMMER TOOLS

- `/givetool [player] <ban|mute|warn|jail>` - Ban Hammer, Mute Hammer, Warn Hammer, Jail Hammer - Right-click target player to apply moderation action instantly

BEDROCK JAIL CAGE

- Jailed players are placed in a temporary bedrock cage - Cage blocks are restored exactly on unjail or jail timeout - Safe release with return teleport to previous location

MAIN GUI

Open with `/modguard`

Quick GUI actions include: - warn, mute, tempmute - kick, tempban, ban - jail, unjail, unban - pc check start - spectate target - theme selection

PERMISSIONS

- `modguard.*` - `modguard.ban` - `modguard.tempban` - `modguard.unban` - `modguard.mute` - `modguard.tempmute` - `modguard.unmute` - `modguard.kick` - `modguard.jail` - `modguard.unjail` - `modguard.setjail` - `modguard.clearchat` - `modguard.chatmute` - `modguard.chatmute.bypass` - `modguard.warn` - `modguard.unwarn` - `modguard.warns` - `modguard.gui` - `modguard.theme` - `modguard.pccheck` - `modguard.spectate` - `modguard.antixray` - `modguard.alerts` - `modguard.tools.give` - `modguard.tools.use`

COMPATIBILITY

- Minecraft `1.16.5` to `1.21.11` - `Paper`, `Spigot`, `Bukkit`, `Purpur`, `Folia`