BotFrame

Server actions · Workflow node

Create role

The Create role node as it appears in the workflow editor.

What it does

Add a new role to the server.

When the workflow reaches this node, BotFrame uses the current server details and any connected IDs to perform the Discord action. The resulting Role ID can be connected to later nodes.

Typical use

Use it when you need to add a new role to the server.

How to use it

  1. Add it from Server actionsOpen the node library and choose Create role from Server actions.
  2. Connect the workflow pathConnect Flow in from the previous step and Flow to the next step.
  3. Choose settings and connect valuesSet Colour, Name. Connections can also supply values produced by earlier nodes.

Settings

These are the options shown when you add this node. A connected value can replace a setting when the workflow runs.

SettingStarting valueWhat it controls
Colour#5865F2Sets the colour of the new role.
NameNew roleUsed when Role name is not connected from an earlier node.

Value connections

Value connections pass information between nodes without changing the order of the workflow. When an input is not connected, BotFrame uses the value selected in the node or details from the starting Discord event when available.

Inputs

Role nameText
Required

Outputs

Role IDRole
Optional

What happens when it runs

When the workflow reaches this node, BotFrame uses the current server details and any connected IDs to perform the Discord action. The resulting Role ID can be connected to later nodes.

You can use this item in a published BotFrame workflow. You can also test it in the simulator.

These details match the node currently available in the BotFrame workflow editor.