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  
GuiBan icon

GuiBan 2.0

The GUI Ban management plugin!



🛡️ GUIBan


Modern GUI Moderation for Paper Servers


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.




⭐ Features


🖱️ GUI Moderation


Moderate players using a clean graphical interface.


Click a player → choose an action → apply punishment.


No command memorization required.




⚖️ Full Punishment System


GUIBan supports:




  • Ban



  • Mute



  • Jail



  • Kick



  • Warn



  • IP Ban


All punishments support temporary or permanent durations.




⏱️ Time Presets


Quick duration selections:









 




1m
5m
15m
30m
1h
6h
12h
1d
1w
2w
Permanent

 


🔐 Staff Permission Levels


GUIBan includes a staff hierarchy system.




1Trial Moderator
2Moderator
3Senior Moderator
4Admin
10Owner

Higher levels can punish lower levels.


Use guiban.bypass for accounts that cannot be punished.




💾 Multiple Storage Options


Choose your storage method:




  • SQLite



  • YAML



  • MySQL


Using MySQL allows punishments to sync across servers.




⚡ Optimized Performance


GUIBan is designed for modern servers.


Features include:




  • Cached punishment lookups



  • Async database operations



  • Minimal server impact




📡 Discord Logging


Send moderation events directly to Discord.


Example log:









 




Player: Steve
Action: Ban
Duration: 7 days
Reason: Cheating
Staff: Admin

 


🖥️ GUI Preview


Player Selection Menu


The main moderation interface.


Staff can quickly select players and apply punishments without commands.


(Insert screenshot here)




📜 Commands




/guibanOpen the player selection GUIguiban.use
/guiban helpShow command help
/guiban ban <player> [time] [reason]Ban a playerguiban.ban
/guiban mute <player> [time] [reason]Mute a playerguiban.mute
/guiban jail <player> [time] [reason]Jail a playerguiban.jail
/guiban kick <player> [reason]Kick a playerguiban.kick
/guiban warn <player> [reason]Warn a playerguiban.warn
/guiban ipban <player|ip> [time] [reason]IP ban a player or IP addressguiban.ipban
/guiban unban <player>Remove a banguiban.unban
/guiban unmute <player>Remove a muteguiban.unmute
/guiban unjail <player>Remove a jailguiban.unjail
/guiban list <ban|mute|jail>View active punishmentsguiban.view
/guiban reloadReload configuration filesguiban.admin

Alias









 




/gb

 

Examples:









 




/gb
/gb ban Steve 1d Cheating
/gb mute Steve 10m Spamming
/gb list ban

 


🔑 Permissions




guiban.*All GUIBan permissionsOP
guiban.useOpen GUIBan GUIOP
guiban.banBan playersOP
guiban.muteMute playersOP
guiban.jailJail playersOP
guiban.kickKick playersOP
guiban.warnWarn playersOP
guiban.ipbanIP ban playersOP
guiban.unbanRemove bansOP
guiban.unmuteRemove mutesOP
guiban.unjailRemove jailsOP
guiban.viewView punishmentsOP
guiban.broadcastReceive staff broadcast messagesOP
guiban.adminReload plugin configsOP
guiban.bypassCannot be punishedOP
guiban.level.1Staff level 1false
guiban.level.2Staff level 2false
guiban.level.3Staff level 3false
guiban.level.4Staff level 4false
guiban.level.5Staff level 5false
guiban.level.6Staff level 6false
guiban.level.7Staff level 7false
guiban.level.8Staff level 8false
guiban.level.9Staff level 9false
guiban.level.10Highest staff levelfalse



🔗 PlaceholderAPI Placeholders




%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



⚙️ Configuration Files


GUIBan includes three configuration files.


config.yml


Controls core plugin settings:




  • Storage type



  • Discord webhook



  • Warn system



  • Sounds



  • Jail location



  • Rate limits




messages.yml


Customize all plugin messages.


Available placeholders:









 




{player}
{reason}
{duration}
{punisher}
{appeal}

 


gui.yml


Customize the GUI layout:




  • Menu titles



  • Item icons



  • Item lore



  • Button layout




📥 Installation




  1. Download GUIBan.jar



  2. Place it inside your /plugins folder



  3. Restart the server



  4. Configure files if needed





🔗 Support


GitHub Repository:


https://github.com/TVDOfficial/GuiBan



Screenshot%202026-03-09%20131444.pngScreenshot%202026-03-09%20131437.pngScreenshot%202026-03-09%20131431.pngScreenshot%202026-03-09%20131422.pngScreenshot%202026-03-09%20131411.pngScreenshot%202026-03-09%20131358.pngScreenshot%202026-03-09%20131350.png


Owned
Ready to download
This resource is already attached to your account. You can download the latest file any time.