Skip to content
KitploitKITPLOIT
도구익스플로잇블로그
Log in
제출
도구익스플로잇블로그
제출

해킹, 침투 테스트 및 사이버 보안 도구를 당신의 보안 무기고에!

Kitploit은 해킹, 사이버 보안 및 침투 테스트 도구 디렉토리입니다. 최신 프로젝트 업데이트를 발견하여 취약점을 찾고, 시스템을 분석하고, 테스트를 자동화하고, 보안을 강화하세요.

피드문의개인정보© 2026 Kitploit

도구 디렉토리

카테고리

모든 카테고리 보기
Loading categories
UnBattletech — BattleTech: The Crescent Hawk's Inception 리버스 엔지니어링 | Kitploit
도구/GitHubGitHub/velteyn/unbattletech
Static AnalysisReverse EngineeringDebuggersBinary AnalysisLearning & EducationFirmware Analysis
GitHubvelteyn/unbattletech

UnBattletech

BattleTech: The Crescent Hawk's Inception 리버스 엔지니어링

저장소 보기
813910일 전아직 검토되지 않음
공유

UnBattletech

BattleTech: The Crescent Hawk's Inception(1988, MS-DOS, Infocom 배급, Westwood Associates 엔진)의 리버스 엔지니어링과, 진행 중인 Godot 4 / C# 재구현 프로젝트입니다.

이 저장소의 다른 어떤 내용보다 먼저 이 섹션을 읽으십시오. 이 프로젝트는 성숙도가 매우 다른 두 가지 작업으로 구성되어 있으며, 문서 곳곳에 등장하는 "phase"라는 단어는 동작이 입증됨이 아니라 코드가 작성됨을 의미합니다.


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 격차 해소(Track 1)와 **(2)의 에뮬레이터 대비 차분 검증(Track 3)**을 앞에 두는 이유입니다. 재구현은 그것을 떠받치는 리버스 엔지니어링만큼만 좋을 수 있습니다.

비트 단위로 정확한 포팅을 찾고 계신다면, 아직 존재하지 않습니다. 도구 지원 RE 환경과 원본 에셋 위에서 실행되는 데이터 기반 재구성을 찾고 계신다면, 바로 그것이 여기 있습니다.


2. 정직한 상태 매트릭스

범례: ✅ 참 / 완료 · ⚠️ 부분적, 근사적, 또는 조용한 격차 존재 · ❓ 알 수 없음 / 미검증 · ❌ 없음

시스템런타임에 원본 파일을 읽는가동작이 원본과 일치하는가검증
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바이트 세이브 레이아웃을 읽고 쓴다.
  • 처음부터 만든 전술 전투 루프를 실행한다 (자체 RNG/LoS/명중/피해/AI).

정직하게 주장할 수 없는 것

  • 원본의 동작을 재현한다는 것. 전투, 뷰포트 렌더링, 그리고 스토리 상태 머신의 일부는 검증된 포팅이 아니라 재구성이다.
  • 시각적으로 자체 완결적이라는 것: 타일셋, 애니메이션, 폰트는 저장소에 없다 (변환된 맵 PNG 15개와 메크 스프라이트 PNG 44개만 있음).

3. 진정으로 RE된 것 (그리고 어디에 있는지)

영역상태정규 문서
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%—

4. 알려진 미지수 (아직 해야 할 RE)

