# Generated by scripts/generate-llms-txt.ts - do not edit by hand
# Generated at: 2026-07-02T17:28:43.779Z
# Sources: src/components/FlowBuilder/sidebar/nodeTemplates.ts

# MasterBot Flow Builder - Node parameters (stable only)

Sidebar field reference for AI assistants building flows.
Source: `parameters` arrays in nodeTemplates.ts (right sidebar in Flow Builder).

## Policy

- **Stable nodes only** - parameters are exported when `status: stable`.
- **Beta nodes omitted** - layout and fields may change until a node leaves beta.
- When a node graduates beta to stable, run `npm run generate:llms` (or `npm run build`) to include its parameters.
- Node list (stable + beta): https://masterbot.gg/llms-nodes.txt
- Maintenance rules: https://masterbot.gg/llms-maintenance.txt

Stable nodes with parameters: 36
Beta nodes (parameters deferred): 17

## `addReaction` - Add Reaction

Category: Messages

The bot adds an emoji reaction to a message

- `reactMode` (select, required) - React Mode
  Options: React to Other | React to Target
- `reactTargetNodeId` (string, optional) - Target Send Message Node
- `targetMessageId` (string, optional) - Message ID
- `targetChannelId` (string, optional) - Channel ID
- `emojis` (array, optional) - Emojis

## `addRole` - Add Role

Category: Roles

Gives roles to members on the server

- `userSource` (select, required) - Target user | default: "interactionUser"
  Options: interactionUser | userOption | userTarget
- `userOptionNodeId` (string, optional) - User Option (node id)
- `selectedUsers` (array, optional) - Selected users (picker)
- `userTargetVariable` (string, optional) - User ID variable
- `roleIds` (array, optional) - Roles (multiselect)
- `roleOptionNodeId` (string, optional) - Role Option (node id)
- `roleIdsVariable` (string, optional) - Role ID(s) from variable

## `apiRequest` - API Request

Category: External

Calls an external website or API and uses the response

- `method` (select, required) - HTTP Method
  Options: GET | POST | PUT | DELETE | PATCH | HEAD | OPTIONS
- `url` (string, required) - API URL | placeholder: https://api.example.com/endpoint
- `headers` (string, optional) - Headers | placeholder: {"Content-Type": "application/json"}
- `body` (string, optional) - Request Body | placeholder: {"key": "value"}
- `timeout` (number, optional) - Timeout (ms) | placeholder: 5000

## `triggerTyping` - Bot Is Typing

Category: Messages

Shows the bot is typing (~10s). Does not send a message.

- `channelSource` (string, required) - Channel source | default: "interactionChannel"
- `channelOptionNodeId` (string, optional) - Channel option (node id)
- `targetChannelId` (string, optional) - Text Channel (picker)
- `targetChannelName` (string, optional) - Channel Name
- `targetChannelType` (number, optional) - Channel Type
- `targetChannelGuildId` (string, optional) - Channel Guild ID
- `targetChannelsByVariables` (string, optional) - Channel ID or variable

## `calculate` - Calculate

Category: Variables

Computes a number from a formula and saves the result

- `variableId` (string, optional) - Variable (Custom)
- `variableName` (string, optional) - Variable Name
- `expression` (string, optional) - Expression
- `objectPropertyPath` (string, optional) - Object property path
- `targetSource` (string, optional) - Target
- `targetVariableName` (string, optional) - Target Variable
- `bulkCalculateConfirmed` (boolean, optional) - Bulk calculate confirmed
- `calculateAllServersBulk` (boolean, optional) - All servers bulk calculate
- `allServersBulkConfirmed` (boolean, optional) - All servers bulk calculate confirmed
- `clampMinEnabled` (boolean, optional) - Clamp min enabled
- `clampMin` (string, optional) - Clamp min
- `clampMaxEnabled` (boolean, optional) - Clamp max enabled
- `clampMax` (string, optional) - Clamp max

## `setBotPresence` - Change Bot Status

Category: Status

Changes this bot’s Discord status dot and optional activity (global on Discord)

- `presenceStatus` (select, required) - Presence status | default: "online"
  Options: online | idle | dnd | invisible
- `activityMode` (select, required) - Activity | default: "none"
  Options: none | rich
- `activityType` (select, optional) - Activity type | default: "Playing"
  Options: Playing | Streaming | Listening | Watching | Competing | Custom
- `activityText` (string, optional) - Activity Message
- `streamUrl` (string, optional) - Stream URL

## `changeMemberNickname` - Change Member Nickname

