ModGUI
github.com
What it is
ModGUI is a self-hosted moderation plugin for Paper servers, with graphical tools for player punishments, investigations, and reports. Server staff can configure punishment types, icons, permissions, console commands, and durations; punishment actions can work with LiteBans, AdvancedBan, EssentialsX, and other punishment plugins. Its investigate screen can display a player’s current-session anticheat flags through optional GrimAC integration. Staff can attach notes to players, and players can submit reports with /report and optional severity levels. Discord webhooks can send punishment logs, anticheat alerts, reports, and staff notes, with optional role pings. A recovery compass opens the investigate GUI when right-clicked. Configuration covers GUI borders, messages, webhook URLs, GrimAC thresholds, ignored checks, and report cooldowns. ModGUI requires Paper 1.21.11 or newer; GrimAC is needed for anticheat flag tracking. Installation involves adding the JAR to the server’s plugins folder, restarting, configuring files, and running /modgui reload. It is free under the MIT License.
Spec sheet
- Purpose
- ModGUI is a Paper moderation plugin providing GUI tools for punishing, investigating, and reporting players.Read 1 Oct 2026 · github.com
- License
- The project is released under the MIT license.Read 1 Oct 2026 · github.com
- Compatibility
- Modrinth lists compatibility with Minecraft Java Edition 1.21.11 on Paper.Read 1 Oct 2026 · modrinth.com
- Configuration
- Punishment types, durations, borders, messages, permissions, and webhook URLs are defined in configuration files.Read 1 Oct 2026 · github.com
- Discord integration
- Discord webhooks log punishments, anticheat alerts, player reports, and staff notes, with optional role pings.Read 1 Oct 2026 · github.com
- Discord webhooks
- ModGUI can send punishment logs, anticheat alerts, player reports, and staff notes to Discord through webhooks.Read 30 Sep 2026 · github.com
- Installation
- Installation consists of placing the ModGUI JAR in the server's plugins folder, restarting, configuring files, and running /modgui reload.Read 1 Oct 2026 · github.com
- Investigation
- The investigate GUI displays a player's current-session anticheat flags through GrimAC integration.Read 1 Oct 2026 · github.com
- Permissions
- ModGUI provides granular LuckPerms-compatible permission nodes for administration, punishment types, investigation, notes, reports, and the staff compass.Read 1 Oct 2026 · github.com
- Player reports
- Players can submit reports with /report and optional severity levels.Read 1 Oct 2026 · github.com
- Punishment compatibility
- Punishment actions are dispatched as console commands and can work with LiteBans, AdvancedBan, EssentialsX, and other punishment plugins.Read 1 Oct 2026 · github.com
- Punishment GUI
- The punishment interface supports configurable punishment types, icons, commands, and durations.Read 1 Oct 2026 · github.com
- Punishment integrations
- Punishment actions are dispatched as console commands and can work with LiteBans, AdvancedBan, EssentialsX, and other punishment plugins.Read 30 Sep 2026 · github.com
- Release
- The repository lists v1.0.0 as the first release of ModGUI, released on June 4, 2026.Read 30 Sep 2026 · github.com
- Requirements
- The plugin requires Paper 1.21.11 or newer, while GrimAC is optional and required for anticheat flag tracking.Read 1 Oct 2026 · github.com
- Staff compass
- A recovery compass can open the investigate GUI when right-clicked.Read 1 Oct 2026 · github.com
- Staff notes
- Staff can add notes against a player, with notes logged to Discord.Read 1 Oct 2026 · github.com
- Support channel
- The project is hosted on a public GitHub repository whose page currently shows zero issues.Read 30 Sep 2026 · github.com
Plans and prices
Strong points and limits
Strong points
- Configurable punishment types, icons, commands, and durations
- Punishments can work with several plugins
- Reports support optional severity levels
- Webhooks send moderation events to Discord
Limits
- Requires Paper 1.21.11 or newer
- GrimAC is required for anticheat flag tracking
Who it suits
ModGUI suits Paper server administrators who need configured moderation tools and Discord logging. Anticheat flag tracking requires GrimAC.
ModGUI in depth
Read the full write-up
ModGUI is a Paper server plugin for teams that want staff actions and player reports managed through in-game interfaces. It is best suited to servers with an existing punishment backend and staff who can configure their own workflows. The trade-off is a strict Paper version requirement, with GrimAC needed for anticheat flag tracking.
Overview
ModGUI brings configurable punishments, player investigation, staff notes, and player reports into a server-side GUI. It does not replace a punishment plugin: actions are dispatched as console commands and can work with LiteBans, AdvancedBan, EssentialsX, or other compatible punishment tools. That makes it a useful staff-facing layer for servers that already have a command-based system, rather than a standalone moderation backend.
Installation means placing the JAR in the server's plugins folder, restarting, configuring the files, and running /modgui reload. Administrators can set punishment types and durations, GUI borders, messages, webhook URLs, GrimAC thresholds and ignored checks, and report cooldowns. The range of controls is valuable for adapting the plugin to a server's process, but calls for deliberate setup.
Key features
Punishments and investigations
The punishment GUI supports configurable types, icons, permissions, commands, and durations. This gives teams room to distinguish staff roles and actions, while leaving the actual punishment execution to console commands and the configured backend. The investigation GUI displays a player's anticheat flags for the current session through GrimAC integration. GrimAC is optional for ModGUI as a whole, but required for this tracking, so teams without it should not choose the plugin for anticheat investigation.
Notes, reports, and Discord
Staff can attach notes to players, and players can submit reports with /report and optional severity levels. Discord webhooks can send punishments, anticheat alerts, reports, and staff notes to a shared channel, with optional role pings. This gives staff a way to follow several moderation events outside the game; the report cooldown and webhook behavior are among the settings administrators can configure.
A recovery compass can open the investigation GUI on right-click, providing a direct staff shortcut. The documented permissions cover administration, punishment types, investigation, notes, spyglass use, reporting, and player exemptions, supporting role-specific access rather than one undifferentiated staff permission.
Pricing
ModGUI is free: its plan costs nothing and is released under the MIT License. The license permits use, copying, modification, distribution, sublicensing, and sale free of charge, with no warranty. There are no paid tiers to weigh against the free plan; the main cost is configuring and maintaining a Paper server that meets the requirement.
Platforms
ModGUI is self-hosted and requires Paper 1.21.11 or newer. Modrinth lists compatibility with Minecraft Java Edition 1.21.11 on Paper. The version floor makes it a poor fit for servers that need to stay on older Paper releases or a different server platform.
Who it's for
Choose ModGUI if your team runs a qualifying Paper server, wants GUI-based staff workflows, and already uses—or is willing to configure—a punishment plugin that accepts console commands. It is especially relevant to teams that want player reports, staff notes, and Discord moderation logs alongside investigations. Look elsewhere if your server cannot meet the Paper version requirement or if you need anticheat flags without GrimAC.
Pros and cons
Works alongside common punishment backends: console-command dispatch can connect the GUI to LiteBans, AdvancedBan, EssentialsX, and other punishment plugins.
Several moderation events can reach Discord: webhooks cover punishments, anticheat alerts, player reports, and staff notes, with optional role pings.
Configurable staff access: documented permissions span the main moderation workflows, letting administrators separate capabilities.
Strict platform floor: Paper 1.21.11 or newer rules out servers that need older versions or another platform.
GrimAC required for flag tracking: the investigation GUI's anticheat view depends on that integration.
Alternatives
Minecraft Moderation Plugins is the broader category to browse if ModGUI's Paper requirement or GrimAC-dependent investigation does not fit.
Staff+ is another free, self-hosted option if broader server compatibility matters: it supports Paper, Purpur, and Folia 1.20–1.21+, as well as Velocity 3.3.0+.
LibertyBans is a free alternative for readers looking for a punishment system with API and self-hosted platforms; it requires Java 17 and supports Minecraft server platforms.
BanManager is a free, open-source alternative for readers who want a project that welcomes contributions, with API, Linux, self-hosted, and web platforms.
Nimbus AntiCheat is a free self-hosted option to consider when anticheat is the priority; it requires Paper 1.21.8, Java 21, and PacketEvents, and is for Java-edition players.
PunishBAN, AdvancedSensitiveWords, ChatSentinel, and ReducedX-Anti Cheat are also alternatives to compare.
Verdict
ModGUI is a strong fit for staff teams on Paper 1.21.11 or newer that want a configurable GUI over an existing punishment backend, plus reports, notes, and Discord logging at no charge. Its main reason to choose it is the breadth of those linked moderation workflows; its main reason to look elsewhere is the narrow platform requirement, with GrimAC an additional prerequisite for anticheat flags.
Verdict
ModGUI combines punishment, investigation, notes, and reporting tools in a server-side GUI. Its Paper version requirement and optional GrimAC dependency are important setup details.
Where Specifiction places it
- Minecraft Moderation Plugins#3 of 197.8