Banning
Commands to ban players or IPs from your server for a certain amount of time or permanently. Each ban can have a reason assigned to it and stores data about who has banned the player.
BanHammer data import
CommandsEX Banning functions were written with the popular BanHammer plugin in mind. It is entirely possible to import the BanHammer.db file from BanHammer into CommandsEX. To do this, follow these steps:
- copy BanHammer.db file from BanHammer plugin into CommandsEX folder in your plugins directory (keep the filename intact)
- make sure you have built your CommandsEX with Banning support (or downloaded a full build from Bukkit Dev / Sourceforge)
- start or restart your server - when CommandsEX will load, you will see information about BanHammer.db file being imported
- once the import is done, you will be informed via Console and BanHammer.db will be renamed to BanHammer.db.done
- remove BanHammer.db.done file from CommandsEX folder
Configuration
There are 3 config options added to accommodate Banning needs:
-
maxIPholdTime - number of seconds to keep player IPs internally. This is used when a player repeatedly joins the server, griefs (or spams) heavily and quits right away. We store his IP address, so we can ip-ban the guy even after he left by using his username. Default: 2 minutes (120 seconds)
-
minTempBansWarn - number of bans for the player to have in history before the system will suggest to ban this player permanently. Default: 5
-
silentBans - set this to false if you want everyone on the server see when a player gets banned and the reason why this happened, otherwise set it to true. Default: false
/cex_ban
- Description: Allows player to ban players from the server.
- Usage: /cex_ban \<Player> [t:time] [reason]
- Permission node: cex.ban
- Default permission: OP only
- Aliases: ban
- Location in JAR file: com/github/zathrus_writer/commandsex/commands/Command_cex_ban.class
/cex_banip
- Description: Allows player to ban IPs from the server.
- Usage: /cex_banip (Player/IP) [t:time] [reason]
- Permission node: cex.banip
- Default permission: OP only
- Aliases: banip
- Location in JAR file: com/github/zathrus_writer/commandsex/commands/Command_cex_banip.class
/cex_bcheck
- Description: Allows player to see other players' current ban status.
- Usage: /cex_bcheck \<Player>
- Permission node: cex.bcheck
- Default permission: OP only
- Aliases: bcheck
- Location in JAR file: com/github/zathrus_writer/commandsex/commands/Command_cex_bcheck.class
/cex_bhistory
- Description: Allows player to see other players' ban history.
- Usage: /cex_bhistory \<Player>
- Permission node: cex.bhistory
- Default permission: OP only
- Aliases: bhistory
- Location in JAR file: com/github/zathrus_writer/commandsex/commands/Command_cex_bhistory.class
/cex_pardon
- Description: Allows player to pardon player or IP from being banned.
- Usage: /cex_pardon (Player/IP)
- Permission node: cex.pardon
- Default permission: OP only
- Aliases: pardon
- Location in JAR file: com/github/zathrus_writer/commandsex/commands/Command_cex_pardon.class