BattlePunishments
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.
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.
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
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 battleplugins.net teamspeak. Just enter the IP battleplugins.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
BattlePlugins Website
Commands and Permissions
Change Log
Java Documentation
CI Server
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.
@Mortalsinn
I have to get my Jenkins working again..
@lDucks
Thanks :) Do you have a Jenkins link or anything? Bukkit is so slow these days with releasing approved plugin builds
@Mortalsinn
Updated with a new version
@lDucks
lol sorry to waste your time, I found the cause :P
@Mortalsinn
It should not cancel out anything, I use it on my server and it works perfectly fine. The code should not interfere with anything. If you disabled it and you're still getting the messages, try running the server without BattlePunishments in for a few minutes and see if the problem is happening. That way we can be sure it is the plugin causing the issues.
After you do that let me know and if it doesn't work I'll have to look into it more.
@lDucks
Thanks a ton, it worked great, no issues. One question - there is an option in your config to log / commands to the console, I've been using that for a while but I noticed that with this option set to True, it cancels out all the chat and only shows the commands being used. What I mean is the regular day to day chat in the general channels aren't logged anymore. I set this back to false, reboot the server and now it's still only logging commands. Do you know how I change this back?
@Mortalsinn
It does it automatically when you enable MySQL.
Wait, what's the command or the process to convert from flat file to MySQL? the change logs for 2.8.0 says "New Commands" but I can't find them :(
@Mortalsinn
No problem, if you need any help with your conversion or something goes wrong in the process feel free to contact me in #BattlePlugins IRC at irc.esper.net or #bukkit or #bukkitdev
@lDucks
Epic, you rock :) Thank you
@Mortalsinn
I don't have a way to convert all your bans over... Sorry D;
EDIT: I took the download off since I found a huge problem I need to fix. When I reupload it, it will contain a way to transfer bans.
Thanks for the MySQL update! Fast question. Is there a command to convert my current bans over to MySQL? or do I need to re-ban everyone again?
@Mortalsinn
You don't need it enabled, just turn it off. Datasaver will be removed in the newest version anyway
do we need to have data saver enabled? it takes sooooooooooooo long to start up the server. Sometimes it hangs for 30 + seconds after it says "starting datasaver"
I'm still working on migrating to SQL, it isn't easy D;
@lDucks
Lol didnt notice the lastseen XD
@lDucks
Alright thanks!
@kahlilnc
It should save through restarts, if not you're going to need to wait for the SQL version release which I am still working on.
@regren
You must have a plugin that has conflicting commands.. Like commandbook?