NewNet Services '98

Compiled 6/25/98 for additions/corrections email JumpMan,   LadyBear , or EddieB

---=============================== CHANSERV ================================---

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

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 # DESC (description)
    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:
    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!

    /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 # LIST [mask]
 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.

User access levels

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.

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
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.


DROP Cancel the registration of a channel
Syntax: /msg Chanserv DROP #(channel)
Explanation: Unregisters the named channel. Can only be used by channel founder, who must use the IDENTIFY command first.


CLEAR Reclaim channel if its taken over
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.


UNBAN Remove all bans preventing you from entering your channel.
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.


LEVELS Allows founders to re assign access level values.
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 # RESET
 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.


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.


Now, help with NickServ or Home