如何安装REPENTOGON：以撒忏悔+ Lua MOD框架完整指南（Windows/Steam Deck全覆盖）

如何安装REPENTOGON以撒忏悔 Lua MOD框架完整指南Windows/Steam Deck全覆盖【免费下载链接】REPENTOGONScript extender for The Binding of Isaac: Repentance项目地址: https://gitcode.com/gh_mirrors/re/REPENTOGONREPENTOGON 是一款专为《以撒的结合忏悔》(The Binding of Isaac: Repentance) 打造的脚本扩展器 / Lua MOD 框架社区称之为 EXE mod。它基于 LibZHL 框架直接挂钩hook游戏本体为 Lua API 增加了大量 BUG 修复、新功能和性能优化是制作以撒 MOD 的基石。本文是一份面向新手的 REPENTOGON 安装教程覆盖 Windows 一键安装与 Steam Deck / Linux 完整步骤帮你快速把 REPENTOGON 装好并跑起来 安装REPENTOGON前的环境检查清单在开始之前请确认你满足以下最低要求条件说明游戏版本《以撒的结合忏悔》v1.9.7.12.J273或 Steam 上最新的官方 Repentance 版本启动器会帮你处理降级启动器REPENTOGON Launcher新版必须通过启动器安装系统Windows 10/11或 Linux / Steam DeckProton 兼容层网络启动器启动时会自动检查更新建议网络通畅 如果你打过中文补丁请先在 Steam 中验证游戏文件完整性还原原版否则启动器会判定不兼容。官方详细文档含中文docs/docs/install.md 与 docs/docs/install_zh.mdWindows 安装REPENTOGON三步完成第 1 步放置启动器位置很关键从官方发布渠道下载REPENTOGON Launcher压缩包并解压到你选择的位置推荐位置C:/REPENTOGONLauncher/或以撒安装目录下的子文件夹REPENTOGONLauncher/⚠️三个不要不要放在 OneDrive 等云同步/受保护目录桌面、文档等容易出权限问题不要直接把启动器解压到以撒安装根目录文件冲突不要在游戏目录里创建只叫repentogon的文件夹该目录预留给启动器写入 MOD 文件如果你用过旧版 Repentance 时代的 REPENTOGON它可能已自动下载启动器并创建了桌面快捷方式可以直接跳到第 2 步。第 2 步首次设置自动定位游戏运行REPENTOGONLauncher.exe首次启动会弹出设置窗口询问以撒的结合忏悔可执行文件isaac-ng.exe的位置通常会自动检测没检测到的话点击Select executable...手动选择然后Next继续启动器会自动完成 REPENTOGON 安装包括把游戏降级到兼容版本全程无需手动拷 DLL第 3 步强烈推荐配置 Steam 启动选项这样从 Steam 点开始游戏就会自动走 REPENTOGON 启动器——Steam 远程畅玩必须这样设置Steam 中右键《The Binding of Isaac: Rebirth》→ 齿轮 →属性在通用 → 启动选项中填入把路径换成你的启动器完整路径保留引号(C:/path/to/REPENTOGONLauncher.exe) --isaac%command%Steam Deck / Linux 安装 REPENTOGONProton 一键启动掌机党看这里全程大约 5 分钟 ⏱️第 1 步部署启动器到游戏目录Steam Deck 切换到桌面模式Desktop ModeSteam 中找到以撒 → 齿轮 →属性 → 已安装文件 → 浏览打开游戏安装目录在安装目录下新建文件夹REPENTOGONLauncher把下载的启动器解压进去最终路径必须形如.../steamapps/common/The Binding of Isaac Rebirth/REPENTOGONLauncher/REPENTOGONLauncher.exe第 2 步写入启动参数 锁定 Proton 版本回到 Steam 的属性 → 通用在启动选项中粘贴原样复制注意引号与竖线echo %command% | sed s|isaac-ng.exe|REPENTOGONLauncher/REPENTOGONLauncher.exe| | sh然后切到兼容性选项卡✅ 启用兼容层并指定Proton 9.0-4版本号必须精确匹配。现在从 Steam 启动以撒就会自动弹出 REPENTOGON 启动器完成首次设置同 Windows 第 2 步定位isaac-ng.exe→ Next。⚠️ 如果启动后没反应90% 是文件夹名拼错、启动参数多了空格、或 Proton 没锁定到 9.0-4逐项核对一遍即可。安装完成后常见问题快速修复启动器提示安装已损坏/无效怎么办按顺序尝试对应 docs/docs/install_zh.md 官方 FAQ重启启动器接受所有更新提示主界面点Choose exe重新指定正确的isaac-ng.exeSteam 中验证以撒游戏文件完整性等修复完成点Update/Repair Installation → Re-install/Repair REPENTOGON还不行就手动删除游戏目录下的repentogon文件夹重新运行启动器手柄输入错乱 / 出现Unknown Device第三方手柄8BitDo 等在 Steam 属性中开启 Steam 输入覆盖并完全退出以撒和启动器后重开游戏内控制映射菜单可以点Reset To Default恢复默认按键若控制菜单里出现 Unknown Device 条目可打开以撒标题界面按~呼出 REPENTOGON 控制台在菜单中勾选Block Unknown Device后重启游戏成就/解锁内容丢失了Repentance 与 Repentance 使用不同存档官方只会导入一次。REPENTOGON 提供了存档互导功能在标题界面按~打开控制台 → 左上角Tools → Game Options切到Save Management选项卡 →Import from Repentance导入/导出只补充缺失的解锁项绝不会删掉已有进度放心操作。进阶用 Basement Renovator 搭配 REPENTOGON 做房如果你是造房玩家要求 Basement Renovator ≥ 3.3.1在 Renovator 的File → Set Paths中把.exe Path指向你的REPENTOGONLauncher.exe之后测试房间就会自动带上 REPENTOGON 启动 装好之后如何上手 REPENTOGON 的 Lua APIREPENTOGON 的价值在于它扩展的 Lua API如Isaac.OpenConsole()、ModCallbacks等详见 changelog.txt。入门建议阅读 API 总览文档docs/docs/Repentogon.md、docs/docs/Isaac.md标题界面按~呼出控制台ImGui 界面支持窗口停靠拖拽可直接改存档、查日志、调试 MOD想深入了解原理核心挂钩层在 libzhl/functions/ZHL 汇编定义Lua 接口绑定在 repentogon/LuaInterfaces/运行时补丁位于 repentogon/Patches/资源文件在 repentogon/resources-repentogon/开发者彩蛋从源码编译 REPENTOGON如果你是开发者需要 Windows CMake 3.13 Git Visual Studio 2019见 README.md 构建章节git clone --recursive https://gitcode.com/gh_mirrors/re/REPENTOGON用 CMake 配置时平台必须选 Win32生成 .sln 后以 Release 模式编译再把resources、resources-repentogon、dsound.dll、freetype.dll、libzhl.dll、Lua5.4.dll、zhlREPENTOGON.dll拷入游戏目录即可。不过对绝大多数玩家来说用启动器一键安装就是最快的方式✅总结REPENTOGON 安装核心就是三件事——放好启动器、让它定位isaac-ng.exe、Linux/Steam Deck 额外写启动参数并锁定 Proton 9.0-4。装好后你的以撒就拥有了完整的 Lua MOD 开发底座可以尽情折腾了 【免费下载链接】REPENTOGONScript extender for The Binding of Isaac: Repentance项目地址: https://gitcode.com/gh_mirrors/re/REPENTOGON创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考