Flags

From StealthBot Wiki Backup
Revision as of 20:40, 29 June 2013 by Ribose (talk) (Default flags)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search
Flags can also refer to numeric flags in scripting.

Flags are one of two ways of giving access to users in order for them to use bot commands. The other is rank. Flags are single-letters that can be defined to mean any set of commands that users can do.

If a user has any of a command's required set of flags, he is allowed to use the command. The user does not need more than one of a command's required flags. Command restrictions may also be present requiring a higher rank or another flag in order to use certain commands in certain ways.

Valid flags

Valid flags are A through Z. You can set the configuration override CaseSensitiveFlags to Y in order to make uppercase flags have a different meaning to the bot than lowercase flags (effectively doubling the number of available flags). When this is set, the bot internally uses the uppercase variant for special flags.

Special flags

Some flags have special meanings to the bot:

  • B - Users with the B flag (Banned) are automatically banned from the channel (if the bot is a channel operator). This flag is the functionality of the shitlist.
  • D - Users with the D flag (Designated) are automatically designated using the Battle.net /designate command (if the bot is a channel operator).
  • I - Users with the I flag (No-Inherit) will be treated as if group and dynamic access rules applied by other userlist entries do not exist.
  • P - Users with the P flag (Protected) cannot be changed by other users with access to the add command. Only users with rank 100 or flag A can change this user entry.
  • S - Users with the S flag (Safelisted) will not be banned by automatic banning, such as quiet time.

Default flags

Some commands have default flag requirements based on a pattern. All of these can be changed with the command manager.

Basic commands

By default, the bot defines several commands as being "basic" in terms of flag requirements in that a user who has any of the above default flags can access them (since you need only one of the required flags in order to access a command). Basic commands are: inbox, checkmail, roll, bmail, flip, scq, cq, whoami, about, pingme, trigger, time, vote, tally, math, where, cancel, owner, quote, lastwhisper, help, helpattr, and helprank.

Making your own set of flag-meanings

Using the command manager, one can change the requirements of any command.

For example, to make more commands "basic" like those above-- usable by anyone you give any flag to-- you can set the required flags to all of the flags you are going to give to users (such as the default value of "AJMORT", which is all of the flags the default settings use).

See also