BotServ

From MIXXnet Wiki

BotServ is a MIXXnet service that provides a bot to sit in your channel and perform extra functions.

BotServ Commands

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 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 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 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 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 CAPS

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 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.