Channel modes

From Ravenchat Wiki
Jump to: navigation, search

This is a list of all the channel modes available on Ravenchat. Channel modes alter the way a channel behaves on the network. Users who are half operators and above can set channel modes. Some channel modes require additional arguments. Those modes are covered separately at the bottom of the page.

To set a mode on a channel, you would issue the following command in your IRC client:

/mode #channel +/-modes

Where #channel is the channel you want to set, +/- denotes whether you want to set or unset modes respectively, and the word modes represents the mode letter(s) you wish to set. You can set and/or upset up to 20 modes in one command. For instance, to mute a channel, make it SSL only, but remove the secret channel mode on #channel, you would issue this command:

/mode #channel +mz-s

Note that channel modes are case sensitive. In the event that two channel modes use the same letter, the capital letter will be listed first, followed by the lower case letter.

User mode Description
A Normally, invitations to channels are issued through an invite command by someone with half operator status or higher. This channel mode removes that restriction and allows all users in the channel to issue invites. Use this this care.
C This mode blocks all CTCP commands from being sent to the channel, with the exception of CTCP ACTION commands.
i This marks the channel as invite only. This is mostly useful if you have a channel set aside for channel operators of another channel, or if you want to ensure that only people you know and approve can join the channel.
K This mode prevents anyone from using a knock command to request an invitation to a channel that they could not otherwise join.
M This mode prevents anyone from sending messages to the channel unless they are registered with and identified to NickServ, or if they have channel mode +v set on them. Any user may still join or part the channel normally unless they are otherwise affected by another channel mode preventing them from doing so.
m This mode prevents anyone who is not voiced or above from sending messages to the channel. This is mostly useful for support channels where you only want one or a small number of users to discuss things one at a time.
n This prevents users from sending messages to the channel unless they are already in the channel. New channels are automatically set with this mode and registered channels are set up with this mode in their channel locks. There is rarely any reason to ever remove this mode.
O This mode prevents anyone from joining the channel without user mode +o. That is, users must be an IRC operator that is identified to the server they are on. Only IRC operators may set or unset this mode.
P This marks a channel as permanent. Permanent channels will still remain in list commands issued by users unless the channel is a private or a secret channel. This mode may only be set or unset by IRC operators but may be made available upon request.
p This denotes a private channel. Private channels will not appear in list commands that are issued by any users except IRC operators.
q This mode denotes a channel owner. While this mode technically takes arguments, and thus should be included in the bottom list, it is kept here because only services may set or unset this mode. This mode is automatically set on all channel founders when they are in the channel and identified to services, unless they have set their autoop off (not the default behavior).
R This mode prevents users from joining the channel at all unless they are registered with and identified to a NickServ account.
r This mode denotes that a channel is registered with services. Only services may set or unset this mode, and only when a channel is registered or dropped respectively.
S This mode strips out all control codes from messages sent to the channel, which removes all coloring, bolding, italicizing, and underlining from such messages. The user using these codes will still see the unaltered messages.
s This marks the channel as secret. Nobody will see the channel when a list or a whois command is issued unless the person is already in the channel or is an IRC operator.
T This mode bars the sending of notice commands to the IRC channel. This mode is mostly useful to stop nuisance spam messages.
t This mode prevents anyone from changing the topic unless they have half operator status on the channel or above. This mode is automatically set by the IRC server upon joining an empty channel and is in a channel's mode locks by default.
Y This denotes an IRC operator who has joined a channel with an ojoin command. This join will be announced to all channel operators and the IRC operator who joined will be exempt from all channel modes and immune from kicking. Operators joining channels in this way will have their nickname prefixed with a ! character. You are unlikely to ever see this.
z This mode prevents users from joining your channel unless they are connected to the IRC server on port 6697. This port is the port which supports secure socket layer, or SSL. Thus, only SSL users will be able to join the channel.

Modes requiring arguments

These channel modes take additional arguments which are further described below. You can mix and match mode letters as above, with all of the arguments coming after the final mode letter in the command. Modes and their arguments are applied in sequence. For instance, if you want to give operator status to user1, remove operator status from user 2, give voice to user 3, remove voice from user 4, make the channel secret, remove SSL only mode, and do all of this in #channel, you could use this command to do it:

/mode #channel +sov-zov user1 user3 user2 user4

User mode Argument format Description
b b [email protected] This bans a specified user or users from the channel. Bans take the format of [email protected] and must be given in that order every time. Wild cards can be used for any field. If you wish to simplify your ban command and have an effective ban, you would issue your ban in the format of +b [email protected] where host is the host name field that appears in a whois command. Your client may come with its own ban command to further simplify this, but we would be unable to offer immediate support for that here. Note that banned user are not automatically removed from a channel. For this you must also issue a kick.
e e [email protected] This provides a ban exception for the specified user or users. This works identically to user mode +b above. For more information about the formatting of ban exception masks, see the above user mode.
F F n:s This provides a method of controlling the number of allowed nick changes over a given period of time. A user is allowed n nick changes in s seconds. To set this mode for 3 changes in 10 seconds, the proper method is +F 3:10
f f [*]n:s This mode provides control over how many messages may be sent to the channel by a user in a given amount of time. A user is allowed to send n messages every s seconds. Users that exceed this are kicked from the channel. If the optional * is included, then the user is also banned. The proper way to set up 3 messages every 10 seconds with a ban for exceeding these numbers is +f *3:10
h h nick This mode sets or unsets the target user as a half operator. You will usually not need to set this mode because services will handle this for you if the channel is registered.
I I [email protected] This is an invite exception, usually called invex by the server software. Any user matching the mask provided to the invite exception is permanently invited to the channel and can join the channel whenever it is set to +i. The format for the host mask is exactly the same here as it is for modes b and e.
j j n:s This is a join throttle. If set, then n users will be allowed to join in s seconds. This is mostly useful to prevent join flooding to the channel.
k k password This mode sets a channel key. If set, only users who know the key will be able to join the channel. Note that users in the channel will be able to see the key, so do not set this while anyone you do not trust is still present in the channel.
L l #channel This mode will forward users to another channel when the current channel is full, usually because the channel limit below has been reached. You must be a channel operator in the target channel for this command to work.
l l number This sets a limit on the number of people that can be in the channel at any one time. If you use this, it is recommended that you have a bot set this limit for you. Most bots should be capable of doing this.
o o nick This mode provides channel operator status to the target nick. You will usually not set this mode yourself, as services will control this mode automatically on all registered channels.
v v nick This mode provides voice access to the target nick. You would not normally set this mode yourself unless it is for an unregistered user, as services will control this mode automatically on all registered channels.