Back to game data

About the data

What the monthly files hold, how to credit them, and what is left out.

Formats

JSONL: one game per line, gzip compressed. Each line is the same JSON as that game's own download on its game page. Fields:

game_id, source.game_urlThe game's id and its page on Mistboard.
variant, modeThe variant id, and pvp (people against people), pve (a person against a bot) or, in the engine game files, eve (a bot against a bot).
playersThe name each seat shows on the game page, keyed by color. A seat set to private reads Anonymous.
time_controlStarting time and increment in milliseconds with a label such as 5+3; null when untimed. An engine match played at a fixed time per move carries movetime_ms.
started_at, ended_atWhen the game started and ended, ISO 8601 in UTC.
result, terminationThe winning color or draw, and how the game ended: checkmate, timeout, resignation and so on.
pliesEvery move in order: the mover, the move as uci, san where the variant has a notation (otherwise null), and each side's clock after the move. In Jieqi, Banqi and Flip Jungle a move that turned a piece over also has revealed, a color and a role.
first_mover_inkBanqi and Flip Jungle only: the color the first player turned up.
deal_fenBanqi and Flip Jungle games played on the site: the starting deal, as a FEN that names every face-down piece. Jieqi games and engine matches have none.
originEngine match downloads only: the event, the credit, and any squares whose piece was never revealed.

A uci move is coordinates: h2e2 moves a piece, @c3 turns over a face-down piece, R@d4 drops a piece from hand (Crazyhouse Xiangqi), and b3e3@e6 is a Duck Xiangqi turn with the duck square last.

PGN, for the variants whose moves can be written so the text replays on its own: SAN for Fog Chess, WXF for Xiangqi and Atomic Xiangqi, ICCS coordinates for Fog Xiangqi and Jieqi, ICGA notation for Banqi, and coordinates for Flip Jungle. Games are separated by a blank line and carry Site (the game page), MistboardVariant, MistboardTermination and License tags. The other variants are JSONL only.

License

The files are published under CC BY 4.0. Use them for anything, commercial or not, as long as you credit Mistboard and link to the game data page, for example:

Game data from Mistboard, https://mistboard.com/data, CC BY 4.0.

Crediting means naming Mistboard and linking to the game data page; the line above is enough. An engine match download also keeps the credit its games show.

What is included

Every finished game played on the site since June 2026, people against people or against the bots, rated and casual, signed in or as a guest. A game is filed under the month it ended, in UTC.

Choose a bot on the game data page to download its completed public games. Games against people and scheduled engine games keep separate files with the same formats and license.

Left out: aborted games and games that ended before both sides moved, games played by the accounts that run and test the site, games that are not public, engine games (they have files of their own), and imported games such as engine matches. The current month is added once it ends.

Hidden information

A finished fog game hides nothing, so its file holds every move of both sides, as the game page shows once the game is over. What each player could see at the time is not stored; it follows from the moves and the visibility rules in the open-source game code.

Jieqi, Banqi and Flip Jungle start with pieces face down. Their files say what every reveal turned out to be, so a downloaded game replays from its moves alone, in either format.

Moves carry reveals. In PGN the piece a move turned over follows it after =, upper case for red and lower case for black, so any PGN reader keeps it as part of the move: e3e4=R in Jieqi, @c3=E in Flip Jungle. A Jieqi capture of a face-down piece names nothing, because only the player who took it saw it. The letters are each FEN's own: Jieqi R chariot, N horse, B elephant, A advisor, C cannon, P soldier; Flip Jungle R rat, C cat, D dog, W wolf, P leopard, T tiger, L lion, E elephant.

Banqi PGN follows the notation of Chen, Shen and Hsu (ICGA Journal, 2010): b4-b2 moves a piece, and a flip the paper writes d8(P) is written d8=P here, because PGN reads parentheses as a side line. The letters are the paper's: K king, G guard, M minister, R rook, N knight, C cannon, P pawn. Its board is 4 columns by 8 rows, so the site's coordinates swap: site files a to h are ICGA rows 1 to 8, and site ranks 1 to 4 are ICGA columns a to d. JSON keeps the site's coordinates.

Careful with G: in Banqi moves it is a guard, but in the Banqi FEN it is the general. The FEN letters are G general, A advisor, E elephant, R chariot, H horse, C cannon, S soldier.

Banqi and Flip Jungle games include the deal. They are dealt in full when they start, so the JSON has deal_fen and the PGN a DealFEN tag: the variant's FEN with a sixth field naming each face-down piece in board order, top rank first. The FEN tag is the face-down start. Every reveal in the moves matches the deal, and both FENs use the site's coordinates and letters. Jieqi files have no deal: a piece captured face-down was seen only by the player who took it, and a piece never turned over was seen by no one, so no file names either.

Engine match downloads have no deal. The match's own referee decided each piece when it was turned over, so a piece still face down at the end never had an identity: origin.never_revealed lists those squares, and no file names a piece for them. Their moves carry every reveal, so they replay the same way.

The open-source game code has a reference replayer, replayHiddenPieceRecord, that rebuilds a game from either file and checks every reveal against the deal when the file has one.

Engine games

The site schedules a few games a day between its own bots, the same bots you can play, in several variants, and plays them on its own servers. They are published in their own monthly files, under Engine games on the game data page, with mode eve. They are never in the files of games people played, and they are not counted in the site's statistics or ratings. A Jieqi engine game is dealt like any other game on the site, so it has deal_fen.

Files and checksums

A file is built from the database the first time anyone downloads it and never changes after that. Its size and SHA-256 appear on the game data page once it exists, so a download can be checked with sha256sum.

The site serves the files itself. They move to object storage (Cloudflare R2) once a month's file passes about 100 MB, or once download bandwidth starts to cost money.