Skip to main content

​
Overview

A Texas Hedge’Em game moves through a fixed sequence of states. The gameState field in HedgeEmGameState tells the client exactly where in the lifecycle the game is.

​
State lifecycle

STATUS_SETUP
    ↓  (advance)
STATUS_START
    ↓  (advance)
STATUS_HOLE          ← Hole betting open
    ↓  (advance)
STATUS_FLOP_CARD1
    ↓
STATUS_FLOP_CARD2
    ↓
STATUS_FLOP_CARD3
    ↓
STATUS_FLOP          ← Flop betting open
    ↓  (advance)
STATUS_TURN          ← Turn betting open
    ↓  (advance)
STATUS_RIVER         ← Winner revealed, payouts calculated
    ↓  (advance)
STATUS_SETUP         ← Next game begins

​
Betting stages

The bettingStage field indicates which stage is currently accepting bets:
ValueStageDescription
-1NON_BETTINGNo bets accepted (river, setup)
0HOLEBetting on hole cards
1FLOPBetting on the flop
2TURNBetting on the turn card

​
Hand status

Each hand’s odds panel has a handStatus that drives how the game client renders it:
StatusMeaningBetting
IN_PLAY_BETTING_STAGE_ACTIVECurrent stage, bets open✅ Open
IN_PLAY_FAVOURITELeading hand✅ Open (lower odds)
IN_PLAY_PREVIOUS_BETTING_STAGE_NOT_ACTIVEEarlier stage, game moved on❌ Closed
IN_PLAY_DISABLEDCannot bet at this stage❌ Closed
IN_PLAY_DEADHand cannot win — no remaining outs❌ Closed
IN_PLAY_WILL_WINGuaranteed winner or draw❌ Closed
IN_PLAY_WINNERRevealed winner at river—

​
Example: 4-hand game at the Hole stage

At STATUS_HOLE, the handOdds array will contain 4 entries — one per hand — all with bettingStage: 0 (HOLE). Subsequent stages (FLOP, TURN) will have IN_PLAY_PREVIOUS_BETTING_STAGE_NOT_ACTIVE for earlier panels. As the game progresses, some hands will be marked IN_PLAY_DEAD and others may become IN_PLAY_WILL_WIN if the outcome is already determined.