關於資料
每月檔案包含什麼、如何署名,以及哪些不包含在內。
格式
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 並連結到對局資料頁面,例如:
署名即註明 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)。