REPENTOGON安装与配置完整指南:零基础跑通《以撒的结合:悔改+》脚本扩展器
【免费下载链接】REPENTOGONScript extender for The Binding of Isaac: Repentance项目地址: https://gitcode.com/gh_mirrors/re/REPENTOGON
照本文操作,约20分钟可以完成REPENTOGON在Windows或Steam Deck上的完整安装。REPENTOGON是《以撒的结合:悔改+》的脚本扩展器(script extender,为游戏加装脚本能力的扩展工具),它直接挂钩游戏本体,给Lua模组补充数百个新接口,加载更快、存档更稳。装完按~打开控制台就能验证。
上手前必须知道的3件事
1. 它不是普通插件。普通Lua模组依赖游戏开放的API,能力有限;REPENTOGON基于LibZHL框架(与经典模组Antibirth同源)挂钩游戏内部结构,能实现普通模组做不到的功能,代价是绑定特定游戏版本。安装与运行统一由**REPENTOGONLauncher(启动器)**完成,而不是手动往游戏目录丢文件。
2. 版本常识。REPENTOGON基于v1.9.7.12.J273开发。若用最新官方Steam版安装,运行中的游戏会缺少个别最新官方补丁内容,这是官方文档说明过的正常现象,无需处理。
3. 硬性环境要求。
| 项目 | 要求 | 可选方案 |
|---|---|---|
| 游戏本体 | 《以撒的结合:悔改+》 | 最新官方Steam版,或v1.9.7.12.J273 |
| 操作系统 | Windows 10/11,或Linux | Steam Deck走Linux路线 |
| 磁盘空间 | 200MB以上 | 留足余量更稳 |
🚀 按你的平台走
Windows:把启动器放进稳定目录,再完成首次设定
先克隆仓库获取启动器(仓库附带完整文档与工具链):
git clone https://gitcode.com/gh_mirrors/re/REPENTOGON将启动器解压到稳定、无同步的位置。两个可靠选择:磁盘根目录下的**C:/REPENTOGONLauncher/,或游戏安装目录里新建的REPENTOGONLauncher子文件夹。坑位:避开桌面、文档等OneDrive同步目录;不要把启动器解压到游戏安装目录根下,也不要提前创建名为repentogon的文件夹**——这两处由启动器自己使用。
双击**REPENTOGONLauncher.exe进入首次设定。游戏通常能被自动检测;检测不到就点Select executable...,手动定位isaac-ng.exe,再点Next**。启动器每次启动都会检查更新,有更新提示就接受。
想从Steam直接进REPENTOGON(Remote Play远程畅玩需要这步),右键《以撒的结合:重生》→属性→常规,在启动选项中填入:
"(PATH TO REPENTOGONLauncher.exe)" --isaac=%command%把括号部分换成启动器exe的完整路径,引号保留:
Linux / Steam Deck:进桌面模式,用sed替换启动目标
Steam Deck先切到桌面模式。在Steam中打开《以撒的结合:重生》→属性→已安装文件→浏览进入游戏安装目录,新建**REPENTOGONLauncher文件夹,把启动器解压进去。最终路径必须是.../steamapps/common/The Binding of Isaac Rebirth/REPENTOGONLauncher/REPENTOGONLauncher.exe**。坑位:不要多套一层文件夹,也不要改错文件夹名,这是Linux装不上最常见的原因。
回到属性→常规,在启动选项粘贴:
echo "%command%" | sed 's|isaac-ng.exe|REPENTOGONLauncher/REPENTOGONLauncher.exe|' | sh它把Steam原本要执行的**isaac-ng.exe替换成启动器,参数逐字一致才能生效。再到兼容性区域开启兼容层并锁定Proton 9.0-4**。
启动游戏后若毫无反应,优先复查三处:路径是否精确、参数是否逐字一致、Proton是否锁定。
✅ 装完先过一遍检查单
- 功能验证:进任意一局,按**
~打开REPENTOGON控制台,输入help**,能看到命令列表即安装成功。 - 存档迁移:标题界面按**
~** →Tools→Game Options→Save Management标签,点Import from Repentance,把忏悔存档中缺失的成就与解锁补齐。操作只做增量,不删已有进度;按钮灰色就确认你正处在标题界面。 - 第三方手柄:Steam属性→控制器,把覆盖设为**
Enable Steam Input;改完必须完全关闭游戏和启动器才生效,仍异常就进游戏按键映射菜单点Reset To Default**。
🛠 想玩得更深
- 测房间:房间编辑工具Basement Renovator需3.3.1以上版本才兼容。打开**
File** →Set Paths,把**.exe Path指向REPENTOGONLauncher.exe**,之后测试房间会直接以REPENTOGON启动,安装异常时启动器会弹出而不是静默失败。 - API与源码:完整Lua API文档见docs/docs/,新接口的核心实现在repentogon/LuaInterfaces/。
- 源码构建:仅限Windows(编译器须与游戏一致),需CMake 3.13+、Git、Visual Studio 2019或更高。递归克隆后CMake配置(平台必须选Win32),编译完成把**
resources、resources-repentogon、dsound.dll、freetype.dll、libzhl.dll、Lua5.4.dll、zhlREPENTOGON.dll**复制到游戏目录。
🔍 问题速查
| 症状 | 可能原因 | 解决办法 |
|---|---|---|
| 启动器提示安装损坏/无效 | exe选错、游戏文件缺失、旧安装残留 | ①点Choose exe重走首次设定;②Steam校验文件完整性,有重下就等它结束;③点Update/Repair Installation选Re-install/Repair REPENTOGON;仍无效就删掉游戏目录下的repentogon子文件夹后重开启动器 |
| 游戏启动即崩溃 | 官方新补丁刚发布、启动器未跟进 | 先更新启动器;仍失败则等约一天官方补丁,并按上条①~③处理,用Check Game Logs导出日志定位 |
| Linux/Steam Deck点启动没反应 | 文件夹名错、启动参数有出入、Proton未锁定 | 逐项核对:路径是否为.../The Binding of Isaac Rebirth/REPENTOGONLauncher/REPENTOGONLauncher.exe;sed命令是否逐字一致;兼容性是否锁定Proton 9.0-4 |
| Steam Remote Play失效 | Steam启动选项没接管 | Windows复查--isaac=%command%是否完整、引号是否在;Linux复查sed命令与Proton版本 |
| 成就与解锁突然消失 | 两版存档结构不同,部分解锁未读取 | 标题界面~→Tools→Game Options→Save Management点Import from Repentance,单向叠加、不删数据 |
长期使用记住4条:启动器有更新就接受;大改模组前先备份存档;修改游戏核心的模组可能冲突,装前确认兼容性;出问题用**Check Game Logs看日志。现在开一局游戏,按~进控制台输入help**,看到命令列表,REPENTOGON就跑通了。
【免费下载链接】REPENTOGONScript extender for The Binding of Isaac: Repentance项目地址: https://gitcode.com/gh_mirrors/re/REPENTOGON
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考