ChanServ

ChanServ Commands

Note: /cs may be substituted for /msg ChanServ in any command below. For example, /msg ChanServ ACCESS #channel add nick level would become /cs ACCESS #channel add nick level

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: /msg ChanServ ACCESS #channel 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: /msg ChanServ ACCESS #channel 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: /msg ChanServ ACCESS #channel 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. /msg ChanServ ACCESS #channel list 1-4,8-10 lists entries 1-4 and 8-10 on the access list)
• CLEAR: /msg ChanServ ACCESS #channel clear
  Clears all entires in the channel access list.

AUTOVOICE: Configures autovoice settings for a channel

• ALL: /msg ChanServ AUTOVOICE #channel all
  Automatically voices every user that enters a channel.
• REG: /msg ChanServ AUTOVOICE #channel reg
  Automatically voices every REGISTERED user that enters a channel.
• OFF: /msg ChanServ AUTOVOICE #channel off
  Disables autovoice.

AKICK: 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: /msg ChanServ AKICK #channel add mask 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: /msg ChanServ AKICK #channel 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: /msg ChanServ AKICK #channel 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: /msg ChanServ AKICK #channel 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: /msg ChanServ AKICK #channel 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: /msg ChanServ AKICK #channel 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: /msg ChanServ AKICK #channel enforce
  Causes ChanServ to enforce the current AKICK list by removing users in a channel that match an AKICK mask.
• CLEAR: /msg ChanServ AKICK #channel clear
  Clears all entries from the auto-kick 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: /msg ChanServ AOP #channel add nick
  Adds the specified nick to the AOP list.
• DEL: /msg ChanServ AOP #channel 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: /msg ChanServ AOP #channel 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. /msg ChanServ AOP #channel list 1-4,8-10 lists entries 1-4 and 8-10 on the AOP list)
• CLEAR: /msg ChanServ AOP #channel clear
  Clears all entries from the AOP list.

BAN: /msg ChanServ BAN #channel nick reason
Bans the specified nick on a channel. If a nick is not given, it will ban you. If channel and nick are not given, it will ban you on all channels you are on, provided you have the access to do so. Limited to AOPs or those with level 5 access or above on a channel.

CLEAR: Tells ChanServ to clear any of the following settings on a channel:

• MODES: /msg ChanServ CLEAR #channel modes
  Resets all modes on the specified channel.
• BANS: /msg ChanServ CLEAR #channel bans
  Clears all bans on the specified channel.
• OPS: /msg ChanServ CLEAR #channel ops
  Removes channel operator (+o) status from all channel operators
• VOICES: /msg ChanServ CLEAR #channel voices
  Removes voice (+v) from anyone with that mode set on a channel
• USERS: /msg ChanServ CLEAR #channel users
  Removes (kicks) all users from the specified channel. Limited to those with founder access on a channel.

DEHALFOP: /msg ChanServ DEHALFOP #channel nick
Dehalfops (-h) the specified nick on a channel. If a nick is not given, it will dehalfop you. If channel and nick are not given, it will dehalfop you on all channels you are on, provided you have the access to do so. Limited to AOPs or those with level 5 access and above, or to HOPs or those with level 4 access and above on the channel for self dehalfopping.

DEOP: /msg ChanServ DEOP #channel nick
Deops (-o) the specified nick on a channel. If a nick is not given, it will deop you. If channel and nick are not given, it will deop you on all channels you are on, provided you have the access to do so. Limited to AOPs or those with level 5 access and above on the channel.

DEOWNER: /msg ChanServ DEOWNER #channel
Removes your owner status (-q) on a channel. If a channel is not given, it will remove your owner status on all channels you are on, provided you have the access to do so. Limited to channel founders.

DEPROTECT: /msg ChanServ DEPROTECT #channel
Deprotects (-&) the specified nick on a channel. If a nick is not given, it will deprotect you. If channel and nick are not given, it will deprotect you on all channels you are on, provided you have the access to do so. Limited to channel founders, or SOPs or those with level 10 access and above on the channel for self deprotecting.

DEVOICE: /msg ChanServ DEVOICE #channel
Devoices (-v) the specified nick on a channel. If a nick is not given, it will devoice you. If channel and nick are not given, it will devoice you on all channels you are on, provided you have the access to do so. Limited to AOPs or those with level 5 access and above on the channel, or to VOPs or those with level 3 access and above on the channel for self devoicing.

DROP: /msg ChanServ DROP #channel
De-registers the specified channel. Limited to the channel founder.

GETKEY: /msg ChanServ GETKEY #channel
Returns the key for the specified channel. Mainly intended to be used by bots or scripts.

HALFOP: /msg ChanServ HALFOP #channel
Halfops (+h) the specified nick on a channel. If a nick is not given, it will halfop you. If channel and nick are not given, it will halfop you on all channels you are on, provided you have the access to do so. Limited to AOPs or those with level 5 access and above, or to HOPs or those with level 4 access and above on the channel for self halfopping.

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: /msg ChanServ HOP #channel add nick
  Adds the specified nick to the HOP list.
• DEL: /msg ChanServ HOP #channel 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: /msg ChanServ HOP #channel 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: /msg ChanServ HOP #channel clear
  Clears all entries from the HOP list.

IDENTIFY: /msg ChanServ IDENTIFY #channel password
Identifies you to ChanServ as the founder of a specified channel. This password is the same one provided with the REGISTER command when registering the channel.

INFO: /msg ChanServ INFO #channel all
Provides information about the specified channel, including its founder, time of registration, last time used, description, and mode lock. If the ‘all’ parameter is entered with the command, the entry message and successor will also be listed. The ‘all’ parameter is limited to those with founder access on the channel.

