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 rudetreats 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.seecan 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.ymlwith 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 mutesfrozen.yml— currently frozen playerswarnings.yml— warning historyconfig.yml— reserved for future options
