深入反编译代码:Silent Hill PC移植版BODYPROG引擎与42个地图Overlay解析

原创2026-10-28 12:21:321,978 阅读

深入反编译代码:Silent Hill PC移植版BODYPROG引擎与42个地图Overlay解析

silent-hill-decomp 是一个将 PSX 版《Silent Hill》完整反编译(decompilation)并移植到 PC 的开源项目。本文将带你深入反编译源码,看懂承载全部游戏主逻辑的 BODYPROG 引擎,以及 42 个按关卡拆分、运行时动态加载的 地图 Overlay 是如何组织、构建和工作的,帮助新手建立从磁盘镜像到 PC 可执行文件的完整认知。

Silent Hill PC移植版启动器:基于反编译BODYPROG引擎构建的PC版游戏

一、项目全貌:反编译 + 原生 PC 移植 🎮

这个项目做了一件难度很高的事:把 1999 年 Konami 的《Silent Hill》从机器码逐函数还原成 C 语言源码,并且保证重新编译出的二进制与原机器码逐字节一致(matching decompilation)。

它的几个关键特点:

  • 不是模拟器,也不是静态重编译。PC 版是一个真正的 Windows/Linux 可执行程序,直接运行反编译后的 C 源码;
  • 硬件抽象层是 PsyCross(一个 PsyQ SDK 兼容层),让原 PSX 代码可以几乎原封不动地在 PC 上运行;
  • 增强功能全部可选:默认设置下,游戏的手感、逻辑、画面与 1999 年原作一致;宽屏、高清材质、PGXP、现代手电等均为可选项;
  • 授权清晰:pc_port/(移植层、启动器、工具)是 GPL-3.0;反编译部分(src/、include/、configs/、lib/)本身未授权,且项目不包含任何游戏资源,需要自备合法购买的 PSX 光盘镜像。详见 COPYRIGHT.md。

整体目录分工在 docs/Organization.md 中有专门说明,核心源码分布如下:

