2.0/Modules/ns access

Language
English Español

Module ns_access Author Anope

Description

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. Any registered user not on the access list has a user level of 0, and any unregistered user has a user access level of -1.

Commands

access #channel ADD mask level

access #channel DEL {mask or entry-num or list}

access #channel LIST [mask or list]

access #channel VIEW [mask or list]

The ACCESS ADD command adds the given mask to the access list with the given user level; if the mask is already present on the list, its access level is changed to the level specified in the command. The level specified may be a numerical level or the name of a privilege (egAUTOOP). When a user joins the channel the access they receive is from the highest level entry in the access list. The given mask may also be a channel, which will use the access list from the other channel up to the given level.

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.) You may remove yourself from an access list, even if you do not have access to modify that list otherwise.

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 VIEW command displays the access list similar to ACCESS LIST but shows the creator and last used time.

The ACCESS CLEAR command clears all entries of the access list.

User access levels can be seen by using the LEVELS command; type /msg ChanServ HELP LEVELS

Default Configuration

/*
 * ns_access
 *
 * Provides the command nickserv/access.
 *
 * Used for configuring what hosts have access to your account.
 */
module
{
        name = "ns_access"
 
        /*
         * The maximum number of entries allowed on a nickname's access list.
         * If not set, the default is 32. This number cannot be set to 0.
         */
        accessmax = 32
 
        /*
         * If set, Services will add the usermask of registering users to the access list of their
         * newly created account. If not set, users will always have to identify to NickServ before
         * being recognized, unless they manually add an address to the access list of their account.
         * This directive is optional.
         */
        addaccessonreg = yes
}
command { service = "NickServ"; name = "ACCESS"; command = "nickserv/access"; }
</div>