yharnam-pc游戏文件Dump完全指南:ZIP/PKG安装向导、eboot.bin排错与DLC配置

原创2026-11-12 09:56:101,949 阅读

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 补丁,无需任何手动操作。

yharnam-pc启动器界面,管理游戏文件与设置

支持的 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 重新打开):

yharnam-pc游戏文件安装向导Welcome步骤,准备Dump安装

第 1 步:Welcome 点击 Start setup 开始;若已有游戏文件夹,可先 Skip for now 直接进启动器。

第 2 步:Game files(核心步骤) 点击 Install from ZIP / PKG,依次选择:

  1. Dump 文件:如 cusa-03173.zip
  2. 目标位置:如 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:

yharnam-pc启动器Game设置页,游戏文件与存档检查项

报错一: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 的配置步骤:

  1. Dump 附加内容:每个 DLC 是一个以 SPEXPANSIONDLC03 之类命名的文件夹,内部只有 sce_sys 目录
  2. 集中放置:把全部 DLC 文件夹放进同一个父文件夹,例如 C:\Games\Bloodborne\dlc
  3. 启动器配置:在 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。

登录后查看全文
yharnam-pc