All versions
1.0
Release
ModerationGUI 1.03 months ago 27
Compatibility
Minecraft: Java Edition
1.21.x
Platforms
Paper
Purpur
Changes
๐ Changelog
[1.0] โ 2026-07-26
๐ Bug Fixes
- Fixed an issue where
/warnwould show a success message but the warning was never actually saved. The punishment was being marked as instantly expired due to aduration = 0miscalculation. Warnings are now stored permanently until manually removed with/unwarn. - Fixed offline players not being targetable for ban, mute, and warn actions. Commands and GUI now support offline players through a player history system.
- Fixed clicking an offline player's skull in the GUI sometimes doing nothing due to a
nullname lookup.
โจ New Features
- Player History โ The plugin now tracks all players who have ever joined the server. Their profiles are saved in
players.ymland are available across all moderation menus. - Offline Player Support โ Ban, Mute, and Warn actions now work on offline players through both the GUI and direct commands.
- Search Button โ An anvil icon in the center of the player selection menu allows staff to search for any player by name.
- Online / Offline Sorting โ In the player selection menu, online players (green) are listed first, followed by offline players (gray).
- Kick Offline Guard โ Attempting to kick an offline player now shows a clear error message instead of silently failing.
โ๏ธ Permission Changes
- Removed automatic
default: opbypass. All permissions now require explicit assignment via LuckPerms or any permission plugin. - Staff members with any moderation permission (e.g.
moderation.kick) can now open the/modmenu without needingmoderation.usegranted separately. - Locked menu buttons are now shown as Barrier icons for actions the staff member doesn't have permission to use.
๐ก Note: If you are updating from a previous version, delete your old
config.ymlfrom theplugins/ModerationGUI/folder to load the latest default configuration.
Projects on Modrinth are automatically available through a Maven repository for use with JVM build tools such as Gradle. To learn more about the Modrinth Maven API, click here.
Note: When available, you should use the creator's maven repo instead as it will have transitive dependency information that the Modrinth Maven API does not. You may also end up with duplicate dependencies if you use a mix of Modrinth and non-Modrinth Maven repositories for your dependencies, because the group identifier will be different when served through the Modrinth Maven API.
Maven coordinates:
Version ID:
build.gradle:
repositories {
exclusiveContent {
forRepository {
maven {
name = "Modrinth"
url = "https://api.modrinth.com/maven"
}
}
// forRepositories(fg.repository) // Uncomment when using ForgeGradle
filter {
includeGroup "maven.modrinth"
}
}
}
// Standard Gradle dependency
dependencies {
implementation "maven.modrinth:eo8jCfkY:WglzCNoY"
}
// Legacy Loom dependency
dependencies {
modImplementation "maven.modrinth:eo8jCfkY:WglzCNoY"
}

