REPENTOGON 安装部署实操指南：从克隆仓库到存档迁移

REPENTOGON 安装部署实操指南从克隆仓库到存档迁移【免费下载链接】REPENTOGONScript extender for The Binding of Isaac: Repentance项目地址: https://gitcode.com/gh_mirrors/re/REPENTOGONREPENTOGON 是《以撒的结合忏悔》的脚本扩展器基于 LibZHL 框架直接挂钩进游戏进程把 Lua API 大幅扩宽让模组能触碰过去够不着的游戏内部。本文覆盖完整链路克隆仓库 → 安装启动器 → 配置 Steam 启动选项 → 存档迁移 → 高频问题速查跟着做五分钟内就能跑起来。它到底帮你省了什么事《以撒》官方 Lua 接口给的能力有限很多想法要么绕路实现要么干脆做不出来。REPENTOGON 和社区熟知的 EXE 级模组一脉相承它把 LibZHL和《Antibirth》同一套底层挂进游戏进程等于在游戏和模组之间架起一座不限流的桥。装上之后新增数百个 Lua 函数与类原来要打补丁才能实现的功能现在几行代码搞定针对卡顿与加载做底层优化长时间对局更稳修复官方遗留 bug莫名崩溃变少提供高级渲染接口视觉上限更高模组加载与资源管理提速多模组共存时收益明显同一个游戏装上它之后能做的事和能调用的资源是另一个量级。动手之前先过一遍这份清单游戏版本《以撒的结合忏悔》v1.9.7.12.J273或 Steam 最新官方版操作系统Windows 10/11或 Linux含 Steam Deck磁盘余量至少 200MB游戏状态本体能正常启动装过官方中文补丁的先用 Steam 校验文件完整性去除补丁网络启动器每次启动都会检查更新需要能访问更新渠道全部打勾再往下走能省掉后面 80% 的排查时间。拿到 REPENTOGON两种路径手动克隆仓库用 git 把仓库克隆到本地再放到你习惯的目录git clone https://gitcode.com/gh_mirrors/re/REPENTOGON启动器文件不要直接丢进游戏安装目录游戏目录下也别建叫repentogon的文件夹这两个位置都要留给启动器自己读写。稳妥的做法是在盘符根目录新建一个文件夹比如D:\your\path\REPENTOGONLauncher\。老用户自动升级如果你之前装过面向「忏悔」版本的 REPENTOGON它通常会提示升级到「忏悔」自动下好新的启动器文件并在桌面建一个快捷方式。找不到快捷方式的话去游戏安装目录下的REPENTOGONLauncher子文件夹里找。REPENTOGON 部署全流程按你的平台走安装教程Windows双击REPENTOGONLauncher.exe首次运行会弹出初始设置窗口启动器会自动定位游戏的isaac-ng.exe没找到就点Select executable...手动指一下提示版本不兼容时对照上面的清单确认游戏版本如果官方刚发布新版本先升级启动器等上约一天让它出适配补丁安装完成后从启动器进游戏验证一遍到这里基础功能已经就位。如果你习惯从 Steam 库直接点「开始」还有一步要配看下一节。Linux / Steam DeckSteam Deck 上先切到桌面模式在 Steam 里进入游戏「属性」→「已安装文件」点「浏览」打开游戏安装目录在游戏目录里新建一个REPENTOGONLauncher文件夹如果同名文件夹已存在且里面有启动器的 exe说明是旧版自动升级下好的跳过下一步把启动器全部文件放进这个文件夹里面应包含REPENTOGONLauncher.exe、launcher-data.bin、steam_appid.txt等文件按下一节设置 Steam 启动选项和 Proton 版本从 Steam 启动游戏会弹出启动器并询问isaac-ng.exe的位置到这里基础功能已经就位。两个平台的差异用一张表收拢项目WindowsLinux / Steam Deck文件放置任意目录别放游戏目录游戏目录内REPENTOGONLauncher文件夹Steam 启动选项路径\REPENTOGONLauncher.exe --isaac%command%sed替换命令额外要求无Proton 9.0-4对接 SteamREPENTOGON 启动器配置指南想让从 Steam 库点「开始」就直接拉起启动器Remote Play 等联机功能必须这样配就在 Steam 里改启动选项。Windows启动选项一行搞定在 Steam 中右键《以撒的结合重生》→「属性」→「常规」把启动选项填成D:\your\path\REPENTOGONLauncher.exe --isaac%command%引号里的路径换成你自己启动器的实际路径。这条命令让 Steam 把原始启动指令先交给启动器再由启动器拉起游戏链路变成 Steam → 启动器 → 游戏。Linux / Steam Decksed 替换在「启动选项」栏粘贴下面这条命令echo %command% | sed s|isaac-ng.exe|REPENTOGONLauncher/REPENTOGONLauncher.exe| | sh它做的事很直白把 Steam 传下来的原始启动指令里的isaac-ng.exe替换成启动器路径再交给 shell 执行。Basement Renovator工具联动可选用 Basement Renovator 画房间的创作者把两边的路径串起来即可确认工具版本不低于 3.3.1菜单里选「文件」→「设置路径」把.exe 路径指向你的REPENTOGONLauncher.exe之后点「测试房间」游戏就会经由启动器拉起环境有问题时启动器会给出明确提示而不是让你对着报错瞎猜。旧存档怎么带过来四步存档迁移换了脚本扩展器之后完全不用担心进度白打。迁移四步走完在标题画面按~打开 REPENTOGON 控制台左上角进「工具」→「游戏选项」会弹出新窗口切到「存档管理」标签点「从忏悔导入」缺失的成就和解锁会自动补齐按钮是灰的就检查自己是否在标题画面。这套导入导出只补不删——它永远不会抹掉你已有的进度只会把另一边有、这边缺的内容补上。高频问题速查启动器报告安装损坏主界面点Choose exe重做一遍初始设置确认选对了以撒可执行文件进Advanced options...选Re-install/Repair REPENTOGON走修复流程都无效时删除游戏目录下的repentogon子文件夹重开启动器让它重建第三方手柄如 8BitDo按键失灵Steam 里进入游戏「属性」→「控制器」把Override for The Binding of Isaac: Rebirth设为Enable Steam Input改完必须完全退出游戏和启动器再重开设置才生效游戏里缺少某些官方新补丁的功能REPENTOGON 基于启动器锁定的旧版本开发。启动器允许你用最新 Steam 版安装但游戏在 REPENTOGON 下运行时可能缺少最新的官方补丁内容。移植到新版本需要大量调试短期内遇到小毛病很正常别急着怀疑自己装错了。从 Steam 启动后没反应核对启动器完整路径是否为.../The Binding of Isaac Rebirth/REPENTOGONLauncher/REPENTOGONLauncher.exe逐字核对启动选项是否和文中一字不差确认「兼容性」里 Proton 精确设为Proton 9.0-4想深入 / 想造轮子路径都在这儿Lua 接口实现repentogon/LuaInterfaces/底层挂钩与扩展框架libzhl/API 文档docs/docs/涵盖各类、枚举与回调的完整说明从源码构建需要Windows 系统编译器需与游戏一致、CMake 3.13 或更高、Git、Visual Studio 2019 及以上平台必须设为 Win32装完了然后呢从拿到仓库到跑通游戏这条链路你都已经走过一遍了版本核对、文件摆放、Steam 启动选项、存档迁移还有几个最容易踩的坑。剩下的就是动手装一遍然后在游戏里敲开~控制台体验新 API 带来的自由度。卡在哪一步就回到上文对应小节对一遍遇到文档没覆盖的情况去仓库的 Issue 页面提一单或到社区「#repentogon」频道问一句都比闷头折腾高效。祝你玩得开心也期待看到你的新模组。【免费下载链接】REPENTOGONScript extender for The Binding of Isaac: Repentance项目地址: https://gitcode.com/gh_mirrors/re/REPENTOGON创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考