Skip to content

Node Reference Logic

Bobby Comet edited this page Jul 31, 2026 · 4 revisions

Node Reference — Logic (built-in)

Logic nodes take bindable inputs and expose one output. Chains evaluate in dependency order each refresh.

Kinds: KIND_NUMBERnumber, KIND_PERCENTpercent, KIND_TEXTtext.


Math — logic.math

Output number
input_a, input_b float, bindable, wide range
operation enum — add, subtract, multiply, divide, min, max, average (as implemented)

Conditional — logic.conditional

Output number
input bindable float
comparison enum (>, >=, <, …)
threshold float
then_value / else_value floats returned when condition holds / fails

Threshold Gate — logic.threshold

Output number (0 or 1)
value bindable
comparison enum (default >=)
threshold float
Notes Binary gate only. For gate/pass-value modes see plugin Threshold.

String Format — logic.string_format

Output text
input bindable (string/number as resolved)
template string with {value} placeholder
decimals int 0–4

Map Range — logic.map_range

Output number
value, in_min, in_max bindable floats
out_min, out_max floats
clamp bool — clamp to out range after map

Maps (value) from ([in_min, in_max]) to ([out_min, out_max]).

Clamp — logic.clamp

Output number
value bindable
min_value, max_value floats

Lerp — logic.lerp

Output number
a, b, t bindable — result ≈ a + (b - a) * t
t typically 0–1 (editor allows wider range)

Deadzone — logic.deadzone

Output number
value bindable
centre, radius floats — values inside ([centre - radius, centre + radius]) collapse toward centre / zero per implementation
Notes Different model from plugin Deadzone (abs magnitude + optional soft edge).

Invert Percent — logic.invert_percent

Output percent
value bindable — typically 100 - value

Scale / Offset — logic.scale

Output number
value bindable
multiply, add value * multiply + add

Round — logic.round

Output number
value bindable
decimals int 0–6 — nearest rounding
Notes Plugin Round adds floor/ceil modes.

Absolute — logic.abs

Output number
value bindable — abs(value)

AND Gate — logic.boolean_and

Output number (0/1)
input_a, input_b bindable

OR Gate — logic.boolean_or

Output number (0/1)
input_a, input_b bindable

Pick A/B — logic.pick (if present in your build)

Output number
selector + values A/B choose A or B from control signal
Notes Plugin Pick (A/B) exposes an explicit threshold.

Built-in vs plugin

Need Prefer
Simple 0/1 vs threshold Built-in Threshold Gate
Pass value when true / invert / equal±ε Plugin Threshold
EMA smoothing Plugin Smooth
°F ↔ °C Plugin Temp Convert
Multi-stage index Plugin Threshold Chain

See Plugins.

Clone this wiki locally