src/
├── maps/       ← 43 个地图 Overlay(MAP#_S##.BIN)
├── screens/    ← B_KONAMI / OPTION / SAVELOAD / STF_ROLL / STREAM 等界面 Overlay
├── bodyprog/   ← 主游戏逻辑 Overlay(BODYPROG.BIN)★ 本文主角
└── main/       ← 主可执行文件(SLUS_007.07)

二、Overlay 架构:PSX 时代的动态加载设计 📦

理解 BODYPROG 之前,先要理解《Silent Hill》的程序组织方式——Overlay(覆盖层)。

游戏光盘上的数据全部打包进两个容器文件:SILENT.(代码与游戏数据)和 HILL.(XA 音频与 FMV 视频)。其中真正含代码的 .BIN 文件分为三类:

文件 所在位置 职责
SLUS_007.07 主可执行 只做一件事:初始化并加载 B_KONAMI.BIN 与 BODYPROG.BIN,同时显示内容警告画面
B_KONAMI.BIN 1ST/ 文件夹 启动画面,加载通用资产(Harry 模型、动画、字体)并显示 KONAMI/KTCE 标志
BODYPROG.BIN 1ST/ 文件夹 主引擎:全部通用游戏逻辑(渲染、战斗、碰撞、事件、BGM……)
MAP#_S##.BIN VIN/ 文件夹 每个关卡一个,包含该地图的场景脚本与 AI 逻辑,按游玩顺序依次加载

PSX 内存有限,所以 Konami 采用"用到才加载"的策略:主引擎常驻内存,每个关卡的脚本代码(如 MAP0_S00.BIN——游戏开头到咖啡馆这一段)在进入关卡时才读入固定内存区域。#_S## 中的 S## 是 STAGE 的缩写,即关卡序号。这种设计正是后文 PC 移植版"42 个地图 DLL"方案的直接来源。

各 .BIN、.TIM、.IPD 等文件格式的详细解析可参考 docs/File Formats.md。

三、解剖 BODYPROG 主引擎 ⚙️

BODYPROG.BIN 是整个游戏的心脏,反编译后的源码全部位于 src/bodyprog/(约 90 个 C 文件 + 十余个子目录),对应的头文件在 include/bodyprog/。每个子目录对应一个子系统:

目录/文件 对应子系统
gfx/ + bodyprog_80055028.c 3D 渲染管线
bodyprog_8003E5E8.c 特效与手电筒(Flashlight)
view/(vc_main.c、vw_main.c) 经典固定视角相机系统
events/(events_main.c、collision_trigger.c、npc_main.c) 事件触发、碰撞区、NPC 调度
game_boot/(game_load.c、load_screen.c) 关卡加载流程
collision/ 碰撞检测系统
bodyprog_combat_*.c 战斗系统
bodyprog_bgm_80087EA8.c BGM 与 KDT1 MIDI 播放
dms.c / demo.c 过场动画(DMS 关键帧)与演示回放
chara_spawn.c / player_control.c 角色生成与玩家控制

项目还维护了一份非常实用的功能命名研究文档 research/decomp_function_names.md,把 func_XXXXXXXX 形式的反编译函数按"GFX 渲染、特效与手电、碰撞系统、事件脚本、战斗系统、BGM/音乐"等 15 大模块给出了规范命名建议——这是新手阅读 BODYPROG 源码的最佳地图。

每个 Overlay 的编译配置存放在 configs/<版本>/ 目录,例如 configs/USA/bodyprog.yaml 定义了 BODYPROG 的源文件路径、段布局(.rodata / .text / .data 顺序)、符号地址表(sym.bodyprog.txt)等,是逐字节还原编译结果的"配方"。

四、42 个地图 Overlay:从 43 个关卡到运行时 DLL 🗺️

《Silent Hill》全游戏共有 43 个地图 Overlay(MAP0_S00.BIN 到 MAP7_S03.BIN),在 configs/USA/maps/ 下每个都有一份独立的编译配置,例如 configs/USA/maps/map0_s00.yaml 中可以看到它的加载地址 vram: 0x800C9578(紧跟 BODYPROG 之后)以及按功能切分的段:player.c(玩家)、particle.c(粒子)、Chara_Stalker.c(徘徊者 AI)等。

每个地图的头文件定义了该关卡的"元数据",如 include/maps/map0/map0_s00.h 中的房间边界(MAP_ROOM_MIN_X 等)、参与角色的 HAS_Chara_Cheryl 标记、血渍数量上限等,跨地图共享的定义则放在 include/maps/shared/。

PC 移植版的关键改造:42 个运行时加载的地图 DLL

在 PC 移植版中,开发者把这种"按需加载"思想原样保留了下来:

  • map0_s00(开局路段)被完整静态编译进主程序,因为新游戏从这里开始;
  • 其余 42 个地图各自编译为一个独立的共享库(.dll / .so),运行时按需加载,完整复刻 PSX 的 overlay 加载行为;
  • 此外还有一个 chara_global DLL,承载跨地图共享的角色逻辑。

构建入口在 pc_port/maps/CMakeLists.txt——你可以看到 add_map_overlay(map1_s00 MAP0_S01) 等 42 条地图注册项 + 1 条 chara_global。每个 overlay 导出 g_MapOverlayHeader_<name> 符号,游戏通过全局指针 g_pMapOverlayHeader(见 pc_port/src/map_registry.c)访问当前关卡的函数与数据,对应原反编译符号 g_MapOverlayHdr(定义于 include/bodyprog/bodyprog.h)。

设计上的巧妙之处:即使某个地图尚未完整编译,注册表也会为它提供"桩头(stub header)"——保留正确的地图类型、BGM、天气等元数据(几何系统正常工作),仅事件/AI 函数指针为空。这样游戏在任何状态下都能跑通。

这个机制还直接服务于 Modding:地图可以分发为独立 DLL 供玩家替换,配合 pc_port/docs/Modding_And_Extraction_Guide.md 中的流程使用。

五、新手阅读路线图:如何上手这份反编译代码 🧭

推荐阅读顺序

  1. 先读结构:docs/Organization.md → docs/Game Information.md(SDK 版本、库清单、各版本发行历史);
  2. 再读引擎:src/bodyprog/ 按上表子系统逐个浏览,配合 research/decomp_function_names.md 对号入座;
  3. 挑一个地图精读:src/maps/map0_s00/ 是最简单的起点(玩家 + 粒子 + 2 个角色 AI),再逐步扩展到 map1~map7;
  4. 了解分析工具链:docs/Analysis Guide.md 详细演示了如何用 Ghidra / IDA Pro 加载主程序与全部 Overlay(含 BODYPROG 起始地址 0x80024B6 等关键参数),以及如何用 m2c 做逐函数匹配反编译。

符号与命名进度追踪

  • 每个 Overlay 的符号表都在 configs/ 下(如 configs/USA/sym.bodyprog.txt),记录已命名的函数/数据地址;
  • 运行 tools/naming_progress.py all 可生成各 Overlay 的命名进度报告,HTML 版已预生成在 docs/naming_reports/(BODYPROG 与各地图逐一定量展示命名完成度);
  • 仓库工具链还包括 tools/autodecompile.py(自动 decomp 管线)、tools/m2ctx.py(生成 m2c 上下文)等。

构建与运行(PC 移植版)

git clone https://gitcode.com/gh_mirrors/sil/silent-hill-decomp
git submodule update --init --recursive   # 拉取 PsyCross

准备好《Silent Hill》(USA, SLUS-00707) 光盘镜像放入 pc_port/build/gamedata/,然后:

cmake -S pc_port -B pc_port/build -G Ninja -DSH_BUILD_MAP_DLLS=ON
cmake --build pc_port/build

⚠️ 注意 -DSH_BUILD_MAP_DLLS=ON 这个开关:它决定那 42 个地图 Overlay 是否被编译成 DLL;不加该参数就只有开局区域可玩。Windows 上也可直接双击 pc_port\build.bat 一键构建。

Silent Hill PC移植版Launcher启动器界面:配置反编译构建选项

六、总结 🏁

概念 一句话理解
Overlay PSX 时代的"运行时模块",内存有限所以用到才加载
BODYPROG.BIN 常驻主引擎,承载渲染/战斗/事件/BGM 等全部通用逻辑
MAP#_S##.BIN 43 个关卡脚本,按游玩顺序逐个加载
PC 移植版方案 map0_s00 静态编入 + 42 个地图 DLL 运行时加载 + chara_global 共享角色 DLL

从 BODYPROG 引擎到 42 个地图 Overlay,silent-hill-decomp 展示了反编译工程化的完整面貌:configs/ 里的 YAML 是编译配方,configs/ 下的 sym 文件是命名进度,src/ 是可读成果,pc_port/ 则证明这份源码不仅"还原了",而且能在现代硬件上跑起来。如果你想为项目贡献代码——无论是补全某个地图函数命名,还是研究尚未解析的 .IPD 格式——本文列出的目录与文档就是起点。

快速索引:引擎源码 src/bodyprog/ · 地图源码 src/maps/ · 编译配置 configs/USA/ · 地图 DLL 构建 pc_port/maps/CMakeLists.txt · 目录说明 docs/Organization.md

登录后查看全文
silent-hill-decomp