Category: Members

Changes or clears a member nickname on the server

- `userSource` (select, required) - Target user | default: "interactionUser"
  Options: interactionUser | userOption | userTarget
- `userOptionNodeId` (string, optional) - User Option (node id)
- `selectedUsers` (array, optional) - Selected users (picker)
- `userTargetVariable` (string, optional) - User ID variable
- `nickname` (string, optional) - Nickname
- `clearNickname` (boolean, optional) - Clear nickname

## `condition` - Condition

Category: Checks

Continues in one of two paths depending on true or false

- `mainValue` (string, required) - Main Value | placeholder: Enter main value

## `customError` - Custom Error

Category: Flow Control

Writes a custom line to the debug log

- `message` (string, required) - Message | placeholder: e.g. API returned 500: {Api.rawHuman}
- `icon` (string, optional) - Icon | default: "error"
- `barColor` (string, optional) - Bar color | default: "#f44336"
- `textColor` (string, optional) - Text color | default: "#e0e0e0"
- `includeFlowName` (boolean, optional) - Include flow name
- `includeOwner` (boolean, optional) - Include owner
- `includeNodeLabel` (boolean, optional) - Include node label
- `includeTimestamp` (boolean, optional) - Include timestamp

## `deleteMessage` - Delete Message

Category: Messages

Deletes a message (reply, follow-up, or a channel message)

- `deleteMode` (select, required) - Delete Mode
  Options: Delete Interaction Reply | Delete Follow-up (by ID) | Delete Channel Message | Delete Message From Node
- `deleteTargetNodeId` (string, optional) - Target SendMessage Node ID
- `messageId` (string, optional) - Message ID
- `channelId` (string, optional) - Channel ID
- `delaySeconds` (number, optional) - Delay (seconds) | placeholder: 0
- `ignoreNotFound` (boolean, optional) - Ignore Missing Message

## `joinVoice` - Join Voice

Category: Voice

Connects the bot to a voice or stage channel

- `channelSource` (string, optional) - Channel source
- `channelOptionNodeId` (string, optional) - Channel option (node id)
- `targetChannelId` (string, optional) - Voice Channel (picker)
- `targetChannelName` (string, optional) - Channel Name
- `targetChannelType` (number, optional) - Channel Type
- `targetChannelGuildId` (string, optional) - Channel Guild ID
- `targetChannelsByVariables` (string, optional) - Channel ID or variable

## `leaveVoice` - Leave Voice

Category: Voice

Disconnects the bot from voice

- `leaveTargetOrVariable` (string, optional) - Guild or channel ID (optional)

## `modalsV2` - Modals V2

Category: Interactions

Opens a Discord modal so the user can fill in a form

- `modalName` (string, optional) - Modal Name | placeholder: modal_name
- `modalTitle` (string, optional) - Modal Title
- `components` (array, optional) - Components

## `optionAttachment` - Option Attachment

Category: Command Options

Adds a file attachment option to the slash command

- `name` (string, required) - Option Name | placeholder: Enter option name
- `description` (string, required) - Description | placeholder: Enter option description
- `required` (boolean, optional) - Required

## `optionBoolean` - Option Boolean

Category: Command Options

Adds a yes or no option to the slash command

- `name` (string, required) - Option Name | placeholder: Enter option name
- `description` (string, required) - Description | placeholder: Enter option description
- `required` (boolean, optional) - Required

## `optionChannel` - Option Channel

Category: Command Options

Adds a channel option that people pick when they use the slash command

- `name` (string, required) - Option Name | placeholder: Enter option name
- `description` (string, required) - Description | placeholder: Enter option description
- `required` (boolean, optional) - Required
- `channelTypes` (array, optional) - Channel Types

## `optionNumber` - Option Number

Category: Command Options

Adds a number option to the slash command

- `name` (string, required) - Option Name | placeholder: Enter option name
- `description` (string, required) - Description | placeholder: Enter option description
- `required` (boolean, optional) - Required
- `min` (number, optional) - Min Value
- `max` (number, optional) - Max Value

## `optionRole` - Option Role

Category: Command Options

Adds a role option that people pick when they use the slash command

- `name` (string, required) - Option Name | placeholder: Enter option name
- `description` (string, required) - Description | placeholder: Enter option description
- `required` (boolean, optional) - Required

## `optionText` - Option Text

Category: Command Options

Adds a text option to the slash command

- `name` (string, required) - Option Name | placeholder: Enter option name
- `description` (string, required) - Description | placeholder: Enter option description
- `required` (boolean, optional) - Required

