CHANLEV

CHANLEV Command

Usage

CHANLEV <channel> [<user> [<change>]]

Description

The CHANLEV command is used to view or modify user access levels on a channel.

Parameters

• channel
  The channel to operate on.

• user (optional)
  The user to view or modify. This can be:

  • An active nickname on the network, or
  • An account name (prefixed with #)

  If omitted, all known users on the channel are listed.

• change (optional)
  Specifies flags to add or remove:

  • Use + to add flags
  • Use - to remove flags

  Examples:

  • +ao → Adds flags a and o
  • -gv → Removes flags g and v

  If omitted, the current access level of the user is displayed.

Access Requirements

• Viewing user access requires known (+k) status on the channel.
• Modifying other users’ access requires master (+m) access.
• Granting or removing master (+m) requires owner (+n) access.
• Only channel owners can grant +n (owner) using the GIVEOWNER command.
• You may remove your own flags (except hidden flags such as +q, +d, +b).
• Modifying your own flags requires known (+k) status.

Access Hierarchy

Access flags are hierarchical:

• Higher-level flags automatically grant permissions of lower-level flags.
• Example: A user with +m (master) can perform operator (+o) actions even without explicitly having +o.

Available Flags

Access Level Flags

These define overall privileges on the channel:

+n — OWNER
Full control. Can assign/remove all flags, including masters.

+m — MASTER
Can assign/remove most flags, except owner and master.

+o — OP
Can obtain operator status on the channel.

+v — VOICE
Can obtain voice status on the channel.

+k — KNOWN
Marks the user as known. Allows invites via the INVITE command.

Punishment Flags

These restrict user capabilities:

+q — DEVOICE
Prevents the user from being voiced.

+d — DEOP
Prevents the user from being opped.

+b — BANNED
Bans the user from the channel.

+s — SUSPENDED
Suspends all channel access until removed by an admin.

Extra Flags

These modify behavior:

+a — AUTOOP
Automatically ops the user on join (requires +o).

+g — AUTOVOICE
Automatically voices the user on join (requires +v).

+p — PROTECT
Ensures the user retains +o or +v status (reapplied if removed).

+t — TOPIC
Allows the user to change the channel topic using TOPIC.

Personal Flags

User-specific preferences (only visible/editable by the user):

+w — NOWELCOME
Disables the welcome message on join.

+j — AUTOINV
Automatically invites the user when they authenticate.

Notes

• Some flag combinations are not allowed if they conflict.
• After any change, the system will confirm the user’s updated access level. 
  
  
  
  For FULL X commands list please visit https://emechnet.org/?page=services_help