Using Access Levels or the XOP System


Table of Contents

Access Levels vs the XOP Access System

Using the Access Levels System
How to edit a level
Disabling certain access permissions
How to view the current levels set to a channel
List of alterable Level settings
Adding users to the channel access list
Returning access levels to default settings

Using the XOP System
What happens to custom levels when changing over from Levels to XOP?
How to turn XOP on/off

Setting XOP ranks:
VOP
HOP
AOP
SOP
QOP
About setting multiple owner ranks
Clearing XOP ranks




Access Levels vs the XOP Access System

There are two main methods of managing the access and permissions of permanent user ranks on a channel: using Access levels and using XOP lists. These systems both allow channel owners to assign specific ranks to registered users, and both allow the users on the list to retain their channel ranks as long as their nickgroups remain registered and identified. Their differences in structure appear with the ability to customize permissions assigned to specific ranks- The Access Level system is editable while the XOP Access system isn't.

Channels on this network use the Access Level system by default.


Using Access Levels

The Access Level system is a number-based access management system that allows the customization of access permissions by utilizing a number hierarchy (called Levels) to determine which rank level can do what. How this works is that each channel rank is assigned their own access level, and the permission sets that each rank has (such as kick, ban, or editing the badwords list) can also be edited to allow certain ranks to have additional (or fewer) access permissions. For instance, Voices by default are set to access level 3, and KICK levels are set to 5. If you wanted Voices to be able to kick people, the KICK level can be edited to level 3, which would allow Voices and anyone set to levels higher than 3 to use KICK commands.

While the Access Level system may appear daunting on first sight, custom editing each permission is completely optional- the default levels set to a channel are pre-configured to give ranks the standard set of channel permissions that are expected of a user at that rank. Your channel will most likely operate fine even if all you ever did was add people to the access list. This makes the Access Level system a preferred choice for overall channel access management.

Access permission levels can only be edited by someone who is set to owner/founder. In addition, most of these permission levels will only affect users who are registered and added to the channel access list. For more information about editing levels see /cs help levels or /msg chanserv help levels.

How to edit a level

All level editing uses the same base command:
/cs levels <#channel> set <option> <number>
or
/msg chanserv levels <#channel> set <option> <number>

Using a fantasy command:
!levels set <option> <number>


For example, setting the GREET level to 3 would be
/cs levels #channel set greet 3 or !levels set greet 3

and setting the AUTOPROTECT level to 51 would be
/cs levels #channel set autoprotect 51 or !levels set autoprotect 51

When setting a level, keep in mind that for most access permissions anyone set to a level above that permission level will be able to use it. So, placing someone at access level 10 will allow them to use anything set to access level 10 or below. The two exceptions to the above rule are AUTODEOP and NOJOIN, which are applied to anyone lower than the level set.

Levels have a number range of -9999 to 9999, and users who are not set to any access level ranks have a level of 0.


Disabling certain access permissions

In addition to setting an access permission to a specific level, you can disable it so that only owners/founders have access to the particular permission. To do this, use:
/cs levels <#channel> dis <permission option>
or
/msg chanserv levels <#channel> dis <permission option>

Using a fantasy command:
!levels dis <permission option>


For example, disabling SAY commands on the channel would be
/cs levels #channel dis say or !levels dis say

To (re)enable an option simply add an access level (back) to it.


How to view the current levels set to a channel

The following will bring up the list of all permission options and their currently set level:
/cs levels <#channel> list
or
/msg chanserv levels <#channel> list

Using a fantasy command:
!levels list


List of alterable Level settings and their default levels

The following are the permission options that can be altered using the Access Level System.
Option Defaut Level Description
AUTODEOP -1 Users assigned to this level and below will not be allowed channel OP.
AUTOHALFOP 4 Sets the HalfOP channel rank to registered users matching the level assigned.
AUTOOP 5 Sets the OP channel rank to registered users matching or above the level assigned.
AUTOPROTECT 10 Sets the admin/protected channel rank to registered users matching or above the level assigned.
AUTOVOICE 3 Sets the Voice channel rank to registered users matching the level assigned.
NOJOIN -2 Users matching the assigned access level will be unable to join the channel.
Because a specific user has to be registered in order for this feature to work, it is recommended to instead use bans or akicks if a person must be kept out of a channel.
SIGNKICK (disabled) Users matching the assigned level or higher will be allowed to turn the SIGNKICK setting that is set to the channel off and on. By default this feature is set to Owner/Founder only.

(The SIGNKICK setting displays the username of any person who performs a kick, and includes this name at the end of the kick message. Turning SIGNKICK off will remove the names from kick messages.)
ACC-LIST 1 Allows users matching the assigned level or higher to view the channel's access list.
ACC-CHANGE 10 Anyone matching the assigned level or higher will be able to make changes to the channel's access list.

