Slots

Overview

Property	Value
Slug	`slots`
Round type	Multi-step (bonus, free spins)
RTP	Configurable (displayed as `info_rtp`)
Volatility	Low / Medium / High (per configuration)
Devices	Desktop, Mobile
Provably Fair	Yes
Win modes	Paylines, Ways-to-Win, Cluster Pays

Slots is a multi-reel slot machine with rich features including Wild symbols, Scatter symbols, Free Spins, Cascade mechanics, and Bonus Games. Rounds can be multi-step — a single round_id may involve multiple bet/win/rollback transactions, delivered across one or more /betwin calls.

Game Mechanics

Reel Configuration

Parameter	Range	Description
Reels	3-7	Number of reels (columns)
Rows	1-5	Number of visible rows per reel
Win Mode	paylines / ways / cluster	How wins are calculated

Symbol Types

Type	Description
Regular	Standard symbols with payout tables
Wild	Substitutes for other symbols. Can be sticky, expanding, or walking
Scatter	Triggers bonus features (Free Spins, Bonus Game). Pays regardless of position
Bonus	Triggers the Bonus Game when enough appear

Win Modes

Paylines — Wins are calculated along predefined lines across the reels.

Ways-to-Win — Matching symbols on adjacent reels (any position) form a win. Typically 243 ways (3 rows x 5 reels).

Cluster Pays — Adjacent matching symbols (horizontally/vertically) form winning clusters. Minimum cluster size is configurable.

Bonus Features

Free Spins

When enough Scatter symbols land (configurable trigger_count):

Player receives spins_awarded free spins
Free spins play at the same bet level with a multiplier
Retrigger: can be enabled to allow additional free spins during the bonus
Max retriggers: limit on how many times free spins can retrigger

Cascade (Tumble)

After a win, winning symbols are removed and new symbols fall into place:

Cascade multiplier starts at multiplier_start and increases by multiplier_inc per cascade
Maximum multiplier capped at max_multiplier
Cascades continue until no new wins form
reset_on_no_win: whether the multiplier resets

Bonus Game

When enough Bonus symbols land:

A separate bonus round is triggered
Types: pick (pick-and-reveal), wheel (wheel of fortune)
Each prize has a value and weight (probability)

Wild Features

Feature	Description
Expanding	Wild expands to cover the entire reel on a win
Sticky	Wild remains in place for the next spin
Walking	Wild moves one position per spin
Multiplier	Wild carries a multiplier applied to wins

Multi-Step Round Flow

Slots rounds can involve multiple wallet operations within a single round_id:

sequenceDiagram
    participant Player
    participant Game as Slots Game
    participant Beexar
    participant Wallet as Operator Wallet

    Player->>Game: Spin (bet=5)
    Game->>Beexar: Place bet
    Beexar->>Beexar: Spin result: 3 Scatters → Free Spins!
    Beexar->>Wallet: POST /betwin (round_id, bet=5.00 + win=2.50, finished=false)
    Wallet-->>Beexar: { balance: "497.50", transactions }

    Note over Beexar,Wallet: Free Spins Round (same round_id)

    loop Free Spin 1..N
        Beexar->>Beexar: Free spin result
        Beexar->>Wallet: POST /betwin (round_id, win=..., finished=false)
        Wallet-->>Beexar: { balance, transactions }
    end

    Beexar->>Wallet: POST /betwin (round_id, win=final, finished=true)
    Wallet-->>Beexar: { balance: "527.50", transactions }
    Game-->>Player: Show total win animation

Configuration Parameters

Core

Parameter	Type	Description
`reels`	int	Number of reels
`rows`	int	Number of rows
`win_mode`	string	`"paylines"`, `"ways"`, or `"cluster"`
`volatility`	string	`"low"`, `"medium"`, or `"high"`
`info_rtp`	float	Display RTP percentage
`max_win_multiplier`	float	Maximum win multiplier (e.g. 5000x)

Symbols

Each symbol has:

Field	Type	Description
`id`	string	Unique identifier
`name`	string	Display name
`type`	string	`"regular"`, `"wild"`, `"scatter"`, `"bonus"`
`payouts`	map[int]float	Count → multiplier (e.g. 3→2.0, 4→5.0, 5→20.0)
`weight`	int	Probability weight on reel strips

Free Spins Config

Field	Type	Description
`enabled`	bool	Whether free spins are available
`trigger_count`	int	Number of scatters to trigger
`spins_awarded`	int	Number of free spins given
`multiplier`	float	Win multiplier during free spins
`retrigger_enabled`	bool	Can free spins retrigger?
`max_retriggers`	int	Maximum retrigger count

Game Result

Field	Type	Description
`reels`	string[][]	Final reel grid (symbol IDs)
`wins`	WinLine[]	List of winning combinations
`total_win`	decimal	Total win amount
`free_spins_awarded`	int	Free spins triggered (0 if none)
`cascade_steps`	CascadeStep[]	Cascade sequence (if cascade enabled)
`bonus_triggered`	bool	Whether bonus game was triggered