## `optionUser` - Option User

Category: Command Options

Adds a user option that people pick when they use the slash command

- `name` (string, required) - Option Name | placeholder: Enter option name
- `description` (string, required) - Description | placeholder: Enter option description
- `required` (boolean, optional) - Required

## `permissionCondition` - Permission Condition

Category: Checks

Checks whether a user has the chosen Discord permissions

- `userSource` (string, required) - User Target | default: "interactionUser"

## `playSoundboardSound` - Play Soundboard Sound

Category: Voice

Joins voice, plays a soundboard sound, then leaves

- `targetChannelId` (string, optional) - Voice Channel (picker)
- `targetChannelName` (string, optional) - Channel Name
- `targetChannelType` (number, optional) - Channel Type
- `targetChannelGuildId` (string, optional) - Channel Guild ID
- `targetChannelsByVariables` (string, optional) - Channel ID or variable
- `soundId` (string, optional) - Sound ID (picker)
- `soundName` (string, optional) - Sound Name
- `soundGuildId` (string, optional) - Sound Guild ID
- `soundByVariable` (string, optional) - Sound ID or variable
- `leaveAfterEnabled` (boolean, optional) - Leave after playing
- `leaveAfterSeconds` (string, optional) - Leave after (seconds)

## `purgeMessages` - Purge Messages

Category: Messages

Deletes multiple messages in a channel (last N or until a message ID)

- `channelSource` (select, required) - Channel | default: "interactionChannel"
  Options: interactionChannel | eventChannel | channelOption | channelTarget
- `channelOptionNodeId` (string, optional) - Channel Option Node
- `targetChannelId` (string, optional) - Target Channel ID
- `targetChannelsByVariables` (string, optional) - Channel ID Variable
- `purgeScope` (select, required) - Purge Scope | default: "lastN"
  Options: lastN | untilMessageId
- `purgeCount` (string, required) - Message Count
- `untilMessageId` (string, optional) - Until Message ID
- `includeAnchorMessage` (boolean, optional) - Include Anchor | default: true
- `ignoreBots` (boolean, optional) - Ignore Bots | default: true
- `ignorePinned` (boolean, optional) - Ignore Pinned | default: true
- `ignoredAuthors` (array, optional) - Ignored Authors
- `ignoredAuthorsByVariables` (string, optional) - Ignored Author IDs
- `ignoreTooOld` (boolean, optional) - Skip Old Messages | default: true
- `ignoreNotFound` (boolean, optional) - Ignore Not Found | default: false
- `delayBetweenBatchesSeconds` (number, optional) - Batch Delay (seconds) | default: 0
- `maxScanMessages` (string, optional) - Max Scan | default: "2000"

## `removeReaction` - Remove Reaction

Category: Messages

Removes the bot's own emoji reaction from a message

- `removeMode` (select, required) - Remove Mode | default: "Remove from Other"
  Options: Remove from Other | Remove from Target
- `removeTargetNodeId` (string, optional) - Target Send Message Node
- `targetMessageId` (string, optional) - Message ID
- `targetChannelId` (string, optional) - Channel ID
- `emojis` (array, optional) - Emojis

## `removeRole` - Remove Role

Category: Roles

Removes roles from members on the server

- `userSource` (select, required) - Target user | default: "interactionUser"
  Options: interactionUser | userOption | userTarget
- `userOptionNodeId` (string, optional) - User Option (node id)
- `selectedUsers` (array, optional) - Selected users (picker)
- `userTargetVariable` (string, optional) - User ID variable
- `roleIds` (array, optional) - Roles (multiselect)
- `roleOptionNodeId` (string, optional) - Role Option (node id)
- `roleIdsVariable` (string, optional) - Role ID(s) from variable

## `resetVariable` - Reset Variable

Category: Variables

Clears a custom variable back to its default value

- `variableId` (string, optional) - Variable (Custom)
- `variableName` (string, optional) - Variable Name
- `targetSource` (string, optional) - Target
- `targetVariableName` (string, optional) - Target Variable
- `bulkResetConfirmed` (boolean, optional) - Bulk reset confirmed
- `resetAllServersBulk` (boolean, optional) - All servers
- `allServersBulkConfirmed` (boolean, optional) - All servers confirmed

## `roleCondition` - Role Condition

Category: Checks

Checks whether a user has the chosen Discord roles

- `userSource` (string, required) - User Target | default: "interactionUser"

## `runCustomEvent` - Run Custom Event

Category: Flows & events

