Command rules
Who may type what, and where. Two modes, two scopes, one cascade that settles it.
In short
With no rule at all, every command works everywhere. One rule changes that for a single command, a single channel, or the whole server at once.
A rule carries one of two modes: allow, or deny. It targets a command and takes effect the moment it is set, with no restart and no delay.
It also carries one of three scopes: the whole server, or a single channel. The channel is read first, so it always wins over the server.
The target is written in three ways: a command, one precise branch with its dot, or the wildcard that takes everything.
The bot reads eight rungs in a fixed order and stops at the first that answers. Deny before allow, channel before server: that order, and nothing else, decides.
Three ways to name a target
A rule first picks one of three scopes, then names what it targets. The server covers every channel; a channel covers only itself, and goes first.
| Spelling | Example | What it takes |
|---|---|---|
| One command | pets | The command and all of its subcommands: a rule set on a parent flows down to every one of its branches. |
| One branch | pets.list | That subcommand alone. The rest of the command is untouched, and the slash autocomplete offers every branch. |
| The wildcard | * or all | Every command in the scope at once, but read after the ones naming a precise command. |
- The wildcard is written
*orall: the 2 spellings are strictly equivalent.
Eight rungs, read in this order
The bot walks down the list and stops at the first rung that answers. If none answers, the command goes through.
One command can be targeted by several rules at once: the rung's rank, never the rule's date, is what settles it.
There are three situations that short-circuit the whole cascade, so a badly set deny never locks the server down.
Seven moves to keep the rules
>commandrules, shortened to >cr, opens a panel in four tabs: the rules grouped by module, a form to add one, a simulator that says whether a member may use a command in a channel and which rule decides, and the sudoers. The words below stay as shortcuts. Moderation means Administrator or Manage Messages; naming a sudoer asks for Administrator.
- A single rule is deleted from the panel's Rules tab, without clearing the others.
The commands
Manage command rules for the server · servers only
<target>The target to allow the command in<command>The command to allow[channel]The channel you want to allow the command in[role]The role you want to allow the command for
<target>The target to deny the command in<command>The command to deny[channel]The channel you want to deny the command in[role]The role you want to block the command for
panelAllow administrators to bypass command rules in a server · servers only