REPENTOGON安装与配置完整指南:零基础跑通《以撒的结合:悔改+》脚本扩展器
2026/8/24 16:47:54 网站建设 项目流程

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,或LinuxSteam 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**,能看到命令列表即安装成功。
  • 存档迁移:标题界面按**~** →ToolsGame OptionsSave 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),编译完成把**resourcesresources-repentogondsound.dllfreetype.dlllibzhl.dllLua5.4.dllzhlREPENTOGON.dll**复制到游戏目录。

🔍 问题速查

症状可能原因解决办法
启动器提示安装损坏/无效exe选错、游戏文件缺失、旧安装残留①点Choose exe重走首次设定;②Steam校验文件完整性,有重下就等它结束;③点Update/Repair InstallationRe-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版本
成就与解锁突然消失两版存档结构不同,部分解锁未读取标题界面~ToolsGame OptionsSave ManagementImport 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),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询