이것들이 진짜 블로커이며, §6의 로드맵은 이들에 달려 있다.

  1. 바이트 단위 완전 일치 전투. RNG, 선제권/턴 순서, 명중 수정치, 명중 부위 표, 클러스터 해석, 열, 탄약 폭발, AI 목표 선택 — 현재는 디스어셈블리에서 영감을 받은 수준이며, 결코 diff된 적은 없음. (docs/combat-system.md)
  2. 디컴파일되지 않은 세그먼트. 복구됨. 전투/이동 세그먼트 19EF / 1000은 reko/gencode/에 존재하며(구 Spice86 코드젠에서 나온 23개 파일, 컴파일에서 제외됨), 추가로 reko/gencode-current/에 새로 재생성된 버전이 있음; 함수 맵은 docs/engine/segments-19ef-1000.md에 있음. (docs/UNVERIFIED_DISCOVERIES.md §7)
  3. 스토리 상태 의미론. b0057(0/1/2)과 인접 값 b0055/b0056/b0058은 코드에 고정되어 있음(fn1631_11AB); D30C 배열 의미론은 상당 부분 매핑됨(훈련/침공, 배신자, 제복, 차고, 비디오 가게, 오두막, 아레나 플래그 — docs/story/story-system.md §17.5/§17.11). 속성 ID 0x1C–0x23은 미매핑. (§5)
  4. 맵→BLD 트리거 매핑. 타일 속성 표(0x32C6) + 변환 표([0x5460]:0x4602) 미해독 해독됨(docs/formats/map-bld-triggers.md); 입구는 지금까지 MAP1에서 수동 검증됨(Citadel (34,10), ComStar (51,10)). (docs/context.md)
  5. 뷰포트 모델. 정식 뷰포트 구조체는 발견되지 않음; seg-0x246C 설정 구조체는 일부만 매핑됨; push/pop 의미론은 불명. (docs/engine/viewport.md)
  6. 타일 속성 / 충돌. 어떤 비트가 물/벽을 의미하는지; 이동을 위해 0x32C6를 읽는 루틴 종결됨(C9): 속성 바이트 하나, 통행 가능성 = prop < per-scene gate t0150; 모든 0x32C6 판독 지점 열거됨(명중 +1, 0xFF 게이트, 경로 탐색 스캔) — 지형별 이동 비용은 존재하지 않음(MP 감소는 고정 스텝 비용). (§2)
  7. 세이브 포맷 왕복. 파서는 존재함; 실제 GAME* 로드→저장→비교는 수행되지 않음.
  8. 생도 경제 & 일일 주기. 수당 틱(부 < 50일 때만 +15, D323 게이트), 부 상한 정지, 보유 자산 성장 — 메커니즘 해독 + 2026-10-14 실시간 검증됨(docs/economy.md); 수수료/틱 분리 + 재정 블록 소스 표는 여전히 미해결. (docs/story/story-system.md)
  9. BLD 오피코드 공백. 26개 파일 전체에서 실제로 어떤 오피코드가 등장하는지, 그리고 인터프리터가 어떤 것을 조용히 건너뛰는지 커버됨(B8): 27/28 슬롯 관측됨(tools/bld/opcode_coverage.py), 0xE7만 미방출; 피연산자 크기 수정됨(EB/EC/F6/F7 및 ED). (BldInterpreter.cs 기본 분기)
  10. 사운드/음악 포맷. 전혀 미해독.
  11. 월드맵 데이터 위치. 로더 매핑됨(E4: 타이틀 BTTLTECH←fn0800_4621, 전투/로컬 MAP15←fn135D_055A via 1F3D:0814 — docs/formats/file-formats.md); 세그먼트-2A02-대-다른 곳이라는 표현은 폐기됨.

5. 레트로 고고학 (바이너리 외부)

실행 파일만으로의 RE에는 한계가 있음(컴파일러 최적화 코드, 부재 세그먼트, 추론된 의미론). 게임 안에 실제로 무엇이 있는지 이해하기 위해 여러 종류의 소스를 교차 검증함 — 어느 것도 바이너리를 대체할 수는 없지만, 함께라면 의도를 밝히고 공백을 메움:

  • 원본 문서 — 매뉴얼, 단서/힌트 북, 그리고 1988–89년 잡지 리뷰 (디자인 의도, 용어, 의도된 UI). 아직 확보되지 않음 — 고고학 과제.
  • 개인 플레이테스트 — 저자 본인의 세션: 플레이어가 실제로 관찰하는 것, 그리고 에뮬레이터에서 검증할 가설을 생성하는 최고의 원천.
  • 공개된 공략집 — 이미 사용됨: docs/walkthrough/bt-walkthrough-1..3.md(내비게이션 및 이벤트 순서).
  • 자매 Westwood 엔진 타이틀 — Mines of Titan(1989, x86, 이미 지문 채취됨: 그래픽/텍스트에서 25개 공유 함수) 및 후기 뷰포트 엔진들(Eye of the Beholder, Kyrandia, Lands of Lore) — 뷰포트 모델용.
  • 다른 BattleTech CHI 포팅/릴리스 — C64 / Apple II / Amiga(있다면) 및 후기 "Gold" 에디션; 서로 다른 컴파일러는 서로 다른 구조를 드러냄.
  • 그라운드 트루스로서의 에뮬레이터 도구 — Spice86 트레이스 + 23개의 bt_* MCP 도구가 diff 대상으로 정확한 런타임 레지스터/메모리 상태를 제공함.

우선순위: 동작에 대해서는 바이너리/에뮬레이터가 우선하며, 문서는 의도에 대해 권위를 가진다. 문서나 기억에서 복원된 모든 주장은 재현물에 들어가기 전에 출처가 표시되고 바이너리에 대해 재검증된다. 전체 정책(출처 분류, 증거 태그 ✅/🟡/❓, 그리고 출처→검증 워크플로)은 docs/SOURCES.md에 있다.


