终极REPENTOGON脚本扩展器安装教程：从零开始快速上手指南

终极REPENTOGON脚本扩展器安装教程：从零开始快速上手指南

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

REPENTOGON是《以撒的结合：悔改》最强大的脚本扩展器，为游戏带来了前所未有的Lua API扩展、性能优化和功能增强。无论你是MOD开发者还是普通玩家，这款工具都能让你获得更丰富的游戏体验。本指南将带你快速掌握REPENTOGON的完整安装流程，让你轻松享受增强的游戏功能。

准备工作与环境要求

在开始安装REPENTOGON之前，你需要确保满足以下条件：

• 游戏版本：必须使用《以撒的结合：悔改+》最新官方Steam版本或v1.9.7.12.J273版本
• 操作系统：支持Windows或Linux系统（包括Steam Deck）
• 磁盘空间：预留至少200MB可用空间
• 基础环境：确保游戏已正确安装并能正常运行

重要提示：REPENTOGON与传统MOD的工作方式不同，它直接挂钩到游戏内部，因此需要特定的安装流程和启动器管理。

获取REPENTOGON启动器

REPENTOGON现在通过专门的启动器进行管理，这是安装过程的核心组件。你可以通过以下两种方式获取：

手动下载启动器

从官方仓库下载最新版REPENTOGON启动器：

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

或者从发布页面获取预编译版本。将启动器解压到你选择的目录中，注意不要直接解压到游戏安装目录，也不要放在游戏目录内的repentogon文件夹中。

从旧版自动升级

如果你之前安装过REPENTOGON的忏悔版本，启动器可能已自动下载并创建桌面快捷方式。你可以在游戏安装目录的REPENTOGONLauncher子文件夹中找到相关文件。

Windows平台快速安装步骤

初始配置流程

运行REPENTOGONLauncher.exe或桌面快捷方式，启动器将打开初始设置窗口：

1. 游戏可执行文件检测：启动器会自动检测《以撒的结合：悔改+》的可执行文件位置
2. 手动选择路径：如果自动检测失败，点击Select executable...并定位到你的isaac-ng.exe文件
3. 验证兼容性：确保游戏版本与REPENTOGON兼容

兼容性检查：如果启动器提示游戏版本不兼容，请确认你使用的是以下任一版本：

• 《以撒的结合：悔改+》v1.9.7.12.J273
• 最新官方Steam版本的《以撒的结合：悔改+》

Steam启动选项配置（推荐）

为了让Steam Remote Play正常工作，强烈建议配置Steam启动选项：

1. 在Steam库中右键点击《以撒的结合：重生》
2. 选择属性，然后进入常规标签
3. 在启动选项字段中输入："你的REPENTOGONLauncher.exe完整路径" --isaac=%command%

路径替换示例："D:\repentogon\REPENTOGONLauncher.exe" --isaac=%command%

这个配置确保通过Steam启动游戏时自动运行REPENTOGON启动器。

Linux/Steam Deck安装指南

Linux用户和Steam Deck玩家需要特别注意文件结构和启动命令：

Steam Deck桌面模式设置

1. 退出到桌面模式
2. 在Steam中导航到《以撒的结合：重生》
3. 点击右侧的齿轮图标，选择属性

创建启动器目录

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

配置Linux启动命令

返回Steam属性窗口的常规标签，在启动选项字段中输入以下命令：

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

这个命令会将Steam的启动命令替换为REPENTOGON启动器路径。

常见问题快速解决

安装失败或启动器报告安装损坏

如果安装失败或启动器报告安装损坏，尝试以下步骤：

1. 重新选择可执行文件：在主启动器窗口中点击Choose exe重新进行初始设置
2. 修复安装：点击Advanced options...，然后选择Re-install/Repair REPENTOGON
3. 完全重装：如果以上方法都失败，导航到游戏安装目录，删除repentogon子文件夹，然后重新启动启动器

版本兼容性说明

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

注意：将REPENTOGON移植到新游戏版本需要大量时间，并且可能引入需要时间发现和修复的错误/不稳定因素。

存档管理与成就导入

REPENTOGON提供了强大的存档管理功能，让你可以在不同版本间自由导入导出成就和解锁内容。

存档导入步骤

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

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

Basement Renovator集成配置

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

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

配置完成后，测试房间时将使用REPENTOGON启动游戏。如果安装有问题，启动器会显示相应提示。

进阶功能与开发支持

Lua API扩展文档

REPENTOGON对Lua API进行了大量添加和修改，增加了众多新功能。完整的API文档可在官方文档中查看。

开发者构建指南

对于想要从源码构建REPENTOGON的开发者，需要满足以下要求：

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

构建步骤：

1. 递归克隆仓库：git clone --recursive https://gitcode.com/gh_mirrors/re/REPENTOGON
2. 使用CMake配置项目
3. 确保编译器与Visual Studio版本匹配
4. 平台必须设置为Win32
5. 生成解决方案文件并在Visual Studio中构建

故障排除与技术支持

启动器报告安装损坏

如果启动器持续报告安装损坏，请：

1. 确保严格按照上述安装说明操作，特别是Linux/Steam Deck用户
2. 重启启动器并接受所有更新提示
3. 验证选择的Isaac可执行文件是否正确
4. 如果问题持续，请删除游戏目录中的repentogon子文件夹并重新安装

成就/解锁内容缺失

《以撒的结合：悔改+》使用与基础忏悔版本分开的存档文件。如果你之前启动过悔改+，然后回到了忏悔版本，你的悔改+存档数据可能仍然停留在之前启动时的状态。

使用REPENTOGON的存档导入功能可以轻松解决这个问题，如前面存档管理部分所述。

总结与最佳实践

REPENTOGON为《以撒的结合：悔改》社区带来了革命性的MOD开发体验。通过正确的安装和配置，你可以充分利用其强大的Lua API扩展、性能优化和功能增强。

关键要点：

• 始终通过启动器管理REPENTOGON安装
• 为Steam Remote Play配置Steam启动选项
• 定期检查启动器更新以确保兼容性
• 使用存档导入功能管理不同版本间的进度

通过本指南，你应该能够顺利完成REPENTOGON的安装并开始享受增强的游戏体验。如果在安装过程中遇到任何问题，建议查阅官方文档或参与社区讨论获取帮助。

官方文档：docs/docs.html
开发者资源：libzhl/
Lua接口源码：repentogon/LuaInterfaces/

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