Inside Component

Argument Control

Argument Control is the {{ autocomplete used in source text, media trigger mappings, TTS messages, and other trigger-aware fields.

Auto-Complete

Argument Control Auto-Complete opened after typing double curly braces

Type {{ in a supported field to open the Auto-Complete control. The list filters while the user types, and the selected token inserts without forcing the user to leave the keyboard.

Use this whenever a field needs live trigger data instead of fixed text, such as chat names, message text, command arguments, dynamic media URLs, or custom trigger payload values.

Auto-completed

Argument Control after selecting a token from Auto-Complete

After a suggestion is selected, NekoBot shows the token as a compact chip so completed fields are easier to scan.

The saved value remains a template token such as {{channel.channelName}}, {{user.display}}, or {{command.arguments[0]}}, so the trigger system still receives the exact runtime value it needs.

Add Trigger Control

Triggers is the search control used in Add Trigger. It is populated from the Streamer.bot trigger catalog, then displays each available trigger as a selectable row.

Populated item
What appears in the list
Raw Trigger
Subscribed raw Streamer.bot events. Rows show the event label or key, category Raw Trigger, and the description Subscribed raw Streamer.bot event.
Command Trigger
Streamer.bot commands. Rows show the command name, category Command Trigger, and description parts from command aliases, trigger modes, and disabled state.
Action Trigger
Streamer.bot actions. Rows show the action name, category Action Trigger, and description parts from action group, trigger events, and disabled state.
Search behavior
Search matches trigger name, key, description, and category. Triggers already bound to the current box are hidden from the list.

Trigger Tokens

The {{ Auto-Complete list is populated by /api/triggers/mapping. It is one flat list sorted by token key, filtered by what the user types after {{, then by the search field.

Category
Tokens populated in the UI
User
{{user.id}}, {{user.name}}, {{user.display}}, {{user.login}}, {{user.role}}, {{user.roleName}}, {{user.avatar}}, {{user.color}}, {{user.badges}}, {{user.subscribed}}, {{user.subscriptionTier}}, {{user.monthsSubscribed}}, {{user.verified}}, plus aliases {{user.username}}, {{user.isSubscribed}}, {{user.isVerified}}, {{user.profilePicture}}, {{user.displayName}}, and {{userName}}.
Message
{{message.id}}, {{message.text}}, {{message.emotes}}, {{message.parts}}, {{message.meta}}, plus alias {{text}}.
Channel
{{channel.id}}, {{channel.name}}, {{channel.channelName}}, {{channel.platform}}, {{channel.isLive}}.
Trigger
{{trigger.id}}, {{trigger.type}}, {{trigger.eventType}}, {{trigger.source}}, {{trigger.timestamp}}, {{trigger.name}}, {{trigger.isFirstWords}}, plus alias {{isFirstWords}}.
Context
{{context.sessionId}}, {{context.requestId}}, {{context.correlationId}}, {{context.tags}}, {{context.metadata}}.
Platform
{{platforms.streamerbot}}, {{platforms.twitch}}, {{platforms.kick}}, {{platforms.youtube}}, {{platforms.custom}}.

Argument Values

These are the currently populated mappings that behave like command or payload arguments inside the same {{ Auto-Complete list.

Argument source
Tokens populated in the UI
Command arguments
{{command.name}}, {{command.prefix}}, {{command.fullCommand}}, {{command.arguments}}, {{command.arguments[0]}}, {{command.argumentCount}}, {{command.argsText}}, {{command.counter}}, {{command.userCounter}}, plus alias {{firstArg}}.
Message text
{{message.text}} and alias {{text}}. Use these for chat-driven text, TTS content, captions, and callouts.
Custom payload
{{custom}} and {{custom["key"]}}. Replace key with the custom variable name supplied by the trigger payload.
Autocomplete display
Each suggestion shows its label, then metadata made from category, type, optional hint, raw token when filtering by a typed prefix, and local usage count.

Selection Behavior

Action
What it does
Type {{
Opens the autocomplete menu.
Keep typing
Filters the suggestions by token key, label, or category.
Arrow keys
Move through visible suggestions.
Enter or Tab
Insert the selected token.
Completed chip
Displays the inserted token as a readable label while keeping the underlying template value intact.
Escape
Closes the menu without inserting a token.

Examples

Use case
Template
Chat callout
{{user.display}}: {{message.text}}
TTS command
{{command.argsText}}
Custom payload value
{{custom["favoriteColor"]}}
Command debug text
{{user.display}} used {{command.name}} with {{command.argumentCount}} arguments