BotServ Advanced Guide

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
 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 | bot) 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 BOT
 Syntax: /msg BotServ  BOT ADD nick user host real

         BOT CHANGE oldnick newnick [user [host [real]]]
         BOT DEL nick

 
 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.  

 
 Note: you cannot create a bot that has a nick that is
 currently registered. If an unregistered user is currently
 using the nick, they 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.

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.