- HELP
BotServ allows users to have added protection and
stability for established channels.
It is a Cservice Bot that is an add-on in addition
to ChanServ. It can sit in your channel and
enforce badwords, flood protection from capslock,
bolds, repeating and more! Cservice Bots are very
easy to customize for Channel Founders.
* Cservice Bots are unable to be deoped, kicked or
banned from a channel making them impervious to
"Channel Takeovers".
A list of commands is provided below; to use them,
type /BS command. For more information
on a specific command, type /BS HELP command.
- BOTLIST
Syntax: /BS BOTLIST
Lists all available bots on this network.
- ASSIGN
Syntax: /BS ASSIGN chan bot
Assigns the K9/Q/W/X/Z bot to the channel. It can then be
configured for the channel so it fits channel needs by the
channel founder. *Command restricted to Cservice Admins*
*CService Bots are automatically assigned to channels after
successful registration with ChanServ and will join
whenever there are 2 or more active users in the channel.
(Assignments are automated and subject to Services AUP
and Cservice Bot Guidelines)
- UNASSIGN
Syntax: /BS UNASSIGN chan
Unassigns K9/Q/W/X/Z 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 | 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 /BS HELP SET option for more information
on a specific option.
Note: access to this command is controlled by the
level SET.
- 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
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 /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 %RBotServ 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]
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 /BS 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: /BS SAY channel text
Makes the bot say the given text on the given channel.
- ACT
Syntax: /BS ACT channel text
Makes the bot do the equivalent of a "/me" command
on the given channel using the given text.
- SERVADMIN BOT
Syntax: /BS 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: /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 prevents a bot from being assigned to a
channel by users that aren't IRC operators.
[