ChanServ Help

ChanServ allows you to register and control various aspects of channels. ChanServ can often prevent

malicious users from "taking over" channels by limiting who is allowed channel operator priviliges. ChanServ's commands are listed below; to use them, type /msg ChanServ <command>. For more information on a specific command, type /msg ChanServ help command.

REGISTER Register a channel

IDENTIFY Identify yourself with your password

SET Set channel options and information

ACCESS Modify the list of privileged users

AKICK Maintain the AutoKick list

DROP Cancel the registration of a channel

Other commands: INFO, LIST, INVITE, OP, DEOP

Note that any channel which is not used for two weeks

(i.e. which no user on the channel's access list enters

for that period of time) will be automatically dropped.

Syntax:AKICK channel ADD mask [reason]

The AKICK ADD command adds the given nick or usermask

to the AutoKick list. If a reason is given with

the command, that reason will be used when the user is

kicked; if not, the default reason is "You have been

banned from the channel".

Syntax: AKICK channel DEL mask

The AKICK DEL command removes the given nick or mask

from the AutoKick list. It does not, however, remove any

bans placed by an AutoKick; those must be removed

manually.

AKICK channel LIST [mask]

Maintains the AutoKick list for a channel. If a user

on the AutoKick list attempts to join the channel,

ChanServ will ban that user from the channel, then kick

the user.

The AKICK LIST command displays the AutoKick list, or

optionally only those AutoKick entries which match the

given mask.

Syntax: CLEAR channel what

Tells ChanServ to clear certain settings on a channel. what

can be any of the following:

modes Resets all modes on the channel (i.e. clears

modes i,k,l,m,n,p,s,t).

bans Clears all bans on the channel.

ops Removes channel-operator status (mode +o) from all channel operators.

voices Removes "voice" status (mode +v) from anyone with that mode set.

users Removes (kicks) all users from the channel.

Your access level on the channel must be at least 10 to use

this command.

Syntax: DEOP #channel nick

Deops a selected nick on a channel. Limited to those with level five access and above on said channel.

See also: OP

Syntax: DROP channel

Unregisters the named channel. Can only be used by channel founder, who must use the IDENTIFY command first.

Syntax: IDENTIFY channel password

Authenticates you to ChanServ as the founder of the given channel. Many commands require you to use this command before using them. The password should be the same one  you sent with the REGISTER command.

Syntax: INFO channel

Lists information about the named registered channel, including its founder, time of registration, last time used, description, and mode lock, if any.

Syntax: INVITE channel

Tells ChanServ to invite you into the given channel. Only works if your access level on that channel is greater than zero.

Syntax: LIST mask

Lists all registered channels matching the given mask.(Channels with the PRIVATE option set are not listed, of course.)

Syntax: OP #channel nick

Ops a selected nick on a channel. Limited to those with level five access and above on said channel.

See also: DEOP

Syntax: REGISTER channel password description

Registers a channel in the ChanServ database. In order to use this command, you must first be a channel operator on the channel you're trying to register. The password is used with the IDENTIFY command to allow you to make changes to the channel settings at a later time. The last parameter, which must be included, is a general description of the channel's purpose.

When you register a channel, you are recorded as the "founder" of the channel. The channel founder is allowed to change all of the channel settings for the channel; ChanServ will also automatically give the founder channel-operator privileges when s/he enters the channel. See the ACCESS command (/msg ChanServ HELP ACCESS) for information on giving a subset of these privileges to other channel users.

NOTICE: In order to register a channel, you must first registered your nickname. If you haven't, /msg NickServ HELP for information on how to do so.

Syntax: UNBAN channel

Tells ChanServ to remove all bans preventing you from entering the given channel. Only works if your access level on that channel is greater than zero.

Syntax: ACCESS channel ADD mask level

The ACCESS ADD command adds the given nickname or usermask to the access list with the given user level; if the nick or mask is already present on the list, its access level is changed to the level specified in the command.

