Fantasy Commands Part 1

Fantasy Commands allow you to use simpler, easier to remember, commands in place of the most commonly used ChanServ, BotServ, and NickServ Commands.

Available commands are listed below; to use them, simple type the command in your chat channel. For more information on a specific command, type !help command.

Commands are indexed alphabetically. Examples of the actual commands that you can copy, paste, and send are listed in italics. A description of the command follows the command. Underlined words in the command are variables that need to be changed to send the command correctly. For example #channel should be changed to your channel's name, Nick is your nick or the nick of the user, Text might be the message you want to be displayed. These can vary by command and will be explained in the command's description that follows. Variables inside curly braces like {ON|OFF} are selections that require one of the options inside the curly braces to be specified.

General Commands:

HELP: !help command
Display the online help for commands. If a command is provided it will give you more information on the specified command.
CMDLIST: !cmdlist
Shows available fantasy commands. (!help is more useful for explanations, this is more useful to see the commands available.)
IRCOPS: !ircops
Shows a list of all available global IRCOps.
STAFF: !staff
Shows a list of all available global IRCOps.
INFO: !info
Shows a list of all available global IRCOps.

Access Control Commands:

SOP:
Provides access to the SOP list. The SOP list gives users all rights given by the AOP list, and adds those needed to use the AutoKick and the BadWords lists, to send and read channel memos, and so on.
(This command may have been disabled for your channel, and in that case you need to use the access list. See ACCESS for information about the access list, and XOP to know how to toggle between the access list and XOP list systems.)

ADD: !sop add nick
Adds specified nick to the SOP list.
DEL: !sop del {nick|entry-num|list}
Deletes specified nick from the SOP list.
LIST: !sop list {mask|list}
Lists nicks on SOP list by in whole or by mask.
CLEAR: !sop clear
Clears out SOP list.
AOP:
Provides access to the AOP list. The AOP list gives users the right to be auto-opped on your channel and to unban or invite themselves.
(This command may have been disabled for your channel, and in that case you need to use the access list. See ACCESS for information about the access list, and XOP to know how to toggle between the access list and XOP list systems.)

ADD: !aop add nick
Adds specified nick to the AOP list.
DEL: !aop del {nick|entry-num|list}
Deletes specified nick from the AOP list.
LIST: !aop list {mask|list}
Lists nicks on AOP list by in whole or by mask.
CLEAR: !aop clear
Clears out AOP list.
HOP:
Provides access to the HOP list. The HOP list gives users the right to be auto-hopped on your channel and to unban or invite themselves.
(This command may have been disabled for your channel, and in that case you need to use the access list. See ACCESS for information about the access list, and XOP to know how to toggle between the access list and XOP list systems.)

ADD: !hop add nick
Adds specified nick to the HOP list.
DEL: !hop del {nick|entry-num|list}
Deletes specified nick from the HOP list.
LIST: !hop list {mask|list}
Lists nicks on HOP list by in whole or by mask.
CLEAR: !hop clear
Clears out HOP list.
VOP:
Provides access to the VOP list. The VOP list allows users to be auto-voiced and to voice themselves if they aren't.
(This command may have been disabled for your channel, and in that case you need to use the access list. See ACCESS for information about the access list, and XOP to know how to toggle between the access list and XOP list systems.)

ADD: !vop add nick
Adds specified nick to the VOP list.
DEL: !vop del {nick|entry-num|list}
Deletes specified nick from the VOP list.
LIST: !vop list {mask|list}
Lists nicks on VOP list by in whole or by mask.
CLEAR: !vop clear
Clears out VOP list.
ACCESS:
Provides access to the ACCESS list. The access list specifies which users are allowed chanop status or access to commands on the channel.
(This command may have been disabled for your channel, and in that case you need to use the XOP list. See ACCESS for information about the access list, and XOP to know how to toggle between the access list and XOP list systems.)

