Inside Component

Add Trigger

The Add Trigger dialog binds a Streamer.bot event, command, or action to the selected overlay box. When the trigger fires, NekoBot decides which source or sources in that box should run.

Open It

Box inspector Trigger section with an existing trigger row and Add Trigger button

Select a box on the overlay stage, open the box inspector, then use the Triggers section. Add Trigger opens a new trigger binding. Existing trigger rows can be renamed, edited, or deleted from the same list.

UI option

What it does

Trigger name

The editable label shown in the box trigger list. If left alone, NekoBot uses the selected trigger name.

Trigger binding

Shows the selected binding as Command, Action, or Event, plus the command mode, action event, or raw event key.

Edit

Reopens the Add Trigger dialog for that saved binding.

Delete

Removes the trigger binding from the selected box.

Trigger Search

Add Trigger dialog before a trigger is selected

The dialog loads available triggers from the Streamer.bot catalog, then displays them under the Search Triggers input. It also loads Argument Control mappings so hit rules and custom cases can use {{ tokens.

UI option

What it does

Search Triggers

Filters by trigger name, key, description, or category.

Trigger row title

The visible trigger name. For commands this is the command name or alias; for actions this is the action name; for raw events this is the event label or key.

Category

Shows Raw Trigger, Command Trigger, or Action Trigger.

Description

Shows aliases and modes for commands, group and trigger events for actions, or Subscribed raw Streamer.bot event. for raw triggers.

Duplicate filtering

Triggers already bound to the current box are hidden. When nothing is left, the list says all available triggers are already added.

Trigger Types

Add Trigger search results showing command, raw, and action trigger rows

The same Add Trigger control handles three Streamer.bot trigger families.

Type

Stored target

Raw Trigger

Stores the raw event key, category, event name, and optional hit rules. Use this when a subscribed event should run a box directly.

Command Trigger

Stores the command id, command name, primary command, aliases, and trigger modes. Use this for chat commands such as !tts, !meme, or !hype.

Action Trigger

Stores the action id, action name, and action trigger events. Use this when a Streamer.bot action should drive a NekoBot box.

Options

Add Trigger dialog showing Ignore commands and raw hit rules

UI option

When it appears

Ignore commands

Appears for chat-message style triggers. When enabled, normal chat-message triggers ignore messages that are commands.

Hit rules

Appears for raw triggers. Use the IF/Else Control when a raw event should only run when specific trigger data matches.

Add hit rule

Adds an IF condition for raw triggers. The IF/Else result is either Trigger or False.

Sequencing

Sequencing appears when the selected box has more than one possible source. For group boxes, sequencing targets source slots across the grouped child boxes.

Mode

What it means

Sequence

Runs through sources in order as the trigger fires over time.

Random

Picks from the available sources randomly.

All

Runs all available sources. This option is hidden for group boxes.

Custom

Shows the IF/Else Control so trigger data can choose specific sources.

Else source

The fallback source or slot used when custom cases do not match.

Custom Cases

Custom Add Trigger case using an argument token and source result

Custom cases use the IF/Else Control to compare trigger data and choose the source result. The left side supports Argument Control, so users can type {{ and pick a mapped trigger value.

UI option

What it does

IF/Else Control

Move to definition

Four-dot drag handle

Reorder and nesting details

Else source

Fallback behavior

Saved Result

Saved Add Trigger row in the box inspector

After saving, the Trigger section shows the binding as an editable row on the selected box. This is the place to rename the binding, confirm what trigger is attached, reopen the dialog, or remove the binding.

UI option

What it means

Name

The friendly label for this trigger binding. Editing it changes the label shown in the box trigger list, not the underlying Streamer.bot trigger.

Trigger

The saved binding summary. It shows whether the box is bound to a command, action, or raw event.

Edit

Reopens the Add Trigger dialog for this saved binding so the trigger, options, sequencing, or IF/Else rules can be changed.

X

Deletes the trigger binding from the selected box.

Add Trigger

Starts another binding for the same box.

The full saved data still includes the Streamer.bot source, selected trigger id/key/name, optional command-ignore behavior, sequencing mode, IF/Else cases, and the selected raw, command, or action target data.