ACCESS channel DEL {mask | entry-num}

The ACCESS DEL command removes the given nick or mask from the access list.

ACCESS channel LIST [mask]

The ACCESS LIST command displays the access list; if a mask is given, only those entries matching the mask are displayed.

Maintains the access list for a channel. The access list specifies which users are allowed chanop status or access to ChanServ commands on the channel. Different user levels allow for access to different subsets of privileges; /msg ChanServ HELP ACCESS LEVELS for more specific information. By default, any nick not on the access list has a user level of 0.

User access levels

There are currently five distinct access levels available:

Founder Full access to ChanServ functions; automatic opping upon entering channel. Note that only one person may have founder status (it cannot be given using the ACCESS command).

10 Access to AKICK command; automatic opping.

5 Automatic opping.

0 No special privileges; can be opped by other ops (unless secure-ops is set).

<0 May not be opped.

In addition, any user with access level greater than zero can add other users to the access list, as long as the new entries are for levels less than the user's own. So, for example, a level 10 user can add level 5 users, and either a level 10 or a level 5 user can add negative-level users.

Founders can add users at any level they want.

Syntax: LEVELS channel SET type level

LEVELS channel {DIS | DISABLE} type

LEVELS channel LIST

LEVELS channel RESET

The LEVELS command allows fine control over the meaning of the numeric access levels used for channels. With this command, you can define the access level required for most of ChanServ's functions. (The SET FOUNDER and SET PASSWORD commands, as well as this command, are always restricted to the channel founder.)

LEVELS SET allows the access level for a function or group of functions to be changed. LEVELS DISABLE (or DIS for short) disables an automatic feature or disallows access to a function by anyone other than the channel founder.

LEVELS LIST shows the current levels for each function or group of functions. LEVELS RESET resets the levels to the default levels of a newly-created channel (see

HELP ACCESS LEVELS).

For a list of the features and functions whose levels can be set, see HELP LEVELS DESC.

Syntax: SET channel option parameters

Allows the channel founder to set various channel options and other information. The founder must use the IDENTIFY command before using SET.

Available options:

FOUNDER Set the founder of a channel

PASSWORD Set the founder password

DESC Set the channel description

URL Associate a URL with the channel

EMAIL Associate an E-mail address with the channel

TOPIC Change the topic on the channel

MLOCK Lock channel modes on or off

KEEPTOPIC Retain topic when channel is not in use

TOPICLOCK Topic can only be changed with SET TOPIC

PRIVATE Hide channel from ChanServ lists

SECUREOPS Stricter control of chanop status

RESTRICTED Restrict access to the channel

SECURE Activate ChanServ security features

Type /msg ChanServ HELP option for more information on a particular option.

Syntax: SET channel DESC description

Sets the description for the channel, which shows up with the LIST and INFO commands.

Syntax: SET channel 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.

Syntax: SET channel 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.

Syntax: SET channel MLOCK modes

Sets the mode-lock parameter for the channel. ChanServ allows you to define certain channel modes to be always on (or off). The modes that can be locked are i, k, l, m, n, p, s, and t; each of these modes can be locked on, locked off, or not locked. 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.

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 HELP SET RESTRICTED), or anyone entering the channel when it is empty will be able to see the key!

Examples:

SET #channel 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 #channel 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 #channel MLOCK +

Removes the mode lock; all channel modes are free to be either on or off.

Syntax: SET channel PASSWORD password

Sets the password used to identify as the founder of the channel.

Syntax: SET channel 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.

Syntax: SET channel 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.

Syntax: 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 IDENTIFY'd with their password will be given access to the channel as controlled by the access list. Note that the access list may only contain registered nicknames if SECURE is set.

Syntax: SET channel 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.

Syntax: SET channel TOPIC topic

Causes ChanServ to set the channel topic to the one specified. This command is most useful in conjunction with SET LOCKTOPIC.

Syntax: SET channel 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 SET TOPIC command.

Syntax: SET channel 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.