BotServ

• HELP
  

   BotServ allows you to have a bot on your own channel.
   It has been created for users that can't host or
   configure a bot, or for use on networks that don't
   allow users' bot. Available commands are listed 
   below; to use them, type /msg BotServ command.  For 
   more information on a specific command, type /msg 
   BotServ HELP command.
   
   BOTLIST            Lists available bots
   ASSIGN             Assigns a bot to a channel
   SET                Configures bot options
   KICK               Configures kickers
   BADWORDS           Maintains bad words list
   
   Other commands: ACT INFO SAY UNASSIGN
   
   Bot will join a channel whenever there is at least
   <num> user(s) on it.
   
  

• BOTLIST
  

   Syntax: /msg BotServ  BOTLIST
   
   Lists all available bots on this network.
   
  

• ASSIGN
  

   Syntax: /msg BotServ  ASSIGN chan nick
   
   Assigns a bot pointed out by nick to the channel chan. You
   can then configure the bot for the channel so it fits
   your needs.  
   
  

• UNASSIGN
  

   Syntax: /msg BotServ  UNASSIGN chan
   
   Unassigns a bot from a channel. When you use this command,
   the bot won't join the channel anymore. However, bot
   configuration for the channel is kept, so you will always
   be able to reassign a bot later without have to reconfigure
   it entirely.
   
  

• INFO
  

   Syntax: /msg BotServ  INFO {chan | nick}
   
   Allows you to see BotServ information about a channel or a bot.
   If the parameter is a channel, then you'll get information
   such as enabled kickers. If the parameter is a nick,
   you'll get information about a bot, such as creation
   time or number of channels it is on.
   
  

• SET
  

   Syntax: /msg BotServ  SET channel option parameters
   
   Configures bot options.  option can be one of:
   
       DONTKICKOPS      To protect ops against bot kicks
       DONTKICKVOICES   To protect voices against bot kicks
       GREET            Enable greet messages
       FANTASY          Enable fantaisist commands
       SYMBIOSIS        Allow the bot to act as a real bot
   
   Type /msg BotServ HELP SET option for more information
   on a specific option.
   
   Note: access to this command is controlled by the
   level SET.
   
  

• SET DONTKICKOPS
  

   Syntax: /msg BotServ  SET channel DONTKICKOPS {ON|OFF}
   
   Enables or disables ops protection mode on a channel.
   When it is enabled, ops won't be kicked by the bot
   even if they don't match the NOKICK level.
   
  

• SET DONTKICKVOICES
  

   Syntax: /msg BotServ  SET channel DONTKICKVOICES {ON|OFF}
   
   Enables or disables voices protection mode on a channel.
   When it is enabled, voices won't be kicked by the bot
   even if they don't match the NOKICK level.
   
  

• SET FANTASY
  

   Syntax: /msg BotServ  SET channel FANTASY {ON|OFF}
   
   Enables or disables fantasy mode on a channel.
   When it is enabled, users will be able to use
   commands !op, !deop, !voice, !devoice,
   !kick, !kb, !unban, !seen on a channel (find how 
   to use them; try with or without nick for each, 
   and with a reason for some?).
   
   Note that users wanting to use fantaisist
   commands MUST have enough level for both
   the FANTASIA and another level depending
   of the command if required (for example, to use 
   !op, user must have enough access for the OPDEOP
   level).
  
  

• SET GREET
  

   Syntax: /msg BotServ  SET channel GREET {ON|OFF}
   
   Enables or disables greet mode on a channel.
   When it is enabled, the bot will display greet
   messages of users joining the channel, provided
   they have enough access to the channel.
  
  

• SET SYMBIOSIS
  

   Syntax: /msg BotServ  SET channel SYMBIOSIS {ON|OFF}
   
   Enables or disables symbiosis mode on a channel.
   When it is enabled, the bot will do everything
   normally done by BotServ on channels, such as MODEs,
   KICKs, and even the entry message.
  
  

• KICK
  

   Syntax: /msg BotServ  KICK channel option parameters
   
   Configures bot kickers.  option can be one of:
   
       BOLDS         Sets if the bot kicks bolds
       BADWORDS      Sets if the bot kicks bad words
       CAPS          Sets if the bot kicks caps
       COLORS        Sets if the bot kicks colors
       FLOOD         Sets if the bot kicks flooding users
       REPEAT        Sets if the bot kicks users who repeat
                          themselves
       REVERSES      Sets if the bot kicks reverses
       UNDERLINES    Sets if the bot kicks underlines
   
   Type /msg BotServ HELP KICK option for more information
   on a specific option.
   
   Note: access to this command is controlled by the
   level SET.
  
  

• KICK BOLDS
  

   Syntax: /msg BotServ  KICK channel BOLDS {ON|OFF} [ttb]
  
   Sets the bolds kicker on or off. When enabled, this
   option tells the bot to kick users who use bolds.
  
   ttb is the number of times an user can be kicked
   before it get banned. Don't give ttb to disable
   the ban system once activated.
  
  

• KICK COLORS
  

   Syntax: /msg BotServ  KICK channel COLORS {ON|OFF} [ttb]
  
   Sets the colors kicker on or off. When enabled, this
   option tells the bot to kick users who use colors.
  
   ttb is the number of times an user can be kicked
   before it get banned. Don't give ttb to disable
   the ban system once activated.
  
  

• KICK REVERSES
  

   Syntax: /msg BotServ  KICK channel REVERSES {ON|OFF} [ttb]
  
   Sets the reverses kicker on or off. When enabled, this
   option tells the bot to kick users who use reverses.
  
   ttb is the number of times an user can be kicked
   before it get banned. Don't give ttb to disable
   the ban system once activated.
  
  