INVITE: /msg ChanServ INVITE #channel
Tells ChanServ to invite you into the specified channel. This is useful if you have been banned from a restricted channel that you have access in (if you tried to join the channel before identifying, for example). Limited to AOPs or those with level 5 access and above on the channel.

KICK: /msg ChanServ KICK #channel nick reason
Kicks a given nick on the specified channel. If a nick is not provided, it will kick you. If channel and nick are not given, it will kick you on all channels you are on, provided you have the access to do so. Limited to AOPs or those with level 5 access and above on the channel.

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 /cs help levels desc

• SET: /msg ChanServ LEVELS #channel set type level
  Allows the access level for a function of group of functions to be changed.
• DISABLE: /msg ChanServ LEVELS #channels [dis|disable] type
  Disables an automatic feature or disallows access to a function by anyone other than the channel founder.
• LIST: /msg ChanServ LEVELS #channel list
  Displays the current levels for each function or group of functions.
• RESET: /msg ChanServ LEVELS #channel reset
  Resets the levels to the default levels of a newly-created channel.

LOGOUT: /msg ChanServ LOGOUT #channel nick
Makes the specified nick no longer identified for the given channel. Channel founders can log anyone out of the channel, else, you can only log yourself out.

OWNER: /msg ChanServ OWNER #channel
Gives you owner status on the channel. If channel is not given, it will give you owner status on all channels you are on, provided you have the access to do so. Limited to those with founder access on the channel.

PROTECT: /msg ChanServ PROTECT #channel nick
Protects (+&) the specified nick on a channel. If nick is not given, it will protect you. If channel and nick are not given, it will protect you on all channels you are on, provided you have the access to do so. Limited to the channel founder, or to SOPs or those with level 10 access and above on the channel for self protecting.

REGISTER: /msg ChanServ REGISTER #channel password description
Registers a channel with ChanServ. Before using this command, you must have a registered nickname and also must join the channel you want to register and have channel operator status (+o or @) in the channel (which will happen automatically as long as no one else is in the channel). The ‘password’ parameter is a password that others can use to identify for the channel and make changes to channel settings at a later time. The ‘description’ parameter is a short description of the channel. Both the channel password and description can be changed at a later time (see SET PASSWORD and DESC).

SET: Allows the channel founder to set various channel options and change channel information:

• BANTYPE: /msg ChanServ SET #channel 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 from *!*user@*.domain
• DESC: /msg ChanServ SET #channel desc description
  Sets the description for the channel.
• EMAIL: /msg ChanServ SET #channel 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: /msg ChanServ SET #channel 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: /msg ChanServ SET #channel founder nick
  Changes the founder of the channel. The nick of the new founder must be registered.
• KEEPTOPIC: /msg ChanServ SET #channel 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: /msg ChanServ SET #channel 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:
  /msg ChanServ SET #channel 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.
  /msg ChanServ SET #channel 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”
  /msg ChanServ SET #channel mlock + – Removes the mode-lock; All modes are free to be on or off.
• OPNOTICE: /msg ChanServ SET #channel 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: /msg ChanServ SET #channel password password
  Set the password used to identify as the founder for a channel.
• PEACE: /msg ChanServ SET #channel 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: /msg ChanServ SET #channel 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: /msg ChanServ SET #channel 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: /msg ChanServ SET #channel 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: /msg ChanServ SET #channel 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: /msg ChanServ SET #channel 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: /msg ChanServ SET #channel 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: /msg ChanServ SET #channel 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: /msg ChanServ SET #channel 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: /msg ChanServ SET #channel 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: /msg ChanServ SET #channel 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.

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 above). 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: /msg ChanServ SOP #channel add nick
  Adds the specified nick to the SOP list.
• DEL: /msg ChanServ SOP #channel 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: /msg ChanServ SOP #channel 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. /msg ChanServ SOP #channel list 1-4,8-10 lists entries 1-4 and 8-10 on the SOP list)
• CLEAR: /msg ChanServ SOP #channel clear
  Clears all entries from the SOP list.

SYNC: /msg ChanServ SYNC #channel
Synchronizes the channel access list with the user list. This allows you make a change to the channel access list and update user statuses without having to set the status manually or have the user cycle the channel.

TOPIC: /msg ChanServ TOPIC #channel topic
Causes ChanServ to set the channel topic to the one specified in the ‘topic’ parameter. If the ‘topic’ parameter is not specified, then an empty topic is set. This command is especially useful with the SET TOPICLOCK command. Limited to those with founder access on the channel.

UNBAN: /msg ChanServ UNBAN #channel
Tells ChanServ to remove all bans preventing you from entering the specified channel. This is useful if you have been banned from a restricted channel that you have access in (if you tried to join the channel before identifying, for example). Limited to AOPs or those with level 5 access and above on the channel.

VOICE: /msg ChanServ VOICE #channel nick
Voices (+v) the specified nick on a channel. If a nick is not given, it will voice you. If channel and nick are not given, it will voice you on all channels you are on, provided you have the access to do so. Limited to AOPs or those with level 5 access and above, or to VOPs or those with level 3 access and above on the channel for self voicing.

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: /msg ChanServ VOP #channel add nick
  Adds the specified nick to the VOP list.
• DEL: /msg ChanServ VOP #channel 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: /msg ChanServ VOP #channel 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. /msg ChanServ VOP #channel list 1-4,8-10 lists entries 1-4 and 8-10 on the VOP list)
• CLEAR: /msg ChanServ VOP #channel clear
  Clears all entries from the VOP list.