企业官网建设流程全解析

REPENTOGON 脚本扩展器：30 分钟装好《以撒的结合：悔改+》并跑通 Lua 控制台

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

REPENTOGON 是《以撒的结合：悔改+》的脚本扩展器，直接挂钩游戏本体，为 Lua 模组补上大量官方缺失的 API。照下面步骤操作，你能在 Windows 或 Steam Deck 完成安装，并在游戏里按~键打开控制台、输入help看到完整命令列表。

REPENTOGON 脚本扩展器与普通 Lua 模组的区别

• 直接挂钩游戏本体，不受表层 Lua API 限制
• 为 Lua 模组提供数百个新增与增强的接口
• 基于 Antibirth 同源的 LibZHL 挂钩框架
• 附带官方 bug 修复与加载性能优化
• 独立启动器安装，规避 DLL 注入的环境兼容问题

因为直接控制游戏内部结构，传统 hack 做不到的功能——改写存档管理、接管模组加载逻辑——都能实现，这也是社区把它当模组生态"地基"的原因。

安装 REPENTOGON 前的环境确认清单

版本注意：游戏为什么会少几个新补丁的内容

REPENTOGON 基于 v1.9.7.12.J273 开发，启动器允许你在最新官方 Steam 版上安装，但运行时游戏会缺少个别最新官方补丁的内容。官方文档明确说明这是正常现象，不必担心。还有一条要提前知道：官方新补丁刚发布时，REPENTOGON 的跟进通常要一天左右，期间启动器可能提示不兼容——先更新启动器，不行就再等等。

Windows 的特殊要求

• 启动器不要放在受保护目录或 OneDrive 同步目录（桌面、文档），容易出权限问题
• 推荐位置：磁盘根目录新建C:/REPENTOGONLauncher/，或游戏安装目录下的REPENTOGONLauncher子文件夹，前者更省心，因为不依赖游戏目录结构
• 不要直接解压进游戏安装根目录，也不要提前创建repentogon文件夹——这个名字留给启动器后续使用

Linux 与 Steam Deck 的特殊要求

• 必须走 Proton 兼容层，且版本锁定为 Proton 9.0-4，其他版本通常无法正常运行
• 启动器完整路径必须是.../steamapps/common/The Binding of Isaac Rebirth/REPENTOGONLauncher/REPENTOGONLauncher.exe，不要多套一层文件夹，也不要改名

如何安装 REPENTOGON 脚本扩展器：Windows 与 Steam Deck 最短路径

Windows 安装步骤

1. 解压启动器到安全位置— 从项目发布渠道下载最新 REPENTOGON Launcher 并解压。装过旧版 REPENTOGON 的用户可能已通过自动升级获得启动器，它在游戏安装目录的REPENTOGONLauncher子文件夹里，直接跳过下载。
2. 首次运行启动器，定位游戏本体— 双击REPENTOGONLauncher.exe，弹出首次设置窗口，询问悔改+ 可执行文件的位置；多数情况能自动检测，失败就点Select executable...选中isaac-ng.exe，再点Next。看到安装完成提示，这一步就成了；提示版本不兼容，回到"版本注意"小节或跳到排错速查表。
3. 启动游戏并验证控制台— 从启动器启动游戏，进任意一局按~打开 REPENTOGON 控制台，输入help。看到命令列表输出，说明脚本扩展器已正常工作。

Linux 与 Steam Deck 安装步骤

1. 切换到桌面模式— Steam Deck 用户先切桌面模式，桌面版 Linux 跳过这一步。
2. 把启动器放进游戏目录— Steam 里打开《以撒的结合：重生》的属性→已安装文件→浏览，在游戏目录内新建REPENTOGONLauncher文件夹，把启动器解压进去。

这张图展示正确的目录层级：REPENTOGONLauncher文件夹直接位于游戏安装目录下，.exe就在文件夹里，没有多余的嵌套。

3. 改写 Steam 启动参数— 回到属性→常规，在启动选项里粘贴：

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

这条命令把 Steam 原本要执行的isaac-ng.exe替换成 REPENTOGON 启动器，参数必须逐字一致，不能手敲。

图中是填好启动选项后的样式，同一窗口的兼容性区域还要做下一步的 Proton 锁定。

4. 锁定 Proton 版本— 在兼容性区域开启兼容层，指定Proton 9.0-4。之后从 Steam 启动游戏：弹出启动器窗口说明成功了，毫无反应就跳到排错速查表。

五个高频场景的配置方法：启动接管、存档迁移与工具链

让 Steam 直接拉起 REPENTOGON 启动器（Remote Play 必需）

想让 Steam 启动游戏时自动带上 REPENTOGON，就必须把启动动作交给启动器——这也是 Steam 远程畅玩能正常工作的硬性前提。Linux 用户在上一步已完成，Windows 用户按下面操作：

