Please put all bug reports on Github


An all around administration system that contains bans, mutes, IP tracking, watchlists, player help commands, and much more.

BattlePunishments Banner


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.


BattlePlayer bp = BattlePunishments.createBattlePlayer(string);
if(bp.getPlayer() != null && !bp.getPlayer().hasPermission(BattlePerms.KICK))

Developer Docs


  • 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.

Future Features (In order of priority)


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


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 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 teamspeak. Just enter the IP 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.

BattlePlugins Website
Commands and Permissions
Change Log
Java Documentation
CI Server GitHub


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.



Please put all bug reports on Github

BattlePlugins Signature Item

You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of Mortalsinn Mortalsinn Jan 18, 2014 at 01:24 UTC - 0 likes

    is this dead?

  • Avatar of DerekZil DerekZil Aug 17, 2013 at 17:07 UTC - 0 likes

    I do not think /mute, /kick, /ban, /unban works. :D

    Edit: Can you make the colors show all the time above your head?

    Last edited Aug 17, 2013 by DerekZil

    Insanity Realms Website

  • Avatar of ericpret ericpret Aug 10, 2013 at 06:23 UTC - 0 likes

    @lDucks: Go

    The issue seems to somehow have corrected itself, but I can't say for sure... They just disappeared about two days after I installed the plugin. Didn't install anything else during that time, which is what threw me off. Anyways, thanks for the reply!


  • Avatar of lDucks lDucks Aug 05, 2013 at 22:30 UTC - 0 likes

    @ericpret: Go

    It shouldn't be BattlePunishments, unless there is something wrong with the config somewhere.

  • Avatar of ericpret ericpret Aug 02, 2013 at 22:31 UTC - 0 likes

    So out of the blue, all log-in and log-off messages stopped working... I've looked into it being other plugins, but I can't seem to find anything that states this. I've checked my BattlePunishments config, and loginmessage: true, logoutmessage: true. I've tried setting them to false and still the same deal. No errors anywhere. Any clue what it might be? I don't have any other plugins that are interfering with login/logoff messages...

  • Avatar of ericpret ericpret Jul 31, 2013 at 07:22 UTC - 0 likes

    @lDucks: Go

    Thanks! I figured the ore thing already, but great to have it confirmed :D I seem to have missed the description in the /mute or /ban aswell... I only found the permission nodes section which had each command explained very roughly, so thanks for the link. And yeah, web connections are still having a hissy fit... Hope you get it fixed soon!

  • Avatar of lDucks lDucks Jul 31, 2013 at 00:35 UTC - 0 likes

    @ericpret: Go

    Hey, so all commands are documented here:

    Perma-banning/muting is done by changing the time to -1, that is stated when you type /ban or /mute.

    As for the items, it uses the Minecraft naming scheme, REDSTONE_ORE should work, IRON_ORE, etc.

    The web connections are currently giving me a hard time and I will get a fix for them soon.

  • Avatar of ericpret ericpret Jul 30, 2013 at 03:13 UTC - 0 likes

    Unfortunately, your Wikipages for this plugin are seriously lacking... Is there an actual way to ban someone permanently? Outside of banning for like 9000000 days. Also, with the block logger, what are the item names for various blocks? I've added things like REDSTONE_ORE, IRON_ORE, COAL_ORE etc. with that kinda format, but you usually have to add the glowing redstone ore aswell. Is there a way to figure out these kinds of things? This plugin is absolutely amazing feature wise, but unfortunately, people like me need alittle more explaining :r I'm also having some issues with registering through WebAPI. For some reason, my server is telling me a connection could not be made. I've tried both the direct IP and the dynamic IP, nothing works...

    Last edited Jul 30, 2013 by ericpret
  • Avatar of lDucks lDucks Jun 18, 2013 at 16:40 UTC - 0 likes

    @xDowsey: Go

    Are you using MySQL or flat files?

  • Avatar of xDowsey xDowsey Jun 18, 2013 at 13:47 UTC - 0 likes

    Editing strikes doesn't work.

    I can't reduce someone's strikes using the command '/editstk'


Date created
Aug 29, 2012
Last update
Jul 13, 2013
Development stage
  • enUS
GNU Lesser General Public License version 3 (LGPLv3)
Curse link
Recent files