REPENTOGON 完整安装教程：给以撒的结合悔改+ 脚本扩展器的保姆级上手指南

REPENTOGON 完整安装教程：给以撒的结合悔改+ 脚本扩展器的保姆级上手指南

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

REPENTOGON 是《以撒的结合：悔改+》（The Binding of Isaac: Repentance）最强大的脚本扩展器（Script Extender），它以注入式改造直接扩展游戏本体，为模组开发者解锁官方 Lua API 之外的数百个新函数、类与性能优化，同时修复大量官方 bug。无论你只是想优化游戏体验的普通玩家，还是想做官方接口做不到的功能的模组作者，这份 REPENTOGON 安装教程都能让你零基础走完全程。

从三个痛点看懂它解决了什么

玩《以撒》的模组，你多半撞过这几堵墙：

• ❌想做的东西官方接口不允许。很多玩家心心念念的自定义机制，官方 Mod API 就是不给开权限。
• ❌模组多了就卡顿。加载慢、掉帧、内存吃紧，体验大打折扣。
• ❌游戏自身的 bug 只能干瞪眼。部分影响游玩的缺陷，普通模组根本碰不到。

REPENTOGON 直接改变了游戏的可扩展边界，它通过钩子（Hook）深入到游戏内部运行逻辑，把"不可能"变成"可编程"。一句话对比最直观：

它的底层沿用了知名模组Antibirth所用的 LibZHL 框架，因此不是小打小闹的补丁，而是一套完整、稳定的扩展体系，这也是社区里把它称为"EXE 级模组"的原因。

对照清单，确认你的运行环境

动手之前先自检，别装到一半才发现环境不达标：

• 游戏本体：《以撒的结合：悔改+》最新官方 Steam 版本或 v1.9.7.12.J273
• 操作系统：Windows 10/11，或 Linux（含 Steam Deck）
• 磁盘空间：预留至少 200MB 给启动器与注入文件
• 基础环境：游戏能正常启动、能进标题画面
• Steam 客户端：已安装并登录（后续配置启动选项要用）

注意：当前 REPENTOGON 基于 v1.9.7.12.J273 开发。虽然支持用最新官方版安装，但移植新版本需要时间，运行最新版游戏时可能缺少部分最新官方补丁，属正常现象。

先拿到启动器文件再继续

REPENTOGON 的一切安装都通过专属启动器（REPENTOGONLauncher）完成，它不是解压进游戏目录就能用的散装补丁。

方式一：直接克隆源码仓库

# 克隆 REPENTOGON 仓库（启动器与全部源码都在其中） git clone https://gitcode.com/gh_mirrors/re/REPENTOGON

方式二：获取预编译版本：从发布页面下载启动器压缩包，解压到你喜欢的目录。

警告：无论哪种方式，都不要把启动器文件直接解压进游戏安装目录！启动器会自己管理游戏目录里的注入文件，你只需记住它放在哪。

如果你之前装过 REPENTOGON 的忏悔（Repentance）版本，启动器可能已自动创建桌面快捷方式，也可以到游戏目录下的REPENTOGONLauncher子文件夹里找找现成的文件。

Windows 平台一步步完成首装

装好启动器后，Windows 用户按以下顺序操作：

1. 双击运行REPENTOGONLauncher.exe。
2. 等待自动检测：启动器会自动定位《以撒的结合：悔改+》的可执行文件位置。
3. 手动补位：如果自动检测失败，点击Select executable...，手动选中你的isaac-ng.exe。

装好后强烈建议顺手配置 Steam 启动选项，这样通过 Steam 启动游戏时，会自动带上 REPENTOGON：

1. 在 Steam 库右键《以撒的结合：重生》→属性→常规。
2. 在启动选项输入框中填入以下内容（把路径换成你启动器的实际位置）：

# 格式：启动器完整路径 + 参数 --isaac=%command% "D:\repentogon\REPENTOGONLauncher.exe" --isaac=%command%

小贴士：启动器提示游戏版本不兼容时，先确认游戏已更新到悔改+ 的 v1.9.7.12.J273 或最新官方版本，再重试。

在 Linux 与 Steam Deck 上定制启动方式

Linux 玩家（含 Steam Deck）的路径不一样，跟着做：

1. 退出到桌面模式：Steam Deck 用户先退出游戏模式，切到桌面模式。
2. 创建专用文件夹：在游戏目录内新建名为REPENTOGONLauncher的文件夹。
3. 放入文件：把启动器相关文件（含REPENTOGONLauncher.exe、steam_appid.txt等）解压进这个文件夹。

4. 改写启动命令：在 Steam 属性的启动选项里粘贴下面这行命令，它会用 sed 把游戏原启动命令重定向到 REPENTOGON 启动器：

