ModGUI

ModGUI is a staff moderation plugin for Paper servers that replaces chat commands with clean, click-through GUIs. Punish, investigate, and manage players, all without ever typing a command!

Features

• Punishment GUI: Open a fully configurable punishment menu on any player. Each punishment type, icon, command, and available durations are defined in config.yml, so ModGUI works alongside any punishment plugin (LiteBans, AdvancedBan, EssentialsX, and more)!

• Investigate GUI: Right-click any player with the staff compass to instantly open their investigation panel. View anticheat flags for the current session with violation counts, ping, TPS, and timestamps. Includes GrimAC integration out of the box.

• Player Reports: Players can submit reports via /report with optional severity levels. A configurable cooldown prevents spam.

• Staff Notes: Add notes against a player directly from the investigate GUI, logged to Discord.

• Discord Webhooks: Punishments, anticheat alerts, reports, and staff notes all log to Discord with rich embeds. Role pings supported per event type.

• Staff Compass: A special compass item that opens the investigate GUI on right-click. Can't be dropped or lost on death.

Commands

Command	Description	Permission
/punish <player>	Opens the punishment GUI	Any modgui.punish.* node
/investigate <player>	Opens the investigate GUI	modgui.investigate
/report <player> [severity] <reason>	Submit a report against a player	modgui.report
/modgui spyglass	Gives you the staff compass	modgui.spyglass
/modgui reload	Reloads config and messages	modgui.admin

Permissions

Permission	Description	Default
modgui.admin	Full access, includes all punish, investigate, notes, and spyglass permissions	OP
modgui.punish.*	All punishment types	false
modgui.punish.warn	Can warn players	false
modgui.punish.kick	Can kick players	false
modgui.punish.mute	Can mute players	false
modgui.punish.tempban	Can temporarily ban players	false
modgui.punish.ban	Can permanently ban players	false
modgui.investigate	Can open the investigate GUI	false
modgui.notes.add	Can add staff notes	false
modgui.spyglass	Can receive and use the staff compass	false
modgui.report	Can submit reports via /report	true
modgui.exempt	Cannot be punished, investigated, or reported through ModGUI	false

Configuration

All punishment types, durations, borders, messages, and webhook URLs are defined in config.yml. Full LuckPerms support with granular permission nodes per punishment type.