牌譜を読むにゃ

概要

「牌譜をファイルに保存するにゃ」でダウンロードした牌譜ファイルの読み方を解説するにゃ！
主に、段位戦の牌譜を解説するにゃ！
段位戦以外の牌譜についても、少しだけ触れるにゃ！
なお、サンプルとして使用している牌譜データには、解説の都合上、編集を加えているにゃ！

牌譜の形式

牌譜データには複数の形式が確認されているにゃ！
将来のアップデートで、新しい形式が登場するかもしれないにゃ！

「牌譜をファイルに保存するにゃ」でダウンロードした牌譜は、1番と2番が同じ形式になるように整形しているにゃ！
牌譜ダウンロードを自前のプログラムで行おうとする猫以外は、1番と2番を区別しなくていいにゃ！
3番は、1～2番に、いろいろな情報を付け加えたものにゃ！
3番の牌譜が読めるようになれば、1～2番の牌譜も読めるにゃ！
なので、このページでは、3番の牌譜の解説をするにゃ！
牌譜解析を自前のプログラムで行おうとする猫は、1～3それぞれの形式に対応する必要があるにゃ！
1～3の違いについては、「牌譜 - バージョン差異」の項でも解説するにゃ！

対局のメタデータ

牌譜ファイルを先頭から読んでいくにゃ！

"head": {
  "uuid": "220317-********-****-****-****-************",
  "start_time": 164745****,
  "end_time": 164745****,
  "config": {
    "category": 2,
    "mode": {
      "mode": 2,
      "detail_rule": {}
    },
    "meta": {
      "mode_id": 16
    }
  },
  "accounts": [
    いったん省略にゃ！
  ],
  "result": {
    いったん省略にゃ！
  }
},

対局者

「対局のメタデータ」で省略した「accounts」について説明するにゃ！

"accounts": [
  {
    "account_id": ********,
    "seat": 0,
    "nickname": "★★★★",
    "avatar_id": 403602,
    "character": {
      "charid": 200036,
      "level": 5,
      "exp": 0,
      "skin": 403602,
      "is_upgraded": true,
      "extra_emoji": [
        990,
        10,
        11,
        12
      ]
    },
    "title": 600032,
    "level": {
      "id": 10501,
      "score": 1982
    },
    "level3": {
      "id": 20202,
      "score": 453
    },
    "avatar_frame": 0,
    "verified": 0,
    "views": [
      {
        "slot": 0,
        "item_id": ******
      },
      省略にゃ！
    ]
  },
  省略にゃ！
],

「account_id」から、プレイヤーがどの言語で雀魂をプレイしているかがわかるにゃ！
計算式は次のとおりにゃ！

account_id ÷ 8388608

上記計算結果が7未満ならば中国語にゃ！
7以上13未満ならば日本語にゃ！
13以上15未満ならば英語にゃ！

対局結果

「対局のメタデータ」で省略した「result」について説明するにゃ！

"result": {
  "players": [
    {
      "seat": 3,
      "total_point": 63600,
      "part_point_1": 73600,
      "part_point_2": 0,
      "grading_score": 184,
      "gold": 17472
    },
    {
      "seat": 0,
      "total_point": -4200,
      "part_point_1": 15800,
      "part_point_2": 0,
      "grading_score": 56,
      "gold": -1176
    },
    {
      "seat": 2,
      "total_point": -18200,
      "part_point_1": 11800,
      "part_point_2": 0,
      "grading_score": -20,
      "gold": -5096
    },
    {
      "seat": 1,
      "total_point": -41200,
      "part_point_1": -1200,
      "part_point_2": 0,
      "grading_score": -50,
      "gold": -11200
    }
  ]
}

牌譜 - バージョン差異

「牌譜の形式」に書いたように、牌譜にはバージョン差異があるにゃ！
説明するにゃ！

{
  省略
  "data": {
    "name": ".lq.GameDetailRecords",
    "data": {
      "records": [
        省略
      ]
      "version": 210715,
      "actions": [
        省略
      ]
    }
  },
  "data_url": ""
}

牌譜 - 基本

