Moderation

A custom Paper 1.21.11 moderation plugin (Java 21). Provides gamemode, vanish, mute, freeze, warning, and inventory-management tools for staff.

Commands

Command	Description	Permission
/gms [player]	Set gamemode to survival	moderation.gamemode
/gmc [player]	Set gamemode to creative	moderation.gamemode
/gmsp [player]	Set gamemode to spectator	moderation.gamemode
/vanish	Toggle invisibility to other players	moderation.vanish
/mute <player> [time] [reason]	Mute a player (timed or permanent)	moderation.mute
/unmute <player>	Remove a mute	moderation.mute
/freeze <player>	Lock a player in place	moderation.freeze
/unfreeze <player>	Release a frozen player	moderation.freeze
/warn <player> [reason]	Warn a player (tracks count)	moderation.warn
/warnings <player>	View a player's warning history	moderation.warn
/invsee <player> (alias /inventorysee)	Open an editable inventory GUI	moderation.invsee

All permissions default to op.

Features

Mutes

• Durations parse units s m h d w, combinable (e.g. 1d12h, 30m); permanent if no time given.
• Smart argument handling: /mute Steve being rude treats the whole tail as the reason when no valid duration is detected.
• Persists to mutes.yml, expires automatically, and survives restarts.
• Blocks chat and chat-style commands (/me, /msg, /tell, etc.). Works on offline players.

Vanish

• Hides you from other players via hidePlayer/showPlayer.
• Re-hides vanished players from anyone who joins while you're hidden.
• Staff with moderation.vanish.see can still see vanished players.

Freeze

• Persists to frozen.yml, so a frozen player who logs out comes back still frozen (no alt-F4 escape).
• Blocks movement, command usage, and all self-initiated teleports — including the chorus-fruit exploit (both the eating and the teleport are cancelled).
• Staff PLUGIN-cause teleports are still allowed so frozen players can be repositioned.

Warnings

• Persists to warnings.yml with reason, issuer, and timestamp.
• Reports a running warning count to both staff and the warned player.

InvSee

• 54-slot GUI showing main inventory, armor, and offhand.
• Items keep full durability, enchantments, and NBT (they are real ItemStacks).
• Fully editable: add, move, or remove items and changes write straight back to the player's live inventory.
• Filler slots and ambiguous shift-clicks are locked to prevent accidental item loss.
• Target must be online.

Technical notes

• Built with Gradle (wrapper pinned to 9.3.1); compiled against paper-api 1.21.11.
• Teleport-cause blocking matches enum names as strings rather than constants, so it stays robust across Paper SNAPSHOT builds that add or rename teleport causes.
• All commands provide tab completion for online player names.

Data files

Stored under plugins/Moderation/:

• mutes.yml — active mutes
• frozen.yml — currently frozen players
• warnings.yml — warning history
• config.yml — reserved for future options