REPENTOGON 从零部署到跑通：新手5步完成全部安装配置
【免费下载链接】REPENTOGONScript extender for The Binding of Isaac: Repentance项目地址: https://gitcode.com/gh_mirrors/re/REPENTOGON
REPENTOGON 是给《以撒的结合：悔改+》扩宽 Lua API 的脚本扩展器。带你走完「获取启动器 → 部署 → 配 Steam 启动选项 → 迁移存档 → 排障」的完整链路，照做就能跑通。
它替你省了什么
官方 Lua 接口能力有限，很多模组想法要么绕路要么做不出来。REPENTOGON 把 LibZHL 框架直接挂进游戏进程，传统 mod 走不通的路它就通了。
- 新增数百个 Lua 函数与类，原来要打补丁的功能现在几行代码搞定
- 底层优化卡顿与加载，长时间对局更稳
- 修复官方遗留 bug，减少莫名崩溃
- 提供高级渲染接口，视觉效果上限更高
同一个游戏，装上它之后能做的事是另一个量级。
动手前4件事
逐项核对一遍，四项都满足再往下走：
- 游戏版本：《以撒的结合：悔改+》v1.9.7.12.J273，或 Steam 最新官方版
- 系统：Windows 10/11，或 Linux（含 Steam Deck）
- 磁盘余量：至少 200MB
- 前置：游戏本身能正常启动
一次到位：获取 + 首次部署
手动获取
git clone https://gitcode.com/gh_mirrors/re/REPENTOGON文件放到习惯的目录，唯一硬性要求：别直接把启动器丢进游戏安装目录，后续更新和管理都会变别扭。
已有用户升级
之前装过「忏悔」版 REPENTOGON 的话，启动器通常已替你下好新文件并建了桌面快捷方式，去游戏目录的REPENTOGONLauncher子文件夹找即可。
首次跑起来
- 双击
REPENTOGONLauncher.exe - 启动器会自动定位
isaac-ng.exe，找不到就点Select executable...手动指定 - 提示版本不兼容时，确认游戏已更新到 v1.9.7.12.J273 或最新 Steam 版
- 安装完成后从启动器进游戏验证一遍
把它变成你的默认入口
习惯从 Steam 库直接点「开始」的话，多配一步，联机功能才能正常工作。
Windows 下 Steam 启动选项一行配好
- Steam 里右键《以撒的结合：重生》→ 属性 → 常规
- 启动选项填入（路径换成你自己的）：
"D:\repentogon\REPENTOGONLauncher.exe" --isaac=%command%这样从 Steam 启动时会先拉起启动器再进游戏。
Linux / Steam Deck 启动选项配置
先在桌面模式操作：
- 进游戏安装目录，新建
REPENTOGONLauncher文件夹 - 启动器全部文件解压进去，应有
REPENTOGONLauncher.exe、launcher-data.bin、steam_appid.txt
- 属性 → 常规，启动选项填入：
echo "%command%" | sed -e 's/isaac-ng.exe/REPENTOGONLauncher/REPENTOGONLauncher.exe/' | sh作用直白：把 Steam 传下来的启动指令里的isaac-ng.exe换成启动器路径，再交给 shell 执行。
| 项目 | Windows | Linux / Steam Deck |
|---|---|---|
| 文件放置 | 任意目录 | 游戏目录内REPENTOGONLauncher文件夹 |
| 启动选项 | "路径\REPENTOGONLauncher.exe" --isaac=%command% | echo ... \| sed ... \| sh |
| 关键文件 | 启动器 exe | exe + launcher-data.bin + steam_appid.txt |
这步是 Steam Remote Play 联机可用的前提。
REPENTOGON 迁移旧存档：进度别丢
换扩展器进度不会白打，迁移就4步：
- 标题画面按
~打开 REPENTOGON 控制台 - 左上角「工具」→「游戏选项」
- 切到「存档管理」标签
- 点「从忏悔导入」，缺失的成就和解锁自动补齐
导入导出是「只补不删」：永不抹掉已有进度，只补另一边有、这边缺的内容。
串起来的其他工具
用 Basement Renovator 画房间的创作者，把两边路径串起来：
- 确认工具版本不低于 3.3.1
- 菜单「文件」→「设置路径」
- 把
.exe 路径指向你的REPENTOGONLauncher.exe
配完点「测试房间」，游戏会经启动器拉起；环境不对，启动器会直接给出明确报错，不用对着提示瞎猜。
最容易翻车的3件事
启动器报告安装损坏？
- 主界面点
Choose exe重做初始设置 - 进
Advanced options...选Re-install/Repair REPENTOGON走修复 - 再不行，删掉游戏目录下的
repentogon子文件夹，重开启动器让它重建
第三方手柄（如 8BitDo）按键失灵？
- 游戏「属性」→「控制器」，Override 设为
Enable Steam Input - 改完必须完全退出游戏和启动器再重开，设置才生效
版本兼容心里有数REPENTOGON 基于 v1.9.7.12.J273 开发。启动器允许用最新 Steam 版安装，但游戏运行它时可能缺最新官方补丁内容；短期内遇到小毛病算正常，别急着怀疑装错了。
想自己造轮子
- Lua 接口实现：
repentogon/LuaInterfaces/ - 底层挂钩与扩展框架：
libzhl/ - API 文档：
docs/docs/，涵盖各类、枚举与回调 - 从源码构建需：Windows（编译器与游戏一致）、CMake 3.13+、Git、VS 2019+，平台必须设为 Win32
你的回合
版本核对、文件摆放、Steam 启动选项、存档迁移、工具联动，到这里全链路都过完了。卡在哪一步就回到对应小节对一遍；文档没覆盖的情况去官方文档翻翻，或到社区 #repentogon 频道问一句，比闷头折腾高效得多。祝你玩得开心 🎮
【免费下载链接】REPENTOGONScript extender for The Binding of Isaac: Repentance项目地址: https://gitcode.com/gh_mirrors/re/REPENTOGON
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
