BLIP

Pages

Commands | Configuration | New Features (v.1.3) | Upcoming Features

Introduction

Introducing Blip. Blip is a tool for IP logging, bans, kicks, and general user management. This plugin works much like most other banning plugins in that it does things such as:

Allows the banning of IPs and Usernames.
Allows you to kick players from the server.
Allows you to use custom messages when kicking or banning. (optional, otherwise specified in the config)
If you ban a username and they sign it with another IP (same name), they are banned again automatically
Likewise, if they change their name and use the same IP, they will still be banned.
This plugin also keeps a comprehensive list of IPs by user, and in the same file, users by IP.
Config file is fully explained on this page and in the readme.txt (automatically generated on every run).

BUT WAIT! There's more!

I have also added a few things to it that I haven't yet seen in other plugins I've used:

I attempted to make very short and simple commands. I like being able to ban someone fast if they're griefing the hell out of something.
If set in the config, usernames or IPs can be exempted from the automatic banning of known users or IPs.
Also in the config, users and IPs can be set as "unbannable".
If a user or IP is in the "doomban" lists, any user that attempts to ban them (aside from the console), will be banned instead.
This plugin includes a word filter. If a word has a word in the filtered-word list in it at all, the word is converted to "magic" letters.
You can mute players by IP rather than just by name. (But you can mute them by name as well!)

At the moment (because this is my first plugin, and I'm not entirely comfortable with Java yet), this plugin does not support any permissions. At all. Nada. That's a project for a later date if I feel I should try to destroy my only currently public plugin. The ONLY commands a non OP player can use is "/blip" and "/blip ip". And "/blip" only tells them that they can use "/blip ip". OP users can see the rest of the commands by typing "/blip", although I do suggest you read through the rest of this (or the readme.txt) for even more information on commands.

Installation

To install this plugin (like any other plugin for the most part), just take 'blip.jar' and move it to your plugins folder in your server directory. This plugin may not want to initialize with a simple reload, so you may need to restart the server for it to work. You'll know it's working when the 'Blip' directory in your plugins folder is generated with these four files in it:

readme.txt
users.yml
banned.yml
config.yml

Commands and Config

(Moved these to seperate pages so the main page wasn't so long)

Commands Page | Configuration Page

Some extra information

This is my first plugin, keep that in mind. I can only hope that this will work accordingly on the majority of MC servers. If this doesn't work, PLEASE be polite and try to be helpful. Try to include console errors (if any, please say so if there are none). Also, it may be useful if you'd tell me what version of CraftBukkit you're using and version of Java if you know. If you are a dev and you know how to do this better, please don't be rude, but I'm up for constructive criticism.

This plugin was compiled with Java 1.6, but should work if you're using JRE1.6 or 1.7 at least. When 1.7 gains more headway, I can recompile with it if necessary.

Credits

Huge thanks to Jacek from betterPHP for helping me with quite a lot of this plugin. His site is http://betterphp.co.uk - Go there for some great tutorials (way more than just Java) and very useful forums.

Bugs

The plugin will usually replace dots with underscores so it doesn't break yml files, they will echo back with underscores when you view them. (they should still work)
If for some reason two people have the same name (but with underscores instead of dots or vice-versa), they will likely be categorized as the same person in the users.yml, I have no way of fixing this at the moment.

Bug Fixes

Hopefully fixed the bug where users attempting to join, but having been banned by another plugin or the server is messing up the users.yml.
If a banned user attempts to join, they may get the message "The Ban Hammer has spoken!" rather than the value set in the config. (This may or may not have been fixed)
Fixed dots and special characters breaking the plugin (not thoroughly tested):

Special Character Fix

To Do

Feel free to contribute ideas. If I like it and I think I can do it, I'll try it out.