Multiplier Ladder

A win multiplier that climbs a ladder of rungs, for cascade and tumble multipliers or free-spin multiplier ladders. A maths node: it runs in the editor preview and compiles to the RGS.

Ladder is the list of multipliers (default [1, 2, 3, 5]; a JSON string is parsed, non-numeric rungs become 1 and an empty ladder becomes [1]). The position starts at Start Index, clamped to the ladder. Fire Step to move Step By rungs (negative steps down; the index never leaves the ladder), or set Step On Do true to step on every Do. Reset returns to Start Index; fire it when a new spin starts so a cascade multiplier restarts.

Outputs after each evaluation: multiplier (multiply the win with it, or wire it into the Calculate Winnings stake), index, atMax (true on the last rung), changed (true after a reset, or a step that moved the index) and the parsed ladder. atMax and changed are booleans, not signals; branch on them with Condition after Done. A shorter ladder wired later clamps the stored index to its last rung.

The node is stateful. In the preview the index lives in the node; on the RGS it persists across rounds for identified players only, and a guest session starts fresh every round. On the server Step and Reset are booleans for the round, evaluated once: the reset is applied first, then the step. In the editor every Step, Reset and Do is its own evaluation, so use either Step or Step On Do, not both in one spin.

Inputs

Parameters

Data	Description
Ladder (array)	Multipliers in rung order, array or JSON string. Default [1, 2, 3, 5]; empty becomes [1].
Start Index (number)	Rung to start from and return to on Reset, clamped to the ladder. Default 0.
Step By (number)	Rungs moved per step; negative steps down. Default 1.
Step On Do (boolean)	Step on every Do. Default false; leave it off when you fire Step yourself.

Actions

Signal	Description
Step	Moves Step By rungs: its own evaluation in the editor, a boolean for the round on the RGS.
Reset	Clears the node's state and starts again. The index returns to Start Index and changed is true.
Do	Runs the node.

Outputs

Events

Signal	Description
Done	Fires when the node has finished, on success and failure alike.

Results

Data	Description
Multiplier (number)	The multiplier on the current rung.
Index (number)	The current rung, counted from 0.
At Max (boolean)	True on the last rung (a boolean, not a signal).
Changed (boolean)	True when this evaluation reset the ladder or moved the index (a boolean, not a signal).
Ladder (array)	The parsed ladder as numbers, after defaults and parsing.

Usage

1. Add Multiplier Ladder to the maths component and set Ladder to your rungs.
2. Fire Reset when a new spin starts.
3. Fire Step from each tumble, for example Directional Cascade hadRemoval or Cluster Pays hasWin.
4. Multiply the spin's win by multiplier with Multiplication before adding it to the round win.