REPENTOGON终极安装指南：5步快速解锁《以撒的结合》完整MOD体验

REPENTOGON终极安装指南：5步快速解锁《以撒的结合》完整MOD体验

【免费下载链接】REPENTOGONScript extender for The Binding of Isaac: Repentance项目地址: https://gitcode.com/gh_mirrors/re/REPENTOGON

想要为《以撒的结合：忏悔+》注入全新活力吗？REPENTOGON脚本扩展器正是你需要的终极解决方案！作为当前最强大的Lua API扩展器，它不仅能修复游戏bug、提升性能，还能解锁传统MOD无法实现的高级功能。无论你是普通玩家还是MOD开发者，这篇完整教程将带你轻松完成安装配置，享受前所未有的游戏体验。

🔍 为什么选择REPENTOGON？

REPENTOGON与传统MOD有着本质区别。它通过LibZHL框架直接挂钩到游戏核心，提供了前所未有的控制能力。以下是它的核心优势：

重要提示：REPENTOGON不会收集或传输任何用户数据，更新机制完全可选且透明，保护你的隐私安全。

📋 安装前准备工作

在开始安装前，请花2分钟检查这些必备条件：

✅游戏版本：《以撒的结合：忏悔+》最新Steam版或v1.9.7.12.J273
✅磁盘空间：至少200MB可用空间
✅系统要求：Windows 10/11或Linux系统（Steam Deck也支持）
✅游戏运行：确保原版游戏能正常启动
✅网络连接：用于下载启动器和更新文件

🚀 第一步：获取REPENTOGON启动器

你有两种方式获取启动器，我们推荐手动下载以获得最新版本：

方式一：手动下载（推荐）

直接从官方仓库克隆最新版本：

git clone --recursive https://gitcode.com/gh_mirrors/re/REPENTOGON

方式二：自动升级

如果你之前安装过旧版REPENTOGON，启动器可能已自动下载。检查游戏安装目录的REPENTOGONLauncher子文件夹。

⚠️ 重要提醒：不要直接把启动器解压到游戏安装目录，也不要放在游戏目录内的repentogon文件夹中！

🖥️ 第二步：Windows平台详细配置

初始设置流程

1. 运行REPENTOGONLauncher.exe
2. 启动器会自动检测《以撒的结合》可执行文件位置
3. 如果检测失败，点击Select executable...手动定位isaac-ng.exe

Steam启动选项配置（关键步骤！）

为了让Steam Remote Play正常工作，必须配置启动选项：

1. 在Steam库中右键点击《以撒的结合：重生》
2. 选择属性→常规标签
3. 在启动选项中输入：

"D:\你的路径\REPENTOGONLauncher.exe" --isaac=%command%

示例配置：如果你的启动器在D:\mods\REPENTOGON，就输入：

"D:\mods\REPENTOGON\REPENTOGONLauncher.exe" --isaac=%command%

Windows平台REPENTOGON启动器配置界面 - 正确设置Steam启动路径

时间预估：整个Windows安装约需8分钟

🐧 第三步：Linux/Steam Deck配置方案

Steam Deck桌面模式设置

1. 退出到桌面模式
2. 在Steam中打开《以撒的结合：重生》属性

创建启动器目录

1. 进入已安装文件标签，点击浏览
2. 在游戏目录内创建REPENTOGONLauncher文件夹
3. 下载并解压REPENTOGON启动器到这个文件夹

Linux平台REPENTOGON启动器文件夹结构 - 确保文件完整无缺

配置Linux启动命令

在Steam属性的启动选项中输入：

echo "%command%" | sed -e 's/isaac-ng.exe/REPENTOGONLauncher/REPENTOGONLauncher.exe/' | sh

Linux平台REPENTOGON启动选项配置 - 正确设置脚本命令

💾 第四步：存档管理与成就导入

REPENTOGON提供了强大的存档管理功能，让你在不同版本间自由导入导出成就：

1. 在标题屏幕按**~**键打开REPENTOGON控制台
2. 左上角导航到工具→游戏选项
3. 切换到存档管理标签
4. 选择从忏悔导入导入所有缺失的成就和解锁

REPENTOGON脚本扩展器存档导入功能 - 轻松管理游戏进度

重要提示：导入/导出过程永远不会删除现有成就，只会解锁在一个版本中获得但在另一个版本中缺失的内容。

🛠️ 第五步：Basement Renovator集成

如果你使用Basement Renovator进行房间编辑，需要与REPENTOGON集成：

1. 确保Basement Renovator至少为3.3.1版本
2. 导航到文件→设置路径
3. 将.exe路径更改为指向你的REPENTOGONLauncher.exe

Basement Renovator与REPENTOGON集成配置 - 正确设置启动器路径

🔧 故障排查手册

安装失败怎么办？

• 重新选择可执行文件：在主启动器窗口点击Choose exe
• 修复安装：点击Advanced options...→Re-install/Repair REPENTOGON
• 完全重装：删除游戏目录的repentogon子文件夹，重新启动启动器

快速问题排查表

版本兼容性提示

当前REPENTOGON基于**《以撒的结合：忏悔+》v1.9.7.12.J273**开发。虽然启动器支持最新官方版本，但运行REPENTOGON时游戏会缺少一些最新补丁。

小贴士：移植到新版本需要时间，可能引入需要修复的错误，建议使用兼容版本。

📚 进阶指南与资源

开发者构建指南

如果你想从源码构建REPENTOGON，需要以下环境：

构建要求：

• Windows系统（必须与游戏使用相同编译器）
• CMake 3.13或更高版本
• Git
• Visual Studio 2019或更高版本

核心源码路径：

• Lua接口源码：repentogon/LuaInterfaces/
• 核心框架源码：libzhl/

社区资源与支持

• 官方文档：docs/docs.html - 完整的API文档和功能说明
• Lua API扩展：查看官方文档了解REPENTOGON新增的功能
• MOD开发：利用扩展的API开发自己的MOD
• 定期检查更新：REPENTOGON持续更新，保持最新版本

安装检查清单

✅ 下载了REPENTOGON启动器
✅ 正确配置了Steam启动选项
✅ 游戏版本兼容性确认
✅ 存档导入功能测试
✅ Basement Renovator集成（如使用）
✅ 控制台功能正常（按~键测试）

记住：REPENTOGON不会收集或传输任何用户数据，更新机制是可选且透明的。现在，你已经掌握了REPENTOGON脚本扩展器的完整安装方法，快去享受增强的游戏体验吧！🎮

小贴士：如果在安装过程中遇到任何问题，建议查阅官方文档或参与社区讨论获取实时帮助。祝你游戏愉快！

【免费下载链接】REPENTOGONScript extender for The Binding of Isaac: Repentance项目地址: https://gitcode.com/gh_mirrors/re/REPENTOGON