Custom Bans Plus is a comprehensive ban management plugin that offers a variety of features to help you effectively manage your server. With its customizable system, you can design your ban and kick pages and announcements to match your server's aesthetic. In addition, the plugin includes a unique feature called Ban Presets, which helps your staff team streamline their processes and procedures for managing bans on the server.
v3.4 Grand QoL Update
Updates:
- "Severities" have now been changed to "Ban Presets" to have more clarity on its uses.
- Added a Ban/IP Ban GUI. Banning has never been made easier than giving you the ability to ban with one click. Access this GUI by only typing "/ban <player>" without any other details.
- Changes Ban Presets from a numbering system to a naming system. You can now call on ban presets by names instead of confusing numbers.
- Config and Messages yamls cleaned up and added more options to configure. To give users more freedom to customize, both the config.yml and messages.yml have been cleaned up to make room for more configurations, all the while still staying user-friendly with commented out descriptions.
- Severity announcement messages removed. To avoid redundancy, the severity announcers have been removed, leaving only the "reason" and "without reason" announcers in operation.
Check out the latest config.yml to see all new additions.
A Setup Guide has been created to better help you set up your staff members' permissions. You may access it by clicking here.
Spoiler: config.yml
#MYSQL CONFIGURATION - You may setup your MySql Database here.
# You may delete the .db file if you use this version.
mysql:
enable : false
host:
port:
user:
pass:
database-name : "custombansplus"
useSSL : false
allowPublicKeyRetrieval : false
Database:
Validate-Tables : true
# Changes the display name of your console. For example, when you ban a player using the console, it'll substitute, save, and display the name below instead of just "CONSOLE."
console-name : "The Great Console"
# Note: If both are set to false, the plugin will default to interval saving at a 15 minute duration.
cache :
# Sends a notif message to admins when cache is being stored.
notify-save : false
# Data saves when N number of new players join.
fixed-amount:
enable : true
save-at : 100
# Data saves every N duration.
intervals:
enable : true
save-at : 15m
# The command that will execute to deduct balance from the player if a supported economy plugin is not found. Currently supported economy plugins: Vault
# NOTE: You will not be able to use percentage deductions if your economy plugin is unsupported.
Bal-Deduct-Command : "eco take %player% %amount%"
GUI:
Ban-GUI:
Enable : true
Defaults:
Duration : 3d
Reason : "Struck by the ban hammer!"
Is-Silent : false
Clear-Inv : false
# Can be exact amount or percentage (Examples: 500, 30%, 2000, 50%, 200%)
Bal-Deduct : "0"
# Set to true if you want to use punishments without reason, and false if you want to use the default reasons if reason is blank.
toggle-no-reason : false
# Set to true if you want to force use the ban preset reason regardless if the sender inputted their own reason or not.
force-preset-reason : false
# Set to true if you want punishments with durations to default to permanent if no value or an invalid value is specified.
# "/ban [-s] <player> <reason>" would default to permanent.
default-punishments-to-permanent : false
# Add as many warn checkers as you want.
# Order of commands executed is top to bottom.
# Format: %player%
warn:
3:
console-commands :
- eco take %player% 500
- kick %player% Reached 3 warns.
5:
console-commands :
- ban %player% s1 Reached 5 warns.
# Set enable-warn-titles to true if you want titles to appear on your warns.
warn-title:
enable : true
warn-title : "&c&lYou have been warned!"
# Set to true if you want the warn reason as the subtitle.
custom-subtitle : false
warn-subtitle : "§fYou've been warned! Check your chat."
# Input your server's whisper or communication commands. A muted player will not be able to use these commands.
whisper-commands :
- "tell"
- "whisper"
- "w"
- "msg"
- "localchat"
- "lc"
- "factionchat"
- "fc"
# Set to true if you want to disallow muted players from placing signs.
Disable-Signs-On-Mute : false
# Set to true if you want your durations to be worded out (e.g. 2d -> 2 Days or 3d2h30m -> 3 Days, 2 Hours, and 30 Minutes).
word-out-durations:
announcers : true
pages : true
time-remaining : false
time-passed : true
updates :
# Set to true if you want op players to receive plugin update notifications.
notify : true
# Set intervals of when to check for updates. Follows the same duration patterns (Xs, Xm, Xh, Xd).
interval : 3h
# Logs to the console when a ban or mute has been lifted (i.e. served their sentences).
log:
ban-lifts : false
mute-lifts : false
PlasmoVoice:
Mute-Voice-On-Mute : true
DiscordSRV :
# Set to true if you want to still announce silent announcements in the 'CustomBansPlus' channel.
Announce-Silent-Announcements : false
# For Offline-Mode Servers: Set to true if you want to force players to use the correct name capitalization based on the first name they joined with.
# Example: Player logged in with the username "Coralise". The server will now deny any variation of the username (cOrAlIsE, CORAlise, CoralisE) except the original one from logging in.
Strict-Username-Capitalization : true
# Generally used for development and bug fixing.
# The developer might ask you to enable this for her to properly locate bugs.
# WARNING: Will spam your console.
Debug-Mode : false
Code (YAML):
#MYSQL CONFIGURATION - You may setup your MySql Database here.
# You may delete the .db file if you use this version.
mysql:
enable : false
host:
port:
user:
pass:
database-name : "custombansplus"
useSSL : false
allowPublicKeyRetrieval : false
Database:
Validate-Tables : true
# Changes the display name of your console. For example, when you ban a player using the console, it'll substitute, save, and display the name below instead of just "CONSOLE."
console-name : "The Great Console"
# Note: If both are set to false, the plugin will default to interval saving at a 15 minute duration.
cache :
# Sends a notif message to admins when cache is being stored.
notify-save : false
# Data saves when N number of new players join.
fixed-amount:
enable : true
save-at : 100
# Data saves every N duration.
intervals:
enable : true
save-at : 15m
# The command that will execute to deduct balance from the player if a supported economy plugin is not found. Currently supported economy plugins: Vault
# NOTE: You will not be able to use percentage deductions if your economy plugin is unsupported.
Bal-Deduct-Command : "eco take %player% %amount%"
GUI:
Ban-GUI:
Enable : true
Defaults:
Duration : 3d
Reason : "Struck by the ban hammer!"
Is-Silent : false
Clear-Inv : false
# Can be exact amount or percentage (Examples: 500, 30%, 2000, 50%, 200%)
Bal-Deduct : "0"
# Set to true if you want to use punishments without reason, and false if you want to use the default reasons if reason is blank.
toggle-no-reason : false
# Set to true if you want to force use the ban preset reason regardless if the sender inputted their own reason or not.
force-preset-reason : false
# Set to true if you want punishments with durations to default to permanent if no value or an invalid value is specified.
# "/ban [-s] <player> <reason>" would default to permanent.
default-punishments-to-permanent : false
# Add as many warn checkers as you want.
# Order of commands executed is top to bottom.
# Format: %player%
warn:
3:
console-commands :
- eco take %player% 500
- kick %player% Reached 3 warns.
5:
console-commands :
- ban %player% s1 Reached 5 warns.
# Set enable-warn-titles to true if you want titles to appear on your warns.
warn-title:
enable : true
warn-title : "&c&lYou have been warned!"
# Set to true if you want the warn reason as the subtitle.
custom-subtitle : false
warn-subtitle : "§fYou've been warned! Check your chat."
# Input your server's whisper or communication commands. A muted player will not be able to use these commands.
whisper-commands :
- "tell"
- "whisper"
- "w"
- "msg"
- "localchat"
- "lc"
- "factionchat"
- "fc"
# Set to true if you want to disallow muted players from placing signs.
Disable-Signs-On-Mute : false
# Set to true if you want your durations to be worded out (e.g. 2d -> 2 Days or 3d2h30m -> 3 Days, 2 Hours, and 30 Minutes).
word-out-durations:
announcers : true
pages : true
time-remaining : false
time-passed : true
updates :
# Set to true if you want op players to receive plugin update notifications.
notify : true
# Set intervals of when to check for updates. Follows the same duration patterns (Xs, Xm, Xh, Xd).
interval : 3h
# Logs to the console when a ban or mute has been lifted (i.e. served their sentences).
log:
ban-lifts : false
mute-lifts : false
PlasmoVoice:
Mute-Voice-On-Mute : true
DiscordSRV :
# Set to true if you want to still announce silent announcements in the 'CustomBansPlus' channel.
Announce-Silent-Announcements : false
# For Offline-Mode Servers: Set to true if you want to force players to use the correct name capitalization based on the first name they joined with.
# Example: Player logged in with the username "Coralise". The server will now deny any variation of the username (cOrAlIsE, CORAlise, CoralisE) except the original one from logging in.
Strict-Username-Capitalization : true
# Generally used for development and bug fixing.
# The developer might ask you to enable this for her to properly locate bugs.
# WARNING: Will spam your console.
Debug-Mode : false
For full details and information, visit the CBP Wiki here.
GENERALS:
- Ban a player.
- IP Ban a player.
- Kick a player.
- Mute a player.
- Warn a player.
- [-s] option to punish a player silently (all punishments above + unban and unmute).
- Check a player's Alternate Account History based on their IPs.
- Full API Support. Click here for more info.
- Fully Customizable Temp Ban, Perm Ban, and Kick pages.
- Fully Customizable announcers.
- You may customize the above either through the config.yml file or in-game.
- All Commands come with an easy Tab Completion method.
- Extremely user-friendly GUI for almost all commands.
- A Ban Preset system for punishment organization. Click here for more info.
- Super easy setup.
- Report Function. A Report Feature where players can report other players, which notifies the staff team. Staff members can do /reports list to see all submitted reports.
- Premium or Cracked Server Compatibility.
- DiscordSRV Support. Click here for the setup guide.
This plugin has a unique feature that gives the server's staff team the ease of penalizing cheaters with only one command.
Say you got a punishment stating that the player will be banned and have their balance deducted; You would have to execute two or more commands to finish punishing a single player. If you got helpers who don't have the permissions for such commands, they would need to wait for a higher staff member to finish the job, making staff activities redundant. Well, this system solves that problem.
A Ban Preset is a type of ban that can have other commands integrated into it, like, for instance, an automatic balance reduction of a player's economy or an automatic clear of their inventory. Each ban preset has a fixed ban duration (temporary or permanent) depending on how you want them set up.
Spoiler: Ban Preset List GUI
With the Ban Presets, staff members can now effortlessly punish cheaters all in one command, allowing you to easily organize your punishments.
For full details and information, visit the CBP Wiki here.
Spoiler: Screenshots
![[IMG]](//proxy.spigotmc.org/452bccb8b30b6a1f8bad2b368619672646f3c192?url=https%3A%2F%2Fi.imgur.com%2FkGuMH2m.jpeg)
![[IMG]](//proxy.spigotmc.org/78bea9c3e95dc827690c0a6bdc152126d88f0b0d?url=https%3A%2F%2Fi.imgur.com%2FATP9tSA.jpeg)
![[IMG]](//proxy.spigotmc.org/4d826e265346135ff729c5becba253d435048ab3?url=https%3A%2F%2Fi.imgur.com%2FKt8FSPf.jpg)
![[IMG]](//proxy.spigotmc.org/f8909e5b1f3bad624dd4f9df2306f116ed400040?url=https%3A%2F%2Fi.imgur.com%2FtbVe9c8.jpg)
~Fully customizable ban page and announcers, easy, simple, and readable GUI.
![[IMG]](http://proxy.spigotmc.org/452bccb8b30b6a1f8bad2b368619672646f3c192?url=https%3A%2F%2Fi.imgur.com%2FkGuMH2m.jpeg)
![[IMG]](http://proxy.spigotmc.org/78bea9c3e95dc827690c0a6bdc152126d88f0b0d?url=https%3A%2F%2Fi.imgur.com%2FATP9tSA.jpeg)
![[IMG]](http://proxy.spigotmc.org/4d826e265346135ff729c5becba253d435048ab3?url=https%3A%2F%2Fi.imgur.com%2FKt8FSPf.jpg)
![[IMG]](http://proxy.spigotmc.org/f8909e5b1f3bad624dd4f9df2306f116ed400040?url=https%3A%2F%2Fi.imgur.com%2FtbVe9c8.jpg)
~Fully customizable ban page and announcers, easy, simple, and readable GUI.
Spoiler: Installation
If you like the plugin, then please do support me!

USD - EUR - PHP - Ko-Fi
Click Here to learn about ShockByte, a game server hosting service!
Ask me for suggestions!
You may contact me regarding all of my plugin-related issues, concerns, and suggestions by joining our discord or direct messaging me, kyurious. See you there!
Thank you for using my plugin, please leave a rating if you can, it'll be enough to make my lil' heart happy
Be sure to follow to keep up to date with more posts!
Spoiler: Terms of Service
* You may not sell/resell the plugin to any individual without my (the developer's) permission.
* You may not redistribute this product. Unless given explicit permission from Coralise.
* I claim the right to terminate your license, at any point and for any reason.
* You may decompile the jar purely, only for development purposes.
* This TOS can and may be changed at absolutely any point without prior notice.
* You may not redistribute this product. Unless given explicit permission from Coralise.
* I claim the right to terminate your license, at any point and for any reason.
* You may decompile the jar purely, only for development purposes.
* This TOS can and may be changed at absolutely any point without prior notice.
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.8, 1.9, 1.10
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
Custom Bans Plus | Fully Customizable Ban Manager is a free Minecraft Java mod. Compatible with Minecraft 1.8, 1.9, 1.10, 1.11 and newer. Downloaded 29,204 times (via Spigot). Download it and open it directly in the game.