2021年7月28日アップデート以降の牌譜にだけ出てくるデータ形式を説明するにゃ！
とても大切なデータ形式なので、よく読んで、丸暗記するにゃ！

{
  "passed": ******,
  "type": *,
  "result": {
    省略にゃ！
  }
  "user_input": {
    省略にゃ！
  }
  "user_event": {
    省略にゃ！
  }
  "game_event": *
},

牌譜 - game_event

「牌譜 - 基本」の項で説明した「type」が「4」の場合、「game_event」というキーが値を持っているにゃ！
「game_event」は、対局開始か対局終了をあらわしているにゃ！
それぞれのサンプルを紹介するにゃ！

{
  "passed": 11116,
  "type": 4,
  "game_event": 1
},

{
  "passed": 2021632,
  "type": 4,
  "game_event": 2
}

牌譜 - user_event

「牌譜 - 基本」の項で説明した「type」が「3」の場合、「user_event 」というキーが値を持っているにゃ！
「user_event」は、プレイヤーの回線接続か回線切断をあらわしているにゃ！
それぞれのサンプルを紹介するにゃ！

{
  "passed": 4857,
  "type": 3,
  "user_event": {
    "seat": 0,
    "type": 1
  }
},

{
  "passed": 659302,
  "type": 3,
  "user_event": {
    "seat": 2,
    "type": 2
  }
},

牌譜 - user_input

「牌譜 - 基本」の項で説明した「type」が「2」の場合、「user_input」というキーが値を持っているにゃ！
「user_input」は、プレイヤーの操作をあらわしているにゃ！

{
  "passed": ******,
  "type": 2,
  "user_input": {
    "seat": *,
    "type": *,
    省略にゃ！
  }
},

[別表：user_inputのtype]

[type: 1 のサンプル]

{
  "passed": 112740,
  "type": 2,
  "user_input": {
    "seat": 1,
    "type": 1,
    "emo": 0
  }
},

[type: 7 のサンプル（type: 5 と 6 と 8 と 9 も同形式）]

{
  "passed": 8414,
  "type": 2,
  "user_input": {
    "seat": 2,
    "type": 7
  }
},

牌譜 - user_input - operation

「牌譜 - user_input」の項で説明した「type」が「2」の場合、「operation」というキーが値を持っているにゃ！
「operation」は、自分の順番での操作をあらわしているにゃ！

{
  "passed": ******,
  "type": 2,
  "user_input": {
    "seat": *,
    "type": 2,
    "operation": {
      "type": *,
      省略にゃ！
    }
  }
},

[別表：operationのtype]

[type: 1 のサンプル （type: 7 も同形式）]

{
  "passed": 21161,
  "type": 2,
  "user_input": {
    "seat": 0,
    "type": 2,
    "operation": {
      "type": 1,
      "tile": "4z",
      "moqie": false,
      "timeuse": 3,
      "tile_state": 0
    }
  }
},

[type: 4 のサンプル（type: 6 も同形式）]

{
  "passed": 833726,
  "type": 2,
  "user_input": {
    "seat": 3,
    "type": 2,
    "operation": {
      "type": 4,
      "index": 1,
      "timeuse": 4
    }
  }
},

[type: 8 のサンプル]

{
  "passed": 1023759,
  "type": 2,
  "user_input": {
    "seat": 1,
    "type": 2,
    "operation": {
      "type": 8,
      "index": 0,
      "timeuse": 1
    }
  }
},

[キャンセル操作のサンプル]

{
  "passed": 2706174,
  "type": 2,
  "user_input": {
    "seat": 2,
    "type": 2,
    "operation": {
      "cancel_operation": true,
      "timeuse": 1
    }
  }
},

牌譜 - user_input - cpg

「牌譜 - user_input」の項で説明した「type」が「3」の場合、「cpg」というキーが値を持っているにゃ！
「cpg」は、他家の順番での操作をあらわしているにゃ！
なお、「cpg」とは、「Chi Peng Gang」（チー、ポン、カン）の略にゃ！

