
BattleTech: The Crescent Hawk's Inception — реверс-инжиниринг
Обратная разработка BattleTech: The Crescent Hawk's Inception (1988, MS-DOS; издатель — Infocom, движок — Westwood Associates) — и незавершённое воссоздание на Godot 4 / C#.
Прочитайте этот раздел, прежде чем доверять чему-либо ещё в этом репозитории. Проект состоит из двух начинаний с очень разной степенью зрелости, и слово «фаза» в остальной документации означает написанный код, а не доказанное поведение.
Этот проект производит два артефакта одновременно, и второй опирается на первый:
(1) Документированная обратная разработка. Декомпиляция в reko/, спецификации в docs/,
эмулятор Spice86 со специфичными для BattleTech инструментами MCP и инструментарий на Python. Это
настоящая работа по RE: форматы файлов, текст истории, карта памяти и значительная часть логики
движка задокументированы и перекрёстно проверены по выводу декомпилятора и трассировкам работающего
эмулятора. Это результат сам по себе, а также спецификация для (2).
(2) Воссоздание (BattleTechCHI/). Программа на Godot 4 C#, которая производится из (1): она
читает оригинальные файлы данных (.BLD, .MTP, .ANM, сохранения GAME*) и заново реализует
поведение движка согласно документации (1). Она верна данным, а не поведению и никогда не
проверялась сквозным образом против оригинала.
Они работают параллельно, но направление зависимости фиксировано:
(2) может быть настолько точным, насколько (1) полон и проверен. Там, где (1) говорит предположительно или открыто, (2) — это догадка.
Именно поэтому дорожная карта ставит закрытие пробелов в RE (Направление 1) и дифференциальную проверку (2) против эмулятора (Направление 3) впереди работы над функциями. Воссоздание хорошо настолько, насколько хороша обратная разработка, на которую оно опирается.
Если вы ищете побитово точный порт, его пока не существует. Если вы ищете среду RE с поддержкой инструментов плюс управляемую данными реконструкцию, работающую на оригинальных ресурсах, — это то, что здесь есть.
Условные обозначения: ✅ верно / сделано · ⚠️ частично, приблизительно или с неявными пробелами · ❓ неизвестно / не проверено · ❌ отсутствует
| Система | Читает исходные файлы во время выполнения | Поведение совпадает с оригиналом | Валидация |
|---|---|---|---|
| Расшифровка BLD + шифротекст | ✅ BldLoader.cs | ✅ (текст) | ✅ побайтово идентичный round-trip 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 потребляет 2 байта вместо 4 и пропускает проверку навыка + переход |
| Заголовок/тайлы карты MTP | ✅ MapLoader.cs / LocalMapView.cs | ✅ (структура) | ⚠️ раскладка декодирована, но не сверена покадрово |
| Анимация ANM (XOR-delta RLE) | ✅ во время выполнения, запасной вариант PNG | ⚠️ | ❓; в репозитории нет спрайт-листов ANM (Assets/Animations/ пуст) |
| Тайлы ICN/CMP | ❌ (предварительно сконвертированы) | — | TileManager загружает BMP; Assets/Tilesets/ пуст |
Файлы сохранений GAME1–6 (4096 Б) | ✅ парсер SaveManager.cs | ❓ | ❌ round-trip не проверен на оригинальных сохранениях |
Состояние сюжета (b0057, свойства) | ✅ (чтение) | ❓ значение выведено предположительно | ❓ семантика не подтверждена в игре |
| Бой (попадание, урон, ИИ, нагрев, боеприпасы, туман) | — (собственная логика) | ❌ приблизительно | ❌ ГСЧ/формулы никогда не сверялись с оригиналом |
| Вьюпорт / раскладка экрана | — | ⚠️ приблизительно | ❓ каноническая структура вьюпорта не найдена |
| Звук / музыка | ❌ | ❌ | ❌ формат не декодирован |
| Сопоставление триггеров карта→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 зависит от них.