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.
Available commands are listed below; to use them type, while you are connected to IRC,
/msg ChanServ command.
For more information on a specific command please consult this document or type, while
you are connected to IRC, /msg ChanServ HELP command.
Note that any channel which is not used for 21 days (i.e. which no user on the channel's
access list enters for that period of time) will be automatically dropped.
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 others 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, while you are connected to IRC
or consult in this document CHANSERV 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 please consult NickServ's document (section NICKSERV REGISTER) or, while you
are connected to IRC, type /msg NickServ HELP REGISTER for information on how to
do so.
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.
Please consult in this document CHANSERV SET and your differents options or type, while you are
connected to IRC, /msg ChanServ HELP SET option for more information on a particular
option.
Changes the successor of a channel. If the founder's nickname expires or is dropped
while the channel is still registered, the successor will become the new founder of the
channel.
However, if the successor already has too many channels registered (20), the channel
will be dropped instead, just as if no successor had been set. The new nickname must
be a registered one.
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,
deletes any current URL for the channel.
Sets the message which will be sent via /notice to users when they enter the channel. If
no parameter is given, causes no message to be sent upon entering the channel.
ChanServ allows you to define certain channel modes to be always on, off or free to
be either on or off.
The modes parameter is constructed exactly the same way as a /MODE command; that is,
modes followed by a + are locked on, and modes followed by a - are locked off. Note,
however, that unlike the /MODE command, each use of SET MLOCK will remove all modes
previously locked before setting the new!.
Warning: If you set a mode-locked key, as in the second example below, you should also
set the RESTRICTED option for the channel (see SET RESTRICTED), or anyone entering the
channel when it is empty will be able to see the key!.
Examples:
SET #channel MLOCK +nt-iklps
Forces modes n and t on, and modes i, k, l, p, and s off. Mode m is left free 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. Also forces the channel
key to be "my-key".
SET #channel MLOCK +
Removes the mode lock; all channel modes are free to be either on or off.
Enables or disables the topic retention option for a channel.
When TOPIC retention is set, the topic for the channel will be remembered by ChanServ
even after the last user leaves the channel, and will be restored the next time the
channel is created.
Enables or disables the peace option for a channel.
When PEACE is set, an user won't be able to kick, ban or remove a channel status of an
user that has a level superior or equal to his via ChanServ commands.
Enables or disables the restricted access option for a channel.
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 the access list) will instead be kicked and banned from the channel.
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.
Enables or disables the secure founder option for a channel.
When SECUREFOUNDER is set, only the real founder will be able to drop the channel,
change its password, its founder and its successor, and not those who are IDENTIFY'd
with ChanServ.
When SIGNKICK is set, kicks issued with ChanServ KICK command will have the nick that
used the command in their reason.
If you use LEVEL, those who have a level that is superior or equal to the SIGNKICK
level on the channel won't have their kicks signed. Please consult this document or see, while
you are connected to IRC, /msg ChanServ HELP LEVELS for more information.
Enables or disables the xOP lists system for a channel.
When XOP is set, you have to use the AOP/SOP/VOP commands in order to give channel
privileges to users, else you have to use the ACCESS command.
Technical Note: when you switch from access list to xOP lists system, your level
definitions and user levels will be changed, so you won't find the same values if you
switch back to access system!.
You should also check that your users are in the good xOP list after the switch from access
to xOP lists, because the guess is not always perfect... in fact, it is not recommended to
use the xOP lists if you changed level definitions with the LEVELS command.
Switching from xOP lists system to access list system causes no problem though.
The AOP list gives users the right to be auto-opped on your channel, to unban or invite
themselves if needed, to have their greet message showed on join, and so on.
The AOP ADD command adds the given nickname to the AOP list.
The AOP DEL command removes the given nick from the AOP list. If a list of entry numbers
is given, those entries are deleted. (See the example for LIST below.)
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 entries numbered 2 through 5 and 7 through 9.
The AOP CLEAR command clears all entries of the AOP list.
The AOP ADD and AOP DEL commands are limited to SOPs or above, while the AOP CLEAR
command can only be used by the channel founder. However, any user on the AOP list
may use the AOP LIST command.
This command may have been disabled for your channel, and in that case you need to use
the access list. Please consult in this document CHANSERV ACCESS or see, while you are
connected to IRC, /msg ChanServ HELP ACCESS for information about the access
list, and consult in this document CHANSERV SET XOP or /msg ChanServ HELP SET XOP,
while you are connected to IRC, to know how to toggle between the access list and xOP list
systems.
The SOP list gives users all rights given by the AOP list, and adds those needed to use
the AutoKick and the BadWords lists, to send and read channel memos, and so on.
The SOP ADD command adds the given nickname to the SOP list.
The SOP DEL command removes the given nick from the SOP list. If a list of entry numbers
is given, those entries are deleted. (See the example for LIST below.)
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 AOP entries numbered 2 through 5 and 7 through 9.
The SOP CLEAR command clears all entries of the SOP list.
The SOP ADD, SOP DEL and SOP CLEAR commands are limited to the channel founder. However,
any user on the AOP list may use the SOP LIST command.
This command may have been disabled for your channel, and in that case you need to use
the access list. Please consult in this document CHANSERV ACCESS or see, while you are
connected to IRC, /msg ChanServ HELP ACCESS for information about the access
list, and consult in this document CHANSERV SET XOP or /msg ChanServ HELP SET XOP,
while you are connected to IRC, to know how to toggle between the access list and xOP list
systems.
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; consult in this document CHANSERV ACCESS LEVELS or
type, while you are connected to IRC, /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.
The ACCESS CLEAR command clears all entries of the access list.
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;
consult in this document CHANSERV LEVELS or type, while you are connected
to IRC, /msg ChanServ HELP LEVELS for information.
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 ChanServ's 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 (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.
The following feature/function names are understood. Note that the levels for
AUTODEOP and NOJOIN are maximum levels, while all others are minimum levels.
AUTODEOP
Channel operator status disallowed.
AUTOOP
Automatic channel operator status.
AUTOVOICE
Automatic mode +v
NOJOIN
Not allowed to join channel if RESTRICTED.
SIGNKICK
No signed kick when SIGNKICK LEVEL is used.
ACC-LIST
Allowed to view the access list.
ACC-CHANGE
Allowed to modify the access list.
AKICK
Allowed to use AKICK command.
SET
Allowed to use SET command (not FOUNDER/PASSWORD).
BAN
Allowed to use BAN command.
BANME
Allowed to ban him/herself.
CLEAR
Allowed to use CLEAR command.
GETKEY
Allowed to use GETKEY command.
INFO
Allowed to use INFO command with ALL option.
KICK
Allowed to use KICK command.
KICKME
Allowed to kick him/herself.
INVITE
Allowed to use INVITE command.
OPDEOP
Allowed to use OP/DEOP commands.
OPDEOPME
Allowed to (de)op him/herself.
TOPIC
Allowed to use TOPIC command.
UNBAN
Allowed to use UNBAN command.
VOICE
Allowed to use VOICE/DEVOICE commands.
VOICEME
Allowed to (de)voice him/herself.
MEMO
Allowed to list/read channel memos.
ASSIGN
Allowed to assign/unassign a bot.
BADWORDS
Allowed to use BADWORDS command.
FANTASY
Allowed to use fantaisist commands.
GREET
Greet message displayed.
NOKICK
Never kicked by the bot's kickers.
SAY
Allowed to use SAY and ACT commands.
By default, the access levels for new channel is setup as follow:
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 STICK command permanently bans the given mask on the channel. If someone
tries to remove the ban, ChanServ will automatically set it again. You can't use it
for registered nicks.
The AKICK UNSTICK command cancels the effect of the AKICK STICK command, so you'll
be able to unset the ban again on 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.
The AKICK VIEW command is a more verbose version of AKICK LIST command.
The AKICK ENFORCE command causes ChanServ to enforce the current AKICK list by
removing those users who match an AKICK mask.
The AKICK CLEAR command clears all entries of the akick list.
Send the password of the given channel to the e-mail address set in the founder's
nickname record. This command is really useful to deal with lost passwords.
May be limited to IRC operators on certain networks.
This command is unavailable when encryption is enabled.
Deops a selected nick on a channel. If nick is not given, it will deop you. If channel
and nick are not given, it will deop you on all channels you're on, provided you have
the rights to.
By default, limited to AOPs or those with level 5 access and above on the channel.
DeUops a selected nick on a channel. If nick is not given, it will deUop you. If channel
and nick are not given, it will deUop you on all channels you're on, provided you have
the rights to.
By default, limited to AOPs or those with level 5 access and above on the channel, or
to UOPs or those with level 1 and above for self deUoping.
Devoices a selected nick on a channel. If nick is not given, it will devoice you. If
channel and nick are not given, it will devoice you on all channels you're on, provided
you have the rights to.
By default, limited to AOPs or those with level 5 access and above on the channel, or
to VOPs or those with level 3 and above for self devoicing.
Kicks a selected nick on a channel. If nick is not given, it will kick you. If channel
and nick are not given, it will kick you on all channels you're on, provided you have
the rights to.
By default, limited to AOPs or those with level 5 access and above on the channel.
Ops a selected nick on a channel. If nick is not given, it will op you. If channel
and nick are not given, it will op you on all channels you're on, provided you have
the rights to.
By default, limited to AOPs or those with level 5 access and above on the channel.
Causes ChanServ to set the channel topic to the one specified. If topic is not given,
then an empty topic is set.
This command is most useful in conjunction with SET TOPICLOCK.
Please consult in this document CHANSERV SET TOPICKLOCK or see, while you are connected
to IRC, /msg ChanServ HELP SET TOPICLOCK for more information.
By default, limited to those with founder access on the channel.
Uops a selected nick on a channel. If nick is not given, it will uop you. If channel
and nick are not given, it will uop you on all channels you're on, provided you have
the rights to.
By default, limited to AOPs or those with level 5 access and above on the channel, or
to UOPs or those with level 1 and above for self uoping.
Maintains the UOP (Under Ops) list for a channel. The UOP list allows users to be
auto-uop and to uop themselves if they aren't.
The UOP ADD command adds the given nickname to the UOP list.
The UOP DEL command removes the given nick from the UOP list. If a list of entry
numbers is given, those entries are deleted. (See the example for LIST below.)
The UOP LIST command displays the UOP 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:
UOP #channel LIST 2-5,7-9
Muestra instancias UOP ennumeradas de 2 a 5 y 7 a 9.
The UOP CLEAR command clears all entries of the UOP list.
The UOP ADD, UOP DEL and UOP LIST commands are limited to AOPs or above, while the
UOP CLEAR command can only be used by the channel founder.
This command may have been disabled for your channel, and in that case you need to use
the access list. Please consult in this document CHANSERV ACCESS or see, while you are
connected to IRC, /msg ChanServ HELP ACCESS for information about the access
list, and consult in this document CHANSERV SET XOP or /msg ChanServ HELP SET XOP,
while you are connected to IRC, to know how to toggle between the access list and xOP list
systems.
Voices a selected nick on a channel. If nick is not given, it will voice you. If channel
and nick are not given, it will voice you on all channels you're on, provided you have
the rights to.
By default, limited to AOPs or those with level 5 access and above on the channel, or to
VOPs or those with level 3 and above for self voicing.
Maintains the VOP (VOicePeople) list for a channel.
The VOP list allows users to be auto-voiced and to voice themselves if they aren't.
The VOP ADD command adds the given nickname to the VOP list.
The VOP DEL command removes the given nick from the VOP list. If a list of entry numbers
is given, those entries are deleted. (See the example for LIST below.)
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 entries numbered 2 through 5 and 7 through 9.
The VOP CLEAR command clears all entries of the VOP list.
The VOP ADD, VOP DEL and VOP LIST commands are limited to AOPs or above, while the
VOP CLEAR command can only be used by the channel founder.
This command may have been disabled for your channel, and in that case you need to use
the access list. Please consult in this document CHANSERV ACCESS or see, while you are
connected to IRC, /msg ChanServ HELP ACCESS for information about the access
list, and consult in this document CHANSERV SET XOP or /msg ChanServ HELP SET XOP,
while you are connected to IRC, to know how to toggle between the access list and xOP list
systems.
Dehalfops a selected nick on a channel. If nick is not given, it will dehalfop you.
If channel and nick are not given, it will dehalfop you on all channels you're on,
provided you have the rights to.
By default, limited to AOPs and those with level 5 access and above on the channel,
or to HOPs or those with level 4 and above for self dehalfopping.
Removes your owner status on channel. If channel is not given, it will remove your owner
status on all channels you're on, provided you have the rights to.
Limited to those with founder access on the channel.
Deprotects a selected nick on a channel. If nick is not given, it will deprotect you.
If channel and nick are not given, it will deprotect you on all channels you're on,
provided you have the rights to.
By default, limited to the founder, or to SOPs or those with level 10 and above on
the channel for self deprotecting.
Halfops a selected nick on a channel. If nick is not given, it will halfop you. If
channel and nick are not given, it will halfop you on all channels you're on,
provided you have the rights to.
By default, limited to AOPs and those with level 5 access and above on the channel,
or to HOPs or those with level 4 and above for self halfopping.
The HOP list gives users the right to be auto-halfopped on your channel.
The HOP ADD command adds the given nickname to the HOP list.
The HOP DEL command removes the given nick from the HOP list. If a list of entry
numbers is given, those entries are deleted. (See the example for LIST below.)
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 #canal LIST 2-5,7-9
Lists HOP entries numbered 2 through 5 and 7 through 9.
The HOP CLEAR command clears all entries of the HOP list.
The HOP ADD, HOP DEL and HOP LIST commands are limited to AOPs or above, while the
HOP CLEAR command can only be used by the channel founder.
This command may have been disabled for your channel, and in that case you need to use
the access list. Please consult in this document CHANSERV ACCESS or see, while you are
connected to IRC, /msg ChanServ HELP ACCESS for information about the access
list, and consult in this document CHANSERV SET XOP or /msg ChanServ HELP SET XOP,
while you are connected to IRC, to know how to toggle between the access list and xOP list
systems.
Protects a selected nick on a channel. If nick is not given, it will protect you.
If channel and nick are not given, it will protect you on all channels you're on,
provided you have the rights to.
By default, limited to the founder, or to SOPs or those with level 10 and above on
the channel for self protecting.