Fantasy

Fantasy Commands

Fantasy commands are simplified, easier-to-remember commands that can be used for some common tasks in place of the typical BotServ, ChanServ, and NickServ commands. To use a fantasy command, just type it into the channel you wish to use it.

Note: unlike typical BotServ, ChanServ, and NickServ commands, fantasy commands will show up in the channel when you use them.

General Fantasy Commands

CMDLIST: !cmdlist
Displays available fantasy commands.

HELP: !help command
Displays help for fantasy commands. If a certain command is specified, it will display help related to that particular command.

INFO: !info
Displays basic information about the channel

IRCOPS: !ircops
Displays a list of all global IRCOps that are currently online.

SEEN: !seen nick
Shows when the specified nick was last seen online.

STAFF: !staff
Displays a list of all global IRCOps that are currently online.

Access Fantasy Commands

SOP: Maintains the AutoSOP list for a channel. When on this list, users will automatically receive Super Operator status (channel operator plus protection) upon entering the channel. The SOP system will only work if xOP is turned on (see SET XOP below). The SOP list gives users all rights given by the AOP list, and adds those needed to use the Auto Kick and the Bad Words lists, to send and read channel memos, etc. The SOP ADD, SOP DEL and SOP CLEAR commands are limited to the channel founder. The SOP LIST command may be used by any user on the AOP list.

ADD: !sop add nick
Adds the specified nick to the SOP list.
DEL: !sop del [nick|entry-num|list]
Removes the specified nick from the SOP list. The ‘entry-num’ parameter removes the nick based on it’s corresponding number in the SOP list. The ‘list’ parameter removes multiple nicks based on their corresponding entry numbers in the list. See LIST below for more information.
LIST: !sop list [mask|list]
Displays the channel SOP list. The ‘mask’ parameter only displays the entries that match the mask. The ‘list’ parameter only shows the entries for a given list. (Ex. !sop list 1-4,8-10 lists entries 1-4 and 8-10 on the SOP list)
CLEAR: !sop clear
Clears all entries from the SOP list.

AOP:Maintains the AutoOP list for a channel. When on this list, users will automatically receive channel operator status upon entering the channel. The AOP system will only work if xOP is turned on (see SET XOP below). The AOP ADD and AOP DEL commands are only available to SOPs and above. The AOP CLEAR command is only available for the channel founder.

ADD: !aop add nick
Adds the specified nick to the AOP list.
DEL: !aop del [nick|entry-num|list]
Removes the specified nick from the AOP list. The ‘entry-num’ parameter removes the nick based on it’s corresponding number in the AOP list. The ‘list’ parameter removes multiple nicks based on their corresponding entry numbers in the list. See LIST below for more information.
LIST: !aop list [mask|list]
Displays the channel AOP list. The ‘mask’ parameter only displays the entries that match the mask. The ‘list’ parameter only shows the entries for a given list. (Ex. !aop list 1-4,8-10 lists entries 1-4 and 8-10 on the AOP list)
CLEAR: !aop clear
Clears all entries from the AOP list.

HOP:Maintains the AutoHOP list for a channel. When on this list, users will automatically receive channel half-operator status upon entering the channel. The HOP system will only work if xOP is turned on (see SET XOP below). The HOP ADD, HOP DEL, and HOP LIST commands are only available to AOPs and above. The HOP CLEAR command is only available for the channel founder.

