Logo
ModGUI
PluginMIT

ModGUI

GUI-based moderation tools for Paper servers. Punishment, investigation, and reporting with Discord webhook integration.

5
Downloads
1
Followers
3 weeks ago
Updated
📦
1
Versions
managementsocialutilitypaper
Download Latestv1.0.0View on Modrinth

📖About ModGUI

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.