ADD: !access add nick
Adds specified nick to the ACCESS list.
DEL: !access del {nick|entry-num|list}
Deletes specified nick from the ACCESS list.
LIST: !access list {mask|list}
Lists nicks on ACCESS list by in whole or by mask.
CLEAR: !access clear
Clears out ACCESS list.
LEVELS:
Provides access to the LEVELS list. The LEVELS command allows fine control over the meaning of the numeric access levels used for the channel. With this command, you can define the access level required for most administrative functions.
(This command may have been disabled for your channel, and in that case you need to use the XOP list. See ACCESS for information about the access list, and XOP to know how to toggle between the access list and XOP list systems.)

SET: !levels set type level
Allows the access level for a function or group of functions to be changed. DISABLE: !levels disable type
Disables an automatic feature or disallows access to a function by anyone other than the channel founder.
LIST: !levels list
Shows the current levels for each function or group of functions.
RESET: !levels reset
Clears out LEVELS list.
Channel Setting Commands:
AKICK: !akick nick
Provides access to the AKICK list. If a user on the Auto Kick list attempts to join the channel, ChanServ will ban that user from the channel, then kick the user.
ADD: !akick add {mask|user} reason
Adds specified mask or host to the AKICK list.
STICK: !akick stick mask
Permanently bans the given mask on the channel. If someone tries to remove the ban, ChanServ will automatically set it again. You can't use it for registered nicks.
UNSTICK: !akick unstick mask
Cancels the effect of the AKICK STICK command, so you'll be able to unset the ban again on the channel.
DEL: !akick del mask
Deletes specified nick from the AKICK list.
LIST: !akick list mask
Lists all masks or users on AKICK list in whole or by mask.
VIEW: !akick view mask
The AKICK VIEW command is a more verbose version of AKICK LIST command.
ENFORCE: !akick enforce
Causes ChanServ to enforce the current AKICK list by removing those users who match an AKICK mask.
CLEAR: !akick clear
Clears out AKICK list.
BADWORDS:
Provides access to the BADWORDS list. (The bad words list determines which words are to be kicked when the bad words kicker is enabled.We strongly recommend you don't enable this feature, use /mode #channel +G instead.)


ADD: !badwords add add word {SINGLE|START|END|ANY}
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.
DEL: !badwords del {word|entry-number|list}
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.)
LIST: !badwords list {mask|list}
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.
CLEAR: !badwords clear
The BADWORDS CLEAR command clears all entries of the bad words list.
SET:
Provides access to the ChanServ SET and BotServ SET commands. Allows the channel founder to set various channel and botserv options and other information.

ChanServ options available are:

