ChanServ Commands

Command Infomation Syntax: /msg chanserv *****
Register Register A Channel REGISTER #channel password description
Identify Identify yourself with your password IDENTIFY channel password
SENDPASS Send a channel’s password to you SENDPASS channel
DROP Cancel the registration of a channel DROP channel
SET Set channel options and information Chanserv Set Commands
UNSET Clear channel information UNSET channel {SUCCESSOR | URL | EMAIL | ENTRYMSG}
INFO Show channel options and information INFO channel [ALL]
ACCESS Maintain the overall channel access list Chanserv Access Syntax
LEVELS Fine-tune channel access levels Chanserv Levels Syntax
SOP Maintain the SuperOp list Chanserv SOP Syntax
AOP Maintain the AutoOp list Chanserv AOP Syntax
VOP Maintain the AutoVoice list Chanserv VOP Syntax
HOP Maintain the AutoHalfop list Chanserv HOP Syntax
OP Give a user chanop status (+o) OP channel [nickname]
DEOP Remove chanop status (+o) DEOP channel [nickname]
VOICE Give a user voice status (+v) VOICE channel [nickname]
DEVOICE Remove voice status (+v) DEVOICE channel [nickname]
HALFOP Give a user halfop status (+h) HALFOP channel [nickname]
DEHALFOP Remove halfop status (+h) DEHALFOP channel [nickname]
PROTECT Give a user protected status (+a) PROTECT channel [nickname]
DEPROTECT Remove protected status (+a) DEPROTECT channel [nickname]
INVITE Invite yourself to a channel INVITE channel
UNBAN Unban yourself from a channel UNBAN channel
KICK Kick a user from a channel KICK channel nickname [reason]
TOPIC Change a channel’s topic TOPIC channel topic
CLEAR Clear channel modes or mass-kick users Chanserv CLEAR Syntax
STATUS Return a user’s access level on a channel STATUS channel nickname
LIST List registered channels LIST pattern [FORBIDDEN] [NOEXPIRE] [SUSPENDED]
AKICK Maintain the AutoKick list Chanserv AKICK Syntax

ChanServ Set Commands

Command Information Syntax: /msg chanserv
FOUNDER Set the founder of a channel SET channel FOUNDER nickname
SUCCESSOR Set the successor for a channel SET channel SUCCESSOR nickname
PASSWORD Set the founder password SET channel PASSWORD password
DESC Set the channel description SET channel DESC description
URL Associate a URL with the channel SET channel URL url
EMAIL Associate an E-mail address with the channel SET channel EMAIL address
ENTRYMSG Set a message to be sent to users when they enter the channel SET channel ENTRYMSG message
KEEPTOPIC Retain topic when channel is not in use SET channel KEEPTOPIC {ON | OFF}
TOPICLOCK Topic can only be changed with TOPIC SET channel TOPICLOCK {ON | OFF}
MLOCK Lock channel modes on or off SET channel MLOCK modes
PRIVATE Hide channel from LIST command SET channel PRIVATE {ON | OFF
RESTRICTED Restrict access to the channel SET channel RESTRICTED {ON | OFF}
SECURE Activate ChanServ security features SET channel SECURE {ON | OFF}
SECUREOPS Stricter control of chanop status SET channel SECUREOPS {ON | OFF}
LEAVEOPS Do not de-op users on channel entry SET channel LEAVEOPS {ON | OFF}
OPNOTICE Send a notice when OP/VOICE commands are used SET channel OPNOTICE {ON | OFF}
ENFORCE Enforce auto-op, auto-voice status SET channel ENFORCE {ON | OFF}

Back To Top Of Page



Syntax: CLEAR channel what

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

MODES Clears all modes on the channel except those set in the channel’s mode lock.
BANS Clears all bans on the channel.
EXCEPTIONS Clears all exceptions on the channel.
INVITES Clears all invite masks on the channel.
OPS Removes channel-operator status (mode +o) from all users.
HALFOPS Removes halfop status (mode +h) from all users.
VOICES Removes “voice” status (mode +v) from all users.
USERS Removes (kicks) all users from the channel.

By default, limited to users with level 100 (SOP) access and above on the channel.

Back To Top Of Page



Syntax: ACCESS channel ADD nickname level
ACCESS channel DEL {nickname | entry-num | list}
ACCESS channel LIST [mask | list]
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 nickname 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 nickname 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.
Note that the access list may also be manipulated with the
SOP, AOP, and HOP, and VOP commands, which
correspond to levels of 100, 50, 40, and 30 respectively.

Back To Top Of Page



Syntax: LEVELS channel SET type level
LEVELS channel {DIS | DISABLE} type
LEVELS channel LIST
LEVELS channel RESET

The LEVELS command allows fine control over the meaning of
the numeric access levels used by the ACCESS command. 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.)

Caution: This command is for advanced users only! Changing
level settings with this command may cause the SOP, AOP,
HOP, and VOP commands to stop working correctly.

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. Back To Top Of Page


Syntax: SOP channel ADD nickname
SOP channel DEL nickname
SOP channel LIST [mask | list]
SOP channel COUNT

Maintains the SuperOp (SOP) list for a channel. Users with
SOP status are automatically opped (set mode +o) and
protected (mode +a) when they join the channel.
An SOP can modify the AOP, HOP, and VOP lists. Only a
channel’s founder can modify the SOP list

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

SOP #channel LIST 2-5,7-9
Lists SOP list entries numbered 2 through 5 and 7 through 9.

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

Back To Top Of Page



Syntax: AOP channel ADD nickname
AOP channel DEL nickname
AOP channel LIST [mask | list]
AOP channel COUNT

Maintains the AutoOp (AOP) list for a channel. Users with
AOP status are automatically opped (set mode +o) when they join the channel.
An AOP can modify the HOP and VOP lists; SOPs can modify the

AOP list.
The AOP LIST command displays the AOP 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:

AOP #channel LIST 2-5,7-9
Lists AOP list entries numbered 2 through 5 and 7 through 9.

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

Back To Top Of Page



Syntax: VOP channel ADD nickname
VOP channel DEL nickname
VOP channel LIST [mask | list]
VOP channel COUNT

Maintains the VoiceOp (VOP) list for a channel. Users with
VOP status are automatically voiced (set mode +v) when they join the channel.

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

VOP #channel LIST 2-5,7-9
Lists VOP list entries numbered 2 through 5 and 7 through 9.

The VOP COUNT command returns the number of entries thereare on the VOP list.

Back To Top Of Page



Syntax: HOP channel ADD nickname
HOP channel DEL nickname
HOP channel LIST [mask | list]
HOP channel COUNT

Maintains the HalfOp (HOP) list for a channel. Users with
HOP status are automatically halfopped (set mode +h) when they join the channel.

An HOP can modify the VOP list; SOPs and AOPs can modify the HOP list.

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

HOP #channel LIST 2-5,7-9
Lists HOP list entries numbered 2 through 5 and
7 through 9.

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

Back To Top Of Page



Syntax: AKICK channel ADD mask [reason]
AKICK channel DEL mask
AKICK channel LIST [mask | list]
AKICK channel VIEW [mask | list]
AKICK channel ENFORCE
AKICK channel COUNT

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 user@host or
nick!user@host mask 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 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 is similar, but shows more details.

The AKICK ENFORCE command causes ChanServ to enforce the
current autokick list by removing those users who match an autokick mask.

Back To Top Of Page