Getting Started
Lucky Races is an on-chain turn-based racing game. Each turn you pick a lane, an item, a speed mode, and whether to defend — then four racers move in parallel, items resolve, and the next turn begins. Races are short (1–3 laps), every move is recorded on-chain, and the final standings are deterministic given the starting state.
This page covers what you need to know to play or build against Lucky Races. For the rules of play, click the ? in the top-right of the lobby for the in-game How to Play deck. For everything that goes through the chain, see [Smart Contracts](#) and the [API Reference](#).
Every race goes through three phases:
1. Lobby — A race is created with a chosen track and lap count, and four racers join. Anyone can create a lobby; anyone can join an open one.
2. Race — Each turn every racer submits a turn (item + lane + speed + defenses). When all turns are in, one tick advances the simulation. Repeat until racers finish.
3. Results — Final placings, finish ticks, and any prize-pool payouts settle on-chain.
A turn submission is one transaction per racer. A tick advance is one transaction. A short race typically resolves in around 12–25 ticks.