1. Steam 库中右键《以撒的结合：重生》→属性→常规
2. 启动选项填入：

"C:\完整\路径\REPENTOGONLauncher.exe" --isaac=%command%

路径必须替换成你的实际完整路径，引号和--isaac=%command%一个都不能少。

这是配置完成后的参考样式：引号内是完整路径，参数紧跟其后。

• 验证：从 Steam 启动游戏，先弹启动器窗口再进游戏，说明接管成功。

从旧版忏悔导入缺失的成就与解锁

悔改+ 与旧版忏悔使用不同的存档文件，而且悔改+ 只在你第一次启动时导入一次旧存档——如果之前启动过悔改+ 又回过旧版，成就和解锁就会"停在原地"。REPENTOGON 的导入可以单向补齐，步骤：

1. 在标题屏幕按~打开控制台（按钮灰色基本都是没在标题屏幕）
2. 左上角Tools→Game Options
3. 切到Save Management标签
4. 点Import from Repentance，补齐所有缺失成就与解锁

这就是存档管理窗口，导入/导出永远不会删除已有进度，只补齐另一版本缺失的内容，放心操作。

第三方手柄按键错乱的修复步骤

8BitDo 等第三方手柄按键乱，通常是 Steam Input 没接管，修复只需两处设置：

1. Steam 中进入以撒的属性→控制器
2. 把Override for The Binding of Isaac: Rebirth设为Enable Steam Input

图中选项设为Enable Steam Input即可。注意：改完必须完全关闭以撒和 REPENTOGON 启动器才生效；仍不行就在游戏内按键映射菜单点Reset To Default。

Basement Renovator 联动测试自制房间

房间编辑工具 Basement Renovator 需要 3.3.1 及以上版本才能配合 REPENTOGON，配置只改一个路径：

1. 确认 REPENTOGON 已按上文装好并能正常运行
2. Basement Renovator 中打开File→Set Paths
3. 把.exe Path改为指向你的REPENTOGONLauncher.exe

窗口中.exe Path已指向启动器，之后测试房间会自动以 REPENTOGON 启动游戏；安装有问题时启动器会弹窗提示，不会静默失败。

开发者场景：从源码构建 zhlREPENTOGON.dll

核心 Lua 接口在 repentogon/LuaInterfaces/，底层挂钩框架在 libzhl/。构建有硬性前提：必须 Windows（要与游戏用同一套编译器）、CMake 3.13+、Git、Visual Studio 2019+。

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

1. CMake 配置：编译器版本与 VS 匹配，平台必须选 Win32，其余保持默认，点 Finish 后 Generate
2. 在 Visual Studio 中打开生成的解决方案，推荐 Release 模式编译
3. 把resources、resources-repentogon、dsound.dll、freetype.dll、libzhl.dll、Lua5.4.dll、zhlREPENTOGON.dll复制到游戏目录

完整 API 说明可在 docs/docs/ 查阅。

排错速查表：安装与启动问题的最快定位

如果表内步骤都没解决，先别删重装，大概率是路径或版本问题，按这个顺序复查：启动器是否最新、Choose exe选中的是不是正确的isaac-ng.exe、Steam 文件完整性校验是否通过（校验触发的重新下载要等它完成）。仍无解时：

• ⚠️最后手段：删除游戏目录下的repentogon子文件夹后重新运行启动器。该文件夹由 REPENTOGON 生成，确认上面三步都试过再做，删除后会触发重新安装。
• 提问题前先点启动器主窗口的Check Game Logs定位日志，向社区报告时附上日志，排查速度会快很多。

长期使用 REPENTOGON 的四个稳定习惯

• 接受启动器更新提示— 启动器每次启动都会检查更新，官方新补丁的跟进通常一天内完成，更新提示出现时直接接受，能避开大部分兼容性问题。
• Check Game Logs是排错第一入口— 启动器内置日志查看器，比手动翻文件快得多，任何异常行为先点它看日志，而不是凭感觉猜。
• 大改模组前备份存档— 悔改+ 与忏悔的存档互相读取可能直接清空数据（官方 FAQ 明确警告过），涉及重大模组变动前先备份，有备无患。
• 装模组先确认兼容性— 直接修改游戏核心的模组可能与挂钩层冲突；做功能时优先用 REPENTOGON 提供的新 API，比传统 hack 写法更高效也更稳。

现在就绪：验证你的 REPENTOGON 已完全跑通

到这里，安装、启动接管、存档迁移和工具链都已配好：你拥有一个 API 完整的 Lua 环境，控制台是后续所有调试与进阶操作的总入口。现在随便进一局游戏，按~打开控制台输入help，看到命令列表输出就全部就绪。遇到怪问题，启动器的Check Game Logs是第一步，项目的 issue 区和 The Modding of Isaac Discord 的 #repentogon 频道是两条求助通道。

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