Users with ACC-CHANGE access can only edit entries/usernames that are lower than their access level. However, users who have an access level of 9999 will be able to add others to level 9999.
AKICK 10 Users matching the assigned level or higher will be able to use and edit the channel's AKICK feature.
SET (disabled) Anyone matching the assigned level or higher will be able to use various /cs set <#channel> commands that alter channel settings.
By default this function is set to Owner/Founder level only.
BAN 5 Users matching the assigned level or higher will have access to the basic BAN commands.
If you would like HalfOP or Voice ranks to be able to perform channel bans, change the BAN level to the level set to AUTOHALFOP or AUTOVOICE.
BANME 5 Allows anyone matching the assigned level or higher to ban themselves from a channel.
Setting this level higher than the BAN level may help prevent staff-in-training from accidentally banning themselves from mistyped ban commands.
CLEAR (disabled) Allows anyone matching the assigned level or higher to perform /cs clear related commands in the channel.
By default this is set to Owner/Founder only.
GETKEY 5 Anyone matching the assigned level or higher will be able to use /cs getkey <#channel> to retrieve a key that may be set to the channel from channel mode +k.
HALFOP 5 Anyone matching the assigned level or higher will be able to set temporary halfop ranks to usernames in the channel via the /cs halfop command.
HALFOPME 4 Anyone matching the assigned level or higher will be able to set halfop to themselves.
INFO (disabled) Anyone matching the assigned level or higher will be able to use /cs info <#channel> all to view detailed information about a channel, such as mode locks and set channel options.
By default this is set to owner/founder level only.
KICK 5 Anyone matching the assigned level or higher will be able to use KICK commands in the channel.
Kicking is by default set to the same level as AUTOOP or higher, but its level is often edited to match AUTOVOICE or AUTOHALFOP levels to allow those ranks to have kick privilages too.
KICKME 5 Anyone matching the assigned level or higher will be able to kick themselves from the channel.
INVITE 5 Anyone matching the assigned level or higher will be able to use /cs invite <#channel> when a channel is set to +i.
OPDEOP 5 Anyone matching the assigned level or higher will be able to use the /cs op and /cs deop commands on other usernames.
OPDEOPME 5 Anyone matching the assigned level or higher will be able to use the /cs op and /cs deop commands on themselves.
PROTECT (disabled) Anyone matching the assigned level or higher will be able to set/remove temporary protected/admin channel ranks to other usernames.
By default this is restricted to Owner/Founder level only.
PROTECTME 10 Anyone matching the assigned level or higher will be able to set/remove the protected/admin channel rank on themselves.
TOPIC (disabled) Anyone matching the assigned level or higher will be able to change the channel topic using /cs topic <#channel> <channel topic here>. By default this is set to owner/founder only.

Note that this level setting has no influence on commands such as /topic <#channel> <channel topic here> and !topic <channel topic here>.
UNBAN 5 Anyone matching the assigned level or higher will be able to unban themselves from a channel using /cs unban <#channel>. This allows the user to unban themselves even if they are not present in the channel to use the other unban commands.
VOICE 5 Anyone matching the assigned level or higher will be able to set/remove temporary voice ranks to other users in the channel.
VOICEME 3 Anyone matching the assigned level or higher will be able to give or temporarily remove voice to themselves.
MEMO 10 Anyone matching the assigned level or higher will be able to read the memos that were sent to the channel.
ASSIGN (disabled) Anyone matching the assigned level or higher will be able to assign/unassign a bot to the channel using the /bs assign/unassign command.
BADWORDS 10 Anyone matching the assigned level or higher will be able to view and edit the badwords list from the /bs kick <#channel> badwords setting.
FANTASIA 3 Anyone matching the assigned level or higher will be able to use fantasy commands (ie. those commands that begin with ! like !kick and !kb that are typed into the channel to execute). The command permissions will still be affected by the levels setting of the commands used.
GREET 5 Anyone matching the assigned level or higher will have their greet message set from /ns set greet <message here> announced to the channel upon entry.
NOKICK 1 Anyone matching the assigned level or higher will be exempt from triggers set by the various /bs kick settings assigned to the channel.
SAY 5 Anyone matching the assigned level or higher will be be able to use /bs say <message> and /bs act <action> through the channel bot.


Adding users to the Access List

You can assign users to the channel's access list by using the access add command. Remember that only registered users can be added to the channel access list.
/cs access <#channel> add <username> <access level>
or
/msg chanserv access <#channel> add <username> <access level>

Using a fantasy command:
!access add <username> <access level>

To remove a user from the access list use:
/cs access <#channel> del <username or access list entry number(s)>
or
/msg chanserv access <#channel> del <username or access list entry number(s)>

Using a fantasy command:
!access del <username>

By default the rank levels are:
3 (Voice)
4 (Halfop)
5 (Channel OP)
10 (Admin/Protected)
9999 (Owner/Founder)

If the rank levels are edited from default, all that needs to be done is to use the new level instead of the default one. For example, if the AUTOOP (Channel OP) level was changed from 5 to 47, the access command used to give a user OP would now be:
/cs access #channel add username 47 or !access add username 47

Any changes to the access levels will still only effect users who are registered and added to the access list.


Returning access levels to default settings

You can use the following command to return all level edits set to a channel back to default settings:
/cs levels <#channel> reset
or
/msg chanserv levels <#channel> reset

Using a fantasy command:
!levels reset






Using the XOP System

