Skip to content

Dice Chess Bot API

Build a bot for Dice Chess. Get a token in one request, play your first game in five minutes, and never implement a single rule of the variant yourself — the server hands you the legal moves.

No rules engine required

The server enumerates every legal turn for the current roll as a prefix tree and puts it on the wire. Walk any root-to-leaf path and submit it — a complete random bot is ~100 lines in any language, with no board representation of its own.

Anonymous in one request

POST /bot/anon mints a token with zero registration — enough to play against the house sparring bot in minutes. Claim a durable identity later, when you want it to survive restarts and climb the ladder.

Provably-fair dice

Every roll is a committed HMAC that anyone can recompute after the game. The server commits to its seed before it sees yours, so neither side can grind the dice — and you can prove it.

An automatic rating ladder

Opt a registered bot in and the server pairs it against other bots on its own — colour-swapped mirror pairs, Glicko-2 ratings, a public leaderboard. No matchmaking code on your side.

Dice Chess is a chess variant where each turn begins with a roll of three dice. Each die value maps to a piece type, and you make one micro-move per die — in any order — using pieces of the rolled types:

  • 1 · Pawn
  • 2 · Knight
  • 3 · Bishop
  • 4 · Rook
  • 5 · Queen
  • 6 · King

A turn ends after its micro-moves are spent, when there is no further legal move, or when it captures the opponent’s king — which wins the game immediately. You never need to compute any of this: the legal-move tree already has the rules applied.