10分钟快速上手REPENTOGON：终极《以撒的结合》脚本扩展器安装指南

10分钟快速上手REPENTOGON：终极《以撒的结合》脚本扩展器安装指南

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

想要为《以撒的结合：忏悔+》带来革命性的游戏体验吗？REPENTOGON脚本扩展器就是你的终极解决方案！这个强大的工具不仅仅是传统MOD的升级版，而是通过深度挂钩游戏内核，为你带来前所未有的Lua API扩展能力、游戏性能提升和bug修复功能。无论你是普通玩家想要更稳定的游戏体验，还是MOD开发者渴望创造更丰富的游戏内容，REPENTOGON都能满足你的需求。

🎯 REPENTOGON三大核心价值

在深入了解安装步骤之前，让我们先看看REPENTOGON能为你的游戏带来哪些实际好处：

性能与稳定性飞跃🚀 传统MOD经常因为兼容性问题导致游戏崩溃或卡顿，但REPENTOGON直接与游戏引擎深度集成，提供了更稳定的运行环境。这意味着你可以享受更流畅的游戏体验，特别是在长时间游戏时，不会因为MOD冲突而烦恼。

跨版本存档管理🔄 你是否曾在Repentance和Repentance+版本间切换时丢失游戏进度？REPENTOGON内置的存档管理功能让你能在两个版本间自由导入导出成就，再也不用担心辛苦解锁的内容消失。

强大的MOD开发基础💡 对于想要创建自定义内容的玩家，REPENTOGON提供了远超传统MOD的API功能。这意味着你可以实现更复杂的游戏机制修改，创造真正独特的游戏体验。

📋 安装前必读：系统要求检查

在开始安装前，花2分钟完成这些基础检查，能避免后续安装过程中可能遇到的问题。

系统与游戏版本要求

小提示：如果你不确定游戏版本，可以在Steam库中右键点击游戏，选择"属性"→"本地文件"→"浏览本地文件"，查看游戏版本信息。

🚀 Windows平台安装教程

第一步：获取REPENTOGON启动器

你有两种方式获取启动器文件：

方式一：手动下载（推荐给首次安装用户）从官方仓库克隆最新版本，确保获得完整文件：

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

方式二：自动升级（适用于已有旧版本用户）如果你之前安装过旧版REPENTOGON，启动器可能已经自动下载。检查游戏安装目录的REPENTOGONLauncher子文件夹，看看是否已有相关文件。

重要提醒：不要直接把启动器解压到游戏安装目录的根文件夹，也不要放在游戏目录内的repentogon子文件夹中！这些位置需要被启动器访问和修改，放置错误会导致安装失败。

第二步：运行启动器进行初始设置

1. 找到你下载或解压的REPENTOGONLauncher.exe文件，双击运行
2. 启动器会自动检测《以撒的结合》可执行文件位置
3. 如果检测失败，点击Select executable...按钮手动定位你的isaac-ng.exe文件

第三步：配置Steam启动选项（关键步骤）

为了让Steam Remote Play正常工作，并且让每次启动游戏都自动加载REPENTOGON，你需要配置Steam启动选项：

1. 在Steam库中右键点击《以撒的结合：重生》
2. 选择"属性"，然后点击"常规"标签
3. 找到"启动选项"字段，输入以下命令：

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

路径示例：如果你的启动器放在D:\mods\REPENTOGON文件夹中，应该输入：

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

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

配置原理：这个命令告诉Steam，每次启动游戏时先运行REPENTOGON启动器，并将原始启动命令传递给启动器。--isaac=%command%参数确保了游戏能正常启动。

🐧 Linux/Steam Deck配置指南

Steam Deck桌面模式设置

如果你使用的是Steam Deck，需要先切换到桌面模式：

1. 按下Steam按钮，选择"电源"→"切换至桌面模式"
2. 在桌面模式下打开Steam客户端
3. 在Steam中找到《以撒的结合：重生》并右键点击，选择"属性"

创建启动器目录结构

1. 在游戏属性窗口中点击"已安装文件"标签
2. 点击"浏览"按钮，这会打开游戏安装目录
3. 在游戏目录内创建一个名为REPENTOGONLauncher的新文件夹
4. 将下载的REPENTOGON启动器文件解压到这个文件夹中

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

配置Linux启动命令

返回Steam游戏属性窗口，切换到"常规"标签，在"启动选项"字段中输入以下命令：

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

Linux平台REPENTOGON启动选项配置 - 使用sed命令替换启动路径

🔧 实用功能：存档管理与成就导入

安装完成后，REPENTOGON最实用的功能之一就是跨版本存档管理。如果你在Repentance和Repentance+版本间切换时丢失了成就，这个功能能帮你找回所有进度。

如何导入缺失的成就

1. 启动游戏并进入标题屏幕
2. 按下键盘上的**~**键打开REPENTOGON控制台
3. 在屏幕左上角找到"工具"菜单，选择"游戏选项"
4. 切换到"存档管理"标签页
5. 点击"从忏悔导入"按钮，系统会自动导入所有缺失的成就和解锁内容

REPENTOGON存档导入功能界面 - 轻松管理游戏进度和成就

安全提示：导入/导出过程永远不会删除你已有的成就，只会解锁在一个版本中获得但在另一个版本中缺失的内容。这意味着你的游戏进度只会增加，不会减少。

🛠️ 进阶配置：Basement Renovator集成

如果你使用Basement Renovator进行房间编辑和MOD开发，需要将其与REPENTOGON集成，确保测试时能正确加载你的修改。

配置步骤

1. 确保你的Basement Renovator至少为3.3.1版本（旧版本可能不兼容）
2. 打开Basement Renovator，导航到"文件"→"设置路径"
3. 在弹出的对话框中，将".exe路径"指向你的REPENTOGONLauncher.exe文件
4. 保存设置，现在测试房间时会自动通过REPENTOGON启动游戏

Basement Renovator与REPENTOGON集成配置 - 正确设置启动器路径确保房间测试正常

🚨 故障排查与常见问题

快速诊断清单

遇到问题时，按顺序尝试以下步骤：

1. ✅ 检查游戏版本是否符合要求
2. ✅ 确认启动器文件完整无缺
3. ✅ 验证Steam启动选项配置正确
4. ✅ 尝试重新选择可执行文件
5. ✅ 使用高级选项中的修复功能
6. ✅ 完全删除后重新安装

常见问题解决方案

📚 下一步行动建议

成功安装REPENTOGON只是开始，现在你可以探索更多可能性：

探索扩展功能

REPENTOGON不仅修复bug，还添加了大量新功能。建议从以下方面开始探索：

• Lua API扩展：查看官方文档了解新增的函数和类
• 性能优化：体验更流畅的游戏运行
• MOD开发：利用扩展API创建自己的游戏内容

开发者资源

如果你对MOD开发感兴趣，REPENTOGON提供了丰富的开发资源：

• 核心框架源码：位于libzhl/目录，了解底层实现
• Lua接口源码：位于repentogon/LuaInterfaces/目录，学习如何扩展功能
• 构建指南：项目支持从源码构建，需要Windows系统、CMake和Visual Studio

最后提醒：REPENTOGON不会收集或传输任何用户数据，更新机制是可选的且透明的。现在你已经掌握了REPENTOGON的完整安装方法，快去享受增强的游戏体验，或者开始你的MOD开发之旅吧！

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