Back to Documentation
Hold & Win Node

HnwWeightedRespin

Respin unlocked positions using weighted symbol distribution

Inputs

lockedTagstringrequired

Tag identifying locked positions (e.g. 'locked:true')

distributionWeightedEntry[]required

Resolved weight table entries [{symbol, weight}]

symbolPrefixstring

Prefix for symbol tags written

Default: symbol

Outputs

newLandedCountnumber

Number of new bonus/collect/multiplier symbols that landed

Overview

For each unlocked position on the grid, picks a new symbol from a weighted distribution. Locked positions are skipped. After placement, counts how many new bonus/collect symbols landed.

Algorithm

  1. Find all position entities (pos_*)
  2. For each position:
    • Skip if position has lockedTag
    • Pick symbol from weighted distribution using RNG
    • Clear existing symbol tags
    • Set new symbolPrefix:symbol tag
    • If bonus/collect/multiplier, auto-lock the position
  3. Return count of newly landed special symbols

Auto-Locking

When a special symbol (bonus, collect, multiplier) lands, the position is automatically locked by setting the lockedTag. This ensures the symbol persists for subsequent respins.