IRC Help:  ChanServ

This utility allows you to register and control various aspects of your own channel (chat room).

If you are already connected to an IRC server and need help using ChanServ, type the following:
/msg chanserv help commands

Otherwise please read the following information.

---

Click on the following links to learn more about each ChanServ option:

Register | Identify | Set | Access | Akick
Drop | Info | List | Invite

REGISTER
Syntax:  /msg chanserv register <channel> <password> <description>

This command is used to register a channel in the ChanServ database.

In order to use this command you must first be channel operator in the channel you're wanting to register. In other words you must be present in the channel at the time and have ops status (designated by a @ next to your nick). The <password> is used in conjunction with the IDENTIFY command to make any changes to the channel settings at any 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 said channel. The channel founder is allowed to change all the channel settings for the channel; ChanServ will automatically give the founder channel-ops status when he/she enters the channel. See ACCESS for information on giving a subset of theses privileges to other channel users.

NOTE: To register a channel you must first be registered with NickServ and have IDENTIFIED yourself.

NOTE: Any channel which is not used for 14 days (i.e. when no user on the channel's access list enters for that time) will be automatically dropped.

IDENTIFY
Syntax:  /msg chanserv <channel> <password>

This command identifies you with ChanServ as the 'founder' of the channel. Many of the commands that follow will have required you to use this command in the first place. The password should be the same as the one used with the REGISTER command.

SET
Syntax:  /msg chanserv set <channel> <option> <parameters>

This command allows the channel founder to set various channel options as well as other information. The channel founder must use the IDENTIFY command before using SET. The available SET options are as follows:

• DESC
• FOUNDER
• KEEPTOPIC
• MLOCK
• PASSWORD
• PRIVATE
• RESTRICTED
• SECURE
• SECUREOPS
• TOPIC
• TOPICLOCK

• DESC:
  Syntax:  /msg chanserv set <channel> desc <description>
  This command allows the channel founder to change the description of the channel and this will show up with the LIST and INFO commands. NOTE: before being able to access this command the founder must have used IDENTIFY.
• FOUNDER:
  Syntax:  /msg chanserv set <channel> <founder> <nick>
  This command changes the founder of a channel. The new nickname MUST be a registered nick.
• KEEPTOPIC:
  Syntax:  /msg chanserv set <channel> keeptopic {on|off}
  This command enables the topic set for the channel to be retained even when the channel is closed and will re-appear on opening.
• MLOCK:
  Syntax:  /msg chanserv set <channel> mlock <modes>
  This command allows the authorised users to define certain channel modes to be always on/off. The modes that can be locked are <m>, <n>, <p>, <s>, and <t>; each of these modes can be locked on or not locked. The <modes> parameter is constructed the same as a </modes> command; meaning that modes followed by a + are locked on and modes followed by a - are locked off.
  
  Examples:
  

  SET #channel MLOCK +nt-iklps	Forces modes n and t on, and modes i, k, l, p, s off. Mode m is left 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, this also forces the channel key to be "my-key"
  SET #channel MLOCK +	Removes the mode lock and all channel modes are free to be either on or off.

• PASSWORD:
  Syntax:  /msg chanserv <old password> <new password>
  This command enables the channel founder to change the password.
  Note:  before being able to access this command the founder must have used IDENTIFY.
• PRIVATE:
  Syntax:  /msg chanserv set <channel> private {on|off}
  This command enables or disables the PRIVATE option for a channel. When PRIVATE is set, a /msg chanserv list will not include the channel on any list.
• RESTRICTED:
  Syntax:  /msg chanserv set <channel> restricted {on|off}
  This command enables or disables the 'restricted access' option for a channel. When 'restricted access' is set, users who normally would be disallowed from having channel operator status (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:
  Syntax:  /msg chanserv set <channel> secure {on|off}
  This command 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.
• SECUREOPS:
  Syntax:  /msg chanserv set <channel> secureops {on|off}
  This commands enables or secures the "secure ops" option for a channel. When secure ops is set users who are not on the userlist will not be allowed chanops status.
  Note: before being able to access this command the founder must have used IDENTIFY.
• TOPIC:
  Syntax:  /msg chanserv set <channel> topic <topic>
  This command causes ChanServ to set the topic to the one specified. This command is most useful when used in conjunction with the TOPICLOCK command.
• TOPICLOCK
  Syntax:  /msg chanserv set <channel> topiclock {on|off}
  Locks the channel topic so that it can only be changed with SET TOPIC.

ACCESS:
Syntax:  /msg chanserv access <channel> {add|del|list} <level>
This command maintains the 'access list' for a channel. The access list specifies which users are allowed channel op status or access to ChanServ commands on the channel

 /msg chanserv access <channel> add <mask> <level>
This 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.
Different user levels allow for different subsets of privileges. There are 6 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
• '3' Automatic voicing
• '0' No special privileges; can be opped by other ops (unless SECUREOPS is set).
• '<0' May not be opped.
• In addition, any users 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 wish.

 /msg chanserv access <channel> del <mask> <entry-num>
This command removes the given nick or mask from the access list.

 /msg chanserv access<channel> list {mask}
This command displays the access list; if a mask is given, only those entries matching the mask are displayed.

AKICK:
Syntax:  /msg chanserv akick <channel> add|del|list <mask> {reason}
This command 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.

 /msg chanserv akick <channel> add <mask> {reason}
This command adds the given nick or user mask to the AUTOKICK list. If a {reason} is given with the command then that reason will be used when the user is kicked, otherwise the default reason of "You have been banned from this channel" will be used.

 /msg chanserv akick del <mask>
This command removes the given nick or mask, from the AUTOKICK list. It does not however, remove any bans placed by AUTOKICK; these must be removed manually.

 /msg chanserv akick list {mask}
This command displays the AUTOKICK list or optionally, only those AUTOKICK entries that match the given mask.

DROP:
Syntax:  /msg chanserv drop <channel>
This command unregisters the named channel. This can only be used by the 'Founder' who must have used the IDENTIFY command first.

INFO:
Syntax:  /msg chanserv info <channel>
This command lists information about the named registered channel, including its founder, time of registration, last time used description and mode locks if any.

LIST:
Syntax:  /msg chanserv list {mask}
This command will list all registered channels matching the given mask. (Channels with the PRIVATE option set are not listed of course).

INVITE:
Syntax:  /msg chanserv invite <channel>
This command tells ChanServ to invite you into the given channel. Only works if your access level on that channel is greater than zero.