Polymart is now Voxel Shop! We're upgrading many features of the site, and during this open beta you will experience occasional bugs. Learn more
The GUI Ban management plugin!
GUIBan is a modern GUI-based moderation plugin for Paper 1.21+ servers.
Moderate players using an intuitive interface instead of memorizing commands.
Perfect for servers that want fast, simple, and structured moderation tools.
Moderate players using a clean graphical interface.
Click a player → choose an action → apply punishment.
No command memorization required.
GUIBan supports:
Ban
Mute
Jail
Kick
Warn
IP Ban
All punishments support temporary or permanent durations.
Quick duration selections:
GUIBan includes a staff hierarchy system.
| 1 | Trial Moderator |
| 2 | Moderator |
| 3 | Senior Moderator |
| 4 | Admin |
| 10 | Owner |
Higher levels can punish lower levels.
Use guiban.bypass for accounts that cannot be punished.
Choose your storage method:
SQLite
YAML
MySQL
Using MySQL allows punishments to sync across servers.
GUIBan is designed for modern servers.
Features include:
Cached punishment lookups
Async database operations
Minimal server impact
Send moderation events directly to Discord.
Example log:
The main moderation interface.
Staff can quickly select players and apply punishments without commands.
(Insert screenshot here)
/guiban | Open the player selection GUI | guiban.use |
/guiban help | Show command help | — |
/guiban ban <player> [time] [reason] | Ban a player | guiban.ban |
/guiban mute <player> [time] [reason] | Mute a player | guiban.mute |
/guiban jail <player> [time] [reason] | Jail a player | guiban.jail |
/guiban kick <player> [reason] | Kick a player | guiban.kick |
/guiban warn <player> [reason] | Warn a player | guiban.warn |
/guiban ipban <player|ip> [time] [reason] | IP ban a player or IP address | guiban.ipban |
/guiban unban <player> | Remove a ban | guiban.unban |
/guiban unmute <player> | Remove a mute | guiban.unmute |
/guiban unjail <player> | Remove a jail | guiban.unjail |
/guiban list <ban|mute|jail> | View active punishments | guiban.view |
/guiban reload | Reload configuration files | guiban.admin |
Examples:
guiban.* | All GUIBan permissions | OP |
guiban.use | Open GUIBan GUI | OP |
guiban.ban | Ban players | OP |
guiban.mute | Mute players | OP |
guiban.jail | Jail players | OP |
guiban.kick | Kick players | OP |
guiban.warn | Warn players | OP |
guiban.ipban | IP ban players | OP |
guiban.unban | Remove bans | OP |
guiban.unmute | Remove mutes | OP |
guiban.unjail | Remove jails | OP |
guiban.view | View punishments | OP |
guiban.broadcast | Receive staff broadcast messages | OP |
guiban.admin | Reload plugin configs | OP |
guiban.bypass | Cannot be punished | OP |
guiban.level.1 | Staff level 1 | false |
guiban.level.2 | Staff level 2 | false |
guiban.level.3 | Staff level 3 | false |
guiban.level.4 | Staff level 4 | false |
guiban.level.5 | Staff level 5 | false |
guiban.level.6 | Staff level 6 | false |
guiban.level.7 | Staff level 7 | false |
guiban.level.8 | Staff level 8 | false |
guiban.level.9 | Staff level 9 | false |
guiban.level.10 | Highest staff level | false |
%guiban_BAN_reason% | Active ban reason |
%guiban_BAN_duration% | Remaining ban time |
%guiban_BAN_punisher% | Who banned the player |
%guiban_MUTE_reason% | Active mute reason |
%guiban_MUTE_duration% | Remaining mute time |
%guiban_MUTE_punisher% | Who muted the player |
%guiban_JAIL_reason% | Active jail reason |
%guiban_JAIL_duration% | Remaining jail time |
%guiban_JAIL_punisher% | Who jailed the player |
GUIBan includes three configuration files.
config.ymlControls core plugin settings:
Storage type
Discord webhook
Warn system
Sounds
Jail location
Rate limits
messages.ymlCustomize all plugin messages.
Available placeholders:
gui.ymlCustomize the GUI layout:
Menu titles
Item icons
Item lore
Button layout
Download GUIBan.jar
Place it inside your /plugins folder
Restart the server
Configure files if needed
GitHub Repository:
https://github.com/TVDOfficial/GuiBan