ADD: !hop add nick
Adds the specified nick to the HOP list.
DEL: !hop del [nick|entry-num|list]
Removes the specified nick from the HOP list. The ‘entry-num’ parameter removes the nick based on it’s corresponding number in the HOP list. The ‘list’ parameter removes multiple nicks based on their corresponding entry numbers in the list. See LIST below for more information.
LIST: !hop list [mask|list]
Displays the channel HOP list. The ‘mask’ parameter only displays the entries that match the mask. The ‘list’ parameter only shows the entries for a given list. (Ex. /msg ChanServ HOP #channel list 1-4,8-10 lists entries 1-4 and 8-10 on the HOP list)
CLEAR: !hop clear
Clears all entries from the HOP list.

VOP: Maintains the AutoVOP list for a channel. When on this list, users will automatically receive voice upon entering the channel. The VOP system will only work if xOP is turned on (see SET XOP above). The VOP ADD, VOP DEL and VOP LIST commands are limited to AOPs or above. The VOP CLEAR command may only be used by the channel founder.

ADD: !vop add nick
Adds the specified nick to the VOP list.
DEL: !vop del [nick|entry-num|list]
Removes the specified nick from the VOP list. The ‘entry-num’ parameter removes the nick based on it’s corresponding number in the SOP list. The ‘list’ parameter removes multiple nicks based on their corresponding entry numbers in the list. See LIST below for more information.
LIST: !vop list [mask|list]
Displays the channel VOP list. The ‘mask’ parameter only displays the entries that match the mask. The ‘list’ parameter only shows the entries for a given list. (Ex. !vop list 1-4,8-10 lists entries 1-4 and 8-10 on the VOP list)
CLEAR: !vop clear
Clears all entries from the VOP list.

ACCESS: Maintains the access list for a channel. The access list stores user access levels (voice (3), halfop (4), op (5), protection (10), co-owner (9999)) on a channel. When a user is not on the access list, they are level 0.

ADD: !access add nick level
Adds the specified nickname to the specified channel’s access list at the given level. If the nickname already exists on the access list, its access level is changed to the one specified in the command. The access level specified must be less than that of the user giving the command, and if the nick is already on the access list, the current access level of that nick must be less than the access level of the user giving the command.
DEL: !access del [nick|entry-num|list]Removes the specified nick from the access list. The ‘entry-num’ parameter removes the nick based on it’s corresponding number in the access list. The ‘list’ parameter removes multiple nicks based on their corresponding entry numbers in the list. See LIST below for more information.
LIST: !access list [mask|list]
Displays the channel access list. The ‘mask’ parameter only displays the entries that match the mask. The ‘list’ parameter only shows the entries for a given list. (Ex. !access list 1-4,8-10 lists entries 1-4 and 8-10 on the access list)
CLEAR: !access clear
Clears all entires in the channel access list.

LEVELS: Allows fine control over the meaning of the numeric access levels used for channels. This command allows you to define the access level required for most of ChanServ’s functions. For more information, type !help levels

SET: !levels set type level
Allows the access level for a function of 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
Displays the current levels for each function or group of functions.
RESET: !levels reset
Resets the levels to the default levels of a newly-created channel.

Channel Setting Fantasy Commands

AKICK: !akick nick
Maintains the auto-kick list for a channel. If a user on the AKICK list tries to enter the channel, the user will be banned and kicked.

ADD: !akick add [mask|user] reason
Adds the specified mask to the auto-kick list. If the ‘reason’ parameter is specified, that reason will be used when the user is kicked. If not specified, the default reason is “You have been banned from the channel”.
STICK: !akick stick mask
Permanently bans the specified mask on the channel. If someone attempts to remove the ban, ChanServ will automatically set it again. Does not work for registered nicks.
UNSTICK: !akick unstick mask
Removes the AKICK STICK on the specified mask. Once the mask is unstick, you will be able to remove the ban from the channel.
DEL: !akick del mask
Removes the specified mask from the auto-kick list. This does not remove any bans set by an auto-kick; Those will need to be removed manually.
LIST: !akick list mask
Displays the auto-kick list. If a mask is specified, the results will only show AKICK entries matching that mask. If no mask is specified, all AKICK entries will be listed.
VIEW: !akick view mask
Displays the auto-kick list. This command will do the same thing and works the same way as the LIST command above.
ENFORCE: !akick enforce
Causes ChanServ to enforce the current AKICK list by removing users in a channel that match an AKICK mask.
CLEAR: !akick clearClears all entries from the auto-kick list.
Clears all entries from the auto-kick list.

BADWORDS: Maintains the bad words list for a given channel, which determines which bad words the bot will kick for. See KICK section below to enable kick for bad words.

ADD: !badwords add word [single|start|end|any]
Adds the specified word to the badword list. The ’single’ parameter tells the bot to kick if the entire word is said. The ’start’ parameter tells the bot to kick if a word is said that starts with the added word. The ‘end’ parameter tells the bot to kick if a word is said that ends with the added word. If no parameter is specified, the bot will kick anytime the word is said.
DEL: !badwords del [word|entry-num|list]
Removes the specified word from the badword list. The ‘word’ parameter removes the word based on the word itself. The ‘entry-num’ parameter removes the word based on it’s corresponding number in the badword list. The ‘list’ parameter removes multiple words based on their corresponding entry numbers in the list. See LIST below for more information.
LIST: !badwords list [mask|list]
Displays bad words list. The ‘mask’ parameter only displays the entries that match the mask. The ‘list’ parameter only shows the entries for a given list. (Ex. !badwords list 1-4,8-10 lists bad words 1-4 and 8-10 on the bad words list)
CLEAR: !badwords clear
Clears all entries in the bad words list.

SET: Provides access to the ChanServ and BotServ SET commands. Allows the channel founder to set various channel and BotServ options.

ChanServ options available are:

BANTYPE: !set bantype type
Sets the default ban type used by services whenever they need to ban someone from your channel. The parameter ‘type’ is a number from 0-3 that means the following:
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.
EMAIL: !set email email-address
Associates the given email address with the channel. The address will be displayed on the returned channel information when the INFO command is used. If the “email-address” parameter is not provided, any current email address associated with the channel will be deleted.
ENTRYMSG: !set entrymsg message
Sets the message that will be sent to users via /notice when they enter the channel. If the ‘message’ parameter is not specified, no message will be set or the current message will be deleted.
FOUNDER: !set founder nick
Changes the founder of the channel. The nick of the new founder must be registered.
KEEPTOPIC: !set keeptopic [on|off]
Enables or disables topic retention for a channel. With topic retention enabled, 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 used.
MLOCK: !set mlock modes
Sets the mode-lock parameter for the channel. This is used to make sure that certain channel modes stay always on, always off, or free to be on or off, even if the channel had been empty. For example:
!set mlock +nt-iklps – Forces modes n and t on, modes i,k,l,p, and s off, and allows mode m free to be either on or off.
!set mlock +knst-ilmp secret-key – Forces modes k,n,s, and t on, modes i,l,m, and p off, and forces the channel key to be “secret-key”
!set mlock + – Removes the mode-lock; All modes are free to be on or off.
OPNOTICE: !set opnotice [on|off]
Enables or disables the op-notice option for a channel. When enabled, 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
Set the password used to identify as the founder for a channel.
PEACE: !set peace [on|off]
Enables or disables the peace option for a channel. When enabled, a user won’t be able to kick, ban, or remove channel status of an user that has a level superior or equal to his using ChanServ commands.
PRIVATE: !set private [on|off]
Enables or disables the private option for a channel. When enabled, the channel will not be displayed in any channel lists.
RESTRICTED: !set restricted [on|off]
Enables or disables the restricted option for a channel. When enabled, 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 identified 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 securefounder option for a channel. When enabled, only the real founder will be able to drop the channel, change its password, change its founder, and change its successor, and not those who are identified to ChanServ for the channel.
SECUREOPS: !set secureops [on|off]
Enables or disables secureops for a channel. When enabled, users who are not on the userlist will not be allowed channel operator status.
SIGNKICK: !set signkick [on|level|off]
Enables or disables signed kicks for a channel. When SIGNKICK is enabled, kicks issued with the ChanServ KICK command will have the nick that used the command in their reason. If you use the ‘level’ parameter, those who have a level that is superior or equal to the SIGNKICK level on the channel won’t have their kicks signed.
SUCCESSOR: !set successor nick
Changes the successor of a channel. If the channel 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, the channel will be dropped instead, just as if no successor had been set. The new successor’s nickname must be registered.
TOPICLOCK: !set topiclock [on|off]
Enables or disables the topic lock option for a channel. When enabled, 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. The URL will be displayed on the returned channel information when the INFO command is used. If the ‘url’ parameter is not provided, any current URL associated with the channel will be deleted.
XOP: !set xop [on|off]
Enables or disables the XOP lists system for a channel. When XOP is enabled, you have to use the SOP/AOP/HOP/VOP commands in order to give channel privileges to users. When XOP is disabled, you have to use the ACCESS command. Note: when you switch from the access list system to the XOP lists system, your level definitions and user levels will be changed. For example: if you have multiple owners (level 9999) set with the access level system then switch back to XOP lists, problems may arise because the XOP lists system does not support multiple owners. Switching from the XOP lists system to the access list system will not cause any issues, though.

BotServ options available are:

DONTKICKOPS: !set dontkickops [on|off]
Enables or disables op protection mode on a channel. When enabled, ops won’t be kicked by the bot, even if they don’t match the NOKICK level. On by default.
DONTKICKVOICES: !set dontkickvoices [on|off]
Enables or disables voices protection mode on a channel. When enabled, voices won’t be kicked by the bot, even if they don’t match the NOKICK level. On by default.
GREET: !set greet [on|off]
Enables or disables greet messages on a channel. When 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 enabled, users will be able to use fantasy commands such as !op, !deop, !voice, !devoice, !kick, !kb, !unban, and !seen. Note that some fantasy commands (such as !op) will only work provided the user has enough access in the channel. On by default. 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 enabled, the bot will do everything normally done by ChanServ (MODEs, KICKs, and entry message) on a channel. On by default.

BKICK: Configures bot kickers. Options available are:

BOLDS: !bkick bolds [on|off] ttb
Sets the bold kicker on or off. When enabled, the bot will kick users who use bold. ttb is the number of times a user can be kicked before being banned. If no ttb is given, the kicker will not ban.
BADWORDS: !bkick badwords [on|off] ttb
Sets the bad words kicker on or off. When enabled, the bot will kick users who use bad words that are added to the bad words list. See the BADWORDS command above for adding bad words to the list. ttb is the number of times a user can be kicked before being banned. If no ttb is given, the kicker will not ban.
CAPS: !bkick caps [on|off] ttb [min [percent]]
Sets the caps kicker on or off. When enabled, the bot will kick users who are typing in caps. The bot will kick if there are at least min caps and they constitute at least % of a text line. When ‘min’ and ‘percent’ are not specified, the default is 10 characters and 25%. ttb is the number of times a user can be kicked before being banned. If no ttb is given, the kicker will not ban.
COLORS: !bkick colors [on|off] ttb
Sets the colors kicker on or off. When enabled, the bot will kick users who are using colors. ttb is the number of times a user can be kicked before being banned. If no ttb is given, the kicker will not ban.
FLOOD: !bkick flood [on|off] ttb [ln [secs]]
Sets the flood kicker on or off. When enabled, the bot will kick users who are flooding with at least ‘ln’ lines in ’secs’ seconds. When ‘ln’ and ’secs’ are not specified, the default is 6 lines in 10 seconds. ttb is the number of times a user can be kicked before being banned. If no ttb is given, the kicker will not ban. See MODE +f in ChanServ Commands for more advanced flood protection.
REPEAT: !bkick repeat [on|off] ttb [num]
Sets the repeat kicker on or off. When enabled, the bot will kick users who are repeating themselves ‘num’ of times. When ‘num’ is not specified, the default is 3 times. ttb is the number of times a user can be kicked before being banned. If no ttb is given, the kicker will not ban.
REVERSES: !bkick reverses [on|off] ttb
Sets the reverses kicker on or off. When enabled, the bot will kick users who are using reverses. ttb is the number of times a user can be kicked before being banned. If no ttb is given, the kicker will not ban.
UNDERLINES: !bkick underlines [on|off] ttb
Sets the underlines kicker on or off. When enabled, the bot will kick users who are using underlines. ttb is the number of times a user can be kicked before being banned. If no ttb is given, the kicker will not ban.

Channel Action Fantasy Commands

TOPIC: !topic message
Replaces the channel’s current topic with the specified message.

TAPPEND: !tappend message
Appends the specified message to the end of the topic.

INVITE: !invite nick
Invites the specified user into the channel.

UP: !up nick
Gives the user the modes he or she 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 the specified 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 channel’s settings matches it, the command is aborted before anyone is kicked or banned. You can also 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 channel’s 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>. ( Ex. !tkb Dan 10m Please do not spam. will kickban Dan for 10 minutes due to spamming.

Channel Modes Fantasy Commands

BAN: !ban [nick|mask]
Bans the specified user(s)/mask from the channel without kicking.

UNBAN: !unban [nick|mask]
Removes the ban on the specified user(s)/mask.

MUTE: !mute [nick|mask]
Mutes the specified user(s)/mask from the channel without kickin.

UNMUTE: !unmute [nick|mask]
Removes the mute on the specified user(s)/mask.

OP: !op nick
Op yourself or the specified user.

DEOP: !deop nick
Deop yourself or the specified user.

HALFOP: !halfop nick
Halfop yourself or the specified user.

DEHALFOP: !dehalfop nick
Dehalfop yourself or the specified user.

VOICE: !voice nick
Voice yourself or the specified user.

DEVOICE: !devoice nick
Devoice yourself or the specified user.

PROTECT: !protect nick
Protect yourself or the specified user.

DEPROTECT: !deprotect nick
Deprotect yourself or the specified user.

OWNER: !owner nick
Owner yourself or the specified user.

DEOWNER: !deowner nick
Deowner yourself or the specified user.