REPENTOGON 安装指南：脚本扩展器的部署与验证
【免费下载链接】REPENTOGONScript extender for The Binding of Isaac: Repentance项目地址: https://gitcode.com/gh_mirrors/re/REPENTOGON
REPENTOGON 是《以撒的结合：悔改+》的脚本扩展器（Script Extender），基于 LibZHL 框架直接挂钩游戏本体，为 Lua 模组扩展新 API 并提供性能优化与官方 bug 修复。完成本文的 REPENTOGON 安装后，你将获得一个可启动扩展功能的运行环境，并掌握控制台验证、存档导入与手柄配置三项基础操作。
REPENTOGON 项目速览：能力、平台与依赖
REPENTOGON 项目速览见下表，开始部署前先确认能力范围与硬性依赖。
| 项目 | 说明 |
|---|---|
| 项目名 | REPENTOGON（社区俗称“EXE 模组”） |
| 核心能力 | 挂钩游戏内部结构，扩展 Lua API，附带性能优化、bug 修复与存档双向导入 |
| 支持平台 | Windows 10/11；Linux（含 Steam Deck，需指定 Proton 版本） |
| 硬性依赖 | 游戏本体为官方最新 Steam 版或 v1.9.7.12.J273；REPENTOGONLauncher（启动器） |
REPENTOGON 部署前的环境预检清单
对照 REPENTOGON 部署前的环境预检清单逐项确认，全部勾选后再进入部署主流程。
- 已安装《以撒的结合：悔改+》，版本为官方最新 Steam 版或 v1.9.7.12.J273
- 操作系统为 Windows 10/11 或 Linux；Steam Deck 已切换到桌面模式
- 磁盘预留 200MB 以上可用空间
- 已获取 REPENTOGONLauncher 最新发行包
REPENTOGON 基于 v1.9.7.12.J273 开发：使用官方最新版安装时，经它运行的游戏会缺少个别最新补丁内容，属正常现象。官方刚发布新补丁而启动器报不兼容时，先更新启动器，仍失败则等待跟进补丁（通常一天内）。
REPENTOGON 部署主流程：下载、放置与启动
部署主流程按下载、放置、启动三阶段执行，Windows 与 Linux 的差异在各阶段内对比给出。
阶段一：下载启动器与项目仓库
- 运行以下命令克隆项目仓库，获取完整文档与安装资源：
git clone https://gitcode.com/gh_mirrors/re/REPENTOGON- 从项目发布渠道下载 REPENTOGONLauncher 最新发行包（Release）并解压备用。
阶段二：放置启动器到正确目录
| 平台 | 推荐放置位置 | 禁止项 |
|---|---|---|
| Windows | 磁盘根目录新建C:/REPENTOGONLauncher/，或游戏安装目录内新建REPENTOGONLauncher子文件夹并解压其中 | 桌面、文档等 OneDrive 同步目录；解压到游戏目录根部；预先创建名为repentogon的文件夹 |
| Linux / Steam Deck | Steam属性→已安装文件→浏览打开游戏目录，新建REPENTOGONLauncher文件夹并解压其中，最终路径须为.../steamapps/common/The Binding of Isaac Rebirth/REPENTOGONLauncher/REPENTOGONLauncher.exe | 多套一层文件夹、改错文件夹名 |
Linux 启动器目录
阶段三：首次启动并接管 Steam 启动选项
Windows 侧：
- 双击
REPENTOGONLauncher.exe，初始化窗口会自动检测游戏；未检测到时点击Select executable...，定位isaac-ng.exe后点击Next。
⚠️ 若提示游戏版本不兼容，确认游戏为官方最新 Steam 版或 v1.9.7.12.J273，并接受启动器的更新提示。
Linux / Steam Deck 侧：
- 在 Steam 的
常规选项卡中，将启动选项填入：
echo "%command%" | sed 's|isaac-ng.exe|REPENTOGONLauncher/REPENTOGONLauncher.exe|' | sh- 在
兼容性（Compatibility）区域开启兼容层并指定为Proton 9.0-4。 - 从 Steam 启动游戏；若初始化窗口未自动检测游戏，点击
Select executable...定位isaac-ng.exe后点击Next。
Linux 启动选项
Steam 启动选项接管（Remote Play 必需）：
- Windows：Steam 库中右键游戏 →
属性→常规，在启动选项填入（替换为实际路径，引号与参数不可省略）：
"C:\path\REPENTOGONLauncher\REPENTOGONLauncher.exe" --isaac=%command%Windows 启动选项
⚠️ 若启动器提示安装损坏、或游戏启动即崩溃，依次执行：
Choose exe重选游戏文件；Steam 校验游戏文件完整性并等待重新下载完成；Update/Repair Installation→Re-install/Repair REPENTOGON。仍失败时，删除游戏目录下的repentogon子文件夹后重启启动器。
若 Steam Remote Play（远程畅玩）失效，回查上一步：Windows 的
--isaac=%command%参数、Linux 的 sed 命令与 Proton 版本是否完全一致。
REPENTOGON 启动后配置与安装验证
REPENTOGON 启动后配置与安装验证按编号步骤完成，每步末尾给出通过标准。
- 验证控制台：在标题屏幕按
~打开 REPENTOGON 控制台（Console），输入help。 ✅ 看到命令列表即验证通过。 - 导入缺失的成就：控制台左上角依次进入
Tools→Game Options，切换到Save Management标签，点击Import from Repentance。 按钮灰色时，确认当前正处于标题屏幕。导入只补齐另一版本缺失的成就与解锁，不会删除现有进度。
存档导入界面
- 修正第三方手柄：Steam 中进入游戏
属性→控制器，将 Override 设置为Enable Steam Input。 修改后须完全关闭 Isaac 与 REPENTOGON 启动器才生效；仍异常时在游戏内按键映射菜单点击Reset To Default。
Steam Input 设置
REPENTOGON 与 Basement Renovator 联动测试房间
REPENTOGON 与 Basement Renovator 的联动配置仅面向需要自测自制房间的开发者，最短路径如下。
- 确认 Basement Renovator 版本不低于 3.3.1，且 REPENTOGON 已通过上文验证。
- 在 Basement Renovator 中进入
File→Set Paths，将.exe Path指向你的REPENTOGONLauncher.exe。 - 之后测试房间将以 REPENTOGON 启动游戏；安装异常时启动器会弹出提示而非静默失败。
房间测试路径配置
REPENTOGON 安装后的下一步行动清单
REPENTOGON 安装完成后，按以下清单执行收尾动作。
- 查阅完整 Lua API 与安装文档：docs/docs/ 目录，中文版安装说明见 install_zh.md。
- 模组开发参考核心源码 repentogon/LuaInterfaces/，底层挂钩框架位于
libzhl/。 - 涉及重大模组变动前，先备份游戏存档。
- 启动器每次启动都会检查更新，出现更新提示时接受即可。
- 排查问题时，用启动器主窗口的
Check Game Logs按钮导出日志。
【免费下载链接】REPENTOGONScript extender for The Binding of Isaac: Repentance项目地址: https://gitcode.com/gh_mirrors/re/REPENTOGON
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