{
  "passed": ******,
  "type": 2,
  "user_input": {
    "seat": *,
    "type": 3,
    "cpg": {
      "type": *,
      省略にゃ！
    }
  }
},

[別表：cpgのtype]

[type: 2 のサンプル（type: 3 と 5 も同形式）]

{
  "passed": 116602,
  "type": 2,
  "user_input": {
    "seat": 1,
    "type": 3,
    "cpg": {
      "type": 2,
      "index": 0,
      "timeuse": 2
    }
  }
},

[type: 9 のサンプル]

{
  "passed": 213274,
  "type": 2,
  "user_input": {
    "seat": 3,
    "type": 3,
    "cpg": {
      "type": 9,
      "index": 0,
      "timeuse": 2
    }
  }
},

[キャンセル操作のサンプル]

{
  "passed": 242019,
  "type": 2,
  "user_input": {
    "seat": 3,
    "type": 3,
    "cpg": {
      "cancel_operation": true,
      "timeuse": 0
    }
  }
},

牌譜 - result

「牌譜 - 基本」の項で説明した「type」が「1」の場合、「result」というキーが値を持っているにゃ！
「result」は、牌山、配牌、自摸、打牌、鳴き、和了、流局、などなどをあらわしているにゃ！
いちばん牌譜らしいデータにゃ！

{
  "passed": ******,
  "type": 1,
  "result": {
    "name": ".lq.RecordXXXXXXXX",
    "data": {
    省略にゃ！
    }
  }
},

[別表：resultのname]

牌譜 - .lq.RecordNewRound

「牌譜 - result」の項で説明した「name」が「.lq.RecordNewRound」の場合について説明するにゃ！
各局の開始時に一度だけ出現するデータ形式にゃ！
配牌や牌山の情報が記されているにゃ！

"name": ".lq.RecordNewRound",
"data": {
  "chang": 0,
  "ju": 0,
  "ben": 0,
  "scores": [
    25000,
    25000,
    25000,
    25000
  ],
  "liqibang": 0,
  "tiles0": [
    "1m",
    "2m",
    "5m",
    "7m",
    "8m",
    "9m",
    "2p",
    "4p",
    "6p",
    "7p",
    "5s",
    "6s",
    "9s",
    "3z"
  ],
  "tiles1": [
    省略にゃ！
  ],
  "tiles2": [
    省略にゃ！
  ],
  "tiles3": [
    省略にゃ！
  ],
  "tingpai": [
    省略にゃ！
  ],
  "operation": {
    "seat": 0,
    "operation_list": [
      {
        "type": 1
      }
    ],
    "time_add": 20000,
    "time_fixed": 8000
  },
  "md5": "945cee39977910189752dbf58117a4b0",
  "paishan": "1m2m8p3m6s6z7s7z4s2p1p8p3p7s1z7p3s0s4z9p7s7z3z3s6p9m8s7z2s6s9s4m6s5p1z3z2m9m2z5z1s2s6m7p2s3p7z8s1z7m7m1m1p5s1s6p2p6z3z9p0p8s1p1s4z4s4m9m8p6m1s0m3m8p4p6m4s4p5z9s6z9s2z",
  "left_tile_count": 69,
  "doras": [
    "5z"
  ],
  "opens": [
    {
      "seat": 0
    },
    {
      "seat": 1
    },
    {
      "seat": 2
    },
    {
      "seat": 3
    }
  ]
}

[別表：operation_listのtype]

「牌譜 - result - data - operation」の項で詳しく説明するにゃ！
なお、表の説明欄が「N/A」となっているものは、配牌直後の親には選択できない操作か、または特殊ルールのため特殊な記述がされる操作ということにゃ！

[type: 8（天和）のサンプル]

