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