Slot Spin
This node executes a single game round on the server.
The Slot Spin node is the main entry point for running a slot game logic cycle.
The Slot Spin node sends a request to the XFORGE game engine to perform a full spin. It handles random number generation, reel stopping, win checking, and feature triggering (Free Spins, Cascades) in one atomic operation. It returns the complete result state needed to visualize the spin.
Slot Configuration
| Data | Description |
|---|
| Reel Strips | The reel strips to use. |
| Rows | Number of rows. |
| Columns | Number of reels. |
Game Parameters
| Data | Description |
|---|
| Bet Amount | The bet for this spin. |
| Payout Formula | Formula for payouts. |
| Initial Free Spins | Current free spins balance (if any). |
Plugins
| Data | Description |
|---|
| Free Spins | Enable Free Spins logic. |
| Cascading Reels | Enable Cascading Reels logic. |
| Reel Ways | Enable Reel Ways logic. |
Session
| Data | Description |
|---|
| Session ID | Unique ID for the player session (for tracking state). |
| Seed | Optional. Force a specific RNG seed (for debugging). |
Actions
| Signal | Description |
|---|
| Spin | Triggers the spin. |
Outputs
Results
| Data | Description |
|---|
| Full Response | The complete JSON response from the engine. |
| Spin Results | Object containing the grid (slotResults), total payout, and win details. |
| Stop Positions List | Array of indices where the reels stopped. |
| Is Big Win | Boolean. True if win > 1000x bet. |
Events
| Signal | Description |
|---|
| Success | Triggered when the spin result is ready. |
| Failure | Triggered on error. |
Usage
Main Game Loop
- Player clicks "Spin".
- Trigger Spin on this node.
- On Success:
- Pass
stopPosList to your Reel Visualizer or animation logic to show the reels stopping.
- Wait for animation to finish.
- Show win lines using
Spin Results.
- Update balance.
Detailed Behavior
- Atomic: The entire game logic (spin -> check wins -> cascade -> check wins again...) happens on the server in one go. The response contains the final state and the history of what happened (e.g., intermediate cascade grids).
- Security: Since logic runs on the server (or simulated server environment), the client cannot cheat the RNG.
Troubleshooting
- Invalid Config: Ensure Reel Strips are populated (e.g., from Generate Reel Strips).