# 将启动命令中的 isaac-ng.exe 替换为 REPENTOGONLauncher.exe 后执行 echo "%command%" | sed -e 's/isaac-ng.exe/REPENTOGONLauncher/REPENTOGONLauncher.exe/' | sh

配置完成后，从 Steam 正常点"开始游戏"即可，剩下的交给启动器。

验证安装：怎样判断自己真的装成了

别急着开玩，先用三招确认脚本扩展器已经生效：

1. 看启动器反馈：安装过程结束时，启动器会显示安装成功或给出错误提示，没有红色报错即为正常。
2. 进游戏开控制台：在标题画面按~（波浪键），能弹出 REPENTOGON 控制台就说明注入成功。
3. 找工具菜单：控制台打开后，观察左上角是否有Tools等扩展菜单项，有则代表新版功能已就位。

如果以上任何一步没出现，直接跳到后面的"常见问题速查"。

按需调整你的个性化选项

装好只是开始，下面三个配置能显著提升你的使用体验。

导入旧存档，补全成就解锁

换了新版本，成就和解锁没跟上？用存档导入功能一键补齐：

1. 标题画面按~打开控制台。
2. 左上角进入工具（Tools）→游戏选项（Game Options）。
3. 切到存档管理标签，选择"从忏悔导入"，即可把旧存档里缺失的成就和解锁全部同步进来。

注意：导入/导出过程永远不会删除现有成就或进度，只做"补缺"，可以放心操作。

让 Basement Renovator 用上你的启动器

房间编辑爱好者注意：Basement Renovator 需要手动指向 REPENTOGON 才能测试你的房间作品：

1. 确保 Basement Renovator 版本不低于 3.3.1。
2. 进入文件→设置路径（Set Paths）。
3. 把.exe 路径改为你的REPENTOGONLauncher.exe所在位置。

之后在编辑器里测试房间时，就会自动通过 REPENTOGON 启动游戏。

让第三方手柄更听话

用 8BitDo 等第三方手柄时，建议启用 Steam Input 覆盖以获得最稳定的输入表现：

1. Steam 中进入《以撒的结合：重生》属性 →控制器标签。
2. 将Override for The Binding of Isaac: Rebirth下拉框设为Enable Steam Input。

注意：改完必须彻底关闭 Isaac 和 REPENTOGON 启动器再重新启动，更改才会生效。

常见问题速查：报错现象、原因与对策

进阶玩法：从源码构建自己的 REPENTOGON

想深入研究的开发者，可以走源码构建路线。前置要求如下：

• Windows 系统（需与游戏使用相同编译器，推荐 Visual Studio 2019 或更高）
• CMake 3.13 或更高版本
• Git

构建步骤如下：

# 递归克隆（子模块 LibZHL 等依赖会一并拉取） git clone --recursive https://gitcode.com/gh_mirrors/re/REPENTOGON # 进入目录后，用 CMake 配置项目，平台必须设置为 Win32 cmake -B build -A Win32

配置完成后用 Visual Studio 打开生成的解决方案，选择 Win32 平台编译即可。构建产物里，核心模块的源码分布很有规律：

• repentogon/LuaInterfaces/：全部 Lua 接口实现，想给模组加新 API 就从这里看起
• libzhl/：底层挂钩与扩展框架，也就是Antibirth同款 LibZHL
• docs/docs/：完整的 API 文档与使用指南

资源与入口：需要时去哪找

• 官方文档：docs/docs/目录内含全部 API 文档与安装说明
• 核心源码：repentogon/LuaInterfaces/、repentogon/Patches/
• 底层框架：libzhl/
• 文档生成配置：docs/mkdocs.yml
• 版本与更新记录：changelog.txt

遇到具体问题时，先翻官方文档的 FAQ 与变化记录（docs/docs/changes/），大多能直接找到答案；也可以在模组社区向其他 REPENTOGON 用户求助。

关键要点回顾

• ✅ 通过启动器管理 REPENTOGON 安装，不要把文件直接解压进游戏目录
• ✅ Windows 与 Linux 都需要配置 Steam 启动选项，Linux 用sed命令重定向
• ✅ 装完用游戏内~控制台验证注入是否成功
• ✅ 用存档导入功能在版本间补齐成就解锁，安全不删档
• ✅ 房间编辑配合 Basement Renovator 3.3.1+，并指向启动器 exe
• ✅ 第三方手柄先启用 Steam Input 覆盖，改完完全重启游戏
• ✅ 源码构建记得--recursive克隆并把平台设为 Win32

现在，启动你的 REPENTOGON，去亲手创造那些官方永远做不出来的《以撒》玩法吧。🚀

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