MODE

The MODE command is used to set or get channel modes or user modes.

Setting or Getting Channel Modes

Usage: MODE <channel> {[+|-][modes] [<modeparams>...]}
<channel> The channel to set or get modes for.
<modes> A string of mode characters to set (+) or unset (-).
<modeparams> (Optional) Parameters for the modes being set or unset.

The following channel modes are supported:

• a Authenticated Only (Only authenticated users can join)
• d Cloneable (Automatically clones channel when member limit is reached)
• e Clone (Channel is a clone) (Read-only)
• f No Format (Instructs client software to not format messages)
• g Op Guard (Protects channel operators from being demoted)
• i Invitation Only (Only invited users can join)
• j Restrict Access (Prevents changes to the channel access list)
• k Channel Key (Password required for entry) (Requires parameter)
• l Member Limit (Maximum number of members allowed to join) (Requires parameter)
• m Moderated (Only voiced members can send messages)
• n No External (Block messages from non-members)
• p Private Channel (Topic and members are hidden to non-members)
• r Registered Channel (Channel remains persistent)
• s Secret Channel (Channel is completely hidden from non-members)
• t No Topic (Restricts topic changes to channel operators)
• u Knock (Send notifications of failed join attempts to channel operators)
• w No Whispering (Disables private messaging via the channel among members)
• x Auditorium (Restricts visibility of channel members) (Read-Only except at creation)
• y Lock Modes (Prevents channel modes being changed)
• z Service Channel (Used for services)
• A Special Control (Server operators have no elevated permissions)
• C Non-Persistent Access (Channel access list cleared after last member leaves)
• D Data Channel (Enables Data Streaming for VoIP etc.)
• E Local Echo (Server will echo back your own sent messages)
• F Filter Channel (Enables content filtering)
• K Lock Keys (Prevents channel passwords being changed)
• L Auto Start Channel (Channel remains open with no members)
• M Operators Only (Only server operators can join)
• P Permanent Channel (Not subject to automatic deregistration when inactive)
• S Encrypted (Only users with encrypted connections can join)
• T Save Transcript (Channel activity is logged)
• V Auto Voice (Grants voice permission upon join)

The h Hidden (IRCX) mode is used instead for Aide (HalfOp) status. For backwards compatibility any attempts to set this mode using a pure IRCX client will result in s Secret mode being set instead.

Channel Access List Modes

The following channel modes affect the channel access lists:

• b Ban Mask (Bans users matching the specified mask) (Requires parameter)
• e Ban Exception Mask (Exempts users matching the specified mask from bans) (Requires parameter)
• I Invite Exception Mask (Exempts users matching the specified mask from invites) (Requires parameter)

User Channel Modes

The following modes affect users within a channel:

• q Channel Owner (Creator)
• o Channel Host (Op)
• h Channel Aide (HalfOp)
• v Voiced Member (Allows member to send messages in a moderated channel)

Setting or Getting User Modes

Usage: MODE <user> {[+|-][modes]}
<user> The nickname of the user to set or get modes for.
<modes> A string of mode characters to set (+) or unset (-).
The following user modes are supported:

• a Server Administrator (Full access)
• c View Connects (Not Implemented / Obsolete; use EVENT command instead)
• e No DCC (Blocks direct client connections requests)
• g Network Manager (Can connect and disconnect servers across the network)
• h Help Assistant (Receive help messages) (HELP - Not Implemented)
• i User Invisible (Hides user from wildcard queues and channel member lists of non-members)
• o Global Operator (Can perform actions on or against all users)
• p No CTCP (Blocks Client-to-client protocol requests)
• r Restricted User (Under Client Rule restrictions) (Not Implemented)
• s View Server Messages (Not Implemented; use EVENT command instead)
• w Wallops (Send and receive messages that warn all operators)
• x IRCX (Using IRCX protocol)
• y View Whois and Kick notifications (Not Implemented)
• z Gag (Prevents user from sending messages)
• A Anonymous Operator (Allows the operator to be covert)
• L Filter Messages (Filter the content of inbound messages)
• O Local Operator (Can perform actions on local users)
• R Readable Text (Strips color codes and formatting from inbound messages) (Not Implemented)

(See section 4.2.3 of RFC 1459, sections 3.1.5 and 3.2.3 of RFC 2812, and sections 5.9 and 7 of IRCX)