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
Syntax: /msg chanserv register channel password description
Example: /msg chanserv register #Arizona fIdo A place to chat about Arizona
The founder must use the IDENTIFY command before using SET.
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.
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.
Syntax: /msg chanserv drop
Unregisters the named channel. Can only be used by channel founder, who must use the IDENTIFY command first.
Syntax: /msg chanserv SET channel option parameters
Allows the channel founder to set various channel options and other information.
- 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 email@example.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
, (invite) k
, (key) l
, (limits the number of ppl in channel) m
, (moderated) n
, (no external messages) p
, (private) s
, (secret) and t
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)
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.
By default, the following access levels are defined:
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.
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 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.
Syntax: /msg chanserv drop #channel
Unregisters the named channel.
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.
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.
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.
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.
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.
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.
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.
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.
Syntax: /msg chanserv clear channel what
What can be any of the following:
Resets all modes on the channel (i.e. clears modes i, k, l, m, n, p, s, t).
Clears all bans on the channel.
Removes channel-operator status (mode +o) from all channel operators.
Removes "voice" status (mode +v) from anyone with that mode set.
Removes (kicks) all users from the channel.
For further help and information type /msg chanserv help in irc.