==================
The RS PHP IRC Bot
==================

This bot attempts to use the nick MrBot - look for him on the userlist of #rebelsquadrons.

Note: You do not need to include "!" in front of commands if using the bot via private message.

MrBot hosts the Inter-Club Training Event on Saturdays.  For more details, please see:  http://www.rebelsquadrons.org/icte/bot


Publicly available commands
---------------------------
!login
  Checks whether you are logged in.
!login PIN password
  Private message this to avoid sharing your password.  This will log you into the bot.
  NOTE: If you have a static IP (most broadband connections), you will only need to do this once per computer.
        If you have a dynamic IP (most dial-up connections), you will need to log in each time you join IRC.
          You can automate this by adding it to your "perform on connect" list (available in most IRC clients).
!private on|off
  Toggles "private mode".  When "on", you will not be displayed on the list of members "currently on IRC" on the main page of RS.org.
  Example: !private on
  
!lookup searchterm
  Searches the RS database for the specified person and provides a profile link and email address.
!email pin(s)
  Retrieves the email address of the requested PIN(s).
  Options: -f format for email clients
  Example: !email -f 1 2 9 10

!seen nick
  Options: -h include hostmasks
           -t include exact time
  Example: !seen -h -t nick
  
!time, !date
  Tells the time or date.
  Timezones included: US Eastern Standard, US Pacific Standard, Greenwich Mean, Australia Eastern Standard.
   [Yes, we know, !time is a little slow, because time on the RS server runs a few minutes behind.  :)   ]
  
!r [number of dice]d[sides]
  Rolls dice.  Example usage: !r 4, !r 6d6, !r 4d20

!cs searchterm
  Searches the ABG character sheet database for the given search term and provides links to the resulting sheets.

!def word
  Defines the given "word".  Thanks to RhymeZone.com for supplying the material for this feature.

!server
  The bot will tell you what server it is currently using.

!uptime
  The bot will tell you how long it's been connected to the IRC server.

!help, !commands, !list
  Links to this help file.


Channel access commands
-----------------------
To use these commands, you must have logged in first via !login.

!access
  The bot tells you to which channels you have access.
!access channel
  The bot tells you what type of access you have to the specified channel.
!accesslist channel
  Prints the bot's access list for the specified channel.
  If channel is omitted, bot will use current window.

Level "Voice":
!say (channel) message
  If channel is omitted, bot will speak in current window.
!action (channel) message
  Bot will use /me.
!dice channel on|off
  Turns dice rolling (!r) on or off in the specified channel.
!voice channel nick
!devoice channel nick
!automode channel mode[voice, op, none]
  Sets what action the bot will take when you join a channel that it is in.
  Example usage: !automode #rebelsquadrons none


Level "Op":
!op (channel) nick
  Examples: !op      !op Licah     !op #rebelsquadrons ADM_Raven
!deop (channel) nick
!topic (channel) message


Level "Manager":
!access pin channel level
  Modifies access for the RSer on that channel.  Possible levels are "voice", "op", "manager".
  (Note: the order of pin and channel are now interchangeable)
!scrambler
  Scrambler.  Please see: http://www.rebelsquadrons.org/scrambler/
!swear (channel) on|off
  Turns the language filter for the specified channel on or off.  Bot will kick anyone who uses a profane word.


Level "Owner":
!log channel on|off
  Turns logging for the specified channel on or off.
!join channel
!part channel


If you have any questions about MrBot, please direct them to RA Licah Fox.  Thanks!