Access Level FAQ
The access system allows you to control what privileges and capabilities users have in your channel. There are three main areas of the system: ACCESS
, FLAGS
, and TEMPLATES
.
The ACCESS
command allows you to add and remove users from you channel's access list. For most channel owners, this command is all that you'll need to manage ChanServ access.
For users looking for an advanced solution, we offer two additional commands to customize a channel's ChanServ access system more extensive. The FLAGS
command allows you to modify the access capabilities of users on the access list. TEMPLATES
allows you to define specific roles that you can easily group your users into. For more information, read about each of these commands below.
Q: How do I add or remove users from my channel?
The ACCESS
command allows displaying and changing privileges on channels.
The ACCESS LIST
subcommand displays a list of users and their privileges.
The ACCESS ADD
subcommand adds a user to the access list or changes their privileges if they were already on the access list.
If the level field is specified, it specifies the privileges to grant, see the FLAGS
and TEMPLATE
help files. If not, the user will be given privileges appropriate for day-to-day management of the channel.
The ACCESS DEL
subcommand removes a user from the access list.
Syntax:
/msg ChanServ ACCESS <#channel> LIST
/msg ChanServ ACCESS <#channel> ADD [role]
/msg ChanServ ACCESS <#channel> DEL
Examples:
/msg ChanServ ACCESS #darkmyst LIST
/msg ChanServ ACCESS #darkmyst ADD foo Operator
/msg ChanServ ACCESS #darkmyst DEL foo
The following roles are available by default:
- Member: User is auto-voiced when they enter the channel.
- Operator: User has channel operator privileges.
- Admin: User has administrative privileges, including the ability to modify access lists.
- Founder: User is the founder and owner of the channel.
Q: How do I use the FLAGS command? [Advanced Users]
User access levels are controlled through the use of FLAGS command. This allows for the granting/removal of channel privileges on a more specific, non-generalized level. It supports nicknames, groups and hostmasks as targets.
When only the channel argument is given, a listing of permissions granted to users will be displayed.
Otherwise, an access entry is modified. A modification may be specified by a template name (changes the access to the template) or a flags change (starts with +
or -
). See the TEMPLATE help entry for more information about templates.
If you are not a channel founder, you may only manipulate flags you have yourself, and may not edit users that have flags you don't have. For this purpose, +v
grants +V
, +o
grants +O
and +r
grants +b
.
For a listing of flags permissions available, see below.
Syntax:
/msg ChanServ FLAGS <#channel> [nickname|hostmask|group flag_changes]
Examples:
/msg ChanServ FLAGS #foo
/msg ChanServ FLAGS #foo foo!*@bar.com VOP
/msg ChanServ FLAGS #foo foo!*@bar.com -V+oO
/msg ChanServ FLAGS #foo foo!*@bar.com -*
/msg ChanServ FLAGS #foo foo +oOtsi
/msg ChanServ FLAGS #foo TroubleUser!*@*.troubleisp.net +b
/msg ChanServ FLAGS #foo !baz +*
Q: How do I use the TEMPLATE command? [Advanced Users]
TEMPLATE
command allows definition of sets of flags, simplifying the use of the FLAGS
command.
When given only the channel argument, a listing of templates for the channel will be displayed.
Otherwise, a template is modified. A modification may be specified by a template name (copies the template) or a flags change (starts with +
or -
, optionally preceded by an !
). Templates cannot be the empty set (making a template empty deletes it).
If the !
form is used, all access entries which exactly match the template are changed accordingly. This is not supported if the template includes or included founder access (+F
).
There is a limit on the length of all templates on a channel.
If you are not a founder, similar restrictions apply as in FLAGS
.
Syntax:
/msg ChanServ TEMPLATE <#channel> [template] [oldtemplate|flag_changes|!flag_changes]
Examples:
/msg ChanServ TEMPLATE #darkmyst
/msg ChanServ TEMPLATE #darkmyst user Member
/msg ChanServ TEMPLATE #darkmyst user !+A
/msg ChanServ TEMPLATE #darkmyst co-founder +*-O
/msg ChanServ TEMPLATE #darkmyst op -*+vVoti
/msg ChanServ TEMPLATE #darkmyst obsoletetemplate -*
Q: What channel access flags are available?
The following flag permissions may be used with the FLAGS command:
Permissions:
+v
- Enables use of the voice/devoice commands.
+V
- Enables automatic voice.
+o
- Enables use of the op/deop commands.
+O
- Enables automatic op.
+s
- Enables use of the set command.
+i
- Enables use of the invite and getkey commands.
+r
- Enables use of the kick, kickban, ban and unban commands.
+R
- Enables use of the recover and clear commands.
+f
- Enables modification of channel access lists.
+t
- Enables use of the topic and topicappend commands.
+A
- Enables viewing of channel access lists.
+S
- Marks the user as a successor.
+F
- Grants full founder access.
+b
- Enables automatic kickban.
The special permission +*
adds all permissions except +b
and +F
.
The special permission -*
removes all permissions including +b
and +F
.