---
title: "Create a new game instance for a given family. Returns initial state to pass to subsequent calls. Variant can include flags like \"grand+random\" or \"standard+drops\"."
method: POST
path: "/api/tools/play_create_game"
---

# Create a new game instance for a given family. Returns initial state to pass to subsequent calls. Variant can include flags like "grand+random" or "standard+drops".

`POST /api/tools/play_create_game`

## Request

- Base URL: `https://tools.moddable.games`
- URL: `https://tools.moddable.games/api/tools/play_create_game`
- Auth: none declared

## Request body

- object
  - `family` string, required: Game family name (chess, draughts, go, reversi, shogi, xiangqi, mancala, morris, hex, landlords-game, backgammon, standard-52, bavarian-32, flower-48, double-six-dominoes, mahjong, standard-dice, agon, asalto, chaupar, dou-shou-qi, fanorona, halma, nyout, pachisi, royal-ur, senet, stern-halma, surakarta, tafl)
  - `variant` string: Variant slug, optionally with flags (e.g. "grand", "grand+random", "standard+drops")
  - `rngSeed` number: Optional RNG seed for deterministic games

## Response `200`

Tool result

---

[API](https://skmtc.dev/moddable/apis/moddable-games-tools.md) · [All operations](https://skmtc.dev/moddable/apis/moddable-games-tools/llms.txt) · [OpenAPI document](https://skmtc.dev/moddable/apis/moddable-games-tools/revisions/637a0b62cb9a?raw)