Interface: ConditionBlock

Condition block — evaluates logic to branch the dialogue flow.

Remarks

Conditions are organized as a 2D array of groups (ExportCondition[][]). Each inner array is a "case" — conditions chained with & (AND) / | (OR).

Single group (classic true/false): [[c1, c2]] — resolve(true) → port 0, resolve(false) → port 1.

Multiple groups (switch mode): [[c1], [c2], [c3]] — groups are evaluated in order, first matching group routes to its port (case_0, case_1, ...), otherwise routes to default. Call context.resolve(matchingIndex) or context.resolve(-1) for default.

Dispatcher mode (nativeProperties.enableDispatcher = true): all groups are evaluated, every matching group fires its port as an async track, and the default port is the main continuation track (always executed). Call context.resolve(matchingIndices[]).

Example

engine.onCondition(({ block, context, next }) => {
  const result = LsdeUtils.evaluateConditionGroups(
    block.conditions ?? [],
    (cond) => myEvaluator(cond),
    !!block.nativeProperties?.enableDispatcher,
  );
  context.resolve(result);
  next();
});

See

ExportCondition for condition structure and chaining rules
ConditionContext for handler context
NativeProperties.enableDispatcher for dispatcher mode

Extends

BlueprintBlockBase

Properties

conditions?

optional conditions?: ExportCondition[][]

Defined in: types.ts:375

2D array of condition groups. Each inner array is a "case" — conditions chained with & / |. Single group: classic true/false branching. Multiple groups: switch mode (case_0..N / default).