Flags

From Ravenchat Wiki
Jump to: navigation, search

This command is used to manipulate access to your channel. These are the finest grained controls available through services. As such, they are also considered the most difficult to use. First time channel owners should consult the documents on xop and access before reading this document. This document will assume keen knowledge of both documents and will not explain answers to questions that are found in the other documents.

Flags are individual letter codes which correspond to various permissions on the channel. One letter code can correspond to several different permissions and vise versa. The same permission will never be accessible via several different flag codes however. The following is a list of the flags we currently offer users on Ravenchat.

Flag descriptions

  • A - Automatic protect upon join
  • a - Allowed to (de)protect users and him/herself
  • b - Allowed to ban users
  • B - Allowed to use SAY and ACT commands
  • c - Allowed to use fantasy commands
  • f - Allowed to view or modify the access list
  • F - Allowed to issue commands restricted to channel founders
  • G - Allowed to use GETKEY command
  • g - Greet message displayed on join
  • H - Automatic halfop upon join
  • h - Allowed to (de)halfop other users and him/herself
  • I - Allowed to get full INFO output
  • i - Allowed to use the INVITE command
  • K - Allowed to use the AKICK command and no signed kicks through ChanServ when SIGNKICK LEVEL is set
  • k - Allowed to use the KICK command
  • m - Allowed to read channel memos
  • N - Prevents users being kicked by Services
  • O - Automatic channel operator status upon join
  • o - Allowed to (de)op users and him/herself
  • Q - Automatic owner upon join
  • q - Allowed to (de)owner users and him/herself
  • s - Allowed to assign/unassign a bot, use the mode command, and use the Set command
  • t - Allowed to change channel topics
  • u - Allowed to unban users
  • V - Automatic voice on join
  • v - Allowed to (de)voice users and him/herself

Adding flags on a user with no access

Because of the advanced nature of the flags command, you can assign access settings that do not correspond to the typical xop levels at all used with xop or access commands. For instance, to give nick1 automatic half op on joining #channel and allowing them to change channel settings, or giving them flags +Hs, you can use this command:

/msg ChanServ flags #channel nick1 +Hs

A few things to note: This will only work if nick1 was not already in the access list. If nick1 is already on the access list, then see modifying flags on an existing user below. Second, you can only give users flags that you have yourself and you must have the +f flag to do this, normally given to automatic operators and above.

Modifying flags on an existing user

If the user is already on the channel access list, then you will need to use the modify command to add or remove specific flags. The following command will ADD (not set) the flags from the previous example to nick1 on #channel:

/msg ChanServ flags #channel modify nick1 +Hs

If you wish to both set flags +Hs and remove flag +V from the access list entry at the same time, you can do this with the following command:

/msg ChanServ flags #channel modify nick1 +Hs-V

Flags do not need to be specified in any particular order, however flags to be added must be prepended with a + symbol and flags to be removed must be prepended with a - symbol.

Viewing a channel's current flags

The view sub command for the flags command is particularly powerful, allowing you to sort the list by host mask or by specific flags. For instance, to view the flags of all users that have "bot" in their nickname for the channel #channel, you would use this command:

/msg ChanServ flags #channel list *bot*

You can also sort users by flags. For instance, to see all automatically voiced users, you can use this command:

/msg ChanServ flags #channel list +V

If you wish to list all automatically opped users who do not have access to change channel settings, you can use this instead:

/msg ChanServ flags #channel list +o-s

Note that currently, you can specify either a set of flags or a mask to search, but not both in the same command.

Clearing all channel flags

This command is dangerous. Once it is run, you cannot reset your channel to the condition it was in before unless you manually readd all the flags. Therefore, you should be absolutely certain you want to do this. To clear the flags on #channel, you can run the following command:

/msg ChanServ flags #channel clear

See Also