Actions › Lookup
Find a role
Looks for a role by name — the highest one, if several share it
- Free
- Outputs: Success, Failure
Fields
What you set in Properties. The grey name is the one in the Blueprint's JSON.
| Field | What it does | |
|---|---|---|
Role name name | The role's exact name, capitals included. | required |
What it passes on
On the Success output, for the nodes after it. Click a value in the editor to copy its reference.
| Data | Path | Type | |
|---|---|---|---|
| Role ▸ ID | role.id | Text | can be empty |
| Role ▸ Name | role.name | Text | can be empty |
| Role ▸ Color | role.color | Text | can be empty |
| Role ▸ Position | role.position | Number | can be empty |
| Role ▸ Mentionable | role.mentionable | Yes/No | can be empty |
| Role ▸ Shown separately | role.hoist | Yes/No | can be empty |
| Found | found | Yes/No |
When it fails
The Failure output receives success (false) and error: error.code, error.message in the server's language, and error.detail, what Discord said. The possible causes are in Errors.
Discord permissions
None: the bot needs no server permission for this node.