BotServ
| It has been suggested that this page or section should be merged with IRC_services. (Discuss) After merging please change the content of this page to #REDIRECT [[IRC_services]] |
Contents |
BotServ
BotServ is an IRC Services module that is primarily used for channel management, much like ChanServ. While on most large networks (including freenode where #shellium is located) BotServ is disabled, it can be found on many smaller networks. The purpose of BotServ is to have a bot in a channel who can respond to "fantasy" commands, such as !kick <user>, !ban <user> <reason> and more. BotServ is really of no use, as anything it can do can be done by ChanServ, to some extent.
Commands
The commands available in BotServ depend on services package the network is using, and on how it's configured. They're outlined below; more help can be found by typing /msg botserv help. To find out what package is used at a network, "/ctcp NickServ version" output may be very helpful.
Anope services
- 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 user bots. 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. Type /msg BotServ HELP SET option for more information on a specific option.
- 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.
- 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. 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.
- 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.
- 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.
- 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.
- 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%%).
- 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).
- 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).
- 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.
- BADWORDS Syntax:
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.
- 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.
ttb is the number of times a user can be kicked before it get banned. Don't give ttb to disable the ban system once activated.
Atheme services
Atheme is the services package used at freenode. However, partly due to the large size of the network, and huge amount of text that needs to be "scanned" while looking for users' commands to the bot, BotServ isn't available at freenode.
- ACT Makes the bot do the equivalent of a "/me" command on the given channel using the given text. Syntax: ACT <chan> <text> Examples: /msg BotServ ACT #help yawns!
- ASSIGN 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. Syntax: ASSIGN <chan> <nick> Examples: /msg BotServ ASSIGN #help Security
- BOTLIST Lists all available bots on this network. Syntax: BOTLIST Examples: /msg BotServ BOTLIST
- INFO INFO allows you to see BotServ information about a channel or a bot. Syntax: INFO <#channel|botnick>
- SAY Makes the bot say the given text on the given channel. Syntax: SAY <chan> <text> Examples: /msg BotServ SAY #help Welcome to #help!
- SET FANTASY Enables or disables fantasy mode on a channel. When it is enabled, users will be able to use all chanserv commands like !op, !deop, !voice, !devoice, !kick, !kb, !unban, !akick, !info on a channel. Syntax: SET <#channel> FANTASY {ON|OFF} Examples: /msg BotServ SET #help FANTASY ON
- SET NOBOT 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. Syntax: SET <#channel> NOBOT {ON|OFF} Examples: /msg BotServ SET #help NOBOT ON
- SET PRIVATE' This option prevents a bot from being assigned to a channel by users that do not have chan:admin privilege. Syntax: SET <botnick> PRIVATE {ON|OFF} Examples: /msg BotServ SET Security PRIVATE ON
- UNASSIGN 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 having to reconfigure it entirely. Syntax: UNASSIGN <chan> Examples: /msg BotServ UNASSIGN #help