Voxel Shop beta is live. Expect 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






