REGISTER Registering a channel
Syntax: /msg Chanserv REGISTER #(channel) (password) (description)
Explanation: Registers a channel with ChanServ.
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.
You should *never* give your channel password to anyone, no one else needs it.
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 he/she enters the channel.
See the ACCESS command (/msg ChanServ HELP ACCESS) for information on giving
other users channel op's and co-founder access.
NOTICE: In order to register a channel, you must first register your nickname.
See the NickServ Help Section.
IDENTIFY Identify yourself with your password
Syntax: /msg Chanserv IDENTIFY #(channel) (password)
Explanation: 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.
SET Set channel options and information
In addition, any user 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 want. AKICK Maintain the AutoKick list
DROP Cancel the registration of a channel
CLEAR Reclaim channel if its taken over
UNBAN Remove all bans preventing you from entering your channel.
LEVELS Allows founders to re assign access level values.
INFO
LIST
INVITE
OP/DEOP
Note: Any channel which is not used for two weeks (i.e. which no user on the
channel's access list enters for that period of time) will be automatically
dropped.
Syntax: /msg Chanserv SET #(channel) (option) (parameters)
Explanation: Allows the channel founder to set various channel options and
other information. The founder must use the IDENTIFY command before using SET.
Available options:
FOUNDER Set the founder of a channel
Syntax: /msg Chanserv SET #(channel) FOUNDER (nick)
Changes the founder of a channel. The new nickname must be a registered one.
--===
PASSWORD Set the founder password
Syntax: /msg Chanserv SET #(channel) PASSWORD (newpass)
Changes the password of a channel. You must be the founder to do this.
--===
URL Set the channel homepage URL
Syntax: /msg Chanserv SET #(channel) URL (description)
Sets the homepage URL for the channel, which shows up with the INFO command.
--===
DESC Set the channel description/greeting
Syntax: /msg Chanserv SET #
Sets the description for the channel, which shows up with the LIST
and INFO command. To use the description as a greeting message to
each person who joins the channel, use:
SET #
--===
GREET Set channel greeting on or off
Syntax: /msg Chanserv SET #(channel) GREET {ON or OFF}
Enables or disables ChanServ greeting new users when they join the
channel. To set the greeting message, use:
SET #(channel) DESC (description)
--===
TOPIC Change the topic on a channel
Syntax: /msg Chanserv SET #(channel) TOPIC (topic)
Causes ChanServ to set the channel topic to the one specified.
This command is most useful in conjunction with SET LOCKTOPIC.
--===
MLOCK Lock channel modes on or off
Syntax: /msg Chanserv SET #(channel) MLOCK (modes)
Sets the mode-lock parameter for the channel. ChanServ allows you to
define certain channel modes to be always on (or off). The modes that
can be locked are i, k, l, m, n, p, s, and t; each of these modes can
be locked on, locked off, or not locked. 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: Chanserv automatically sets the mlock to +nt when you register the channel.
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 HELP SET RESTRICTED), or anyone entering the channel when it is
empty will be able to see the key!
Examples:
/msg Chanserv 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.
/msg Chanserv 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".
/msg Chanserv SET #channel MLOCK +
Removes the mode lock; all channel modes are free to be either on or off.
--===
KEEPTOPIC Retain topic when channel is not in use
Syntax: /msg Chanserv SET #(channel) KEEPTOPIC {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 used.
--===
TOPICLOCK Topic can only be changed with SET TOPIC
Syntax: /msg Chanserv SET #(channel) TOPICLOCK {ON or OFF}
Enables or disables the topic lock option for a channel. When topic
lock is set, ChanServ will not allow the channel topic to be changed
except via the SET TOPIC command.
--===
PRIVATE Hide channel from ChanServ lists
Syntax: /msg Chanserv SET #(channel) PRIVATE {ON or OFF}
Enables or disables the private option for a channel. When private is
set, a /msg ChanServ LIST will not include the channel in any lists.
--===
SECUREOPS Stricter control of chanop status
Syntax: /msg Chanserv SET #(channel) SECUREOPS {ON or OFF}
Enables or disables the secure ops option for a channel. When
secure-ops is set, users who are not on the userlist will not be
allowed chanop status.
--===
RESTRICTED Restricts access to channel
Syntax: /msg Chanserv SET #(channel) RESTRICTED {ON or OFF}
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.
--===
SECURE Activate ChanServ security features
Syntax: /msg Chanserv SET #(channel) SECURE {ON on OFF}
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.
ACCESS Modify the list of privileged users
Explanation: 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.
Syntax: /msg Chanserv ACCESS #(channel) ADD (nick|mask) (level)
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.
Syntax: /msg Chanserv ACCESS #(channel) DEL (nick|mask) or (entry-num)
Removes the given nick or mask from the access list.
Syntax: /msg Chanserv ACCESS #
Displays the access list; if a mask is given, only those entries matching the
mask are displayed.
Note: By default, any nick not on the access list has a user level of 0.
There are currently five 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.
0 No special privileges; can be opped by other ops
(unless secure-ops is set)
<0 May not be opped.
Explanation: 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.
Syntax: /msg Chanserv AKICK (channel) ADD (nick|mask) [reason]
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".
Syntax: /msg Chanserv AKICK (channel) DEL (nick|mask)
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.
Syntax: /msg Chanserv AKICK (channel) LIST [mask]
Displays the AutoKick list, or optionally only those AutoKick entries which
match the given mask.
Syntax: /msg Chanserv DROP #(channel)
Explanation: Unregisters the named channel. Can only be used by channel
founder, who must use the IDENTIFY command first.
Syntax: /msg Chanserv CLEAR #(channel) (command)
Explanation: Tells ChanServ to clear certain settings on a channel.
These commands 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.
Your access level on the channel must be at least 10 to use this command.
Syntax: /msg Chanserv UNBAN #(channel)
Tells ChanServ to remove all bans preventing you from entering the given
channel.
Only works if your access level on that channel is greater than zero.
Explanation: 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.)
Syntax: /msg Chanserv LEVELS (#channel) SET (type) (level)
Allows the access level for a function or group of functions to be changed.
Syntax: /msg Chanserv LEVELS #(channel) {DIS or DISABLE} (type)
(or DIS for short) disables an automatic feature or disallows access to a
function by anyone other than the channel founder.
Syntax: /msg Chanserv LEVELS #(channel) LIST
Shows the current levels for each function or group of functions.
Syntax: /msg Chanserv LEVELS #
Resets the levels to the default levels of a newly-created channel
(see ACCESS LEVELS).
The following feature/function names are understood. Note that the levels
for AUTODEOP and NOJOIN are maximum levels while all others are minimum levels.
AUTOOP Automatic channel operator status
AUTOVOICE Automatic mode +v
AUTODEOP Channel operator status disallowed
NOJOIN Not allowed to join channel if RESTRICTED
INVITE Allowed to use INVITE command
AKICK Allowed to use AKICK command
SET Allowed to use SET command (not FOUNDER/PASSWORD)
CLEAR Allowed to use CLEAR command
UNBAN Allowed to use UNBAN command
OPDEOP Allowed to use OP/DEOP commands
ACCESS Allowed to use ACCESS command
Syntax: /msg Chanserv INFO #(channe)
Explanation: Lists information about the named registered channel, including
its founder, time of registration, last time used, description, and mode lock,
if any.
Syntax: /msg Chanserv LIST (mask)
Explanation: Lists all registered channels matching the given mask. (Channels
with the PRIVATE option set are not listed, of course.)
Syntax: /msg Chanserv INVITE #(channel)
Explanation: Tells ChanServ to invite you into the given channel. Only works
if your access level on that channel is greater than zero.
Syntax: /msg Chanserv OP #(channel) (nick)
Explanation: Ops a selected nick on a channel. Limited to those with level
five access and above on said channel.
Syntax: /msg Chanserv DEOP #(channel) (nick)
Explanation: Deops a selected nick on a channel. Limited to those with level
five access and above on said channel.