
BattleTech: The Crescent Hawk's Inception 리버스 엔지니어링
BattleTech: The Crescent Hawk's Inception(1988, MS-DOS, Infocom 배급, Westwood Associates 엔진)의 리버스 엔지니어링과, 진행 중인 Godot 4 / C# 재구현 프로젝트입니다.
이 저장소의 다른 어떤 내용보다 먼저 이 섹션을 읽으십시오. 이 프로젝트는 성숙도가 매우 다른 두 가지 작업으로 구성되어 있으며, 문서 곳곳에 등장하는 "phase"라는 단어는 동작이 입증됨이 아니라 코드가 작성됨을 의미합니다.
이 프로젝트는 동시에 두 개의 산출물을 만들어 내며, 두 번째 산출물은 첫 번째 산출물 위에 올라타 있습니다:
(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 격차 해소(Track 1)와 **(2)의 에뮬레이터 대비 차분 검증(Track 3)**을 앞에 두는 이유입니다. 재구현은 그것을 떠받치는 리버스 엔지니어링만큼만 좋을 수 있습니다.
비트 단위로 정확한 포팅을 찾고 계신다면, 아직 존재하지 않습니다. 도구 지원 RE 환경과 원본 에셋 위에서 실행되는 데이터 기반 재구성을 찾고 계신다면, 바로 그것이 여기 있습니다.
범례: ✅ 참 / 완료 · ⚠️ 부분적, 근사적, 또는 조용한 격차 존재 · ❓ 알 수 없음 / 미검증 · ❌ 없음
| 시스템 | 런타임에 원본 파일을 읽는가 | 동작이 원본과 일치하는가 | 검증 |
|---|---|---|---|
| BLD 복호화 + 암호문 | ✅ BldLoader.cs | ✅ (텍스트) | ✅ 왕복 BLD↔JSON 바이트 단위 동일 (tools/bld) |
| BLD opcode 인터프리터 (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-delta RLE) | ✅ 런타임, PNG 폴백 | ⚠️ | ❓; 저장소에 ANM 스프라이트시트 없음 (Assets/Animations/ 비어 있음) |
| ICN/CMP 타일 | ❌ (사전 변환됨) | — | TileManager가 BMP를 로드; Assets/Tilesets/ 비어 있음 |
세이브 파일 GAME1–6 (4096 B) | ✅ 파서 SaveManager.cs | ❓ | ❌ 원본 세이브와의 왕복 미검증 |
스토리 상태 (b0057, props) | ✅ (읽기) | ❓ 의미 추론됨 | ❓ 플레이 중 의미 미확인 |
| 전투 (명중, 피해, AI, 열, 탄약, 안개) | — (자체 로직) | ❌ 근사치 | ❌ RNG/공식이 원본과 비교된 적 없음 |
| 뷰포트 / 화면 레이아웃 | — | ⚠️ 근사치 | ❓ 정규 뷰포트 구조체를 찾지 못함 |
| 사운드 / 음악 | ❌ | ❌ | ❌ 포맷 미해독 |
| 맵→BLD 트리거 매핑 | ✅ 해독됨 | ✅ ([0x5460]:0x4602 + 건물 위치 테이블 → MTP 이름 목록; docs/formats/map-bld-triggers.md) | ⚠️ 입구는 지금까지 MAP1에서만 수동 검증됨 |
.BLD 스크립트를 로드하고 복호화하여 해석한다 (대화, 메뉴, 상점, 다수의 디스패치
케이스) — 미구현 opcode에서는 조용한 공백이 있음..MTP 맵을 파싱하고, 실제 4096바이트 세이브 레이아웃을 읽고 쓴다.| 영역 | 상태 | 정규 문서 |
|---|---|---|
| BLD 포맷, 암호, opcode | 🟢 견고함 | 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 < per-scene gate 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-대-다른 곳이라는 표현은 폐기됨.실행 파일만으로의 RE에는 한계가 있음(컴파일러 최적화 코드, 부재 세그먼트, 추론된 의미론). 게임 안에 실제로 무엇이 있는지 이해하기 위해 여러 종류의 소스를 교차 검증함 — 어느 것도 바이너리를 대체할 수는 없지만, 함께라면 의도를 밝히고 공백을 메움:
docs/walkthrough/bt-walkthrough-1..3.md(내비게이션 및
이벤트 순서).bt_* MCP 도구가 diff 대상으로
정확한 런타임 레지스터/메모리 상태를 제공함.우선순위: 동작에 대해서는 바이너리/에뮬레이터가 우선하며, 문서는 의도에 대해 권위를 가진다.
문서나 기억에서 복원된 모든 주장은 재현물에 들어가기 전에 출처가 표시되고 바이너리에 대해 재검증된다.
전체 정책(출처 분류, 증거 태그 ✅/🟡/❓, 그리고 출처→검증 워크플로)은 docs/SOURCES.md에 있다.
순서는 의도적이다: 더 많은 화면을 만들기 전에 데이터 경로와 동작을 증명하라. 각 게이트는 기능이 아니라 검증이다.
docs/rebuild/progress.md, 위키를 정직하게 유지하라; 모든 주장을
검증됨 / 추론됨 / 알 수 없음으로 표시하고 날짜를 기입하라.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* 파일에 대한 세이브 왕복 검증.