Blitzed.org

Skip navigation, go direct to content

Blitzed.org - Help Department - User Services - ChanServ

[ Overview | ChanServ | NickServ | MemoServ ]
Below you will find the extended help file for ChanServ. The command, along with proper syntax, and a explanation are provided.

Register Identify Drop
Set Founder Succesor
Password Description URL
Email Entrymessage Topic
Keeptopic Mlock Private
Restricted Secure Secureops
Leaveops Verbose Access
VOP AOP SOP
Access Levels AKick Levels
Info List Op
Deop Voice Devoice
Invite Unban Clear
Register
/msg ChanServ REGISTER <channel> <password> <description>

Use: Registers a channel in the 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 that channel. The channel founder is allowed to change all of the channel settings for the channel and will be given founder channel-operator privileges when s/he enters the channel. See the ACCESS command for information on giving a subset of these privileges to other channel users.

NOTICE: In order to register a channel, you must have first registered your nickname.

Identify
/msg ChanServ IDENTIFY <channel> <password>

Use: 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.

Drop
/msg ChanServ DROP <channel>

Use: Unregisters the named channel.

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

Set
/msg ChanServ SET <channel> <option> <parameters>

Use: 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
/msg ChanServ SET channel FOUNDER nick

Use: Changes the founder of a channel. The new nickname must be a registered one.

SUCCESSOR
/msg ChanServ SET channel SUCCESSOR nick

Use: 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, the channel will be dropped instead, just as if no successor had been set. The new nickname must be a registered one.

PASSWORD
/msg ChanServ SET channel PASSWORD password

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

DESC
/msg ChanServ SET channel DESC description

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

URL
/msg ChanServ SET channel URL url

Use: 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.

EMAIL
/msg ChanServ 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. If no parameter is given, deletes any current E-mail address for the channel.

ENTRYMSG
/msg ChanServ SET channel ENTRYMSG message

Use: 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.

TOPIC
/msg ChanServ SET channel TOPIC topic

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

KEEPTOPIC
/msg ChanServ SET channel KEEPTOPIC {ON | OFF}

Use: 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.

TOPICLOCK
/msg ChanServ SET channel TOPICLOCK {ON | OFF}

Use: 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.

MLOCK
/msg ChanServ SET channel MLOCK modes

Use: 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.

PRIVATE

/msg ChanServ SET channel PRIVATE {ON | OFF}

Use: 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
/msg ChanServ SET channel RESTRICTED {ON | OFF}

Use: 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
/msg ChanServ SET channel SECURE {ON | OFF}

Use: Enables or disables ChanServ's security features for a channel. When SECURE is set, only users who have registered their nicknames with ChanServ and IDENTIFY'd with their password will be given access to the channel as controlled by the access list.

SECUREOPS
/msg ChanServ SET channel SECUREOPS {ON | OFF}

Use: 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.

LEAVEOPS
/msg ChanServ SET channel LEAVEOPS {ON | OFF}

Use: Enables or disables the leave ops option for a channel. When leave ops is set, ChanServ will never de-op a user in that channel except with the DEOP command.

VERBOSE
/msg ChanServ SET channel VERBOSE {ON | OFF}

Use: Enables or disables the verbose option for a channel. When verbose is set, ChanServ will send a notice to the channel's operators when certain commands are used on the channel.

Access
/msg ChanServ ACCESS <channel> ADD <nick> <level
/msg ChanServ ACCESS <channel> DEL { nick | entry-num | list }
/msg ChanServ ACCESS <channel> LIST { mask | list }
/msg ChanServ ACCESS <channel> COUNT

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. Any nick not on the access list has a user level of 0.

The ACCESS ADD command adds the given nickname to the access list with the given user level; if the nick is already present on the list, its access level is changed to the level specified in the command. The 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.

The ACCESS DEL command removes the given nick from the access list. If a list of entry numbers is given, those entries are deleted. (See the example for LIST below.)