6. 진정한 로드맵 (여기서부터 충실한 Godot 재현까지)

순서는 의도적이다: 더 많은 화면을 만들기 전에 데이터 경로와 동작을 증명하라. 각 게이트는 기능이 아니라 검증이다.

트랙 0 — 진실 유지 (지속적)

  • 이 README, docs/rebuild/progress.md, 위키를 정직하게 유지하라; 모든 주장을 검증됨 / 추론됨 / 알 수 없음으로 표시하고 날짜를 기입하라.
  • 검증 산출물(트레이스, diff, 또는 바이트 비교) 없이는 새로운 "✅"를 달지 말라.

트랙 1 — RE 미스터리 해소 (§4, 우선순위 순)

  1. 세그먼트 19EF/1000 디컴파일/주석 달기 (전투/이동). ✅ 복원됨 (reko/gencode/ + gencode-current/, 맵은 docs/engine/segments-19ef-1000.md).
  2. 전투 공식/RNG를 에뮬레이터 트레이스와 대조 (바이트 단위 일치 테이블). ← 트랙 3의 차단 해제
  3. 맵→BLD 트리거 테이블을 디코딩하여 입구가 수작업이 아닌 데이터 기반이 되도록. ✅ 디코딩됨 (docs/formats/map-bld-triggers.md).
  4. 생도 경제 / 일일 주기 코드 위치 파악. 🟡 디코딩 + 실시간 검증됨 (docs/economy.md); 수수료/틱 분리 미해결.
  5. 뷰포트 구조체 + w4FBC/push-pop 해석; 타일 속성 비트 완성.
  6. 실제 GAME* 파일에 대한 세이브 왕복 검증.

트랙 2 — 데이터 경로를 충실하게 만들기

  • TileManager는 런타임에 ICN/CMP를 디코딩해야 한다(사전 생성된 BMP 요구 없음); 타일셋/애니메이션/폰트를 커밋하거나 재생성하거나, 정확한 추출 단계를 문서화하라.
  • ANM: PNG 폴백 의존성을 제거하라; 런타임 디코더가 단일 진실 공급원이다.
  • 실제로 발생하는 모든 BLD opcode를 열거하고 구현하라; 알 수 없는 것은 크게 실패하라.

트랙 3 — 차분 검증 (빠진 키스톤)

  • 동일한 스크립트 입력을 (a) Spice86 에뮬레이터와 (b) Godot 재현물에 실행한 뒤 비교하는 하네스를 구축하라: 상태 배열, 스토리 슬롯, 크레딧, 커서, 유닛 슬롯, 전투 그리드, 렌더링된 프레임.
  • 첫 목표: 전체 훈련일(임무 → 수면), 상점 거래, 전투 조우 하나.
  • 시스템은 해당 시나리오에 대한 diff가 비어 있을 때만 "완료"로 간주된다.
도구 다운로드

인기

모두 보기 →

커뮤니티에서 가장 많이 사용되는 도구를 찾아보세요.

  • 1

    OsintHunter

    letox4/osinthunter

    🎯 궁극의 OSINT 툴킷: 조사 그래프, 신뢰도 점수 산정, 별칭 패밀리, 지도, 타임라인 및 보고서. 49개 모듈, 400개 이상 사이트, API 키 불필요.

    755
  • 2

    ghostlock-app

    yukonga/ghostlock-app

    # GhostLock 원탭 실행 앱 (CVE-2026-43499)

    510
  • 3

    ARTEX

    baarai/artex

    LLM 멀티 에이전트 자율 침투 테스트 플랫폼으로, 플래너/워커 에이전트, 자산 및 탐색 그래프, MITM 트래픽 기록, 취약점 재테스트 기능을 제공합니다.

    415
  • 4

    redforge

    cybersecurity91/redforge

    브라우저 측 레드 팀 툴킷으로, 정찰, 페이로드 생성, 자격 증명 공격, 암호화, 인코딩 및 참여 보고를 위한 102개의 오프라인 도구를 제공합니다.

    343
  • 5

    antifox

    antifox-ai/antifox

    정찰, 공격 표면 탐색, 익스플로잇 검증, 증거 기반 보고서 전달을 수행하는 AI 멀티 에이전트 자율 침투 테스트 플랫폼입니다.

    259
  • 6

    CyberStrikeAI

    ed1s0nz/cyberstrikeai

    AI 네이티브 사이버보안을 위한 행동 체계—의도가 통제된 실행이 되고, 증거가 운영 메모리가 되며, 모든 운영이 다음 운영을 개선하는 곳.

    258

모든 도구 탐색

도구 컬렉션을 둘러보세요

모든 도구 보기 →