UQMatchbot (name pending) is supposed to be a matchmaking / player statistics bot that resides in #uqm-arena on freenode.
Currently, the main function is to allow players to signify that they are ready to play a game for a given duration, which others can then see using !readyusers.
Once players have finished a game, they can use the !result command to let the channel know the result of their game. In future versions of UQMatchbot, this will also record the result, and perhaps broadcast it over several channels (Twitter seems all the rage these days).
Currently, the following commands are supported in public chat:
!help - List public commands
!readyusers - List all players ready to play a game, and the time that they're still willing to play in minutes.
The following commands are supported in private chat (/query UQMatchbot):
!help - List private commands
!readyusers - List all players ready to play a game, and the time that they're still willing to play in minutes.
!login <username> <passworde> - Logs you in with a specific username and password.
!register <username> - Registers a user with a specific username. A password will be generated for you.
!chpass <oldpass> <newpass> - Changes your password. Note that you must be logged in, and that passwords are NOT stored securely, so please DO NOT use a password you use somewhere else!
!ready <readytime> - Sets your state to ready to play for "readytime" minutes.
!result claim <opponent> <result> [pointsmax] [pointsremaining] - Records a game's result against an opponent. Note that "opponent" has to be the username of your enemy (not their nickname in IRC), and that "result" has to be either 'win' or 'lose'. 'pointsmax' and 'pointsremaining' are optional ('pointsremaining' refers to the amount of points the winner's non-destructed fleet is still worth). Note that your opponent will have to verify your result claim for it to count.
!result confirm <claimID> - Confirms a result claim.
!result reject <claimID> - Rejects a result claim.
General rules, guidelines and stuff
1) DO NOT attempt to break UQMatchbot without telling the operator (Megagun) first!
2) UQMatchbot is in Alpha stage. Please report any bugs or issues, aswell as ideas to the operator (Megagun). You can do this nicely in IRC with /msg Megagun, or PM Megagun on some random forum on the Internet..
3) Things can crash. Things can flame out. Do not expect UQMatchbot to remain up or keep it's data when it goes out of Alpha. Do not rely on UQMatchbot only.
Future versions of UQMatchbot might send game results off to a dedicated Twitter account, and record player statistics on a webpage somewhere. Maybe implementing Elo's algorithm for player ratings...
Furthermore, UQMatchbot may one day be utilized to make tournaments easier to hold.
In the Future(tm), when UQMatchbot is done, I might craft a tray application IRC client specifically geared towards UQMatchbot that might serve as a crude game notifier/game lobby for UQM. Unless, of course, someone else already starts working on that... ;)
APOLOGIES if things break down and you get annoyed! MORE APOLOGIES if some random feature ends up spamming you or something (which it should not, but..)
Changelog (Central European Time)
18-oct-2009, ??:?? - Initial alpha release. Big woot and high-fives all 'round.
19-oct-2009, 17:06 - Changed the !result command significantly. Now allows the specification of the winner's remaining fleet points and the game's maximum allowed fleet points. Furthermore, result confirming and rejecting is now handled through !result confirm and !result reject. Furthermore, confirmed results are now stored on disk, and some bugfixes have been made here-and-there.