The ACCESS LIST command displays the access 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:

ACCESS #channel LIST 2-5,7-9 Lists access entries numbered 2 through 5 and 7 through 9.

The ACCESS COUNT command returns the number of entries there are on the access list.

VOP
/msg ChanServ VOP <channel> ADD <nick>

Use: The VOP ADD command adds the given nick to the access list using the channel's default level for auto voice (default level 3).

This command is meant as a quick alias to ACCESS ADD.

AOP
/msg ChanServ AOP channel ADD nick
Use: The AOP ADD command adds the given nick to the access list using the channel's default level for auto op (default level 5). This command is meant as a quick alias to ACCESS ADD.
SOP
/msg ChanServ SOP channel ADD nick
Use: The SOP ADD command adds the given nick to the access list using the channel's default level for AKICK add (default level 10). This command is meant as a quick alias to ACCESS ADD.
Default Access Levels
Use: User access levels. This is not a command, but is the default levels set by ChanServ. Most people may never change these, however some may want to fine tune their' channels access levels. By default, the following access levels are defined: 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). These levels may be changed, or new ones added, using the LEVELS.
Levels
/msg ChanServ LEVELS channel SET type level
/msg ChanServ LEVELS channel {DIS | DISABLE} type
/msg ChanServ LEVELS channel LIST
/msg ChanServ 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.
AKick
/msg ChanServ AKICK channel ADD mask [reason]
/msg ChanServ AKICK channel DEL mask
/msg ChanServ AKICK channel LIST [mask | list]
/msg ChanServ AKICK channel VIEW [mask | list]
/msg ChanServ AKICK channel ENFORCE
/msg ChanServ AKICK channel COUNT
Use: 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 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". 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. The AKICK LIST command displays the AutoKick list, or optionally only those AutoKick entries which match the given mask. AKICK VIEW simply shows more details. The AKICK ENFORCE command causes ChanServ to enforce the current AKICK list by removing those users who match an AKICK mask. The AKICK COUNT command returns how many entries there are on the AutoKick list.
Info
/msg ChanServ INFO channel [ALL]
Use: Lists information about the named registered channel, including its founder, time of registration, last time used, description, and mode lock, if any. If you are identified as the founder of the channel you're getting information for and ALL is specified, the entry message and successor will also be displayed.
List
/msg ChanServ LIST pattern
Use: Lists all registered channels matching the given pattern. (Channels with the PRIVATE option set are not listed.)
Op
/msg ChanServ OP #channel [nick]
Use: Ops a selected nick on a channel. By default, limited to those with level 5 access and above on the channel. If nick is omitted, this command will attempt to op you in the specified channel.
Deop
/msg ChanServ DEOP #channel [nick]
Use: Deops a selected nick on a channel. By default, limited to those with level 5 access and above on the channel. If nick is omitted, this command will attempt to deop you in the specified channel.
Voice
/msg ChanServ VOICE #channel [nick]
Use: Voices a selected nick on a channel. By default, limited to those with level 5 access and above on the channel. If nick is omitted, this command will attempt to voice you in the specified channel, this by default requires level 3 access.
Devoice
/msg ChanServ DEVOICE #channel [nick]
Use: Devoices a selected nick on a channel. If nick is omitted, this command will attempt to devoice you in the specified channel. Devoicing yourself by default requires level 3 access, devoicing others requires level 5 access by default.
Invite
/msg ChanServ INVITE channel
Use: Tells ChanServ to invite you into the given channel. By default, only works if your access level on that channel is greater than zero.
Unban
/msg ChanServ UNBAN channel

Use: Tells ChanServ to remove all bans preventing you from entering the given channel.

By default, only works if your access level on that channel is greater than zero.

Clear
/msg ChanServ CLEAR channel what

Use: Tells ChanServ to clear certain settings on a channel. what can be any of the following:

By default, your access level on the channel must be at least 10 to use this command.

[End ChanServ Help]