yharnam-pc游戏文件Dump完全指南:ZIP/PKG安装向导、eboot.bin排错与DLC配置
yharnam-pc游戏文件Dump完全指南:ZIP/PKG安装向导、eboot.bin排错与DLC配置
本文是 yharnam-pc 的游戏文件 Dump 完全指南。yharnam-pc 让《Bloodborne》原生运行在 Windows 10/11 上,但项目不包含任何游戏文件,你需要准备自己的游戏 Dump,然后通过内置的 ZIP/PKG 安装向导一键安装。指南将带你完成 Dump 文件准备、安装向导操作、eboot.bin 常见报错排查与 DLC 配置,全程约 10 分钟。
什么是游戏文件Dump?yharnam-pc为什么需要它
Dump 就是从你自有的 PS4 游戏数据中提取出解密后的游戏文件。yharnam-pc 的启动器内置了安装向导,可以直接吃下你的 Dump 压缩包(ZIP)或 PKG 文件,自动解压、校验并打上 1.09 补丁,无需任何手动操作。
支持的 Dump 格式:
| 格式 | 说明 |
|---|---|
cusa-03173.zip |
推荐,ZIP 内包含基础 PKG 和 1.09 更新 PKG,向导会自动解包 |
CUSA03173.pkg |
单个基础 PKG,需同时提供 1.09 更新 PKG |
已解压的 CUSA03173 文件夹 |
直接指定文件夹,要求内部直接包含 eboot.bin |
准备工作:目录规划与空间要求
将发布包 bbport-windows.zip 完整解压到一个永久路径(例如 C:\Games\Bloodborne\bbport-windows),不要从 zip 里直接运行游戏。推荐目录结构如下:
C:\Games\Bloodborne\
├── bbport-windows\
│ ├── Bloodborne.exe
│ └── bin\bb-probe.exe
└── CUSA03173\ ← 游戏文件夹
├── eboot.bin
├── dvdroot_ps4\
├── sce_module\
└── sce_sys\
💡 空间提示:安装向导会在目标磁盘上暂存 PKG 与解压数据,一个 30 GB 的 ZIP 大约需要 70 GB 可用空间。空间不足时向导会直接报错并给出所需数值,见 launcher/bbport_pkg_setup.py 中的磁盘检查逻辑。
ZIP/PKG安装向导:三步完成游戏安装
首次启动 Bloodborne.exe 会打开设置向导(之后可随时从 Game → Setup wizard 重新打开):
第 1 步:Welcome 点击 Start setup 开始;若已有游戏文件夹,可先 Skip for now 直接进启动器。
第 2 步:Game files(核心步骤) 点击 Install from ZIP / PKG,依次选择:
- Dump 文件:如
cusa-03173.zip - 目标位置:如
C:\Games\Bloodborne,游戏将解压为CUSA03173子文件夹
向导内部会执行严格的校验流程(源码见 launcher/bbport_pkg_setup.py):
- ZIP 中必须同时包含
CUSA03173.pkg和原版 1.09 更新 PKG - ⚠️ 不要选 720p / 1080p 60fps 变体更新,向导会主动拦截并提示改选原版 1.09 更新
- 基础与更新 PKG 选反时,向导会自动互换重试
- 全部校验通过后才落盘,绝不会覆盖已有安装
第 3 步:Your data
可选导入 keys.json(奖杯名称用)或指定已有存档文件夹。检查项变为绿色表示游戏文件夹已是 1.09 版本;新安装无存档时显示黄色属正常现象。
最后点击 Play now,首次启动会预编译着色器(窗口标题显示 Preparing shaders: N%),耗时稍长属正常,之后启动很快。
eboot.bin排错:三种常见报错与解决方案
若你选择 Choose existing game folder 手动指定文件夹,或安装后检查不通过,大概率是以下三种情况之一。检查逻辑见 launcher/bbport_readiness.py:
报错一:No eboot.bin
✗ No eboot.bin in the game folder (Game & effects)
原因:选错文件夹了。eboot.bin 必须直接位于你选中的文件夹内(即 CUSA03173 文件夹本身),而不是它的父目录或子目录。
解决:重新 Browse,定位到包含 eboot.bin 的那一层。
报错二:版本 1.00(或低于 1.09)
原因:1.09 更新没有打上。社区补丁与解锁帧率等功能都基于 01.09 版本构建(见 scripts/patches.py)。
解决:补装原版 CUSA03173 Update v1.09.pkg,再重新走一遍安装向导。
报错三:游戏卡在加载(无报错弹窗)
原因:解压工具损坏了压缩文件。部分版本的 LibOrbisPkg PkgTool(.NET 6 及以上)解压时会残留过期的压缩扇区,导致游戏加载着色器时静默挂起。
解决:
- 换用其他解压工具重新解压游戏和 1.09 更新
- 用仓库自带的检查脚本逐文件验证(会扫描全部
.dcx着色器文件):
scripts/game_check.py GAME_DIR
- 确认无误前想强制启动,可设环境变量
BB_SKIP_GAME_CHECK=1(原理见 scripts/game_check.py)
DLC配置:让The Old Hunters在PC上运行
DLC(The Old Hunters)的配置分两种情况:
| 你的Dump来源 | 是否需要DLC配置 |
|---|---|
| Game of the Year 版(CUSA03173) | ❌ 已包含 The Old Hunters,开箱即玩 |
| 基础版 Dump | ✅ 需要单独 Dump 并配置 DLC 文件夹 |
基础版 Dump 的配置步骤:
- Dump 附加内容:每个 DLC 是一个以
SPEXPANSIONDLC03之类命名的文件夹,内部只有sce_sys目录 - 集中放置:把全部 DLC 文件夹放进同一个父文件夹,例如
C:\Games\Bloodborne\dlc - 启动器配置:在 Game 页面选择该父文件夹为 DLC folder
启动器会将其注入环境变量 BB_DLC_DIR(见 launcher/bbport_launcher_win.py),游戏运行时的内容模块会把其中的 DLC 报告为"已安装"(见 src/runtime_content.c),The Old Hunters 即可在基础版游戏内正常进入。
常见问题速查
| 现象 | 可能原因 | 处理方法 |
|---|---|---|
| Game files 检查红色 ✗ | 文件夹不含 eboot.bin |
重新选择 CUSA03173 文件夹 |
| 提示 Version 1.00 | 1.09 更新未应用 | 补装原版 1.09 更新 PKG |
| 启动时长时间无响应 | 着色器首次预编译 | 等待 Preparing shaders 完成 |
| 加载时静默卡死 | 解压工具损坏文件 | 换工具重解,或用 game_check.py 验证 |
| 奖杯只显示编号 | 缺少 keys.json |
从自己的 PS4 导出奖杯密钥 |
| 目标文件夹已存在 | 向导拒绝覆盖旧安装 | 换一个目标位置 |
📌 小贴士:升级新版本时不要只复制 Bloodborne.exe 到旧目录,应解压到新文件夹,再把 Game folder 与 Saves folder 指向旧数据即可(迁移步骤详见 README.md 的 Already have another launcher 一节)。
总结
- 准备
cusa-03173.zip或基础/更新两个 PKG,预留约 70 GB 空间 - 用安装向导自动完成安装,务必选原版 1.09 更新,避开 60fps 变体
eboot.bin必须在所选文件夹内;版本报错就补 1.09 更新- DLC 放在统一父文件夹后,在 Game 页选择 DLC folder 即可
完成以上步骤后,你就能在 PC 上以解锁帧率、DLSS/FSR 加持的画质重返亚楠了。更多功能与已知问题可参阅 docs/CHANGELOG.md 与 docs/ROADMAP.md。


