Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

ModGUI

github.com

  • Free plan
  • Self-hosted
7.0 Club score Visit github.com

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.

ModGUI

Free

Free plan

Getting started

  1. Open the ModGUI GitHub repository
  2. Place the ModGUI JAR in the server’s plugins folder
  3. Restart the Paper server
  4. Configure punishment, GUI, message, webhook, GrimAC, and report settings
  5. 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.