REPENTOGON 安装实战指南以撒脚本扩展器一次跑通【免费下载链接】REPENTOGONScript extender for The Binding of Isaac: Repentance项目地址: https://gitcode.com/gh_mirrors/re/REPENTOGONREPENTOGON 是《以撒的结合忏悔》的 Lua 脚本扩展器它直接挂钩游戏本体在官方 API 之外提供数百个新接口、性能优化与存档保护。 读完本文你将在 Windows 或 Linux/Steam Deck 上完成从获取启动器、首次初始化到存档导入、手柄配置的全部流程。什么情况下该上它适合这三类人你的模组功能已经卡在官方 Lua API 的边界上只能靠又慢又脆的 hack 绕路多个模组同时加载卡顿切房间掉帧想让整个生态跑得稳你在忏悔与忏悔之间来回切换成就和解锁项在存档里失踪。它不是又一个模组而是生态的地基基于与 Antibirth 同源的 LibZHL 框架直接挂钩游戏内部做到普通 Lua 模组做不到、或需要重写到性能爆炸才能做到的事。装之前先把这几项对上检查项要求确认方式游戏本体忏悔 最新官方 Steam 版或v1.9.7.12.J273二选一Steam 属性中查看游戏版本操作系统Windows 10/11或 Linux含 Steam Deck查看系统信息磁盘空间预留 200MB 以上查看磁盘剩余容量启动器获取 REPENTOGONLauncher下文主线第 1 步克隆完成后确认REPENTOGONLauncher.exe存在一个版本常识REPENTOGON 基于 v1.9.7.12.J273 开发但启动器允许你基于 Steam 最新版安装。运行时游戏会缺少个别最新官方补丁的内容——这是设计如此官方文档有明确说明不用当作故障处理。安装实战一条主线两个分叉4.1 通用主线三步完成初始化第 1 步获取。克隆仓库里面自带完整文档与工具链git clone https://gitcode.com/gh_mirrors/re/REPENTOGON第 2 步放对位置。启动器要放在稳定、无同步的目录。两条禁忌记牢不要直接解压进游戏安装目录根下可能引发文件冲突不要在游戏目录里预先创建叫repentogon的文件夹这个路径后面由启动器自己使用。第 3 步首次初始化。运行REPENTOGONLauncher.exe会弹出首次设定窗口询问忏悔可执行文件的位置。多数情况下自动检测检测不到就点Select executable...定位到isaac-ng.exe点Next继续。启动器每次启动都会检查更新——看到更新提示就接受保持最新能避开大部分兼容性问题。4.2 Windows 分叉Windows 与主线的差异只有两处位置选点和接入 Steam。位置推荐两个稳妥落点——磁盘根目录新建C:/REPENTOGONLauncher/或游戏安装目录内新建REPENTOGONLauncher子文件夹。桌面、文档这类 OneDrive 同步目录容易出权限问题别放。Steam 启动选项Steam 远程畅玩正常工作的前置条件Steam 库右键《以撒的结合重生》→属性→常规在启动选项填入(你的 REPENTOGONLauncher.exe 完整路径)--isaac%command%路径替换成真实值引号保留参数一个字符都不能少。4.3 Linux / Steam Deck 分叉这个平台的差异在于启动器必须放进游戏目录再用一条命令把启动流程交给它。Steam Deck 用户先切换到桌面模式Steam 中进入《以撒的结合重生》属性→已安装文件→浏览打开安装目录在游戏目录内新建REPENTOGONLauncher文件夹把启动器解压进去若文件夹里已有旧版升级带来的REPENTOGONLauncher.exe此步可跳过核对最终路径必须是.../steamapps/common/The Binding of Isaac Rebirth/REPENTOGONLauncher/REPENTOGONLauncher.exe——不要多套一层文件夹也不要改错名字回到属性→常规把启动选项替换为这一行echo %command% | sed s|isaac-ng.exe|REPENTOGONLauncher/REPENTOGONLauncher.exe| | sh它的作用是把 Steam 原本要执行的isaac-ng.exe替换成 REPENTOGON 启动器。在兼容性区域开启兼容层锁定为Proton 9.0-4。⚠️ 启动后毫无反应时按路径 → 启动参数 → Proton 版本的顺序逐项复查三处必须全部吻合。首次运行冒烟测试进入标题界面后依次做这三件事每件都很快。验证安装随便开一局按~打开 REPENTOGON 控制台输入help能看到命令列表即一切正常。控制台也是后续一切调试的入口。补回失踪的成就忏悔 与忏悔使用不同存档文件而官方只在首次启动忏悔时自动导入一次——所以你过去的进度很可能还停着。在标题屏幕按~→ 左上角Tools→Game Options→ 切到Save Management标签 → 点Import from Repentance。按钮是灰色的话说明你没在标题屏幕该操作只补齐另一版本缺的内容永远不会删除已有成就。规范手柄按键8BitDo 等第三方手柄到游戏属性→控制器把 Override 设为Enable Steam Input。⚠️ 这个改动必须完全关闭 Isaac 和 REPENTOGON 启动器后重启才生效仍异常时进游戏内按键映射菜单点Reset To Default。两个长期习惯顺手带上启动器的每次启动更新提示直接接受重大模组变动前先备份存档。进阶玩法接入你的开发流Basement Renovator 联动。房间编辑器需要3.3.1 及以上版本才能与 REPENTOGON 配合。确认 REPENTOGON 初始化正常后打开 Basement Renovator 的File→Set Paths把.exe Path改为你的REPENTOGONLauncher.exe。之后测试房间会自动经 REPENTOGON 启动游戏安装若损坏会弹启动器窗口而不是静默失败。API 与源码在哪。Lua API 完整文档在 docs/docs/Lua 接口实现位于 repentogon/LuaInterfaces/底层挂钩框架在 libzhl/。启动器自带的模组管理器还会替换游戏原有的模组加载逻辑加载时间有明显改善。源码构建最小流程必须 Windows与游戏同编译器CMake 3.13、Git、Visual Studio 2019git clone --recursive https://gitcode.com/gh_mirrors/re/REPENTOGON打开 CMake源码目录指向仓库根目录产物目录任选点Configure编译器与你的 VS 版本一致平台必须选 Win32其余保持默认点Generate生成.sln用 Visual Studio 打开按Release模式构建把resources、resources-repentogon、dsound.dll、freetype.dll、libzhl.dll、Lua5.4.dll、zhlREPENTOGON.dll复制到游戏目录或把ISAAC_DIRECTORY设为游戏根目录构建后自动复制。出问题先查这张表症状第一反应解决路径启动器提示安装损坏/无效重启启动器接受更新提示主窗口Choose exe重走首次设定Steam 校验游戏文件完整性有重下就等完Update/Repair Installation→Re-install/Repair REPENTOGON仍无效则删除游戏目录下repentogon子文件夹后重开启动器游戏启动即崩溃先怀疑新官方补丁新补丁刚发布就先更新启动器仍失败则等待官方最多约一天跟进走完上一条修复流程用Check Game Logs按钮取日志再报告Steam 远程畅玩失效启动选项没配对Windows 核对--isaac%command%是否完整Linux 核对 sed 命令与Proton 9.0-4是否锁定成就与解锁突然不见存档没丢只是跨版本结构不同按首次运行冒烟测试第 2 条做存档导入一键补齐手柄按键错乱设置未生效完全关闭 Isaac 与启动器后重启或进游戏内按键映射Reset To Default收尾下一个动作很明确在标题屏幕按~敲help确认控制台响应正常。然后翻一翻 docs/docs/ 里的 API 文档看看新增的几百个接口能做什么。配置途中摸出任何捷径发到社区里帮下一个人少走弯路。【免费下载链接】REPENTOGONScript extender for The Binding of Isaac: Repentance项目地址: https://gitcode.com/gh_mirrors/re/REPENTOGON创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考