• KICK UNDERLINES
  

   Syntax: /msg BotServ  KICK channel UNDERLINES {ON|OFF} [ttb]
  
   Sets the underlines kicker on or off. When enabled, this
   option tells the bot to kick users who use underlines.
  
   ttb is the number of times an user can be kicked
   before it get banned. Don't give ttb to disable
   the ban system once activated.
  
  

• KICK CAPS
  

   Syntax: /msg BotServ  KICK channel CAPS {ON|OFF} [ttb [min [percent]]]
  
   Sets the caps kicker on or off. When enabled, this
   option tells the bot to kick users who are talking in
   CAPS.
  
   The bot kicks only if there are at least min caps
   and they constitute at least percent%% of the total 
   text line (if not given, it defaults to 10 characters
   and 25%%).
  
   ttb is the number of times an user can be kicked
   before it get banned. Don't give ttb to disable
   the ban system once activated.
  
  

• KICK FLOOD
  

   Syntax: /msg BotServ  KICK channel FLOOD {ON|OFF} [ttb [ln [secs]]]
  
   Sets the flood kicker on or off. When enabled, this
   option tells the bot to kick users who are flooding
   the channel using at least ln lines in secs seconds
   (if not given, it defaults to 6 lines in 10 seconds).
   
   ttb is the number of times an user can be kicked
   before it get banned. Don't give ttb to disable
   the ban system once activated.
  
  

• KICK REPEAT
  

   Syntax: /msg BotServ  KICK #channel REPEAT {ON|OFF} [ttb [num]]
  
   Sets the repeat kicker on or off. When enabled, this
   option tells the bot to kick users who are repeating
   themselves num times (if num is not given, it
   defaults to 3).
  
   ttb is the number of times an user can be kicked
   before it get banned. Don't give ttb to disable
   the ban system once activated.
  
  

• KICK BADWORDS
  

   Syntax: /msg BotServ  KICK #channel BADWORDS {ON|OFF} [ttb]
  
   Sets the bad words kicker on or off. When enabled, this
   option tells the bot to kick users who say certain words
   on the channels.
  
   You can define bad words for your channel using the
   BADWORDS command. Type /msg BotServ HELP BADWORDS for
   more information.
  
   ttb is the number of times an user can be kicked
   before it get banned. Don't give ttb to disable
   the ban system once activated.
   
  

• BADWORDS
  

   Syntax: /msg BotServ  BADWORDS channel ADD word [SINGLE | START | END]
           BADWORDS channel DEL {word | entry-num | list}
           BADWORDS channel LIST [mask | list]
           BADWORDS channel CLEAR
   
   Maintains the bad words list for a channel. The bad
   words list determines which words are to be kicked
   when the bad words kicker is enabled. For more information,
   type /msg BotServ HELP KICK BADWORDS.
   
   The BADWORDS ADD command adds the given word to the
   badword list. If SINGLE is specified, a kick will be
   done only if an user says the entire word. If START is 
   specified, a kick will be done if an user says a word
   that starts with word. If END is specified, a kick
   will be done if an user says a word that ends with
   word. If you don't specify anything, a kick will
   be issued every time word is said by an user.
   
   The BADWORDS DEL command removes the given word from the
   bad words list.  If a list of entry numbers is given, those
   entries are deleted.  (See the example for LIST below.)
   
   The BADWORDS LIST command displays the bad words list.  If
   a wildcard mask is given, only those entries matching the
   mask are displayed.  If a list of entry numbers is given,
   only those entries are shown; for example:
  
      BADWORDS #channel LIST 2-5,7-9
         Lists bad words entries numbered 2 through 5 and
         7 through 9.
         
   The BADWORDS CLEAR command clears all entries of the
   bad words list.
  
  

• SAY
  

   Syntax: /msg BotServ  SAY channel text
   
   Makes the bot say the given text on the given channel.
  
  

• ACT
  

   Syntax: /msg BotServ  ACT channel text
   
   Makes the bot do the equivalent of a "/me" command
   on the given channel using the given text.
  
  

• SERVADMIN HELP
  

   
   The following command is available to Services admins:
   
       BOT              Maintains network bot list
  
  

• SERVADMIN BOT
  

   Syntax: /msg BotServ  BOT ADD nick user host real
           BOT CHANGE oldnick newnick [user [host [real]]]
           BOT DEL nick
           BOT LIST
   
   Allows Services admins to create, modify, and delete
   bots that users will be able to use on their own
   channels.
   
   BOT ADD adds a bot with the given nickname, username,
   hostname and realname. Since no integrity checks are done 
   for these settings, be really careful.
   BOT CHANGE allows to change nickname, username, hostname
   or realname of a bot without actually delete it (and all
   the data associated with it).
   BOT DEL removes the given bot from the bot list.  
   BOT LIST is an alias of BOTLIST and just lists all
   bots available on the network.
   
   Note: if you create a bot that has a nick that is 
   registered, it will be dropped. Also, if an user is
   currently using the nick, it will be killed.
  
  

• SERVADMIN SET
  

   
   These options are reserved to Services admins:
   
       NOBOT            Prevent a bot from being assigned to 
                           a channel
       PRIVATE          Prevent a bot from being assigned by
                           non IRC operators
  
  

• SERVADMIN SET NOBOT
  

   Syntax: /msg BotServ  SET channel NOBOT {ON|OFF}
   
   This option makes a channel be unassignable. If a bot 
   is already assigned to the channel, it is unassigned
   automatically when you enable the option.
   
   Limited to Services admins.
  
  

• SERVADMIN SET PRIVATE
  

   Syntax: /msg BotServ  SET bot-nick PRIVATE {ON|OFF}
   
   This option prevents a bot from being assigned to a
   channel by users that aren't IRC operators.
   
   Limited to Services admins.