ModGUI
github.com
- Free plan
- Self-hosted
What ModGUI is
ModGUI is a free, self-hosted moderation plugin for Paper servers, with graphical tools for punishments, player investigations, staff notes, and reports. Administrators can configure punishment types, icons, permissions, console commands, and durations. Punishment actions run as console commands and can work with LiteBans, AdvancedBan, EssentialsX, and other punishment plugins. The investigation interface can show a player's anticheat flags for the current session through GrimAC; GrimAC is optional and required for that tracking. Players can submit reports with /report and optional severity levels, while staff notes can be logged to Discord. Webhooks can also send punishment logs, anticheat alerts, and reports, with optional role pings. A recovery compass opens the investigation interface when right-clicked. ModGUI requires Paper 1.21.11 or newer. Installation uses a plugin JAR, a server restart, configuration, and the /modgui reload command. It is MIT-licensed and listed as free.
Who it suits
ModGUI suits administrators of Paper servers who need configurable moderation tools and Discord logging. Anticheat flag tracking is for servers also using GrimAC.
Good to know, and what to watch
- Free under the MIT License.
- Punishment actions work with several listed plugins.
- Staff notes and moderation events can reach Discord.
- Players can submit reports with severity levels.
- Requires Paper 1.21.11 or newer.
- Anticheat flag tracking requires optional GrimAC.
- Installation requires a server restart and configuration.
Plans
Every plan and priceModGUI
Free plan
Getting started
- Open the ModGUI GitHub repository
- Place the ModGUI JAR in the server’s plugins folder
- Restart the Paper server
- Configure punishment, GUI, message, webhook, GrimAC, and report settings
- Run /modgui reload
Limits to check
The plugin requires Paper 1.21.11 or newer. Anticheat flag tracking requires the optional GrimAC integration.
The Club's review
ModGUI is a free Paper moderation plugin for server teams that want staff actions, player reports, and notes gathered into GUI-led workflows. Its main advantage is that punishments can be routed to an existing plugin; its anticheat investigation tools depend on GrimAC.
Overview
ModGUI gives staff interfaces for issuing punishments, investigating players, and recording notes, while players can submit reports with /report. Because punishment actions are dispatched as console commands, it can complement LiteBans, AdvancedBan, EssentialsX, or another punishment plugin rather than requiring a replacement backend. That makes it most useful as a staff-facing layer for a server with an established punishment system.
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 breadth of configuration supports tailored workflows, but staff teams need to make those choices before the interfaces match their process.
Key features
Punishments and investigations
The punishment GUI lets administrators configure types, icons, permissions, commands, and durations. This is a practical fit for teams with different staff permissions or command conventions. The investigation GUI shows a player's anticheat flags for the current session through GrimAC; ModGUI can run without GrimAC, but flag tracking cannot.
Notes, reports, and Discord
Staff can attach notes to players, and those notes can be logged to Discord. Players submit reports through /report, with severity levels available as an option. Discord webhooks can also send punishment logs, anticheat alerts, and reports, with optional role pings. This creates a shared record and notification path, though teams need to manage their own webhook configuration.
A recovery compass can open the investigation GUI on right-click, giving staff a direct in-game route to the player view. The README documents permissions across administration, punishment types, investigation, notes, spyglass use, reporting, and player exemptions, so access can be divided by role.
Pricing
ModGUI is free: the ModGUI plan costs nothing and is released under the MIT License. That license permits use, copying, modification, distribution, sublicensing, and sale without charge, and provides no warranty. There are no paid tiers described; the tradeoff is that server operators remain responsible for installation, configuration, and their moderation setup.
Platforms
ModGUI is self-hosted and requires Paper 1.21.11 or newer. Compatibility is listed for Minecraft Java Edition 1.21.11 on Paper. This is a narrow fit for operators already on that server platform and version range, not teams seeking a hosted moderation service or support for other server software.
Who it's for
Choose ModGUI if your staff moderate a Paper server, want a shared GUI workflow for punishments and investigation, and prefer to keep an existing command-based punishment plugin. It is also a sensible fit when Discord notifications and player notes are part of the team's process. Look elsewhere if your server does not meet the Paper requirement, or if anticheat flag tracking is essential and you do not use GrimAC.
Pros and cons
Pros
- Works alongside existing punishment tools: console-command actions can connect to LiteBans, AdvancedBan, EssentialsX, and other punishment plugins.
- Several moderation workflows converge: punishments, investigation, notes, and player reports have dedicated tools, with Discord webhooks covering event notifications.
- Role-aware configuration: administrators can define punishment permissions and other documented permission groups.
- Free and modifiable: the MIT License permits modification and redistribution as well as use.
Cons
- Paper version requirement: it requires Paper 1.21.11 or newer, limiting its fit to compatible servers.
- Investigation flags require another plugin: GrimAC is optional overall but necessary for anticheat flag tracking.
- Configuration is part of the work: punishment behavior, messages, webhooks, report cooldowns, and other settings need operator decisions.
Alternatives
For another free self-hosted moderation option, browse Minecraft Moderation Plugins.
- LibertyBans is worth considering when you want a free punishment plugin with API and self-hosted platforms and Java 17 support.
- Staff+ suits teams seeking a free self-hosted staff plugin compatible with Paper, Purpur, or Folia 1.20–1.21+ and Velocity 3.3.0+.
- Nimbus AntiCheat is a stronger fit when anticheat checks are central: its free plan lists 43 checks, per-check punishments, player reports, staff inspection tools, and Discord webhook notifications, with Paper 1.21.8 support.
- ExtraBan is another free self-hosted option for Paper or a fork, with Java 25+ required.
- Player Report is a narrower free self-hosted choice if the primary need is a Minecraft server reporting plugin for major version 1.21.
- ReportsGUI is a reporting-focused alternative for servers on native Minecraft 1.17, with up to 54 unhandled reports.
- BanManager is a free option when you want a tool spanning API, Linux, self-hosted, and web platforms.
- PunishBAN is another free self-hosted option.
Verdict
ModGUI is best for Paper server teams that want one staff interface for punishments, investigation, notes, and reports without replacing their current punishment backend. Its flexibility and no-cost MIT license are compelling; the version floor and GrimAC dependency for flag tracking are the main reasons to choose another tool.
The verdict
ModGUI brings punishment, investigation, notes, and reports into a Paper server interface. GrimAC is only necessary for anticheat flag tracking, and the plugin requires Paper 1.21.11 or newer.
Questions people ask
How much does ModGUI cost?
ModGUI is listed as free and uses the MIT License.
Which server platform does ModGUI support?
It is self-hosted and requires Paper 1.21.11 or newer, with compatibility listed for Minecraft Java Edition 1.21.11 on Paper.
Does ModGUI require GrimAC?
GrimAC is optional overall, but it is required to track and display anticheat flags for the current session.
Can ModGUI connect to Discord?
Yes. Discord webhooks can log punishments, anticheat alerts, player reports, and staff notes, with optional role pings.
What punishment plugins can it work with?
Punishment commands can work with LiteBans, AdvancedBan, EssentialsX, and other punishment plugins.
What the maker publishes
- Compatibility
- Modrinth lists compatibility with Minecraft Java Edition 1.21.11 on Paper. source
- Configuration
- The configuration defines punishment types, durations, GUI borders, messages, webhook URLs, GrimAC thresholds, ignored checks, and report cooldowns. source
- Configuration
- Punishment types, durations, borders, messages, permissions, and webhook URLs are defined in configuration files. source
- Discord integration
- Discord webhooks log punishments, anticheat alerts, player reports, and staff notes, with optional role pings. source
- Discord webhooks
- ModGUI can send punishment logs, anticheat alerts, player reports, and staff notes to Discord through webhooks. source
- Installation
- Installation consists of placing the ModGUI JAR in the server's plugins folder, restarting, configuring files, and running /modgui reload. source
- Investigation
- The investigate GUI displays a player's anticheat flags for the current session through GrimAC integration. source
- Investigation
- The investigate GUI displays a player's current-session anticheat flags through GrimAC integration. source
- License
- The software is released under the MIT License, which grants use, copying, modification, distribution, sublicensing, and sale free of charge, with no warranty. source
- License
- The project is released under the MIT license. source
- Permissions
- The README documents permissions for administration, punishment types, investigation, notes, spyglass use, reporting, and player exemptions. source
- Permissions
- ModGUI provides granular LuckPerms-compatible permission nodes for administration, punishment types, investigation, notes, reports, and the staff compass. source
- Player reports
- Players can submit reports with /report and optional severity levels. source
- Player reports
- Players can submit reports with /report and optional severity levels. source
- Punishment compatibility
- Punishment actions are dispatched as console commands and can work with LiteBans, AdvancedBan, EssentialsX, and other punishment plugins. source
- Punishment GUI
- The punishment GUI supports configurable punishment types, icons, permissions, console commands, and durations. source
- Punishment GUI
- The punishment interface supports configurable punishment types, icons, commands, and durations. source
- Punishment integrations
- Punishment actions are dispatched as console commands and can work with LiteBans, AdvancedBan, EssentialsX, and other punishment plugins. source
- Purpose
- ModGUI is a Paper moderation plugin providing GUI tools for punishing, investigating, and reporting players. source
- Purpose
- ModGUI is a Paper moderation plugin providing GUI tools for punishing, investigating, and reporting players. source
- Release
- The repository lists v1.0.0 as the first release of ModGUI, released on June 4, 2026. source
- Requirements
- The plugin requires Paper 1.21.11 or newer, while GrimAC is optional and required for anticheat flag tracking. source
- Requirements
- The plugin requires Paper 1.21.11 or newer, while GrimAC is optional and required for anticheat flag tracking. source
- Staff compass
- A recovery compass item opens the investigate GUI when right-clicked. source
Checked against the maker's pages on 1 Oct 2026.