Copyright: © 2000, ShadowWorld.Net. All rights reserved


Identify
IDENTIFY:

/msg ChanServ IDENTIFY password

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


REGISTER

/msg ChanServ REGISTER #channelname 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 are 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. Be aware that if you give your founder password to others, they will be able to take your channel from you. The last parameter, which must be included is a general description of the channel's purpose. When you register the 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 he or she enters the channel. See the ACCESS command for information on giving a subset of these commands to other channel users. NOTICE: In order to register a channel, you must first have registered your nickname with nickserv.


Set
SET:

/msg ChanServ SET {channel} {option} {parameter}

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 #channelname founder {newfounder}

Allows you to change founders for an existing channel.

The nickname must be a registered one.

PASSWORD

/msg chanserv set #channelname password {newpass}

Allows you to change founder password for an existing channel.

DESC

/msg chanserv set #channelname desc {description}

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

URL

/msg chanserv set #channelname 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, the current URL is deleted.

EMAIL

/msg chanserv set #channelname email (email address)

Associates the given E-mail address with the channel. This address is displayed whenever someone requests information on the channel with the INFO command.  If no parameter is given, the current E-mail is deleted.

ENTRYMSG

/msg chanserv set #channelname entrymsg {desired entry message}

Sets the message which will be sent via /notice to users when they enter the channel.  If no parameter is given, no message will be sent.

TOPIC

/msg chanserv set #channelname topic {new topic}

Allows you to change topics in your channel.

MLOCK

/msg chanserv set #channelname mlock {+/- options}

Available mlocks are I (invite only), L (limits the number of users, requires a parameter with that number), P (private), S (secret), K (requires users to enter a use a keyword to enter the channel, reguires a furthur parameter), M (moderated), N (no external messages allowed), T (only ops may change the topic). Options must be toggled on or off with a + or -.

*WARNING* -- If you set a mode-locked key, as in the example below, you should also set the RESTRICTED option for the channel, or anyone entering the channel when it is empty will be able to see the key!

/msg chanserv set #channelname MLOCK +knst my-key

This would lock the channel modes to k, n, s, t, and the channel key to “my-key”.

KEEPTOPIC

/msg chanserv set #channelname keeptopic {on or off}

Allows chanserv to keep the topic when the channel is not in use.

TOPICLOCK

/msg chanserv set #channelname topiclock {on or off}

Note: This is referred to as locktopic in the online help, but it is really topiclock. When topiclock is set on, the topic can only be set with the set topic command.

PRIVATE

/msg chanserv set #channelname private {on or off}

When this option is set on, your channel doesn't show in /list.

SECUREOPS

/msg chanserv set #channelname secureops {on or off}

When secure ops is set, users who are not on the userlist will not be allowed chanop status.

RESTRICTED

/msg chanserv set #channelname restricted {on or off}

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

ther access list) will instead be kicked and banned from the channel.

SECURE

/msg chanserv set #channelname secure {on or off}

Activates ChanServ security features for a channel.  When secure is set, only users who

have registered their nicknames with Nickserv and IDENTIFY’d wilt their password will

be given access to the channel as controlled by the access list.


LEVELS

/msg chanserv levels #channelname set {type} {level}

/msg chanserv levels #channelname disable {type}

/msg chanserv levels #channelname list

/msg chanserv levels #channelname 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 chanservs 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 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.

The following feature/function names are understood. Note that the AUTODEOP and NOJOIN are maximum levels, while all others are minimum levels.

 AUTOOP - Automatic channel operator status

 AUTOVOICE - Automatic mode +v

 AUTODEOP - Channel operator status disallowed.

 NOJOIN - Not allowed to join channel if RESTRICTED

 INVITE  - Allowed to use the invite command

 AKICK  - Allowed to use AKICK command

 SET  - Allowed to use SET command (not founder/password)

 CLEAR  - Allowed to use CLEAR command

 UNBAN - Allowed to use UNBAN command

 OP/DEOP - Allowed to use OP and DEOP commands

 ACC-LIST - Allowed to view the access list

 ACC-CHANGE - Allowed to modify the access list

 MEMO  - Allowed to list and read channel memos


ACCESS

/msg chanserv access #channelname add nick level

/msg chanserv access #channelname del {nick or entry number}

/msg chanserv access #channelname list {mask}

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 sebsets of privileges. By default any user 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 level; if the given user is already present on access list, their 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 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.

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

User access levels:

By default, the following access levels are defined:.

FOUNDER -- full access to all ChanServ functions; automatic opping upon entering the channel.

 Note that only one person may have founder status. It cannot be given using the ACCESS

 command.

 10      Acess to the AKICK command, automatic opping.

  5       Automatic opping.

  3       Automatic voicing.

  0       No special privileges; can be opped by other ops (unless secureops is set on)

<0       May not be opped.

In addition, any user with an 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 level 5 users can add -1 users. Founders can add users at any level they want.


AKICK

/msg ChanServ AKICK #channelname add nick or mask {reason}

/msg Chanserv AKICK #channelname del mask

/msg ChanServ AKICK #channelname list {mask}

Maintains the AutoKick list for a channel. If a user on the AutoKick list attempts to join the channel, ChanServ will ban the user from the channel, then kick the user.

AKICK ADD

The akick add command adds the given nick or user@host 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."

AKICK DEL

This command removes the given nick or user@host from the channels akick list. It does not, however, remove any bans placed by an akick; those must be removed manually.

AKICK LIST

This command displays the autokick list.


INFO

/msg ChanServ INFO #channelname

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


DROP

/msg ChanServ DROP #channelname

This command drops the named channel from the ChanServ database. It can only be used by the founder, who must use the IDENTIFY command first.


INVITE

/msg chanserv INVITE channel

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


LIST

/msg chanserv LIST {pattern}

Lists all registered channels matching the given pattern.  Channels with the PRIVATE option will only be displayed to services admins.


OP

/msg chanserv OP #channelname nick

Ops a selected nick on a channel. By default, limited to those with level 5 access and above on the channel.


DEOP

/msg chanserv DEOP #channelname nick

Deops a selected nick on a channel.  By default, limited to those with level 5 access and above on the channel.


UNBAN

/msg chanserv UNBAN #channelname

Tells chanserv to remove all bans preventing you from entering the given channel.  By default,

this only works if your access level is greater than zero.


CLEAR

/msg chanserv clear #channelname {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 (+o) from all channel operators.

 VOICES - Removes +v from anyone with that mode set.

 USERS - Removes (kicks) all users from the channel.

By default your access level must be at least 10 to use this command.


Author
Author Information

All About BlackHole


Chanserv
Chanserv Commands

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, for more in formation on a specific command, type /msg ChanServ help {command}.

List of Chanserv Commands:

Register

Identify

Set

Access

Levels

Akick

Drop

Info

List

Invite

Op

Deop

Unban

Clear


Nickserv


Memoserv