BANTYPE: !set bantype Type
Sets the ban type that will be used by services whenever they need to ban someone from your channel.
Type is a number between 0 and 3 that means:
0: ban in the form *!user@host
1: ban in the form *!*user@host
2: ban in the form *!*@host
3: ban in the form *!*user@*.domain
DESC: !set desc description
Sets the description for the channel, which shows up with the LIST and INFO commands.
EMAIL: !set email address
Associates the given E-mail address with the channel. This address will be displayed whenever someone requests information on the channel with the INFO command. If no parameter is given, deletes any current E-mail address for the channel.
ENTRYMSG: !set entrymsg message
Sets the message which will be sent via /notice to users when they enter the channel. If no parameter is given, causes no message to be sent upon entering the channel.
FOUNDER: !set founder nick
Changes the founder of a channel. The new nickname must be a registered one.
KEEPTOPIC: !set keeptopic {ON|OFF}
Enables or disables the topic retention option for a channel. When topic retention is set, the topic for the channel will be remembered by ChanServ even after the last user leaves the channel, and will be restored the next time the channel is created.
MLOCK: !set mlock modes
Sets the mode-lock parameter for the channel. ChanServ allows you to define certain channel modes to be always on, off or free to be either on or off.
The modes parameter is constructed exactly the same way as a /mode command; that is, modes followed by a + are locked on, and modes followed by a - are locked off. Note, however, that unlike the /mode command, each use of SET MLOCK will remove all modes previously locked before setting the new!
Warning: If you set a mode-locked key, as in the second example below, you should also set the RESTRICTED option for the channel (see /msg chanserv help set restricted), or anyone entering the channel when it is empty will be able to see the key!
Examples:
!set mlock +nt-iklps
Forces modes n and t on, and modes i, k, l, p, and s off. Mode m is left free to be either on or off.
!set mlock +knst-ilmp my-key
Forces modes k, n, s, and t on, and modes i, l, m, and p off. Also forces the channel key to be "my-key".
!set mlock +
Removes the mode lock; all channel modes are free to be either on or off.
OPNOTICE: !set opnotice {ON|OFF}
Enables or disables the op-notice option for a channel. When op-notice is set, ChanServ will send a notice to the channel whenever the OP or DEOP commands are used for a user in the channel.
PASSWORD: !set password password
Sets the password used to identify as the founder of the channel.
PEACE: !set peace {ON|OFF}
Enables or disables the peace option for a channel. When peace is set, an user won't be able to kick, ban or remove a channel status of an user that has a level superior or equal to his via ChanServ commands.
PRIVATE: !set private {ON|OFF}
Enables or disables the private option for a channel. When private is set, a /msg chanserv LIST will not include the channel in any lists.
RESTRICTED: !set restricted {ON|OFF}
Enables or disables the restricted access option for a channel. When restricted access is set, users who would normally be disallowed from having channel operator privileges (users with negative access levels and, if secure ops is set, users not on the access list) will instead be kicked and banned from the channel.
SECURE: !set secure {ON|OFF}
Enables or disables ChanServ's security features for a channel. When SECURE is set, only users who have registered their nicknames with NickServ and IDENTIFY'd with their password will be given access to the channel as controlled by the access list.
SECUREFOUNDER: !set securefounder {ON|OFF}
Enables or disables the secure founder option for a channel. When secure founder is set, only the real founder will be able to drop the channel, change its password, its founder and its successor, and not those who are IDENTIFY'd with ChanServ.
SECUREOPS: !set secureops {ON|OFF}
Enables or disables the secure ops option for a channel. When secure ops is set, users who are not on the userlist will not be allowed chanop status.
SIGNKICK: !set signkick {ON | LEVEL | OFF}
Enables or disables signed kicks for a channel. When SIGNKICK is set, kicks issued with ChanServ KICK command will have the nick that used the command in their reason.
If you use LEVEL, those who have a level that is superior or equal to the SIGNKICK level on the channel won't have their kicks signed. See /msg chanserv help levels for more information.
SUCCESSOR: !set successor nick
Changes the successor of a channel. If the founder's nickname expires or is dropped while the channel is still registered, the successor will become the new founder of the channel. However, if the successor already has too many channels registered (20), the channel will be dropped instead, just as if no successor had been set. The new nickname must be a registered one.
TOPICLOCK: !set topiclock {ON|OFF}
Enables or disables the topic lock option for a channel. When topic lock is set, ChanServ will not allow the channel topic to be changed except via the TOPIC command.
URL: !set url url
Associates the given URL with the channel. This URL will be displayed whenever someone requests information on the channel with the INFO command. If no parameter is given, deletes any current URL for the channel.
XOP: !set XOP {ON|OFF}
Enables or disables the XOP lists system for a channel. When XOP is set, you have to use the AOP/SOP/VOP commands in order to give channel privileges to users, else you have to use the ACCESS command.
Technical Note: when you switch from access list to XOP lists system, your level definitions and user levels will be changed, so you won't find the same values if you switch back to access system!
You should also check that your users are in the good XOP list after the switch from access to XOP lists, because the guess is not always perfect... in fact, it is not recommended to use the XOP lists if you changed level definitions with the LEVELS command.
Switching from XOP lists system to access list system causes no problem though.

