Crash

This document outlines the socket.io events used for the Crash game.

All events are prefixed crash: unless they are global game events.

Game States

The game cycles through three states:

1. waiting: The betting period (6 seconds). Users can place or update bets.

2. in-game: The multiplier starts at 1.00x and increases until it crashes.

3. after: The period immediately after a crash (3 seconds) before the next round.

---

Client to Server Events (Emitted by Frontend)

crash:bet

Places a bet for the upcoming round.

• Payload:

  {
    "betAmount": 100.50,
    "autoCashout": 2.50
  }

• Notes: autoCashout is optional (0 or undefined for manual cashout).

crash:cashout

Triggers a manual cashout during the in-game state.

• Payload: None

crash:status

Requests the current game state.

• Payload: None

crash:history

Requests the last 20 crash multipliers.

• Payload: None

crash:bet-count

Requests the number of players in the current round.

• Payload: None

---

Server to Client Events (Listened by Frontend)

crash:loop

Continuous updates for the game timer or multiplier.

• Payload (Waiting/After):

  {
    "status": "waiting",
    "timer": 4500
  }

• Payload (In-Game):

  {
    "multiplier": 1.45,
    "counter": 2500
  }

• Payload (Crash):

  {
    "multiplier": 5.67,
    "counter": 8500,
    "gameOver": true
  }

crash:bet

Response to a bet attempt.

• Payload:

  {
    "status": true
  }

  OR

  {
    "status": false,
    "message": "Insufficient balance"
  }

crash:cashout

Response to a manual cashout attempt.

• Payload:

  {
    "status": true
  }

crash:cashouts

Broadcasted when any user cashes out.

• Payload:

  {
    "cashout": {
      "1715632000000": {
        "avatar": "https://...",
        "username": "Player1",
        "multiplier": 2.45
      }
    }
  }

crash:status

Current game status.

• Payload:

  {
    "status": "in-game"
  }

crash:history

Last 20 multipliers.

• Payload:

  {
    "history": [1.5, 4.2, 1.05, 12.5, ...]
  }

crash:bet-count

Total players in the round.

• Payload:

  {
    "count": 15
  }

crash:bet-amount (User-specific)

Sent to the betting user to confirm their total wager.

• Payload:

  {
    "amount": 100.50
  }

balance-change (User-specific)

Sent when a user's balance changes due to a bet or win.

• Payload:

  {
    "change": -100.50
  }