返回对局数据

关于数据

月度文件包含什么、如何署名,以及哪些不包含在内。

格式

JSONL:每行一盘对局,gzip 压缩。每一行与该对局页面上单独下载的 JSON 完全相同。字段:

game_id, source.game_url对局编号及其在 Mistboard 上的页面。
variant, mode变体编号,以及 pvp(人对人)、pve(人对机器人),或在机器人对局文件中的 eve(机器人对机器人)。
players各方在对局页面上显示的名字,按颜色区分。设为私密的座位显示为 Anonymous。
time_control初始时间和每步加时(毫秒),并附 5+3 这样的标签;不限时则为 null。按每步固定用时进行的引擎对局附 movetime_ms。
started_at, ended_at对局开始和结束的时间,ISO 8601 格式,UTC。
result, termination获胜颜色或和棋,以及对局如何结束:将死、超时、认输等。
plies按顺序列出每一步:走子方、uci 格式的着法、该变体有记谱法时的 san(否则为 null),以及每步之后双方的剩余时间。在揭棋、暗棋和翻翻兽棋中,翻开棋子的着法还带有 revealed,为颜色加兵种。
first_mover_ink仅暗棋和翻翻兽棋:先手翻出的颜色。
deal_fen本站下的暗棋和翻翻兽棋对局:开局的暗子布局,以写明每枚暗子的 FEN 表示。揭棋对局和引擎对局没有此字段。
origin仅引擎对局下载:赛事、署名,以及始终未揭开的棋子所在的格子。

uci 着法是坐标:h2e2 是走子,@c3 是翻开一枚暗子,R@d4 是从手中打入(疯狂屋象棋),b3e3@e6 是一回合鸭子象棋,最后是鸭子的落点。

PGN:用于着法能写成可独立重放文本的变体:迷雾国际象棋用 SAN,象棋和原子象棋用 WXF,迷雾象棋和揭棋用 ICCS 坐标,暗棋用 ICGA 记谱法,翻翻兽棋用坐标。对局之间空一行,并带有 Site(对局页面)、MistboardVariant、MistboardTermination 和 License 标签。其他变体只提供 JSONL。

许可

这些文件按 CC BY 4.0 发布。可用于任何用途,商业或非商业皆可,只要注明 Mistboard 并链接到对局数据页面,例如:

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

署名即注明 Mistboard 并链接到对局数据页面,上面那一行就够了。引擎对局下载还需保留其对局显示的署名。

包含哪些对局

自 2026 年 6 月起在本站下完的每一盘对局:人对人或人对机器人,计分或休闲,登录或以访客身份。对局按结束时所在的月份(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.

不包含:中止的对局和任一方尚未走过棋就结束的对局、运营和测试本站的账号下的对局、非公开对局、机器人对局(它们有单独的文件),以及引擎对局等导入的对局。当月结束后才会加入。

隐藏信息

已结束的迷雾对局不再隐藏任何信息,所以文件包含双方的每一步,与对局结束后页面上显示的一致。当时每位玩家能看到什么并未保存;可以由着法和开源游戏代码中的视野规则推出。

揭棋、暗棋和翻翻兽棋开局时棋子背面朝上。它们的文件写明每次翻开的是什么棋子,所以下载的对局只凭着法就能重放,两种格式都可以。

着法带有翻开的棋子。在 PGN 中,着法翻开的棋子写在 = 之后,红方大写,黑方小写,所以任何 PGN 读取器都会把它当作着法的一部分:揭棋如 e3e4=R,翻翻兽棋如 @c3=E。揭棋吃掉暗子时不写出被吃的棋子,因为只有吃子的一方看到了它。字母沿用各自 FEN 的字母:揭棋 R 车、N 马、B 相、A 仕、C 炮、P 兵;翻翻兽棋 R 鼠、C 猫、D 狗、W 狼、P 豹、T 虎、L 狮、E 象。

暗棋 PGN 依照 Chen、Shen 和 Hsu 的记谱法(ICGA Journal,2010):b4-b2 是走子;论文中写作 d8(P) 的翻子,这里写作 d8=P,因为 PGN 会把括号读成变着。字母沿用论文:K 帅、G 仕、M 相、R 车、N 马、C 炮、P 兵。它的棋盘是 4 列 8 行,所以本站坐标要互换:本站的 a 到 h 列是 ICGA 的第 1 到 8 行,本站的第 1 到 4 行是 ICGA 的 a 到 d 列。JSON 保留本站坐标。

注意 G:在暗棋着法中它是仕,在暗棋 FEN 中却是帅。FEN 的字母为 G 帅、A 仕、E 相、R 车、H 马、C 炮、S 兵。

暗棋和翻翻兽棋对局附带暗子布局。这些对局在开始时就把棋子全部发好,所以 JSON 带有 deal_fen,PGN 带有 DealFEN 标签:在该变体的 FEN 后加第六个字段,按棋盘顺序(从最上一行开始)写出每枚暗子。FEN 标签是背面朝上的初始局面。着法中的每次翻开都与布局一致,两个 FEN 都使用本站的坐标和字母。揭棋文件没有布局:被吃的暗子只有吃子的一方看到过,从未翻开的棋子没有人看到过,所以任何文件都不会写出它们。

引擎对局下载没有暗子布局。对局自己的裁判程序在棋子翻开时才决定它是什么,所以对局结束时仍是暗子的棋子从未有过身份:origin.never_revealed 列出它们所在的格子,任何文件都不会为它们写出棋子。它们的着法带有每一次翻开,所以同样可以重放。

开源游戏代码中有一个参考重放器 replayHiddenPieceRecord,可以从任一文件重建对局,并在文件带有布局时逐一核对翻开的棋子与布局。

机器人对局

本站每天安排几盘自己的机器人之间的对局,就是你可以对战的那些机器人,涵盖多个变体,并在本站自己的服务器上进行。这些对局发布在单独的月度文件中,位于对局数据页面的“机器人对局”下,mode 为 eve。它们从不出现在人类对局的文件中,也不计入本站的统计或等级分。揭棋机器人对局和本站其他对局一样在开局时分配棋子,因此带有 deal_fen。

文件与校验和

文件在第一次有人下载时由数据库生成,之后不再改变。文件生成后,对局数据页面会显示它的大小和 SHA-256,可以用 sha256sum 校验下载。

文件由本站直接提供。当某个月的文件超过约 100 MB,或下载流量开始产生费用时,会迁移到对象存储(Cloudflare R2)。