Channel management: Difference between revisions
No edit summary |
→Extended Bans: Removed template use from the section, was causing PHP notices to be spat out on the page |
||
(11 intermediate revisions by 4 users not shown) | |||
Line 4: | Line 4: | ||
* Commands in this guide will be given in both the <code>/msg</code> format, and the fantasy command format. | * Commands in this guide will be given in both the <code>/msg</code> format, and the fantasy command format. | ||
Most aspects of channel management on Xertion are controlled by ChanServ. ChanServ manages the registration and settings of channels on the network. | |||
Commands to [[ChanServ]] can be given in a number of ways: | Commands to [[ChanServ]] can be given in a number of ways: | ||
Line 12: | Line 10: | ||
* Fantasy: <code>.[command] [variable]</code> | * Fantasy: <code>.[command] [variable]</code> | ||
==Managing Channel Access== | ==Managing Channel Access== | ||
===Adding Access=== | ===Adding Access=== | ||
====Access Levels==== | ====Access Levels==== | ||
Access levels define who gets what level of access in a channel, which defines what modes someone gets and what ChanServ functions they're allowed to use on the channel. There are a number of ways to define someone's access in a channel - the most well known of these is the ACCESS command. | |||
< | <span style="color: rgb(255, 0, 0);" data-mce-style="color: #ff0000;">'''NOTE: '''</span>With the ACCESS, SOP/AOP/HOP/VOP, and FLAGS commands, you can specify a '''nickname!user@host''' mask instead of just '''nickname''', which can be used to give unregistered users matching the host mask the specified access. '''''Be careful using user@host masks though, because you could accidentally give someone else access you didn't intend to!''''' | ||
To add someone to the channel's access list: | |||
* <code>/msg ChanServ ACCESS #channel ADD nickname level, OR</code> | |||
* Type in channel: <code>.access add nickname level</code> | |||
The default levels used for 'level' are as follows - note these are just the default settings, they can be changed with ChanServ's LEVELS command. See the [[ChanServ]] page for more details on this. | |||
<pre>Level 3 -- Gives user voice (+).<br data-attributes="class=%22mw_emptyline%22">Level 4 -- Gives user half-operator (%) status.<br data-attributes="class=%22mw_emptyline%22">Levels 5 - 9 -- Gives user operator (@) status.<br data-attributes="class=%22mw_emptyline%22">Levels 10 - 9998 -- Gives user administrator/protected (&) status.<br data-attributes="class=%22mw_emptyline%22">Level 9999 -- Gives user co-founder (~) status.<br data-attributes="class=%22mw_emptyline%22"></pre> | |||
====xOP==== | ====xOP==== | ||
If you | If you want simplicity, you can use the xOP commands to modify channel access. There are 4 basic commands: | ||
* SOP - '''S'''uper'''OP''' -- Equivalent to admin/protected status, &, or levels 10-9998 by default | |||
* AOP - '''A'''uto'''OP''' -- Equivalent to operator status, @, or levels 5-9 by default | |||
* HOP - '''H'''alf'''OP''' -- Equivalent to half-op status, %, or level 4 by default | |||
* VOP - '''VO'''ice'''P'''erson -- Equivalent to voice, +, or level 3 by default | |||
Note that there is no 'turning on/off' the xOP system - it's always there right alongside the ACCESS command, so you can alternate between whichever method is more comfortable for you. | |||
* Adding SOPs (admins) | |||
** <code>/msg ChanServ SOP [#channel] add [nickname]</code>, OR | |||
** Type in channel: <code>.sop add [nickname]</code> | |||
* Assign AOPs (operators) | |||
** <code>/msg ChanServ AOP [#channel] add [nickname]</code>, OR | |||
** Type in channel: <code>.aop add [nickname]</code> | |||
* Assign HOPs (half-operators) | |||
** <code>/msg ChanServ HOP [#channel] add [nickname]</code>, OR | |||
** Type in channel: <code>.hop add [nickname]</code> | |||
* Assign VOPs (voice users) | |||
** <code>/msg ChanServ VOP [#channel] add [nickname]</code>, OR | |||
** Type in channel: <code>.vop add [nickname]</code> | |||
===Removing Access=== | ===Removing Access=== | ||
If ever | If you ever need to remove someone's channel access, you can do so as follows: | ||
* <code>/msg ChanServ ACCESS # | * With ACCESS command: <code>/msg ChanServ ACCESS [#channel] DEL [nickname]</code> will remove the given nickname's access from the specified channel. | ||
* <code>/msg ChanServ | ** In-channel: .access del [nickname] | ||
* | * With SOP/AOP/HOP/VOP commands: <code>/msg ChanServ [SOP|AOP|HOP|VOP] [#channel] DEL [nickname]</code> will remove the given nickname's access from the specified xOP list. | ||
** In-channel: .sop del [nickname] OR .aop del [nickname] OR .hop del [nickname] OR .vop del [nickname] | |||
==Channel Modes== | |||
Channel modes are used to control basic functions and settings of the channel. | |||
To set a channel mode on a channel: | |||
To | * <code>/mode [#channel] +''[mode letter(s)]''</code> | ||
* <code>/mode # | To remove a mode... | ||
* <code>/mode [#channel] -''[mode letter(s)]''</code> | |||
* <code>/mode # | You can also add AND remove modes at the same time: | ||
* <code>/mode [#channel] +''[mode(s)]''-''[mode(s)]]</code>, etc etc. | |||
Some commonly used modes on Xertion: | |||
* Channel mode +c - block all messages to the channel that contain color/styling. | |||
* Channel mode +S - strip color/styling from messages, so they appear as plain text. | |||
* Channel mode +p - mark the channel as 'private', which hides it from a user's whois output and replaces it with a '*' in a /list output. '''IRC Operators/Admins on Xertion can always see all channels even if this is set.''' | |||
* Channel mode +s - mark the channel as 'secret', which hides it from the /list command and from a user's whois output. '''IRC Operators/Admins on Xertion can always see all channels even if this is set.''' | |||
* Channel mode +k - set a password to join the channel, specify the password as the second parameter (e.g /mode #channel +k password), include with /join command when set (/join #channel password). Note that to UNSET this mode, you must specify the same password that is currently set. | |||
* Channel mode +i - marks the channel as invite-only, users must be invited with the /invite command (or have an invite exception set in the channel) to join. | |||
* Channel mode +l - sets a maximum limit on the number of users that can be in the channel at one time (e.g /mode #channel +l 500, will set a limit of 500 users) | |||
* Channel mode +m - 'moderates' the channel. When +m is set, users must have voice (+v) or above to send messages to the channel. | |||
This is just a partial list of modes. A full list of modes and what they do, can be obtained by typing '''/quote help chmodes''' on the network. | |||
==Banning== | ==Banning== | ||
Banning a user from a channel | Banning a user from a channel essentially prevents them from joining and/or speaking. Channel bans are set using a '''nick!user@host''' mask format. This format also supports wildcards, so you can ban more than one user at a time with a single ban. | ||
Channel bans are set with channel mode +b | |||
* | * To ban a user by hostname: | ||
* | ** <code>/mode #channel +b *!*@some.hostname.mask</code> | ||
* | ** <code>/mode #channel +b *!user@*.hostname.mask</code> | ||
** '''The above format is the most effective way of setting channel bans, and are HIGHLY recommended for use over any other ban mask format''' | |||
* To ban a user by nickname: <code>/mode #channel +b nickname!*@*</code> | |||
* To ban a user by their ident (the 'user' portion of the user@hostname mask): <code>/mode #channel +b *!ident@*</code> | |||
== | ==Excepts/Invite-Excepts== | ||
In addition to banning, you can also set up channel exemptions (excepts) and channel invite-exceptions (invexes), which exempt users matching the specified nick/hostmask from bans and channel mode +i, respectively. | |||
Users whose hostname matches a channel exception mask can join a channel even if they match an existing channel ban. Users whose hostname matches a channel invite-exception mask can join an invite-only channel without needing to be invited in. | |||
The commands to set these are: | |||
* Channel exceptions: | |||
** By hostname - <code>/mode #channel +e *!*@some.hostname.mask</code> OR <code>/mode #channel +e *!user@*.hostname.mask</code> OR simply use the nickname (most common with an exception mask): <code>/mode #moo +e nickname!*@*</code> | |||
* Channel invite-exceptions: | |||
** By hostname - <code>/mode #channel +I *!*@some.hostname.mask</code> OR <code>/mode #channel +I *!user@*.hostname.mask</code> OR simply use the nickname (most common with an exception mask): <code>/mode #moo +I nickname!*@*</code> | |||
===Extended Bans=== | |||
< | An alternative to channel modes like +m, +N, +S, etc is to use what's known as extended bans. These are special bans that apply a specific channel restriction (such as channel mode +m for example), to just a user or set of users. This is typically done as follows: <code>/mode #channel +b [letter]:[mask/parameters]</code> | ||
Extended bans can also be used in ban exceptions (EXCEPTS) and invite-exceptions (INVEX): | |||
* When extended bans are used in ban exceptions (mode +e), matching users are not affected by the corresponding channel mode (if it is currently set), and are also not affected by a matching extban of that type. | |||
* When extended bans are used in invite-exceptions (mode +I), matching users are allowed to bypass channel mode +i. | |||
<span style="color: rgb(255, 153, 0);" data-mce-style="color: #ff9900;">'''WARNING:'''</span>'''The extended bans listed here, as well as most extended bans supported on Xertion, DO NOT affect users with at least voice (+v) or above in the channel. An exception to this is extended ban Q, which DOES affect channel halfoperators and above. Please keep this in mind!''' | |||
Some commonly used extended bans and how to set them: | |||
* Extended ban '''m''': Matching users cannot "talk" in the channel - <code>/mode #channel +b m:*!*@some.hostname.mask</code> | |||
** ''When used with ban exception:'' Matching users can talk if channel mode +m is set - <code>/mode #channel +e m:*!*@some.hostname.mask</code> | |||
* Extended ban '''N''': Matching users are not allowed to change their nickname while in the channel - <code>/mode #channel +b N:*!*@some.hostname.mask</code> | |||
** ''When used with ban exception:'' Matching users can change nicknames if channel mode +N is set - <code>/mode #channel +e N:*!*@some.hostname.mask</code> | |||
* Extended ban '''c''': Matching users cannot send messages with color/styling to the channel - <code>/mode #channel +b c:*!*@some.hostname.mask</code> | |||
** ''When used with ban exception:'' Matching users can send colored/styled messages to the channel if channel mode +c is set - <code>/mode #channel +e c:*!*@some.hostname.mask</code> | |||
* Extended ban '''Q''': Matching users cannot use the /kick command - <code>/mode #channel +b Q:*!*@some.hostname.mask</code> | |||
** ''When used with ban exception:'' Matching users can use the /kick command when channel mode +Q is set - <code>/mode #channel +e N:*!*@some.hostname.mask</code> | |||
A full list of extended bans can be found by typing (on the network): <code>/quote help extbans</code> | |||
==Miscellaneous== | ==Miscellaneous== | ||
* <code>/whois | Here's a few other commands that can be helpful in assisting you with the above information | ||
* <code>/list</code> - | * <code>/whois [nickname]</code> - Gives you general information on the given nickname, if they are online. This is most useful to obtain a given user's user@host mask for use with channel bans/exceptions/invite-exceptions | ||
* <code>/list</code> - Pulls up a list of channels on the network. Channels that have channel mode +p set will only appear as a '*' in the list, and channels that have channel mode +s set won't appear in the list at all (they ARE secret after all) | |||
Line 140: | Line 133: | ||
[[Category:Tutorials]] | [[Category:Tutorials]] | ||
[[Category:Services]] | |||
[[Category:Commands]] |
Latest revision as of 03:09, 26 May 2020
Types of Commands
- Fantasy commands are commands initiated with a period. "."
- Commands in this guide will be given in both the
/msg
format, and the fantasy command format.
Most aspects of channel management on Xertion are controlled by ChanServ. ChanServ manages the registration and settings of channels on the network.
Commands to ChanServ can be given in a number of ways:
- Messages:
/msg ChanServ [command] [variable]
- Fantasy:
.[command] [variable]
Managing Channel Access
Adding Access
Access Levels
Access levels define who gets what level of access in a channel, which defines what modes someone gets and what ChanServ functions they're allowed to use on the channel. There are a number of ways to define someone's access in a channel - the most well known of these is the ACCESS command.
NOTE: With the ACCESS, SOP/AOP/HOP/VOP, and FLAGS commands, you can specify a nickname!user@host mask instead of just nickname, which can be used to give unregistered users matching the host mask the specified access. Be careful using user@host masks though, because you could accidentally give someone else access you didn't intend to!
To add someone to the channel's access list:
/msg ChanServ ACCESS #channel ADD nickname level, OR
- Type in channel:
.access add nickname level
The default levels used for 'level' are as follows - note these are just the default settings, they can be changed with ChanServ's LEVELS command. See the ChanServ page for more details on this.
Level 3 -- Gives user voice (+).<br data-attributes="class=%22mw_emptyline%22">Level 4 -- Gives user half-operator (%) status.<br data-attributes="class=%22mw_emptyline%22">Levels 5 - 9 -- Gives user operator (@) status.<br data-attributes="class=%22mw_emptyline%22">Levels 10 - 9998 -- Gives user administrator/protected (&) status.<br data-attributes="class=%22mw_emptyline%22">Level 9999 -- Gives user co-founder (~) status.<br data-attributes="class=%22mw_emptyline%22">
xOP
If you want simplicity, you can use the xOP commands to modify channel access. There are 4 basic commands:
- SOP - SuperOP -- Equivalent to admin/protected status, &, or levels 10-9998 by default
- AOP - AutoOP -- Equivalent to operator status, @, or levels 5-9 by default
- HOP - HalfOP -- Equivalent to half-op status, %, or level 4 by default
- VOP - VOicePerson -- Equivalent to voice, +, or level 3 by default
Note that there is no 'turning on/off' the xOP system - it's always there right alongside the ACCESS command, so you can alternate between whichever method is more comfortable for you.
- Adding SOPs (admins)
/msg ChanServ SOP [#channel] add [nickname]
, OR- Type in channel:
.sop add [nickname]
- Assign AOPs (operators)
/msg ChanServ AOP [#channel] add [nickname]
, OR- Type in channel:
.aop add [nickname]
- Assign HOPs (half-operators)
/msg ChanServ HOP [#channel] add [nickname]
, OR- Type in channel:
.hop add [nickname]
- Assign VOPs (voice users)
/msg ChanServ VOP [#channel] add [nickname]
, OR- Type in channel:
.vop add [nickname]
Removing Access
If you ever need to remove someone's channel access, you can do so as follows:
- With ACCESS command:
/msg ChanServ ACCESS [#channel] DEL [nickname]
will remove the given nickname's access from the specified channel.- In-channel: .access del [nickname]
- With SOP/AOP/HOP/VOP commands:
/msg ChanServ [SOP|AOP|HOP|VOP] [#channel] DEL [nickname]
will remove the given nickname's access from the specified xOP list.- In-channel: .sop del [nickname] OR .aop del [nickname] OR .hop del [nickname] OR .vop del [nickname]
Channel Modes
Channel modes are used to control basic functions and settings of the channel.
To set a channel mode on a channel:
/mode [#channel] +[mode letter(s)]
To remove a mode...
/mode [#channel] -[mode letter(s)]
You can also add AND remove modes at the same time:
/mode [#channel] +[mode(s)]-[mode(s)]]
, etc etc.
Some commonly used modes on Xertion:
- Channel mode +c - block all messages to the channel that contain color/styling.
- Channel mode +S - strip color/styling from messages, so they appear as plain text.
- Channel mode +p - mark the channel as 'private', which hides it from a user's whois output and replaces it with a '*' in a /list output. IRC Operators/Admins on Xertion can always see all channels even if this is set.
- Channel mode +s - mark the channel as 'secret', which hides it from the /list command and from a user's whois output. IRC Operators/Admins on Xertion can always see all channels even if this is set.
- Channel mode +k - set a password to join the channel, specify the password as the second parameter (e.g /mode #channel +k password), include with /join command when set (/join #channel password). Note that to UNSET this mode, you must specify the same password that is currently set.
- Channel mode +i - marks the channel as invite-only, users must be invited with the /invite command (or have an invite exception set in the channel) to join.
- Channel mode +l - sets a maximum limit on the number of users that can be in the channel at one time (e.g /mode #channel +l 500, will set a limit of 500 users)
- Channel mode +m - 'moderates' the channel. When +m is set, users must have voice (+v) or above to send messages to the channel.
This is just a partial list of modes. A full list of modes and what they do, can be obtained by typing /quote help chmodes on the network.
Banning
Banning a user from a channel essentially prevents them from joining and/or speaking. Channel bans are set using a nick!user@host mask format. This format also supports wildcards, so you can ban more than one user at a time with a single ban.
Channel bans are set with channel mode +b
- To ban a user by hostname:
/mode #channel +b *!*@some.hostname.mask
/mode #channel +b *!user@*.hostname.mask
- The above format is the most effective way of setting channel bans, and are HIGHLY recommended for use over any other ban mask format
- To ban a user by nickname:
/mode #channel +b nickname!*@*
- To ban a user by their ident (the 'user' portion of the user@hostname mask):
/mode #channel +b *!ident@*
Excepts/Invite-Excepts
In addition to banning, you can also set up channel exemptions (excepts) and channel invite-exceptions (invexes), which exempt users matching the specified nick/hostmask from bans and channel mode +i, respectively.
Users whose hostname matches a channel exception mask can join a channel even if they match an existing channel ban. Users whose hostname matches a channel invite-exception mask can join an invite-only channel without needing to be invited in.
The commands to set these are:
- Channel exceptions:
- By hostname -
/mode #channel +e *!*@some.hostname.mask
OR/mode #channel +e *!user@*.hostname.mask
OR simply use the nickname (most common with an exception mask):/mode #moo +e nickname!*@*
- By hostname -
- Channel invite-exceptions:
- By hostname -
/mode #channel +I *!*@some.hostname.mask
OR/mode #channel +I *!user@*.hostname.mask
OR simply use the nickname (most common with an exception mask):/mode #moo +I nickname!*@*
- By hostname -
Extended Bans
An alternative to channel modes like +m, +N, +S, etc is to use what's known as extended bans. These are special bans that apply a specific channel restriction (such as channel mode +m for example), to just a user or set of users. This is typically done as follows: /mode #channel +b [letter]:[mask/parameters]
Extended bans can also be used in ban exceptions (EXCEPTS) and invite-exceptions (INVEX):
- When extended bans are used in ban exceptions (mode +e), matching users are not affected by the corresponding channel mode (if it is currently set), and are also not affected by a matching extban of that type.
- When extended bans are used in invite-exceptions (mode +I), matching users are allowed to bypass channel mode +i.
WARNING:The extended bans listed here, as well as most extended bans supported on Xertion, DO NOT affect users with at least voice (+v) or above in the channel. An exception to this is extended ban Q, which DOES affect channel halfoperators and above. Please keep this in mind!
Some commonly used extended bans and how to set them:
- Extended ban m: Matching users cannot "talk" in the channel -
/mode #channel +b m:*!*@some.hostname.mask
- When used with ban exception: Matching users can talk if channel mode +m is set -
/mode #channel +e m:*!*@some.hostname.mask
- When used with ban exception: Matching users can talk if channel mode +m is set -
- Extended ban N: Matching users are not allowed to change their nickname while in the channel -
/mode #channel +b N:*!*@some.hostname.mask
- When used with ban exception: Matching users can change nicknames if channel mode +N is set -
/mode #channel +e N:*!*@some.hostname.mask
- When used with ban exception: Matching users can change nicknames if channel mode +N is set -
- Extended ban c: Matching users cannot send messages with color/styling to the channel -
/mode #channel +b c:*!*@some.hostname.mask
- When used with ban exception: Matching users can send colored/styled messages to the channel if channel mode +c is set -
/mode #channel +e c:*!*@some.hostname.mask
- When used with ban exception: Matching users can send colored/styled messages to the channel if channel mode +c is set -
- Extended ban Q: Matching users cannot use the /kick command -
/mode #channel +b Q:*!*@some.hostname.mask
- When used with ban exception: Matching users can use the /kick command when channel mode +Q is set -
/mode #channel +e N:*!*@some.hostname.mask
- When used with ban exception: Matching users can use the /kick command when channel mode +Q is set -
A full list of extended bans can be found by typing (on the network): /quote help extbans
Miscellaneous
Here's a few other commands that can be helpful in assisting you with the above information
/whois [nickname]
- Gives you general information on the given nickname, if they are online. This is most useful to obtain a given user's user@host mask for use with channel bans/exceptions/invite-exceptions/list
- Pulls up a list of channels on the network. Channels that have channel mode +p set will only appear as a '*' in the list, and channels that have channel mode +s set won't appear in the list at all (they ARE secret after all)
See also: Channel Modes, ChanServ