aoc mgz

毫克

帝國時代 II 用 Python 3 記錄遊戲解析和摘要。

支援的版本

• 列王時代 ( .mgl )
• 征服者 ( .mgx )
• 使用者補丁 1.4 ( .mgz )
• 使用者補丁 1.5 ( .mgz )
• 高清版 >= 4.6 ( .aoe2record )
• 最終版（ .aoe2record ）

建築學

mgz的核心功能是解析器，它根據錄製的遊戲檔案產生 Python 資料結構。它還提供抽象表示，使數據的使用更加容易。

解析器

mgz提供了兩個解析器， fast和full 。 fast解析器會跳過很少需要的數據，而full解析器會嘗試解析盡可能多的數據。當然， fast解析器比full解析器更快。 full解析器幾乎可以做所有事情，但fast可能只有 80-90%。 summary將自動嘗試fast解析器，並在需要時回退到full解析器。

抽象

抽象將解析器輸出作為輸入，並傳回一個具有規範化資料的對象，該對像在大多數情況下更易於使用。有兩個可用的抽象， summary和model 。 summary抽象試圖公開最大量的可用資料。 model抽象受到更多限制，但會自動執行更多查找。

支援

版本	模型	概括	快（標題）	快（身體）	完整（標題）	完整（身體）
列王時代 ( .mgl )		✓		✓	✓
征服者 ( .mgx )		✓		✓	✓
使用者補丁 <= 1.4 ( .mgz )		✓		✓	✓	✓
使用者補丁 1.5 ( .mgz )	✓	✓	✓	✓	✓	✓
高清版 >= 4.6		✓		✓	✓	✓
高清版5.8	✓	✓	✓	✓	✓	✓
最終版 <= 13.34 ( .aoe2record )		✓		✓	✓	✓
最終版 > 13.34，<= 26.21 ( .aoe2record )	✓	✓	✓	✓	✓	✓
最終版 > 26.21 ( .aoe2record )	✓	✓	✓	✓	✓

範例

完整解析器（標頭）+ 快速解析器（主體）

 import os
from mgz import header , fast

with open ( '/path/to/file' , 'rb' ) as data :
    eof = os . fstat ( data . fileno ()). st_size
    header . parse_stream ( data )
    fast . meta ( data )
    while data . tell () < eof :
        fast . operation ( data )

概括

 from mgz . summary import Summary

with open ( '/path/to/file' , 'rb' ) as data :
    s = Summary ( data )
    s . get_map ()
    s . get_platform ()
    # ... etc

模型

 from mgz . model import parse_match

with open ( '/path/to/file' , 'rb' ) as data :
    match = parse_match ( data )
    match . map . name
    match . file . perspective . number
    # ... etc 

轉為 JSON

 import json
from mgz . model import parse_match , serialize

with open ( '/path/to/file' , 'rb' ) as h :
    match = parse_match ( h )
    print ( json . dumps ( serialize ( match ), indent = 2 ))

常見問題解答

Q：遊戲結束時的成就/統計數據在哪裡？

A：在postgame行動中，僅在使用者修補版本中可用。

Q：我如何知道某一點的資源/殺戮/等數量？

答：你不能，除非在遊戲中重播比賽。

Q：遊戲錄製檔案如何運作？

答：第一部分（ header ）是初始遊戲狀態的快照。第二部分（ body ）是玩家所做的動作清單。遊戲載入標題，然後根據遊戲規則應用每個動作來改變狀態。

Q：如何安裝這個軟體包？

答： pip install mgz

貢獻

• 歡迎拉取請求和補丁

資源

• aoc-mgx-format：https://github.com/stefan-kolb/aoc-mgx-format
• 回收：https://github.com/goto-bus-stop/recage
• 再分析：http://sourceforge.net/p/recanalyst/
• genie-rs：https://github.com/SiegeEngineers/genie-rs/tree/default/crates/genie-rec
• bari-mgx-格式：https://web.archive.org/web/20090215065209/http://members.at.infoseek.co.jp/aocai/mgx_format.html