Runs another custom event flow in the same execution

- `targetFlowId` (string, optional) - Target flow
- `waitForChildCompletion` (boolean, optional) - Wait for child flow

## `runLoop` - Run Loop

Category: Flow Control

Runs the same steps several times or over a list

- `mode` (string, optional) - Mode | default: "fixed"
- `count` (number, optional) - Count
- `listVariableName` (string, optional) - List variable
- `loopVariableName` (string, optional) - Loop variable name
- `delayMs` (number, optional) - Delay (ms) | default: 500

## `sendMessage` - Send Message

Category: Messages

Sends a message in a channel (you can add embeds and choose how to reply)

- `content` (string, optional) - Message Content
- `responseType` (select, required) - Response Type
  Options: Reply to Interaction | Reply to Last Flow Message | Reply to Target Message | Send to Command Channel | Send to Channel Option | Send to Channel Target | Create thread in forum | DM Command User | DM User Option | DM User Target | Edit Other Message | Edit Target Message
- `variable` (string, optional) - Optional Variable
- `label` (string, optional) - Block Label
- `embedAuthor` (string, optional) - Embed Author
- `embedAuthorUrl` (string, optional) - Embed Author URL
- `embedAuthorIconUrl` (string, optional) - Embed Author Icon URL
- `embedTitle` (string, optional) - Embed Title
- `embedDescription` (string, optional) - Embed Description
- `embedUrl` (string, optional) - Embed URL
- `embedColor` (string, optional) - Embed Color

## `sendMessageV2` - Send Message V2

Category: Messages

Sends a Discord message with rich layout (sections, text, media)

- `responseType` (select, required) - Response Type
  Options: Reply to Interaction | Reply to Last Flow Message | Reply to Target Message | Send to Command Channel | Send to Channel Option | Send to Channel Target | Create thread in forum | DM Command User | DM User Option | DM User Target | Edit Other Message | Edit Target Message
- `components` (array, optional) - V2 Components

## `setTempVariable` - Set Temp Variable

Category: Variables

Stores a value in memory for the rest of this flow

- `variableName` (string, required) - Variable Name | placeholder: Enter variable name
- `variableValue` (string, required) - Variable Value | placeholder: Enter variable value

## `setVariable` - Set Variable

Category: Variables

Saves or updates a custom variable in the database

- `variableId` (string, optional) - Variable (Custom)
- `variableName` (string, optional) - Variable Name
- `operation` (string, optional) - Operation | default: "push_end"
- `value` (string, optional) - Value
- `targetSource` (string, optional) - Target
- `targetVariableName` (string, optional) - Target Variable
- `listIndex` (string, optional) - Index (list)
- `bulkSetConfirmed` (boolean, optional) - Bulk set confirmed
- `setAllServersBulk` (boolean, optional) - All servers bulk set
- `allServersBulkConfirmed` (boolean, optional) - All servers bulk set confirmed

## `stopLoop` - Stop Loop

Category: Flow Control

Stops the loop and continues after the loop

- `stopScope` (string, optional) - Stop scope | default: "this"

## `transformText` - Transform Text

Category: Variables

Changes text (for example trim or case) and saves the result

- `resultVariableName` (string, optional) - Result Variable Name
- `sourceText` (string, optional) - Text
- `operation` (string, optional) - Operation
- `operationArgs` (array, optional) - Operation Args

## `wait` - Wait

Category: Flow Control

Waits for a while before the flow continues

- `delaySeconds` (number, required) - Delay (seconds) | placeholder: 1

## Beta nodes (parameters not published yet)

These nodes appear in llms-nodes.txt but parameters are withheld until status becomes stable:

- `chanceCondition` - Chance Condition
- `channelCondition` - Channel Condition
- `createChannel` - Create Channel
- `createInvite` - Create Invite
- `createRole` - Create Role
- `createThread` - Create Thread
- `deleteChannel` - Delete Channel
- `deleteInvite` - Delete Invite
- `deleteRole` - Delete Role
- `deleteThread` - Delete Thread
- `editChannel` - Edit Channel
- `editComponents` - Edit Components
- `editRole` - Edit Role
- `editThread` - Edit Thread
- `forumTagCondition` - Forum Tag Condition
- `pauseInvites` - Pause Invites
- `timeCondition` - Time Condition

## Related

- Node catalog: https://masterbot.gg/llms-nodes.txt
- Flow Builder UI: https://masterbot.gg/llms-flow-builder.txt
- Variables: https://masterbot.gg/llms-variables.txt