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