"tingpai": [
  {
    "seat": 0,
    "tingpais1": [
      {
        "tile": "7z",
        "haveyi": false,
        "yiman": false,
        "count": 0,
        "fu": 40,
        "biao_dora_count": 0,
        "yiman_zimo": false,
        "count_zimo": 1,
        "fu_zimo": 30
      }
    ]
  }
],
"operation": {
  "seat": 0,
  "operation_list": [
    {
      "type": 1
    },
    {
      "type": 7,
      "combination": [
        "1m",
        "2m",
        "3m",
        "5m",
        "6m",
        "7m",
        "1p",
        "2p",
        "3p",
        "6s",
        "7s",
        "8s",
        "7z",
        "7z"
      ]
    },
    {
      "type": 8
    }
  ],
  "time_add": 20000,
  "time_fixed": 8000
},

牌譜 - .lq.RecordDealTile

「牌譜 - result」の項で説明した「name」が「.lq.RecordDealTile」の場合について説明するにゃ！
牌を自摸ってきたときに出現するデータ形式にゃ！

"name": ".lq.RecordDealTile",
"data": {
  "seat": 0,
  "tile": "4s",
  "left_tile_count": 22,
  "liqi": {
    "seat": 1,
    "score": 32900,
    "liqibang": 1
  },
  "doras": [
    "7m",
    "4p"
  ],
  "zhenting": [
    false,
    false,
    false,
    true
  ],
  "operation": {
    "seat": 0,
    "operation_list": [
      {
        "type": 1
      }
    ],
    "time_add": 20000,
    "time_fixed": 5000
  }
}

[別表：operation_listのtype]

「牌譜 - result - data - operation」の項で詳しく説明するにゃ！
なお、表の説明欄が「N/A」となっているものは、自摸時には選択できない操作ということにゃ！

牌譜 - .lq.RecordDiscardTile

「牌譜 - result」の項で説明した「name」が「.lq.RecordDiscardTile」の場合について説明するにゃ！
打牌したときに出現するデータ形式にゃ！

"name": ".lq.RecordDiscardTile",
"data": {
  "seat": 3,
  "tile": "7m",
  "is_liqi": false,
  "moqie": false,
  "zhenting": [
    false,
    false,
    false,
    true
  ],
  "tingpais": [
    {
      "tile": "6m",
      "haveyi": true,
      "yiman": false,
      "count": 1,
      "fu": 30,
      "biao_dora_count": 1,
      "yiman_zimo": false,
      "count_zimo": 1,
      "fu_zimo": 30
    },
    {
      "tile": "9m",
      "haveyi": false,
      "yiman": false,
      "count": 0,
      "fu": 30,
      "biao_dora_count": 1,
      "yiman_zimo": false,
      "count_zimo": 0,
      "fu_zimo": 30
    }
  ],
  "doras": [
    "8m",
    "9s"
  ],
  "is_wliqi": false
  "operations": [
    {
      "seat": 0,
      "operation_list": [
        {
          "type": 2,
          省略にゃ！
        }
      ],
      "time_add": 20000,
      "time_fixed": 5000
    }
  ]
}

[別表：operation_listのtype]

「牌譜 - result - data - operation」の項で詳しく説明するにゃ！
なお、表の説明欄が「N/A」となっているものは、打牌時には選択できない操作ということにゃ！

牌譜 - .lq.RecordChiPengGang

「牌譜 - result」の項で説明した「name」が「.lq.RecordChiPengGang」の場合について説明するにゃ！
チー、ポン、大明槓のどれかをしたときに出現するデータ形式にゃ！

"name": ".lq.RecordChiPengGang",
"data": {
  "seat": 3,
  "type": 0,
  "tiles": [
    "4p",
    "6p",
    "0p"
  ],
  "froms": [
    3,
    3,
    0
  ],
  "liqi": {
    "seat": 0,
    "score": 24000,
    "liqibang": 1
  },
  "zhenting": [
    false,
    false,
    false,
    false
  ],
  "operation": {
    "seat": 3,
    "operation_list": [
      {
        "type": 1,
        "combination": [
          "5p"
        ]
      }
    ],
    "time_add": 20000,
    "time_fixed": 5000
  },
  "tile_states": [
    0,
    0
  ]
}

牌譜 - .lq.RecordAnGangAddGang

「牌譜 - result」の項で説明した「name」が「.lq.RecordAnGangAddGang」の場合について説明するにゃ！
加槓、暗槓のどちらかをしたときに出現するデータ形式にゃ！

