ChanServ

Hits
ChanServ allows you to register and control various aspects of chat rooms. ChanServ can often prevent malicious users from "taking over" chat rooms by limiting who is allowed channel operator privileges. Available commands are listed below; to use them, type /msg ChanServ command. For more information on a specific command, type /msg ChanServ HELP command.

Note that any channel which is not used for 14 days (i.e. which no user on the channel's access list enters for that period of time) will be automatically dropped.

  • Register - Register a channel
  • Identify - Identify yourself with your password
  • Drop - Cancel the registration of a channel
  • Set - Set channel options and information
  • Set Founder - Changes the founder of a channel
  • Set Successor - Set the successor for a channel
  • Set Password - Set the founder password
  • Set Url - Associate a URL with the channel
  • Set Description - Set the channel description
  • Set Email - Associate an E-mail address with the channel
  • Set Entrymsg - Set a message to be sent to users when they enter the channel
  • Set Topic - Change the topic on the channel
  • Set Keeptopic - Retain topic when channel is not in use
  • Set Topiclock - Topic can only be changed with SET TOPIC
  • Set Mlock - Lock channel modes on or off
  • Set Private - Hide channel from LIST command
  • Set Restricted - Restrict access to the channel
  • Set Secure - Activate ChanServ security features
  • Set Secure Ops - Stricter control of chanop status
  • Set LeaveOps - Never de-op users except with DEOP command
  • Set OpNotice - Send a notice when OP/DEOP commands are used
  • Access - Modify the list of privileged users
  • Access Levels - Redefine the meanings of access levels
  • Akick - Maintain the AutoKick list
  • Drop - Cancel the registration of a channel
  • Info - Get info for a given channel
  • Invite - Ask for an invite to a channel
  • List - Lists all registered channels matching the given pattern
  • Op - Ops a selected nick on a channel
  • Deop - Deops a selected nick on a channel
  • Voice - Voices a selected nick on a channel
  • Devoice - Devoices a selected nick on a channel
  • Unban - Tells ChanServ to remove all bans preventing you from entering the given channel
  • Clear - Clears a channel's modes

Register:
Syntax: /msg chanserv register channel password description
Example: /msg chanserv register #Arizona fIdo A place to chat about Arizona

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 have first registered your nickname. If you haven't, /msg NickServ HELP for information on how to do so.

Identify:
Syntax: /msg chanserv ident #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.

Drop:
Syntax: /msg chanserv drop
Unregisters the named channel. Can only be used by channel founder, who must use the IDENTIFY command first.

Set:
Syntax: /msg chanserv 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.

Options:

  • Founder - /msg chanserv set #channel founder nickname
  • Successor - /msg chanserv set #channel successor nickname
  • Password - /msg chanserv set #channel password newpassword
  • Url - /msg chanserv set #channel url www.yoururl.com
  • Description - /msg chanserv set #channel desc Arizona chat
  • Email - /msg chanserv set #channel email anon@yourhost.com
  • Entrymsg - /msg chanserv set #channel entrymsg Welcome to #Arizona Sit down and enjoy the chat!!
  • Topic - /msg chanserv set #channel topic newtopic
  • Keeptopic - /msg chanserv set #channel keeptopic on (or off)
  • Topiclock - /msg chanserv set #channel topiclock on (or off)
  • Mlock - /msg chanserv set #channel mlock modes

Modes Are:
i, (invite) k, (key) l, (limits the number of ppl in channel) m, (moderated) n, (no external messages) p, (private) s, (secret) and t (topic).

Each of these modes can be locked on, or not locked. Modes followed by a + are locked on, and modes followed by a - are locked off. See /msg chanserv help set mlock for further help.

  • Private - /msg chanserv set #channel private on (or off)
  • Restricted - /msg chanserv set #channel restricted on (or off)
  • Secure - /msg chanserv set #channel secure on (or off)
  • SecureOps - /msg chanserv set #channel secureop on (or off)
  • LeaveOps - /msg chanserv set #channel leaveops on (or off)
  • OpNotice - /msg chanserv set #channel Opnotice on (or off)

Access:
Syntax: /msg chanserv access #channel add nick level
/msg chanserv access #channel del nick (list or entry number)
/msg chanserv access #channel list (list or 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 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.

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).

10 - Access to AKICK command; automatic opping.
5 - Automatic opping.
3 - Automatic voicing.
0 - No special privileges; can be opped by other ops (unless secure-ops is set).
0 May not be opped.

These levels may be changed, or new ones added, using the LEVELS command; type /msg ChanServ HELP LEVELS for information.

Akick:
Syntax: /msg chanserv akick #channel add mask reason
/msg chanserv akick #channel del mask
/msg chanserv 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 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.

Drop:
Syntax: /msg chanserv drop #channel
Unregisters the named channel.

Info:
Syntax: /msg chanserv info #channel (all)

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.

Invite:
Syntax: /msg chanserv invite #channel
Tells ChanServ to invite you into the given channel. By default, only works if your access level on that channel is greater than zero.

List:
Syntax: /msg chanserv list pattern
Lists all registered channels matching the given pattern. Channels with the PRIVATE option set will only be displayed to Services Admins.

Op:
Syntax: /msg chanserv op #channel nickname
Ops a selected nick on a channel. By default, limited to those with level 5 access and above on the channel.

Deop:
Syntax: /msg chanserv deop #channel nickname
Deops a selected nick on a channel. By default, limited to those with level 5 access and above on the channel.

Voice:
Syntax: /msg chanserv #channel +v nickname
Voices a selected nick on a channel. By default, limited to those with level 3 access and above on the channel.

Devoice:
Syntax: /msg chanserv devoice #channel nickname
Devoices a selected nick on a channel. By default, limited to those with level 3 access and above on the channel.

Unban:
Syntax: /msg chanserv unban #channel
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:
Syntax: /msg chanserv clear channel what

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.

For further help and information type /msg chanserv help in irc.