Back to Documentation
Concept
Positions
Grid positions and their states - the fundamental building blocks of a slot game grid
Positions are the fundamental building blocks of a slot game grid. Each position represents a cell on the reel grid where symbols can land.
Position Identification
Positions are identified by their column and row coordinates:
- Entity ID Format:
pos_{column}_{row}(0-indexed) - Example:
pos_0_0is the top-left position
Position States
Positions can exist in different states, controlled by tags:
Normal
Default state. Participates in all game mechanics, symbol can be replaced during spins.
Locked
Tag: locked:true
Symbol persists across respins. Still participates in payouts.
Disabled
Tag: disabled:true
Symbol generated but excluded from win evaluation.
Common Position Tags
| Tag | Description |
|---|---|
locked:true | Position is locked (persists across respins) |
disabled:true | Position excluded from win calculations |
coin:value:{N} | Coin value for H&W mechanics |
position:multiplier:{N} | Position-specific multiplier |
Symbol Association
Each position can be occupied by a symbol instance. The symbol entity uses 1-indexed naming:
Position (pos_1_2)
└── occupied by → Symbol Instance (s_2_3)
└── has tag → base:wild