Please put all bug reports on Github
BattlePunishments
An all around administration system that contains bans, mutes, IP tracking, watchlists, player help commands, and much more.

To use the website compatibility, this plugin requires WebAPI
![]()
Intro
An all around minecraft player/admin management system that contains bans, mutes, IP tracking, watchlists, player help commands, and much, much more.
This plugin started out as a personal plugin for my server and has grown into a plugin full of amazing admin tools and cool features to help you run your server and handle player information. This plugin was released because I have experience in running large MineCraft communities and I could not imagine how difficult it would be to run them without these commands.
This plugin contains many features listed below. I am constantly reworking and adding features to the plugin.
What makes this plugin different than CommandBook/Essentials?
Well, that's a good question. I'm glad you asked.... Unlike CommandBook, BattlePunishments stores the data for player information even when the player is not online. BattlePunishments also has IP cross checking and saves every single player in their own data file. BattlePunishments has features that log when a player breaks blocks. We even have a command to allow players to request help from the staff and an admin watchlist. The best part about it, all features are completely configurable! You can chose what you want to use, why, and how you want to use it! Also, I am always looking to add new things to the plugin so any requests that you have may be implemented. The plugin has an API for people to be able to edit the player.yml files if they want to add or change something from and external plugin.
Please note, this plugin's goal is not to replace CommandBook or Essentials in any way. It is made to work along side and give extra abilities. Maybe one day I'll add all the commands from Essentials and CommandBook so that they are obsolete with this plugin but at the moment they are both perfectly good plugins. This plugin has different or improved features. I recommend running it along side CommandBook/Essentials
For Server Owners
When you first load up BattlePunishments, please go to the plugins/BattlePunishments directory and open the config.yml. Your config page should look like this. Edit the configuration to your specifications, and then enter the command "/bpreload" in game and the new config will be reloaded. If you edited the MySQL information, you'll need to restart the server. When you're in game you can type /bp <number> and you will get a list of all the commands. Report any bugs you have and make sure to keep updated with new versions.
For Developers
There isn't much to hook into for this plugin, however I've made it easy for a developer to hook into the BattlePlayer class. If you would like to use BattlePunishments in another plugin (to ban, mute, kick, to check IPs, and more) you can now do so by hooking into the BattlePlayer class.
Example:
BattlePlayer bp = BattlePunishments.createBattlePlayer(string); if(bp.getPlayer() != null && !bp.getPlayer().hasPermission(BattlePerms.KICK)) bp.kickPlayer("Xraying");
Features
- Automated bans
- Automated mutes
- Kick players
- Herochat compatibility
- IP checking/comparing
- Watchlist
- Teleporting to random players
- Server broadcasting tool
- A command for player's to request help in game.
- Strike system
- Command blocker
- Automated messages
- IP Banning
- Command Logging
- Nicknames with TagAPI support
- "Found diamonds" block logging messages
- Player information logging
- Welcome messages for new players
- Lightweight chat format editing ability
- Import bans from a txt file or other ban plugin.
- Website!
Future Features (In order of priority)
N/A
Registering the Server
Unregistered Users:
- Access to public ban and mute list
- Access to basic information on player/server profiles
Registered Users:
- Access to all information on player/server profiles
- Access to public ban and mute list
- Can register a server
- Can sync information from server to the public lists
- Can post support ticket support tickets
How to Register
- Download the latest version of the plugin
- Install the plugin on your server and edit the config.yml, set website to true
- Install the WebAPI plugin
- Go to BattlePunishments.net and register
- Click "Your Servers" then "Register Server" and fill out the form, save the key somewhere safe.
- Go to your server and enter /bp verify <THE KEY YOU WERE GIVEN>
- That's it!
Help
You can ask me questions in real time on irc when I'm on. You can usually find me in #battleplugins, #bukkit, or #bukkitdev in irc.esper.net. I will also answer any Bukkit related questions that may not have to do with BattlePunishments specifically. It is also perfectly fine to come online to chat. If you don't have an IRC client, you can use the in-browser one.
Another location where I can be found would be the Battlecraftpvp.net teamspeak. Just enter the IP battlecraftpvp.net and send a PM to "Ducks" .. If I don't reply in either location it would mean I am not at my computer. At that point you should just shoot me a private message.
Converting From Another Plugin?
Check out the guide on how to do conversions HERE.
Links
BattlePunishments Website
BattlePlugins Website
Commands and Permissions
Change Log
Java Documentation
GitHub
Donate
I code these plugins as a hobby, however every donation helps to keep me motivated. If you like what I'm doing feel free to send me a donation.
Facts
- Date created
- Aug 29, 2012
- Categories
- Last update
- May 04, 2013
- Development stage
- Mature
- Language
- enUS
- License
- GNU Lesser General Public License version 3 (LGPLv3)
- Curse link
- BattlePunishments
- Downloads
- 3,890
- Recent files
- R: BattlePunishments v2.9.4.1 for CB 1.5.2-R0.1 May 04, 2013
- R: BattlePunishments v2.9.4 for CB 1.5.1-R0.2 Apr 21, 2013
- R: BattlePunishments v2.9.3.9 for CB 1.5.1-R0.1 Apr 10, 2013
- R: BattlePunishments v2.9.3.7 for 1.5.1 Apr 03, 2013
- R: BattlePunishments v2.9.3.6 for 1.5.1 Apr 02, 2013


- Reply
- #148
xDowsey May 08, 2013 at 02:28 UTC - 0 likes@lDucks: Go
When will the update be out? :)
- Reply
- #147
lDucks May 07, 2013 at 01:15 UTC - 0 likes@xDowsey: Go
It should be fixed.
You can ask me questions in real time on irc when I'm on. You can usually find me in #battleplugins, #bukkit, or #bukkitdev in irc.esper.net.
- Reply
- #146
xDowsey May 06, 2013 at 17:07 UTC - 0 likesI noticed you added my previous post to your issues list on Github.
Any further updates on this issue?
- Reply
- #145
xDowsey May 01, 2013 at 21:56 UTC - 0 likesHi. For some reason when we try to mute or ban a player, we're getting these error messages.
Mute:
Ban:
- Reply
- #144
lDucks Apr 13, 2013 at 17:58 UTC - 0 likes@Mortalsinn: Go
Will be fixed in next version - problem is someone has a nickname over 16 characters.
- Reply
- #143
Mortalsinn Apr 12, 2013 at 16:28 UTC - 0 likesGoing off the latest version I get this error when the server is white listed and someone tries to log in. Probably not a big deal but you know me... Mr. Bug Report lol
- Reply
- #142
lDucks Apr 03, 2013 at 18:28 UTC - 0 likes@Mortalsinn: Go
Hm, for some reason it is still trying to call the WebAPI class.. A quick fix would be to add it for now but I need to just go through and try to remove all the calls that I must have missed that are trying to call in the wrong places. Thanks for reporting the bugs!
- Reply
- #141
Mortalsinn Apr 03, 2013 at 14:10 UTC - 0 likesUpdated to the latest version, deleted my config, let it regen.........now I am getting this error lol.......any ideas now???
- Reply
- #140
lDucks Apr 02, 2013 at 15:53 UTC - 0 likes@Mortalsinn: Go
Edit your config.yml and add
- Reply
- #139
Mortalsinn Apr 02, 2013 at 12:47 UTC - 0 likesCrap - sorry that was a lot longer than I planned.
Once you review the errors please delete that comment so it doesn't look all crappy in your comment section. I just wanted you to see whats going on with the latest version