The XOP system is basic and straightforward- simply add users to the specified rank list and nothing further is needed to be done. All channel permissions and features are pre-set and unchangeable, and as long as you are aware of what each rank can and can't do people can be easily grouped and managed. The drawback of the XOP system is that beyond applying ranks to usernames no access permissions can be customized. This may cause some headaches if, for example, you want to allow users set to VOP (voice) to be able to use the KICK commands. Nonetheless, this system may be beneficial to those who want simple and easy to remember channel access commands and features.

If you wish to use the XOP Access system on this network you will need to manually activate it.


What happens to custom levels when converting from Access Levels to XOP?

When converting a channel from Levels to XOP, all edited levels will be returned to default before being disabled. If you attempt to edit an access/permission level while the XOP system is activated you will receive a message reminding you that levels have been disabled.

Users who were added to custom access levels will be set to the XOP rank that closest fit what level-based rank they had. However, any users that were set to 9999 and were not the registered founder of the channel will be adjusted down to the SOP (admin) rank, and will only be able to perform default admin-level commands.

If you turn XOP off to return your channel to a level-based system all level settings will be at default, regardless of what they were set to previous to the XOP switch-over.

How to turn XOP on/off

To turn on the XOP system use the following:
/cs set <#channel> xop on
or
/msg chanserv set <#channel> xop on

Using a fantasy command:
!set xop on


To turn off the XOP system use the following:
/cs set <#channel> xop off
or
/msg chanserv set <#channel> xop off

Using a fantasy command:
!set xop off


Setting XOP Ranks

Users can be added to the following ranks: VOP (Voice OP), HOP (HalfOP), AOP (OP/Auto-Op) and SOP (Super OP/admin/protected). All users added to the XOP access list need to have registered usernames.


VOP
VOP is the XOP Voice rank. Other than being able to post to a channel during a channel mute, VOPs don't really have any notable channel permissions.

To add a user to VOP:
/cs vop <#channel> add <username>
or
/msg chanserv vop <#channel> add <username>

Using a fantasy command:
!vop add <username>


To remove a user from VOP:
/cs vop <#channel> del <username>
or
/msg chanserv vop <#channel> del <username>

Using a fantasy command:
!vop del <username>



HOP
HOP is the XOP Halfop rank. Halfops have access to the /kick command, but can not use kicks or bans involving chanserv or fantasy commands.

To add a user to HOP:
/cs hop <#channel> add <username>
or
/msg chanserv hop <#channel> add <username>

Using a fantasy command:
!hop add <username>

To remove a user from HOP:
/cs hop <#channel> del <username>
or
/msg chanserv hop <#channel> del <username>

Using a fantasy command:
!hop del <username>



AOP
AOP is the XOP channel OP rank. These users have permissions similar to the standard OP rank given to the Level-based access rank, such as being able to use fantasy commands, chanserv-based kicks and bans as well as editing channel modes.
To add a user to AOP:
/cs aop <#channel> add <username>
or
/msg chanserv aop <#channel> add <username>

Using a fantasy command:
!aop add <username>


To remove a user from AOP:
/cs aop <#channel> del <username>
or
/msg chanserv aop <#channel> del <username>

Using a fantasy command:
!aop del <username>



SOP
SOP is the XOP admin/protected rank. These users have permissions similar to that of the standard level-based admin/protected rank, such as being able to edit akicks, badwords list entries and being able to edit the XOP access list. Only the registered founder of a channel can add a user to the SOP rank.

To add a user to SOP:
/cs sop <#channel> add <username>
or
/msg chanserv sop <#channel> add <username>

Using a fantasy command:
!sop add <username>


To remove a user from SOP:
/cs sop <#channel> del <username>
or
/msg chanserv sop <#channel> del <username>

Using a fantasy command:
!sop del <username>



QOP
QOP is the XOP Founder level rank. This rank is given solely to the registered founder of the channel and can not be assigned to any other user via XOP commands. QOPs have permissions similar to that of the Access Level-based owner/founder.


About setting multiple owner ranks

Unfortunately, the XOP system does not support having a channel with multiple users at owner/founder level. If having multiple owners/founders is a feature crucial to your channel's management, it is best to turn XOP off and instead use the Access Level system. Note that settings such as channel successors can still be used here.


Clearing XOP ranks


The XOP clear command can be used to quickly clear all usernames that are set to a particular rank on the XOP access list. This command can only be used by the registered channel founder.
/cs <xOP rank> <#channel> clear
or
/msg chanserv <xOP rank> <#channel> clear

Using a fantasy command:
!<xOP rank> clear


Replace <xOP rank> with VOP, HOP, AOP or SOP, depending on what rank you would like to clear.

Using the clear command will remove all users of that target rank from the XOP access list, but if any of the users of the affected rank are present in the channel at the time the clear command is used, their visible rank will remain. Any rank they still display will now be treated as a temporary assigned rank and will disappear when they exit the channel. If a user must be de-ranked immediately, the delete command specific to that user and access rank should be used instead.


This concludes the section of using Access Levels and XOP Lists. If you ever need help with any of the above, feel free to drop by #help or use one of our support e-mails to get in touch with staff.