"name": ".lq.RecordAnGangAddGang",
"data": {
  "seat": 2,
  "type": 2,
  "tiles": "2s",
  "doras": [
    "8p",
    "5z"
  ],
  "operations": [
    {
      "seat": 1,
      "operation_list": [
        {
          "type": 9
        }
      ],
      "time_add": 20000,
      "time_fixed": 5000
    }
  ]
}

段位戦の牌譜において、サンプルに示したような、「doras」キーと「operations」キーが両方存在するのは、次のどちらかのケースにゃ！どちらもレアにゃ！

大明槓または加槓をする
  ↓
自摸ってきた嶺上牌で加槓をする
  ↓
その加槓で他家が槍槓ロン可能

大明槓または加槓をする
  ↓
自摸ってきた嶺上牌で暗槓をする
  ↓
その暗槓で他家が国士無双ロン可能

牌譜 - .lq.RecordBaBei

「牌譜 - result」の項で説明した「name」が「.lq.RecordBaBei」の場合について説明するにゃ！
三麻で北抜きをしたときに出現するデータ形式にゃ！

"name": ".lq.RecordBaBei",
"data": {
  "seat": 2,
   "doras": [
     "9m",
     "2s"
   ],
  "operations": [
    {
      "seat": 0,
      "operation_list": [
        {
          "type": 9
        }
      ],
      "time_add": 20000,
      "time_fixed": 5000
    }
  ],
  "moqie": true
}

段位戦の牌譜において、サンプルに示したような、「doras」キーと「operations」キーが両方存在するのは、次のケースにゃ！

大明槓または加槓をする
  ↓
自摸ってきた嶺上牌の北で北抜きをする
  ↓
その北で他家がロン可能

牌譜 - .lq.RecordHule

「牌譜 - result」の項で説明した「name」が「.lq.RecordHule」の場合について説明するにゃ！
和了したときに出現するデータ形式にゃ！

"name": ".lq.RecordHule",
"data": {
  "hules": [
    {
      "hand": [
        "2p",
        "2p",
        "3s",
        "2s",
        "1s",
        "7p",
        "8p"
      ],
      "ming": [
        "kezi(6z,6z,6z)",
        "angang(0m,5m,5m,5m)"
      ],
      "hu_tile": "6p",
      "seat": 3,
      "zimo": true,
      "qinjia": true,
      "liqi": false,
      "doras": [
        "1z",
        "7s"
      ],
      "yiman": false,
      "count": 3,
      "fans": [
        {
          "val": 1,
          "id": 8
        },
        {
          "val": 1,
          "id": 4
        },
        {
          "val": 1,
          "id": 32
        }
      ],
      "fu": 50,
      "point_rong": 9600,
      "point_zimo_xian": 3200,
      "title_id": 0,
      "point_sum": 9600,
      "dadian": 9600,
      "baopai": 0
    }
  ],
  "old_scores": [
    29200,
    22000,
    25800,
    23000
  ],
  "delta_scores": [
    -3200,
    -3200,
    -3200,
    9600
  ],
  "wait_timeout": 0,
  "scores": [
    26000,
    18800,
    22600,
    32600
  ],
  "gameend": {},
  "baopai": 0
}

包の情報が2箇所に存在する理由を推測してみるにゃ！1局で包が2件発生し、更にダブルロンで、両方の包が適用されたケースを想定するにゃ！この場合、「data」直下には包の情報は1件分しか記録できないため、2件の包に対応できないにゃ！一方、「hules」の中に包の情報を記録しておけば、「hules」はダブルロンならば2個、トリプルロンならば3個存在するので、2件の包に対応できるにゃ！おそらく、2022年4月27日アップデートにおいて、2件の包の同時成立に対応したのだと思うにゃ！

牌譜 - .lq.RecordNoTile

牌譜 - .lq.RecordLiuJu

牌譜 - result - data - operation

[operation_listのtype]

[type: 1 のサンプル]
[type: 2 のサンプル]

イレギュラーな牌譜

続きは少し休んでから書くにゃ！