This program needs Java. Go to http://www.java.com/en/download/index.jsp if you don't have Java.
Marshall is a bot that joins your room as a mod and takes care of lots of dirty work. (See the features list.) It tracks all room events per user, and the room as a whole. Certain events are flagged as violations. For example, a user may send a very long message composed of many line breaks, something that users do in an attempt to blank out the message window. The bot recognizes a configurable number of line breaks and marks the activity as a violation for that user. The severity of this depends on the number of line breaks exceeding the limit in the configuration. The user will be warned privately by the bot, and repeat offenses will add to that user's severity ranking. When the user has violated the terms enough times, they are kicked (with an explanation as to why, and that further violations may result in banning,) and are allowed to return to the room.
If many users are violating the terms, the room severity as a whole can reach a critical level, at which point the bot may password protect the entire room so that users already in the room can continue talking without interruption. This is temporary and the bot un-protects the room after a time. I'm still working on the time limits being configurable. It's only a few minutes at the moment.
The bot accepts commands in the room from moderators OR in private message.
Most command will accept an asterisk after the caret symbol, signifying that the bot should match any users to the letters you type after the asterisk.
- b^nickname - bans a user. (Meebo's in room ban option only kicks,)
- k^nickname - kicks a user
- m^nickname - mutes a user
- um^nickname - unmutes a user
- say^message - the bot will repeat what you say. Recommend you do this in PM to the bot.
- version^ - shows the bot's version.
- printBanned^partialNickname - searches the banned user list and prints those matching the nickname or the part of it you typed.
- printMuted^ - shows all muted users.
- k^guests - kicks all guest accounts (non-signed in users)
- b^guests - bans guests... good for some emergencies.
- m^guests - mutes all guests
- kv^ - kicks all those who are muted
- pause^ - prevents the bot from taking any action
- unpause^ - resumes bot activity
- set^propertyName - sets a property to a new value while the bot is running
This bot needs to be set up as an admin in the room. I recommend creating an account specifically for the bot. This helps keep things organized, avoid sign on collisions, and avoids any fear that somewhere the code is sending out your password. See the source, yourself... that's another recommendation.
It will be super fast or super... "slow," depending on your internet connection.
Running the bot and configuring the bot. http://code.google.com/p/mrbrooksmarshall/wiki/Example
Get the bot! http://code.google.com/p/mrbrooksmarshall/downloads/list
Features (configurable) via properties file.
- Private messages users of its activity on their accounts
- Auto-muting guest accounts or account with very long names
- Allows moderator control of the bot via simple chat room messages
- Prevents guest flooding
- Prevents people repeating themselves, fast or slow, to spam or advertise in a room
- Prevents people from sending messages very fast, to flood the room without repeats
- Automatically detects and fixes backwards room hacks.
- Detects too many line breaks in a message, usually meant to flood the room with white space.
- Some of the room commands are very useful - muting all guests at once, kicking all guests, banning via nickname, etc.
- More features will be added over time.
