Actions

The building blocks for visual commands and events — reply, embed, roles, conditions, and data.

Actions are the building blocks of visual commands and events. Chain them together in the graph editor.

Response actions

  • Reply — send a text response. Supports template variables and ephemeral mode.
  • Embed — send a rich embed with title, description, color, footer, and thumbnail.
  • Send to channel — post a message to a specific channel, the system channel, or a channel from a setting.
  • DM — send a direct message to the triggering user.
  • React — add an emoji reaction to the trigger message.

Role actions

  • Add role — assign a role to a user. Target can be the triggering user or a user from a command option.
  • Remove role — remove a role from a user.

Roles can be specified by ID or resolved from a guild setting.

Logic actions

Condition

Branch based on a value. Supports these operators:

OperatorDescription
eqEquals
neqNot equals
containsString contains
gtGreater than
ltLess than

Each condition has a then path and an else path, each containing their own actions.

The condition field can reference {option:name}, {user.name}, {store:key}, or any template variable.

Data

Interact with the KV store from visual actions:

  • Load — read a value into scope for use in later actions
  • Save — write a value (supports template variables in both key and value, e.g. points_{user.id})
  • Delete — remove a value

Math

Perform arithmetic on a stored or loaded value:

  • add / subtract / multiply / divide / modulo

Useful for point systems, counters, and leaderboards without writing code.