Button Roles
Requirements and Cooldowns
Control who may use each button and how often, plus button colors.
Every button can decide who is allowed to use it and, optionally, how often. These are set per button in its editor.
Required and blacklist roles#
- Required roles: the member must hold these to use the button. With more than one, choose whether they need all of them or any of them.
- Blacklist roles: members holding any of these can never use the button.
Both are available on every plan. If a member doesn't meet the requirement, the click is rejected with a short ephemeral message and no roles change.
Required roles gate the button (whether the click is allowed at all). Per-action conditions (see Actions) gate individual actions inside the chain. Use a required role for "only staff can press this", and a condition for "this one action only applies to Tier 2 members".
Cooldowns#
A cooldown stops a member from re-clicking the same button for a set time (for example, a daily reward button on a 1d cooldown). Cooldowns are per member and per button.
When a member clicks during their cooldown, Zira tells them how long is left and makes no change.
Button colors#
A button can be grey, blurple, green, or red.