如何安装REPENTOGON：以撒忏悔+ Lua MOD框架完整指南（Windows/Steam Deck全覆盖）

如何安装REPENTOGON：以撒忏悔+ Lua MOD框架完整指南（Windows/Steam Deck全覆盖）

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

REPENTOGON 是一款专为《以撒的结合：忏悔+》(The Binding of Isaac: Repentance+) 打造的脚本扩展器 / Lua MOD 框架（社区称之为 "EXE mod"）。它基于 LibZHL 框架直接挂钩（hook）游戏本体，为 Lua API 增加了大量 BUG 修复、新功能和性能优化，是制作以撒 MOD 的基石。本文是一份面向新手的 REPENTOGON 安装教程，覆盖 Windows 一键安装与 Steam Deck / Linux 完整步骤，帮你快速把 REPENTOGON 装好并跑起来 🎮

安装REPENTOGON前的环境检查清单

在开始之前，请确认你满足以下最低要求：

💡 如果你打过中文补丁，请先在 Steam 中"验证游戏文件完整性"还原原版，否则启动器会判定不兼容。

官方详细文档（含中文）：docs/docs/install.md 与 docs/docs/install_zh.md

Windows 安装REPENTOGON：三步完成

第 1 步：放置启动器（位置很关键）

1. 从官方发布渠道下载REPENTOGON Launcher压缩包并解压到你选择的位置
2. 推荐位置：C:/REPENTOGONLauncher/或以撒安装目录下的子文件夹REPENTOGONLauncher/
3. ⚠️三个"不要"：
   • 不要放在 OneDrive 等云同步/受保护目录（桌面、文档等），容易出权限问题
   • 不要直接把启动器解压到以撒安装根目录（文件冲突）
   • 不要在游戏目录里创建只叫repentogon的文件夹（该目录预留给启动器写入 MOD 文件）

如果你用过旧版 Repentance 时代的 REPENTOGON，它可能已自动下载启动器并创建了桌面快捷方式，可以直接跳到第 2 步。

第 2 步：首次设置（自动定位游戏）

运行REPENTOGONLauncher.exe：

• 首次启动会弹出设置窗口，询问以撒的结合：忏悔+可执行文件（isaac-ng.exe）的位置
• 通常会自动检测；没检测到的话点击Select executable...手动选择，然后Next继续
• 启动器会自动完成 REPENTOGON 安装（包括把游戏降级到兼容版本），全程无需手动拷 DLL

第 3 步（强烈推荐）：配置 Steam 启动选项

这样从 Steam 点"开始游戏"就会自动走 REPENTOGON 启动器——Steam 远程畅玩必须这样设置！

1. Steam 中右键《The Binding of Isaac: Rebirth》→ 齿轮 →属性

2. 在通用 → 启动选项中填入（把路径换成你的启动器完整路径，保留引号）：

   ("C:/path/to/REPENTOGONLauncher.exe") --isaac=%command%

Steam Deck / Linux 安装 REPENTOGON：Proton 一键启动

掌机党看这里，全程大约 5 分钟 ⏱️

第 1 步：部署启动器到游戏目录

1. Steam Deck 切换到桌面模式（Desktop Mode）
2. Steam 中找到以撒 → 齿轮 →属性 → 已安装文件 → 浏览，打开游戏安装目录
3. 在安装目录下新建文件夹REPENTOGONLauncher，把下载的启动器解压进去
4. 最终路径必须形如：.../steamapps/common/The Binding of Isaac Rebirth/REPENTOGONLauncher/REPENTOGONLauncher.exe

第 2 步：写入启动参数 + 锁定 Proton 版本

回到 Steam 的属性 → 通用，在启动选项中粘贴（原样复制，注意引号与竖线）：

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

然后切到兼容性选项卡：✅ 启用兼容层，并指定Proton 9.0-4（版本号必须精确匹配）。

现在从 Steam 启动以撒，就会自动弹出 REPENTOGON 启动器完成首次设置（同 Windows 第 2 步：定位isaac-ng.exe→ Next）。

⚠️ 如果启动后没反应：90% 是文件夹名拼错、启动参数多了空格、或 Proton 没锁定到 9.0-4，逐项核对一遍即可。

安装完成后：常见问题快速修复

启动器提示"安装已损坏/无效"怎么办？

按顺序尝试（对应 docs/docs/install_zh.md 官方 FAQ）：

1. 重启启动器，接受所有更新提示
2. 主界面点Choose exe重新指定正确的isaac-ng.exe
3. Steam 中验证以撒游戏文件完整性，等修复完成
4. 点Update/Repair Installation → Re-install/Repair REPENTOGON
5. 还不行就手动删除游戏目录下的repentogon文件夹，重新运行启动器

手柄输入错乱 / 出现"Unknown Device"

• 第三方手柄（8BitDo 等）：在 Steam 属性中开启 Steam 输入覆盖，并完全退出以撒和启动器后重开
• 游戏内"控制映射"菜单可以点Reset To Default恢复默认按键

• 若控制菜单里出现 "Unknown Device" 条目，可打开以撒标题界面按~呼出 REPENTOGON 控制台，在菜单中勾选Block Unknown Device后重启游戏：

成就/解锁内容"丢失"了？

Repentance+ 与 Repentance 使用不同存档，官方只会导入一次。REPENTOGON 提供了存档互导功能：

1. 在标题界面按~打开控制台 → 左上角Tools → Game Options
2. 切到Save Management选项卡 →Import from Repentance

导入/导出只补充缺失的解锁项，绝不会删掉已有进度，放心操作。

进阶：用 Basement Renovator 搭配 REPENTOGON 做房

如果你是造房玩家（要求 Basement Renovator ≥ 3.3.1）：在 Renovator 的File → Set Paths中，把.exe Path指向你的REPENTOGONLauncher.exe，之后测试房间就会自动带上 REPENTOGON 启动 🧱

装好之后：如何上手 REPENTOGON 的 Lua API？

REPENTOGON 的价值在于它扩展的 Lua API（如Isaac.OpenConsole()、ModCallbacks等，详见 changelog.txt）。入门建议：

• 阅读 API 总览文档：docs/docs/Repentogon.md、docs/docs/Isaac.md
• 标题界面按~呼出控制台（ImGui 界面，支持窗口停靠拖拽），可直接改存档、查日志、调试 MOD：

• 想深入了解原理？核心挂钩层在 libzhl/functions/（ZHL 汇编定义），Lua 接口绑定在 repentogon/LuaInterfaces/，运行时补丁位于 repentogon/Patches/，资源文件在 repentogon/resources-repentogon/

开发者彩蛋：从源码编译 REPENTOGON

如果你是开发者，需要 Windows + CMake 3.13+ + Git + Visual Studio 2019+（见 README.md 构建章节）：

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

用 CMake 配置时平台必须选 Win32，生成 .sln 后以 Release 模式编译，再把resources、resources-repentogon、dsound.dll、freetype.dll、libzhl.dll、Lua5.4.dll、zhlREPENTOGON.dll拷入游戏目录即可。不过对绝大多数玩家来说，用启动器一键安装就是最快的方式✅

总结：REPENTOGON 安装核心就是三件事——放好启动器、让它定位isaac-ng.exe、（Linux/Steam Deck 额外写启动参数并锁定 Proton 9.0-4）。装好后你的以撒就拥有了完整的 Lua MOD 开发底座，可以尽情折腾了 🚀

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