REPENTOGON 安装实战指南：以撒脚本扩展器一次跑通

REPENTOGON 安装实战指南：以撒脚本扩展器一次跑通

【免费下载链接】REPENTOGONScript extender for The Binding of Isaac: Repentance项目地址: https://gitcode.com/gh_mirrors/re/REPENTOGON

REPENTOGON 是《以撒的结合：忏悔+》的 Lua 脚本扩展器，它直接挂钩游戏本体，在官方 API 之外提供数百个新接口、性能优化与存档保护。 读完本文，你将在 Windows 或 Linux/Steam Deck 上完成从获取启动器、首次初始化到存档导入、手柄配置的全部流程。

什么情况下该上它

适合这三类人：

• 你的模组功能已经卡在官方 Lua API 的边界上，只能靠又慢又脆的 hack 绕路；
• 多个模组同时加载卡顿，切房间掉帧，想让整个生态跑得稳；
• 你在忏悔与忏悔+之间来回切换，成就和解锁项在存档里"失踪"。

它不是"又一个模组"，而是生态的地基：基于与 Antibirth 同源的 LibZHL 框架，直接挂钩游戏内部，做到普通 Lua 模组做不到、或需要重写到性能爆炸才能做到的事。

装之前，先把这几项对上

一个版本常识：REPENTOGON 基于 v1.9.7.12.J273 开发，但启动器允许你基于 Steam 最新版安装。运行时游戏会缺少个别最新官方补丁的内容——这是设计如此，官方文档有明确说明，不用当作故障处理。

安装实战：一条主线，两个分叉

4.1 通用主线：三步完成初始化

第 1 步：获取。克隆仓库，里面自带完整文档与工具链：

git clone https://gitcode.com/gh_mirrors/re/REPENTOGON

第 2 步：放对位置。启动器要放在稳定、无同步的目录。两条禁忌记牢：不要直接解压进游戏安装目录根下（可能引发文件冲突）；不要在游戏目录里预先创建叫repentogon的文件夹（这个路径后面由启动器自己使用）。

第 3 步：首次初始化。运行REPENTOGONLauncher.exe，会弹出首次设定窗口，询问忏悔+可执行文件的位置。多数情况下自动检测；检测不到就点Select executable...，定位到isaac-ng.exe，点Next继续。启动器每次启动都会检查更新——看到更新提示就接受，保持最新能避开大部分兼容性问题。

4.2 Windows 分叉

Windows 与主线的差异只有两处：位置选点和接入 Steam。

• 位置：推荐两个稳妥落点——磁盘根目录新建C:/REPENTOGONLauncher/，或游戏安装目录内新建REPENTOGONLauncher子文件夹。桌面、文档这类 OneDrive 同步目录容易出权限问题，别放。
• Steam 启动选项（Steam 远程畅玩正常工作的前置条件）：Steam 库右键《以撒的结合：重生》→属性→常规，在启动选项填入：

(你的 REPENTOGONLauncher.exe 完整路径)--isaac=%command%

路径替换成真实值，引号保留，参数一个字符都不能少。

4.3 Linux / Steam Deck 分叉

这个平台的差异在于：启动器必须放进游戏目录，再用一条命令把启动流程交给它。

1. Steam Deck 用户先切换到桌面模式；
2. Steam 中进入《以撒的结合：重生》属性→已安装文件→浏览，打开安装目录；
3. 在游戏目录内新建REPENTOGONLauncher文件夹，把启动器解压进去（若文件夹里已有旧版升级带来的REPENTOGONLauncher.exe，此步可跳过）；
4. 核对最终路径必须是.../steamapps/common/The Binding of Isaac Rebirth/REPENTOGONLauncher/REPENTOGONLauncher.exe——不要多套一层文件夹，也不要改错名字；

5. 回到属性→常规，把启动选项替换为这一行：

echo "%command%" | sed 's|isaac-ng.exe|REPENTOGONLauncher/REPENTOGONLauncher.exe|' | sh

它的作用是把 Steam 原本要执行的isaac-ng.exe替换成 REPENTOGON 启动器。

6. 在兼容性区域开启兼容层，锁定为Proton 9.0-4。

⚠️ 启动后毫无反应时，按"路径 → 启动参数 → Proton 版本"的顺序逐项复查，三处必须全部吻合。

首次运行冒烟测试

进入标题界面后，依次做这三件事，每件都很快。

1. 验证安装：随便开一局，按~打开 REPENTOGON 控制台，输入help能看到命令列表即一切正常。控制台也是后续一切调试的入口。
2. 补回失踪的成就：忏悔+ 与忏悔使用不同存档文件，而官方只在首次启动忏悔+时自动导入一次——所以你过去的进度很可能还停着。在标题屏幕按~→ 左上角Tools→Game Options→ 切到Save Management标签 → 点Import from Repentance。按钮是灰色的话，说明你没在标题屏幕；该操作只补齐另一版本缺的内容，永远不会删除已有成就。

3. 规范手柄按键：8BitDo 等第三方手柄，到游戏属性→控制器，把 Override 设为Enable Steam Input。⚠️ 这个改动必须完全关闭 Isaac 和 REPENTOGON 启动器后重启才生效；仍异常时进游戏内按键映射菜单点Reset To Default。

两个长期习惯顺手带上：启动器的每次启动更新提示，直接接受；重大模组变动前，先备份存档。

进阶玩法：接入你的开发流

Basement Renovator 联动。房间编辑器需要3.3.1 及以上版本才能与 REPENTOGON 配合。确认 REPENTOGON 初始化正常后，打开 Basement Renovator 的File→Set Paths，把.exe Path改为你的REPENTOGONLauncher.exe。之后测试房间会自动经 REPENTOGON 启动游戏；安装若损坏，会弹启动器窗口而不是静默失败。

API 与源码在哪。Lua API 完整文档在 docs/docs/；Lua 接口实现位于 repentogon/LuaInterfaces/，底层挂钩框架在 libzhl/。启动器自带的模组管理器还会替换游戏原有的模组加载逻辑，加载时间有明显改善。

源码构建最小流程（必须 Windows，与游戏同编译器；CMake 3.13+、Git、Visual Studio 2019+）：

1. git clone --recursive https://gitcode.com/gh_mirrors/re/REPENTOGON
2. 打开 CMake，源码目录指向仓库根目录，产物目录任选；
3. 点Configure：编译器与你的 VS 版本一致，平台必须选 Win32，其余保持默认；
4. 点Generate生成.sln，用 Visual Studio 打开，按Release模式构建；
5. 把resources、resources-repentogon、dsound.dll、freetype.dll、libzhl.dll、Lua5.4.dll、zhlREPENTOGON.dll复制到游戏目录（或把ISAAC_DIRECTORY设为游戏根目录，构建后自动复制）。

出问题？先查这张表

收尾

下一个动作很明确：在标题屏幕按~，敲help，确认控制台响应正常。然后翻一翻 docs/docs/ 里的 API 文档，看看新增的几百个接口能做什么。配置途中摸出任何捷径，发到社区里，帮下一个人少走弯路。

【免费下载链接】REPENTOGONScript extender for The Binding of Isaac: Repentance项目地址: https://gitcode.com/gh_mirrors/re/REPENTOGON