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 /bs command.

For more information on a specific command, type /bs HELP command.

BotSERV's commands include:

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 1 user on it.

BOTLIST
Syntax: /bs BOTLIST

Lists command will list any and all network added service bots that are available on this network. Please note that this will not list private, hidden, or personal bots.

ASSIGN
Syntax: /bs 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: /bs 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: /bs 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: /bs 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 /bs HELP SET option for more information on a specific option. Note: access to this command is controlled by the level SET. Also, please set ChanSERV XOP command to OFF - /cs channel XOP OFF

SET DONTKICKOPS
Syntax: /bs 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: /bs 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: /bs 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: /bs 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: /bs 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: /bs KICK channel option parameters

Kick options can be any of the many listed below, also a more detailed description of each is listed slightly farther down the page: 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 /bs HELP KICK option for more information on a specific option. Note: access to this command is controlled by the level SET.

KICK BOLDS
Syntax: /bs 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: /bs 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: /bs 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: /bs 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: /bs 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: /bs 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: /bs 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: /bs 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 /bs 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: /bs BADWORDS channel ADD word SINGLE/START/END
Syntax: /bs BADWORDS channel DEL word/entry-num/list
Syntax: /bs BADWORDS channel LIST mask/list
Syntax: /bs 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 /bs HELP KICK BADWORDS. 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. BADWORDS DEL command removes the given word from the bad words list. If a list of entry numbers is given, those entries are deleted. 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. BADWORDS CLEAR - This clears all entries of the bad words list.

SAY
Syntax: /bs SAY channel text

Makes the bot say the given text on the given channel. Please note, that anyone caught using the say command for any reason found to be annouying, will be removed from the network.

ACT
Syntax: /bs ACT channel text

Makes the bot do the equivalent of a "/me" command on the given channel using the given text. Please note, that anyone caught using the act command for any reason found to be annouying, will be removed from the network.

SERVADMIN BOT
Syntax: /bs BOT ADD nick user host real
Syntax: /bs BOT CHANGE oldnick newnick user host real
Syntax: /bs 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 * commands are listed below: 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

Sets various BotSERV options. Options can be one of the two listed below, also a more detailed description of each is slightly farther down the page: 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: /bs 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: /bs SET bot-nick PRIVATE ON/OFF

This option turns a bot privacy on, which will prevent it from being assigned to a channel by users that are not IRC operators.