游戏开发插件系统【免费下载链接】REPENTOGONScript extender for The Binding of Isaac: Repentance项目地址https://gitcode.com/gh_mirrors/re/REPENTOGON点击查看免费下载本文基于 REPENTOGON 仓库的官方安装文档简体中文版 install_zh.md英文原版见 install.md完整讲解如何在 Windows 与 Linux / Steam Deck 上部署 REPENTOGON 启动器并完成首次设定说明 Steam 启动选项Launch Options的正确配置方法并覆盖“安装损坏、成就丢失、Basement Renovator 联动”等高频故障的排查手段。读完后你可以独立完成一次可运行的 REPENTOGON 安装并理解启动器背后“DLL 加载 版本固定 存档保护”的设计动机与底层加载链。一、安装前提版本与环境核对清单在动手之前先核对两个硬性前提REPENTOGON 的启动器Launcher以及一个符合要求的游戏版本。根据 install_zh.md 与 README.md 的说法安装运行 REPENTOGON 需要REPENTOGON 启动器Launcher——不同操作系统的安装方式不同见下文各节以下游戏版本之一以撒的结合忏悔The Binding of Isaac: Repentance最新官方 Steam 版本以撒的结合忏悔v1.9.7.12.J273。当前仓库的版本状态可以作为参照version.txt 中记录的 REPENTOGON 版本为1.1.3该版本号在构建期被写入 repentogon/Version.cpp 并导出为__REPENTOGON_VERSION符号——启动器正是通过读取这个符号来校验“启动器版本”与“游戏目录中 REPENTOGON DLL 版本”是否匹配这也是后文“安装损坏”报错的来源之一。组件版本/状态依据REPENTOGON1.1.3当前仓库version.txt游戏基线版本忏悔 v1.9.7.12.J273install_zh.md、README.md可接受的游戏版本最新官方 Steam 版 或 v1.9.7.12.J273install_zh.md加载器产物zhlREPENTOGON.dll、libzhl.dll、zhlLoader.dll 等CMakeLists.txt、README.md译注原文档保留中文补丁会修改原版游戏请校验完整性去除补丁后使用 REPENTOGON。二、Windows 安装获取启动器获取启动器有两条路径手动下载与从旧版本自动升级。2.1 手动下载从启动器项目的 Releases 下载最新版 REPENTOGON 启动器压缩包解压到一个你自己指定的目录不要直接解压到以撒安装目录下更不要解压到以撒安装目录下的repentogon文件夹这些文件夹后续需要由启动器访问和修改所以不能把启动器文件本身放在里面。结合英文文档 install.md 的补充说明放在受 OneDrive 同步保护的目录桌面、文档等也可能引发启动器问题两个可靠的放置位置是C:/REPENTOGONLauncher/这类盘符根目录下的新文件夹或以撒安装目录下的REPENTOGONLauncher子文件夹注意是REPENTOGONLauncher不是小写的repentogon。启动器会尝试从 GitHub 获取更新如果失败则会从 Steam 创意工坊获取更新。启动器支持识别系统代理请确保你的系统环境能够流畅访问上述渠道之一。2.2 自动升级从旧版本 REPENTOGON 升级如果你安装过忏悔Repentance时代的旧版 REPENTOGON它会提示你升级到忏悔、自动下载启动器并在桌面创建一个快捷方式。如有需要可以在以撒安装目录的REPENTOGONLauncher文件夹内找到启动器文件。三、Windows 安装完成 REPENTOGON 安装3.1 运行启动器与首次设定运行REPENTOGONLauncher.exe或者桌面的REPENTOGON快捷方式首次运行会弹出启动器的首次设定窗口。启动器会在启动后检查更新请保持启动器版本最新以确保功能正常。首次设定窗口会询问《以撒的结合忏悔》的可执行文件位置有自动检测功能如果没有检测成功点击Select executable...选择你游戏的isaac-ng.exe文件然后点击Next继续。如果启动器显示Compatible with Repentogon兼容 REPENTOGON不是 yes注意你需要满足以下之一以撒的结合忏悔v1.9.7.12.J273最新官方 Steam 版本的以撒的结合忏悔。如果游戏新版本刚刚发布请尝试升级启动器如果还不行请耐心等待——官方可能需要约一天时间来为新版本发布补丁。3.2 安装失败 / 安装损坏时的排查动作如果安装失败或启动器报告安装已损坏按顺序尝试点击启动器主界面中的Choose exe重新进行首次设定点击启动器主界面中的Advanced options...然后选择Re-install/Repair REPENTOGON如果都不行到游戏安装文件夹中删除repentogon文件夹然后再次运行启动器。从构建侧看这个repentogon文件夹正是 REPENTOGON 的落盘位置README.md 的构建说明要求把resources、resources-repentogon、dsound.dll、freetype.dll、libzhl.dll、Lua5.4.dll与zhlREPENTOGON.dll复制到游戏目录可通过 CMake 的ISAAC_DIRECTORY变量指向游戏根目录下的Repentogon文件夹实现自动拷贝而 CMakeLists.txt 中同样有把zhlLoader.dll复制到${ISAAC_DIRECTORY}的add_custom_command。启动器安装的repentogon目录里存放的就是这套 DLL 集合因此删除该目录等价于一次彻底的卸载重装。四、可选/推荐通过 Steam 启动 REPENTOGON如果希望从 Steam 启动以撒时直接运行启动器按以下步骤操作。如需 Steam 远程畅玩Remote Play在 REPENTOGON 上工作此步骤必需在 Steam 上转到The Binding of Isaac: Rebirth点击屏幕右侧的齿轮选择属性这会打开一个新窗口在通用页的启动选项Launch Options中输入(启动器文件REPENTOGONLauncher.exe路径) --isaac%command%注意事项原文档强调(启动器文件REPENTOGONLauncher.exe路径)必须替换成 REPENTOGON 启动器的完整路径不要括号保留引号如果你是从旧版本 REPENTOGON 自动升级的启动器文件可能就在游戏安装路径下可以通过 Steam 的“已安装文件”找到配置完成后%command%会被 Steam 展开为游戏的原始启动命令并整体传给启动器由启动器决定以何种方式拉起游戏。这个接口在源码中有对应物repentogon/LauncherInterface.h 中定义了两端共享的通信常量LAUNCHER_EXIT_MODS_CHANGED 1 8并注明该文件必须与启动器侧的等价文件保持同步——它规定了“模组被加载/卸载/安装/卸载安装后游戏进程以该退出码退出、要求启动器立即重启游戏”的约定说明启动器与游戏进程之间存在一条持续通信的通道而--isaac%command%就是这条通道的第一次握手。五、Linux / Steam Deck 安装Linux含 Steam Deck的部署方式与 Windows 不同启动器直接放进游戏目录再用 Steam 启动选项把isaac-ng.exe替换为启动器。在 Steam Deck 上先退出到桌面模式Desktop Mode在 Steam 里转到The Binding of Isaac: Rebirth点击屏幕右侧的齿轮图标选择属性这会打开一个新的窗口转到已安装文件点击浏览这会打开游戏安装目录在安装目录下创建一个新的文件夹名为REPENTOGONLauncher如果文件夹已存在且包含文件REPENTOGONLauncher.exe则可能是已经从旧版 REPENTOGON 自动升级下载了启动器。这个没问题可以跳过下一步下载 REPENTOGON 启动器压缩包并解压到新创建的REPENTOGONLauncher里面返回 Steam 菜单点击通用在启动选项中复制粘贴以下内容echo %command% | sed s|isaac-ng.exe|REPENTOGONLauncher/REPENTOGONLauncher.exe| | sh这样从 Steam 里打开以撒时Steam 先执行原始启动命令字符串sed把其中的isaac-ng.exe替换成REPENTOGONLauncher/REPENTOGONLauncher.exe最后由sh执行——等价于“用启动器代替游戏主程序被启动”。启动以撒REPENTOGON 启动器就会打开。启动器同样会在启动后检查更新请保持其版本最新首次设定窗口会询问《以撒的结合忏悔》的可执行文件位置有自动检测功能如果没有检测成功点击Select executable...选择你游戏的isaac-ng.exe然后点击Next继续。与 Windows 一样如果Compatible with Repentogon不是 yes需要满足 v1.9.7.12.J273 或最新官方 Steam 版本两个条件之一如果安装失败或启动器报告安装已损坏同样依次尝试Choose exe重做首次设定、Advanced options...→Re-install/Repair REPENTOGON、删除游戏目录中的repentogon文件夹后重开启动器。补充以英文文档 install.md 为准启动器完整路径应为.../steamapps/common/The Binding of Isaac Rebirth/REPENTOGONLauncher/REPENTOGONLauncher.exe请勿用错文件夹名或把文件多嵌套一层并且英文文档建议将 Steam 的兼容性选项启用并明确指定为Proton 9.0-4。六、为什么需要启动器动机与设计背景安装文档用一大节 FAQ 解释了启动器的由来这也是理解整个部署方案的关键。简答——三条动机通用加载方案最初动机是需要一个加载 REPENTOGON 的通用方案基于 DLL 的加载方式在某些环境下不可用固定游戏版本忏悔 的发布周期相对较快这会让 REPENTOGON 陷入无尽的移植工作存档结构变化不同游戏版本的存档结构不同如果一个版本去加载另一个版本的存档会导致数据完全丢失。长答——启动器诞生于忏悔 宣布之前有些 Windows 系统上的用户无法运行 REPENTOGON团队意识到只依赖 DLL 没有通用解决方案。随后忏悔 开始滚动迭代传统 Lua 模组依赖的是各版本间大体稳定的、定义良好的 API而 REPENTOGON 依赖对游戏结构的逆向这在每个版本上都不同。在较快的发布节奏下移植工作变成了“在一个版本上的移植还没结束就已过时”的无尽循环。于是团队选定v1.9.7.12.J273作为发行基线启动器随之承担“把游戏无缝降级到 REPENTOGON 兼容版本”的第二职责。第三职责来自存档结构的破坏性变化在最新版本上尝试加载 REPENTOGON 兼容的存档可能损毁全部成就启动器为此在游戏可执行文件上增加了若干应对措施。仓库源码印证了这条加载链的存在。loader/loader.cpp 中导出的Launch(bool initConsole)入口会写入repentogon.log、加载libzhl.dll并调用其InitZHLInitZHL则回调LoadMods——它遍历当前目录的zhl*.dll逐个LoadLibraryA优先调用普通模组的ModInit而对 REPENTOGON 主 DLL 则查找并调用InitRepentogon导出函数见 loader/loader.cpp 中GetProcAddress(mod, InitRepentogon)分支。值得注意的是其中的安全设计如果遍历结束仍未发现 REPENTOGON 本体repentogonFound为假加载器会记录[FATAL] Repentogon was not found, aborting to prevent possible save files corruption并直接abort()——即“找不到 REPENTOGON 就宁可让游戏起不来也不让原版游戏在错误的加载环境下运行”从代码层面兜底了 FAQ 里提到的“跨版本加载导致存档损毁”风险。七、关于游戏版本为什么新功能“不在”最近忏悔更新的一些东西在哪里——目前 REPENTOGON 运行在以撒的结合忏悔 v1.9.7.12.J273上。虽然启动器能基于忏悔的最新官方版本一键安装但游戏以 REPENTOGON 加载时会失去一些新版本的官方修复。对于 REPENTOGON 这样逆向项目移植到新版本耗时极长且会引入大量 bug/不稳定因素而忏悔 仍在持续开发因此团队决定基于 v1.9.7.12 发行 REPENTOGON让玩家和模组作者重新用回 REPENTOGON同时开发团队可以不被迫追着每个新补丁移植。这也解释了安装文档中“新版本发布后请耐心等待一天”的表述官方需要时间适配新版本之后你才能通过“最新官方 Steam 版本”这一路径安装而不是停留在旧基线上。八、成就/解锁丢失利用 Save Management 导入导出这是安装文档中最实用的自救场景忏悔 与忏悔使用不同的存档文件没有 REPENTOGON 也是如此而忏悔 只在你第一次启动它时从忏悔导入一次存档。也就是说如果你曾经启动过忏悔、之后又回退到忏悔继续玩你的忏悔 存档会一直停留在上次玩忏悔 时的状态。REPENTOGON 提供了自由的双向同步从忏悔版本导入缺失的成就/解锁项或者把新获得的成就/解锁项导出回忏悔。操作步骤严格按文档在标题界面按~键打开 REPENTOGON 控制台在屏幕左上角选择Tools然后选择Game Options——会弹出一个新窗口切换到Save Management选项卡选择Import from Repentance从忏悔存档导入缺失的成就和解锁项。如果按钮不可用确保你正处于标题界面导入/导出操作完全不会移除已存在的成就或进度它只会在当前存档上解锁“另一个存档中有、当前存档中缺失”的成就。源码层面这个选项卡的实现在 repentogon/ImGuiFeatures/GameOptions.hSave Management页签里有一个可用性判定saveManagementAllowed其条件是!Isaac::IsInGame() g_MenuManager且当前选中菜单 ID 为 1 或 2即标题/存档菜单、且没有存档文件被加载——这正是文档反复强调“必须在标题界面”的原因不满足条件时按钮会被ImGui::BeginDisabled整体禁用并显示红色提示文本。页签内同时提供三类操作Sync调用SaveSyncing::PerformVanillaSaveSynchronization做原版存档同步Import from Repentance / Export to Repentance分别调用SaveSyncing::ImportFrom(SaveSyncing::REPENTANCE, slot)与SaveSyncing::ExportTo(...)并带有存档槽位下拉选择。同步状态本身由 repentogon/SaveSyncing/SaveSyncing.h 中的SyncStatus类维护它保存“最近一次成功同步”的校验和checksum映射用 JSON 持久化以此判断两侧存档是否失同步GameVersion枚举中区分了REPENTANCE4、REPENTANCE_PLUS5与REPENTOGON6三种体系与 FAQ 中“忏悔 与忏悔是不同存档文件”的说法一一对应。页面上的Enable Save Syncing复选框直接读写syncStatus的启用状态默认启用并落盘 JSON。九、常见问题速查与 Basement Renovator 联动9.1 启动器说我的 REPENTOGON 安装损坏/无效依次尝试原文档给出的顺序确保你严格按照前面的步骤操作过——特别是Linux 或 Steam Deck 用户文件夹名、嵌套层级是最高频错误重启启动器如有更新提示则更新点击启动器主窗口上的Choose exe重做首次配置确保选择了正确的以撒可执行文件点击Advanced options...选择Re-install/Repair REPENTOGON以上都做了还不行转到游戏安装文件夹删除repentogon目录重新打开启动器。如果问题依旧或反复出现就走“报告问题”流程见 9.4。9.2 启动器里为什么有 mod 管理器文档的解释这个 mod 管理器是启动器开发过程中的附属项目之一当它被集成进启动器、再移植到 REPENTOGON 中替代游戏原本的 mod 管理逻辑后团队发现它显著改进了游戏加载时间以及多数情况下的 mod 管理时间所以保留了下来。9.3 Steam 启动 / 远程畅玩不工作“在 Steam 上启动以撒来打开 REPENTOGON”是 Windows 安装流程中的可选步骤、Linux 中的强制步骤并且是 Steam 远程畅玩正常工作的前提。做法即第四节的启动选项配置。9.4 Basement Renovator 联动首先确认 Basement Renovator 版本Basement Renovator 需要 3.3.1 或以上版本才能与 REPENTOGON 协同工作请获取最新版本确保已下载 REPENTOGON 启动器、完成首次设定且确认 REPENTOGON 能正常工作在 Basement Renovator 中选择File→Set Paths会弹出对话框修改.exe Path为REPENTOGONLauncher.exe在测试房间时就会以 REPENTOGON 启动游戏同时如果出现任何问题比如安装受损会弹出启动器界面而不是直接失败。9.5 报告问题 / 联系我们Bug、问题与建议可以通过 REPENTOGON 的 GitHub Issues 页面或启动器的 Issues 页面提出。报告 bug 或提问题时请附带相关的日志文件——这些文件可以通过点击启动器上的Check Game Logs按钮获取。此外也可以访问 The Modding of Isaac Discord 服务器上的#repentogon频道。从仓库角度补一句日志体系是现成的。loader/loader.cpp 在Launch过程中持续向repentogon.log写入带时间戳的分级日志线程上下文转储、ZHL 加载地址、InitZHL结果等模组加载失败时会记录WARN Unable to load mod ...及 Win32 错误码——报告问题时附上这份日志开发方能直接定位是“DLL 无法加载”还是“初始化报错”。十、要点回顾两条安装路径Windows 手动/自动升级获取启动器后走首次设定Linux / Steam Deck 则把启动器放进游戏目录REPENTOGONLauncher/并用sed启动选项替换isaac-ng.exe版本红线游戏必须是忏悔 最新官方 Steam 版本或v1.9.7.12.J273新版发布后给官方一天的补丁窗口期Steam 启动选项Windows 下为(完整启动器路径) --isaac%command%远程畅玩必需损坏排查三板斧Choose exe重设 →Re-install/Repair REPENTOGON→ 删除游戏目录中repentogon文件夹重来成就丢失标题界面~打开控制台 → Tools → Game Options → Save Management → Import from Repentance操作只增不删源码依据加载链见 loader/loader.cpp找不到 REPENTOGON 即 abort 防存档损坏版本校验符号见 repentogon/Version.cpp启动器握手协议见 repentogon/LauncherInterface.h存档同步 UI 与状态见 repentogon/ImGuiFeatures/GameOptions.h、repentogon/SaveSyncing/SaveSyncing.h。赞分享游戏开发插件系统【免费下载链接】REPENTOGONScript extender for The Binding of Isaac: Repentance项目地址https://gitcode.com/gh_mirrors/re/REPENTOGON点击查看免费下载相关推荐REPENTOGON 安装与部署完全指南从 Launcher 配置、版本锁定到存档同步与常见故障排查REPENTOGON 安装与部署完全指南从 Launcher 配置、版本锁定到存档同步与常见故障排查 本文基于 REPENTOGON 官方安装文档 docs/游戏开发插件系统REPENTOGON完整安装与使用指南REPENTOGON完整安装与使用指南 REPENTOGON是一个专为《以撒的结合悔改》设计的脚本扩展器它为游戏提供了API级别的增强包括错误修复、额外功游戏开发插件系统REPENTOGON完整安装指南以撒的结合终极脚本扩展器快速部署手册REPENTOGON完整安装指南以撒的结合终极脚本扩展器快速部署手册 REPENTOGON是《以撒的结合重生》的终极脚本扩展器为游戏带来前所未有的MOD支游戏开发插件系统上一篇React Native Windows与UWP/WinUI集成原生组件开发终极指南下一篇EmuDeck vs 手动配置Steam Deck Emulation自动化工具深度评测创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考