REPENTOGON 安装部署完整指南:从零跑通启动器、迁移存档 📅 发布时间:2026/8/21 21:23:47 👁 浏览次数: REPENTOGON 安装部署完整指南从零跑通启动器、迁移存档【免费下载链接】REPENTOGONScript extender for The Binding of Isaac: Repentance项目地址: https://gitcode.com/gh_mirrors/re/REPENTOGONREPENTOGON 是《以撒的结合悔改》的脚本扩展器把 Lua 接口扩展到了引擎底层。这篇文章带你走完「拿到启动器 → 完成安装 → 接入 Steam 启动 → 迁移旧存档成就」的完整链路照做即可一次跑通。先说清楚它是什么、凭什么值得装官方 Lua 接口能给的能力有限很多模组想法要么绕路要么做不出来。REPENTOGON 的做法不一样把 LibZHL 框架和《Antibirth》同一套底层直接挂进游戏进程游戏和模组之间从此没有限流新增数百个 Lua 函数与类原来要打补丁才能实现的功能现在几行代码就能写针对卡顿与加载做底层优化长时间对局更稳修复一批官方遗留 bug减少莫名崩溃模组加载与资源管理提速多模组共存时收益明显同一个游戏装上它之后你能做的事、能调用的资源是另一个量级。动手前的准备清单项目要求说明游戏版本《以撒的结合悔改》v1.9.7.12.J273或 Steam 最新官方版REPENTOGON 基于 J273 开发最新 Steam 版也可用于安装操作系统Windows 10/11或 Linux含 Steam Deck从源码构建仅支持 Windows磁盘余量至少 200MB存放启动器与资源文件前置条件游戏本身能正常启动建议先在 Steam 校验一次文件完整性主部署流程一条主线四步走每步都给了可验证的结果。拿到启动器文件。新用户直接克隆仓库git clone https://gitcode.com/gh_mirrors/re/REPENTOGON把启动器文件放到你习惯的目录。不要直接丢进游戏安装目录游戏目录下的repentogon文件夹要留给 REPENTOGON 自己使用。老用户装过「忏悔」版 REPENTOGON的启动器通常已自动更新去游戏目录的REPENTOGONLauncher子文件夹找即可。可验证结果目录里能看到REPENTOGONLauncher.exe。运行REPENTOGONLauncher.exe。首次运行会弹出初始设置窗口启动器可能先检查更新有提示就接受。可验证结果窗口里显示出它定位到的游戏版本兼容状态。指认游戏可执行文件。没自动检测到时点Select executable...选中isaac-ng.exe再点Next。可验证结果兼容检查显示通过若不通过先核对游戏是否为 v1.9.7.12.J273 或最新 Steam 版。等安装完成从启动器启动游戏验证一遍。可验证结果进入游戏后在标题画面按~能打开 REPENTOGON 控制台。主线走完 ✅Linux / Steam Deck 分支差异Steam Deck 上先切到桌面模式然后在 Steam 属性「已安装文件」里打开游戏目录新建一个REPENTOGONLauncher文件夹把启动器全部文件解压进去目录里应包含REPENTOGONLauncher.exe、launcher-data.bin、steam_appid.txt属性「兼容性」一栏开启兼容层并固定选Proton 9.0-4之后照常走上面四步。Linux 上启动器的位置是硬性要求放错文件夹后面怎么点都不会启动。装完之后的配置与数据迁移接通 Steam 启动选项Windows习惯从 Steam 库直接点「开始」的话补这一步右键《以撒的结合重生》→「属性」→「常规」在启动选项里填D:\repentogon\REPENTOGONLauncher.exe --isaac%command%引号里的路径换成你自己的实际路径。这样 Steam 会先拉起启动器再进游戏Remote Play 等联机功能也只有这么配才正常工作。接通 Steam 启动选项Linux / Steam Deck在同一个「启动选项」框里粘贴echo %command% | sed s|isaac-ng.exe|REPENTOGONLauncher/REPENTOGONLauncher.exe| | sh这条命令把 Steam 传下来的原始指令里的isaac-ng.exe替换成启动器路径再交给 shell 执行。Linux 上这一步是必选不是可选。旧存档成就最快迁移步骤换了扩展器进度不用白打。这套导入导出是「只补不删」永远不会抹掉已有进度标题画面按~打开 REPENTOGON 控制台左上角「工具」→「游戏选项」切到「存档管理」标签点「从忏悔导入」缺失的成就和解锁自动补齐按钮灰着点不了确认你现在停在标题画面别在其他菜单里。Basement Renovator 房间编辑器联动用 Basement Renovator 画房间的创作者确认工具版本不低于 3.3.1菜单「文件」→「设置路径」把.exe 路径指向你的REPENTOGONLauncher.exe之后点「测试房间」游戏就会经由启动器拉起环境有问题时启动器会弹出明确提示而不是让你对着报错猜。要点速查表项目WindowsLinux / Steam Deck文件放置任意目录避开 OneDrive 同步目录游戏目录内REPENTOGONLauncher文件夹启动选项路径\REPENTOGONLauncher.exe --isaac%command%echo %command% \| sed s\|isaac-ng.exe\|REPENTOGONLauncher/REPENTOGONLauncher.exe\| \| sh关键文件REPENTOGONLauncher.exeexe launcher-data.binsteam_appid.txt兼容层无需Proton 9.0-4该步骤属性推荐Remote Play 必需必需高频问题自救症状启动器报告安装损坏/无效主界面点Choose exe重做首次设置确认选对了以撒可执行文件打开Advanced options...选Re-install/Repair REPENTOGON走修复流程都无效时删除游戏目录下的repentogon文件夹再重开启动器让它重建症状第三方手柄如 8BitDo按键失灵Steam 中进入游戏「属性」→「控制器」把覆盖项设为Enable Steam Input完全退出游戏和启动器再重开设置才生效仍不行就进游戏内按键映射菜单点「Reset To Default」症状官方刚出新版本启动器提示不兼容先把启动器更新到最新还不行就耐心等待官方补丁可能需要约一天才放出别急着怀疑自己装错进阶源码与文档入口想深入玩转或参与开发从这几个位置起步Lua 接口实现repentogon/LuaInterfaces/按类拆分和文档一一对应底层挂钩与扩展框架LibZHLlibzhl/API 文档docs/docs/覆盖各类、枚举与回调的完整说明从源码构建需要 Windows 系统编译器须与游戏一致、CMake 3.13、Git、Visual Studio 2019且平台必须设为 Win32入口是CMakeLists.txt到这里流程已经全部走完启动器装好、Steam 链路接通、旧存档迁完、编辑器联动配好。下一步动作很明确——启动游戏在标题画面按~敲开控制台把新 API 上手试几把。中途卡在哪一步先回上面对应小节对一遍实在解决不了去社区「#repentogon」频道问一句比闷头折腾高效得多。祝你玩得开心期待你的新模组。【免费下载链接】REPENTOGONScript extender for The Binding of Isaac: Repentance项目地址: https://gitcode.com/gh_mirrors/re/REPENTOGON创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考