BattleTech: The Crescent Hawk's Inception(1988年、MS-DOS、発売元 Infocom、エンジン開発 Westwood Associates)のリバースエンジニアリング、およびその進行中の Godot 4 / C# による再実装。
このリポジトリの他の内容を信頼する前に、このセクションを読んでください。 このプロジェクトは成熟度が大きく異なる2つの取り組みから成り、ドキュメント内の他の箇所で使われる「フェーズ」という語はコードが書かれたことを意味し、動作が証明されたことを意味するものではありません。
このプロジェクトは同時に2つの成果物を生み出し、2つ目は1つ目の上に立脚しています:
(1) 文書化されたリバースエンジニアリング。 reko/ の逆コンパイル、docs/ の仕様書、BattleTech 専用の MCP ツールを備えた Spice86 エミュレータ、そして Python ツール群。これが実際の RE 作業です:ファイルフォーマット、ストーリーテキスト、メモリマップ、そしてエンジンロジックの大部分が文書化され、逆コンパイラの出力や実行中のエミュレータトレースと照合されています。これはそれ自体が独立した成果物であり、同時に (2) のための仕様でもあります。
(2) 再実装(BattleTechCHI/)。 (1) から派生した Godot 4 C# プログラムで、オリジナルのデータファイル(.BLD、.MTP、.ANM、GAME* セーブデータ)を読み込み、(1) で文書化された通りにエンジンの動作を再実装します。これはデータに忠実であって、動作に忠実ではなく、オリジナルに対してエンドツーエンドで検証されたことは一度もありません。
両者は並行して動作しますが、依存の方向は固定されています:
(2) は、(1) が完全かつ検証済みである分だけしか忠実になり得ない。 (1) が推測または未解決と述べている箇所では、(2) は当て推量にすぎない。
だからこそロードマップでは、RE のギャップを埋めること(トラック1)と、**(2) をエミュレータに対して差分検証すること(トラック3)**を、機能開発より優先しています。再実装の質は、それに立脚するリバースエンジニアリングの質を超えられません。
ビット単位で一致する移植版をお探しなら、それはまだ存在しません。ツール支援の RE 環境と、オリジナルのアセット上で動作するデータ駆動型の再構築をお探しなら、それがここにあります。
凡例:✅ 真 / 完了 · ⚠️ 部分的、近似的、または暗黙のギャップあり · ❓ 不明 / 未検証 · ❌ 欠如
| システム | 実行時に元ファイルを読み込む | 動作がオリジナルと一致する | 検証 |
|---|---|---|---|
| BLD 復号 + 暗号文 | ✅ BldLoader.cs | ✅ (テキスト) | ✅ ラウンドトリップ BLD↔JSON バイト一致 (tools/bld) |
| BLD オペコードインタプリタ (28 スロット 0xE4–0xFF) | ✅ | ⚠️ 部分的 | ❓ エンドツーエンドで未プレイ; オペランドサイズ固定 (EB/EC/F6/F7 および ED: 4 バイト idx/thresh/LE-target、match→jump); 全スロット処理済み (暗黙のドロップなし) |
Fn1CD3 ディスパッチ (47 ケース) | ✅ | ⚠️ 部分的 | ❓ 逆コンパイルから実装; いくつかのケースは近似; 既知の誤り: 0x23 はアリーナ/部屋戦闘のセットアップ (1CD3:1062 → fn0FDC_0629(8)) であり、新規ゲーム初期化ではない — リビルドの NewGameInit はアリーナの試合がそれを発火させると実行を破壊する; ED UnitCheckLoop は 4 バイトではなく 2 バイトを消費し、スキルチェック + ジャンプをスキップする |
| MTP マップヘッダ/タイル | ✅ MapLoader.cs / LocalMapView.cs | ✅ (構造) | ⚠️ レイアウトはデコード済み、フレーム単位の差分は未実施 |
| ANM アニメーション (XOR 差分 RLE) | ✅ ランタイム、PNG フォールバック | ⚠️ | ❓; リポジトリに ANM スプライトシートなし (Assets/Animations/ は空) |
| ICN/CMP タイル | ❌ (事前変換済み) | — | TileManager は BMP を読み込む; Assets/Tilesets/ は空 |
セーブファイル GAME1–6 (4096 B) | ✅ パーサー SaveManager.cs | ❓ | ❌ ラウンドトリップはオリジナルのセーブに対して未検証 |
ストーリー状態 (b0057、プロパティ) | ✅ (読み取り) | ❓ 意味は推測 | ❓ セマンティクスはプレイで未確認 |
| 戦闘 (命中、ダメージ、AI、熱、弾薬、霧) | — (独自ロジック) | ❌ 近似 | ❌ RNG/計算式はオリジナルに対して未差分検証 |
| ビューポート / 画面レイアウト | — | ⚠️ 近似 | ❓ 正規のビューポート構造体は未特定 |
| サウンド / 音楽 | ❌ | ❌ | ❌ フォーマット未デコード |
| マップ→BLD トリガーマッピング | ✅ デコード済み | ✅ ([0x5460]:0x4602 + 建物位置テーブル → MTP 名リスト; docs/formats/map-bld-triggers.md) | ⚠️ 入口はこれまで MAP1 でのみ手動検証済み |
.BLD スクリプトを読み込んで復号し、解釈する (ダイアログ、メニュー、ショップ、多くのディスパッチ
ケース) — 未実装のオペコードでは暗黙のギャップがある。.MTP マップを解析し、実際の 4096 バイトのセーブレイアウトを読み書きする。| 領域 | 状態 | 正規ドキュメント |
|---|---|---|
| BLD フォーマット、暗号、オペコード | 🟢 堅牢 | docs/formats/bld-bytecode.md |
| ストーリーテキスト (全 26 BLD) | 🟢 抽出済み | docs/story/STORY_TEXT.txt |
| メモリマップ (100 以上のアドレス、セグメント) | 🟢 堅牢 | docs/formats/memory-map.md |
| ワールドマップ / ローカルマップ | 🟢 堅牢 | docs/world-map.md |
| 戦闘モデル | 🟡 ~90%、一部推測 | docs/combat-system.md |
| 経済 / ショップ / 在庫 | 🟡 UI フローは現在ライブで観察済み | docs/story/story-system.md |
| ANM フォーマット | 🟢 文書化済み | docs/formats/anm-format.md |
| ビューポート抽象化 | 🔴 不完全 | docs/engine/viewport.md |
| サウンド | 🔴 0% | — |
これらが真のブロッカーであり、§6 のロードマップはこれらに依存している。
docs/combat-system.md)19EF / 1000 は reko/gencode/ に存在し(旧Spice86コード生成による23ファイル、コンパイル対象外)、さらに reko/gencode-current/ に新規再生成分がある。関数マップは docs/engine/segments-19ef-1000.md を参照。(docs/UNVERIFIED_DISCOVERIES.md §7)b0057(0/1/2)と隣接する b0055/b0056/b0058 はコードに固定済み(fn1631_11AB)。D30C 配列の意味論はほぼ解明済み(訓練/侵攻、裏切り者、制服、ガレージ、ビデオ店、小屋、アリーナのフラグ — docs/story/story-system.md §17.5/§17.11)。プロパティID 0x1C–0x23 は未マッピング。(§5)0x32C6)+変換テーブル([0x5460]:0x4602)は未デコードdocs/formats/map-bld-triggers.md)。入口はこれまでMAP1上で手動検証済み(Citadel (34,10)、ComStar (51,10))。(docs/context.md)0x246Cの設定構造体も
部分的にしかマッピングされていない。push/popの意味論は不明。(docs/engine/viewport.md)0x32C6を読むルーチンはどれかprop < シーンごとのゲート t0150。0x32C6の全リーダーを列挙済み(命中+1、0xFFゲート、経路探索スキャン)— 地形ごとの移動コストは存在しない(MPの減少は固定のステップコスト)。(§2)GAME*のロード→セーブ→比較は未実施。D323でゲート)、富裕度上限による停止、保有資産の成長 — メカニクスはデコード済み+2026-10-14に実機検証済み(docs/economy.md)。手数料/ティックの分離と財務ブロックのソーステーブルは未解決。(docs/story/story-system.md)tools/bld/opcode_coverage.py)、未出力は0xE7のみ。オペランドサイズを修正(EB/EC/F6/F7 およびED)。(BldInterpreter.csのデフォルト分岐)BTTLTECH←fn0800_4621、戦闘/ローカル MAP15←fn135D_055A via 1F3D:0814 — docs/formats/file-formats.md)。セグメント2A02かそれ以外かという表現は廃止。実行ファイル単体からのリバースエンジニアリングには限界がある(コンパイラ最適化されたコード、欠落セグメント、推測された 意味論)。ゲームに実際に何が入っているかを理解するため、我々は複数種類の情報源を照合する — いずれもバイナリを置き換えることはできないが、組み合わせることで意図を解明し欠落を埋める:
docs/walkthrough/bt-walkthrough-1..3.md(ナビゲーションと
イベントシーケンス)。bt_* MCPツールにより、実行時のレジスタ/メモリ状態を正確に取得し差分比較できる。優先順位: 挙動についてはバイナリ/エミュレータが優先され、文書は意図について権威を持つ。
文書や記憶から復元されたすべての主張は、再現に取り込まれる前に出典付きとしてマークされ、
バイナリに対して再検証される。完全なポリシー(ソースクラス、証拠タグ ✅/🟡/❓、
およびソース→検証のワークフロー)は docs/SOURCES.md にある。
順序は意図的である: より多くの画面を作る前に、データパスと挙動を証明する。 各ゲートは検証であり、機能ではない。
docs/rebuild/progress.md、および wiki を正直に保つ。すべての主張を
検証済み / 推測 / 不明としてマークし、日付を付ける。19EF/1000(戦闘/移動)を逆コンパイル/注釈付けする。reko/gencode/ + gencode-current/、マップは docs/engine/segments-19ef-1000.md)。docs/formats/map-bld-triggers.md)。docs/economy.md)。手数料/ティックの分離は未解決。w4FBC/push-pop を解決する。タイルプロパティのビットを完成させる。GAME* ファイルに対してセーブのラウンドトリップを検証する。