ModGUI
ModGUI is a free, self-hosted moderation plugin for Paper servers, with graphical tools for player punishments, investigations, and reports.
What ModGUI is
ModGUI is a free, self-hosted moderation plugin for Paper servers, with graphical tools for player punishments, investigations, and reports. Administrators can configure punishment categories, icons, permissions, commands, and durations; actions run as console commands and can work with LiteBans, AdvancedBan, EssentialsX, and other punishment plugins. Its investigation screen can show a player's anticheat flags from the current session through optional GrimAC integration. Staff can attach notes to players, and players can file reports using /report, with optional severity levels. Discord webhooks can relay punishment activity, anticheat alerts, reports, and staff notes, including optional role pings. A recovery compass can open the investigation screen on right-click. ModGUI requires Paper 1.21.11 or newer; GrimAC is needed only for anticheat flag tracking. Configuration covers punishment settings, GUI borders, messages, webhook URLs, GrimAC settings, and report cooldowns. The MIT-licensed plugin is listed as free. Installation involves adding its JAR to the server plugins folder, restarting, configuring files, and running /modgui reload.
Good
- Configurable punishment types, icons, permissions, and durations
- Console-command punishments can work with several plugins
- Reports can include severity levels
- Discord webhooks cover moderation events and staff notes
Watch out
- Requires Paper 1.21.11 or newer
- GrimAC is required for anticheat flag tracking
- Self-hosted; installation requires server setup
Who it suits
ModGUI suits Paper server administrators who want GUI-based moderation, configurable punishments, reports, and staff notes. GrimAC is relevant for servers that want to track session anticheat flags.
Verdict
ModGUI brings punishment, investigation, and reporting workflows into a Paper server GUI, with configurable Discord logging. Its Paper version requirement and optional GrimAC dependency are worth checking against a server's setup.
Plans and prices
From ModGUI's own pricing page, checked 1 Oct 2026.
| Plan | Price | What it gives you |
|---|---|---|
| ModGUI | Free | MIT license · Paper 1.21.11 or newer |
The facts
Each one read from ModGUI's own pages, with the date it was checked.
What it does
- Compatibility
- Modrinth lists compatibility with Minecraft Java Edition 1.21.11 on Paper.checked 1 Oct 2026
- Configuration
- Punishment types, durations, borders, messages, permissions, and webhook URLs are defined in configuration files.checked 1 Oct 2026
- Discord integration
- Discord webhooks log punishments, anticheat alerts, player reports, and staff notes, with optional role pings.checked 1 Oct 2026
- Discord webhooks
- ModGUI can send punishment logs, anticheat alerts, player reports, and staff notes to Discord through webhooks.checked 30 Sep 2026
- Installation
- Installation consists of placing the ModGUI JAR in the server's plugins folder, restarting, configuring files, and running /modgui reload.checked 1 Oct 2026
- Investigation
- The investigate GUI displays a player's current-session anticheat flags through GrimAC integration.checked 1 Oct 2026
- License
- The project is released under the MIT license.checked 1 Oct 2026
- Permissions
- ModGUI provides granular LuckPerms-compatible permission nodes for administration, punishment types, investigation, notes, reports, and the staff compass.checked 1 Oct 2026
- Player reports
- Players can submit reports with /report and optional severity levels.checked 1 Oct 2026
- Punishment compatibility
- Punishment actions are dispatched as console commands and can work with LiteBans, AdvancedBan, EssentialsX, and other punishment plugins.checked 1 Oct 2026
- Punishment GUI
- The punishment interface supports configurable punishment types, icons, commands, and durations.checked 1 Oct 2026
- Punishment integrations
- Punishment actions are dispatched as console commands and can work with LiteBans, AdvancedBan, EssentialsX, and other punishment plugins.checked 30 Sep 2026
- Purpose
- ModGUI is a Paper moderation plugin providing GUI tools for punishing, investigating, and reporting players.checked 1 Oct 2026
- Release
- The repository lists v1.0.0 as the first release of ModGUI, released on June 4, 2026.checked 30 Sep 2026
- Requirements
- The plugin requires Paper 1.21.11 or newer, while GrimAC is optional and required for anticheat flag tracking.checked 1 Oct 2026
- Staff compass
- A recovery compass can open the investigate GUI when right-clicked.checked 1 Oct 2026
- Staff notes
- Staff can add notes against a player, with notes logged to Discord.checked 1 Oct 2026
- Support channel
- The project is hosted on a public GitHub repository whose page currently shows zero issues.checked 30 Sep 2026
The full review of ModGUI
ModGUI is a free Paper moderation plugin for server teams that want staff actions, investigations, reports, and notes in a GUI-led workflow. It is most compelling when a server already has a command-based punishment system and wants to add staff tools around it; servers on older Paper versions should look elsewhere.
Overview
ModGUI brings punishment and investigation tools to staff, while players can submit reports with /report. Punishment actions run as console commands, so administrators can connect them to LiteBans, AdvancedBan, EssentialsX, or other punishment plugins instead of replacing an existing backend. That makes ModGUI a useful staff interface for an established setup, rather than a standalone replacement for every moderation system.
Installation requires putting 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 controls is a strength for teams with defined workflows, but those teams need to configure the plugin to match them.
Key features
Punishment and investigation
The punishment GUI supports configurable types, icons, permissions, commands, and durations, giving administrators room to distinguish actions and access by staff role. Investigation displays a player's anticheat flags for the current session through GrimAC. GrimAC is optional for ModGUI overall, but required for flag tracking, so teams that do not run it should not choose the plugin expecting that investigation view.
Reports, notes, and Discord
Players can submit reports through /report, with optional severity levels. Staff can add notes to a player's record, and a recovery compass can open the investigate GUI on right-click. Discord webhooks can log punishments, anticheat alerts, reports, and staff notes, with optional role pings. This gives staff a way to follow several moderation events in Discord, though it depends on configuring webhooks and does not remove the need to manage moderation inside the server.
Pricing
ModGUI is free: the ModGUI 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 a cheaper plan.
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. This is a narrow fit for servers already on that platform and version; the requirement rules it out for older Paper installations. GrimAC is needed only for anticheat flag tracking.
Who it's for
ModGUI suits Paper server administrators who want configurable staff actions, player reports, notes, and Discord moderation logs while keeping an existing command-based punishment plugin. It is less suitable for teams that need anticheat flag tracking without GrimAC, or that cannot meet the Paper version requirement. The README documents permissions covering administration, punishment types, investigation, notes, spyglass use, reporting, and player exemptions, which helps teams assign access across those functions.
Pros and cons
- Pro: Console-command punishments can work with LiteBans, AdvancedBan, EssentialsX, and other punishment plugins, so ModGUI can complement an existing backend.
- Pro: Discord webhooks can log four kinds of moderation activity—punishments, anticheat alerts, reports, and staff notes—with optional role pings.
- Pro: The MIT License allows free use and modification, including distribution and sale.
- Con: Paper 1.21.11 or newer is required, excluding servers that have not moved to that version.
- Con: Anticheat flag tracking requires GrimAC, so that part of the investigation workflow is unavailable without it.
- Con: Configuration spans actions, durations, permissions, webhooks, and reporting controls; administrators need to set these deliberately before the workflow fits their team.
Alternatives
Minecraft Moderation Plugins is the category to browse when comparing moderation tools across the field.
- LibertyBans is another free option, with API and self-hosted platforms; consider it if those platform options matter more than ModGUI's Paper staff interface.
- Staff+ is free and supports Paper, Purpur, and Folia 1.20–1.21+, as well as Velocity 3.3.0+; pick it if broader server-platform compatibility is the priority.
- Nimbus AntiCheat is free and offers 43 checks, Paper 1.21.8 support, per-check punishments, reports, staff inspection tools, and Discord webhook notifications; choose it if those anti-cheat checks and earlier Paper support fit better.
- BanManager is a free, open-source option with API, Linux, self-hosted, and web platforms; consider it if that platform range is a better match.
- AdvancedSensitiveWords is a free self-hosted alternative.
- ChatSentinel is a free self-hosted alternative.
- PunishBAN is a free self-hosted alternative.
- ReducedX-Anti Cheat is a free self-hosted alternative.
Verdict
Choose ModGUI if your team runs Paper 1.21.11 or newer and wants configurable moderation interfaces and Discord logs alongside an existing punishment plugin. Its strongest reason to choose it is the combination of command-based punishments with reports, notes, and staff investigation tools; the main reason to look elsewhere is its version requirement, or the need for anticheat flags without GrimAC.
Getting started
- Use a Paper server running version 1.21.11 or newer
- Download the ModGUI JAR from https://github.com/eande171/modgui
- Place the JAR in the server's plugins folder
- Restart the server
- Edit punishment, report, permission, and webhook configuration files
- Run /modgui reload
Limits worth knowing
ModGUI requires Paper 1.21.11 or newer. GrimAC is optional overall but required to track anticheat flags in the investigation GUI.
Questions
How much does ModGUI cost?
It is free under the MIT License, with the listed plan listed as free.
Which Minecraft platform does it support?
ModGUI is a self-hosted plugin for Minecraft Java Edition 1.21.11 on Paper.
Is GrimAC required?
GrimAC is optional, but it is required for anticheat flag tracking in the investigation GUI.
Can it work with punishment plugins?
Punishments run as console commands and can work with LiteBans, AdvancedBan, EssentialsX, and other punishment plugins.
What can Discord webhooks log?
Webhooks can send punishment logs, anticheat alerts, player reports, and staff notes, with optional role pings.
How are reports submitted?
Players use /report and can include optional severity levels.
Alternatives to ModGUI
- 1

LibertyBans
Free planAPISelf-hosted6.2Free plan - 2
Staff+
Free planSelf-hosted6.2Free plan - 3

BanManager
WebAPILinuxSelf-hosted5.9 - 4

ExtraBan
Free planSelf-hosted5.6Free plan - 5
Player Report
Free planSelf-hosted5.6Free plan - 6
ReportsGUI
Free planSelf-hosted5.6Free plan