BotServ options available are:

DONTKICKOPS: !set 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. On by default, off not recommended.
DONTKICKVOICES: !set 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. On by default, off not recommended.
GREET: !set 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. Off by default.
FANTASY: !set 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 fantasist 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.) On by default, off not recommended. IMPORTANT: Disabling this will disable all fantasy commands on this channel so re-enabling will have to be done through botserv.

SYMBIOSIS: !set symbiosis {on|off}
Enables or disables symbiosis mode on a channel. When it is enabled, the bot will do everything normally done by ChanServ on channels, such as MODEs, KICKs, and even the entry message. On by default, off not recommended.
BKICK: Configures bot kickers.Options available are:

BOLDS: !bkick 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. We strongly recommend you don't enable this feature, use /mode #channel +U instead.

BADWORDS: !bkick badwords {on|off} ttb
Sets the Badwords 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. We strongly recommend you don't enable this feature, use /mode #channel +G instead.

CAPS: !bkick 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.
COLORS: !bkick 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.We strongly recommend you don't enable this feature, use /mode #channel +U instead.
FLOOD: !bkick 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. We strongly recommend you don't enable this feature, instead use our much improved Flood Protection. Please see the FAQ topic, How do I enabled Flood Protection for more information.
REPEAT: !bkick 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.
REVERSES: !bkick 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. We strongly recommend you don't enable this feature, use /mode #channel +U instead.
UNDERLINES: !bkick 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. We strongly recommend you don't enable this feature, use /mode #channel +U instead.
Channel Action Commands:

CLEAR: !clear {modes|bans|excepts|invites|ops|hops|voices|users}
Clears the specified option on the channel.
TOPIC: !topic message
Replaces the channel's current topic with the message submitted.
TAPPEND: !tappend message
Tacks on the message submitted to the end of the topic.
INVITE: !invite nick
Invites specified user into the channel.
UP: !up nick
Gives the user the modes he has rights to.
DOWN: !down nick
Unsets all modes. If the channel is moderated, it will reset voice, unless issued on another user by a founder. Note: A nick can only be specified by the founder of the channel.
KICK: !kick nick
Kick a user from the channel.
KB: !kb {nick|mask} reason
This will kick and ban the specified user or all users matching the given mask from the channel. If a mask is given and someone who should not be kicked according to the channels' settings matches it, the command is aborted before anyone is kicked or banned. (Kick and ban multiple users by inserting a space between their nicks.)
TKB: !tkb {nick|mask} time reason
This will kick and temporary ban the specified user or all users matching the given mask from the channel for the specified amount of time. If a mask is given and someone who should not be banned according to the channels' settings matches it, the command is aborted before anyone is kicked. Also be aware that this command may not work with IPs for privacy reasons. If the time is not given or is invalid, it will default to 1 hour. The time should be given in the format <(s)/m/h/d>. Example: !tkb Viper 10m Bye which will kickban me for 10 minutes.

Channel Modes Commands:
BAN: !ban {nick|mask}
Bans (a) user(s)/mask from the channel without kicking
UNBAN: !unban {nick|mask}
Removes the ban on a user.
MUTE: !mute {nick|mask}
Mutes (a) user(s)/mask from the channel without kicking
UNMUTE: !unmute {nick|mask}
Removes the mute on a user.
OP: !op nick
Op yourself or another user.
DEOP: !deop nick
Deop yourself or another user.
HALFOP: !halfop nick
HalfOp yourself or another user.
DEHALFOP: !dehalfop nick
DeHalfOp yourself or another user.
VOICE: !voice nick
Voice yourself or another user.
DEVOICE: !devoice nick
Devoice yourself or another user.
PROTECT: !protect nick
Protect yourself or another user.
DEPROTECT: !deprotect nick
Deprotect yourself or another user.
OWNER: !owner nick
Owner yourself or another user.
DEOWNER: !deowner nick
Deowner yourself or another user.