如何为《以撒的结合：悔改》安装REPENTOGON扩展框架

如何为《以撒的结合：悔改》安装REPENTOGON扩展框架

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

REPENTOGON是一款针对《以撒的结合：悔改+》的扩展框架，它为游戏的Lua API提供了大量错误修复、额外功能和性能增强。与传统的模组不同，REPENTOGON通过LibZHL框架直接注入游戏进程，让模组开发者能够实现以前无法完成的功能，无需依赖性能消耗巨大的变通方案。

安装前的准备工作

在开始安装前，请确认您的系统环境满足以下要求：

• 游戏版本：需要《以撒的结合：悔改+》v1.9.7.12.J273版本，或者最新Steam官方版本
• 操作系统：Windows系统或Linux/Steam Deck
• 存储空间：确保游戏安装目录有足够的可用空间
• 备份提醒：建议在安装前备份游戏存档和重要文件

Windows系统安装指南

获取启动器文件

您可以通过两种方式获取REPENTOGON启动器：

1. 手动下载：从官方仓库下载最新版本的REPENTOGON启动器
2. 自动升级：如果您之前安装过旧版REPENTOGON，系统可能已自动下载启动器并创建桌面快捷方式

重要提示：将启动器文件解压到您选择的目录中，但不要直接放在以撒的安装文件夹内，也不要放在以撒安装文件夹内的repentogon子文件夹中。这些文件夹后续需要被启动器访问或修改。

执行安装过程

1. 运行REPENTOGONLauncher.exe或桌面上的REPENTOGON快捷方式
2. 启动器将显示初始设置窗口，要求指定《以撒的结合：悔改+》的可执行文件位置
3. 如果位置未自动检测到，点击选择可执行文件...并找到您的isaac-ng.exe，然后点击下一步继续

启动器会在启动时检查更新。请确保启动器保持最新状态以保证功能正常。

配置Steam启动参数（推荐）

为了让Steam启动游戏时自动运行REPENTOGON启动器，您需要配置启动参数。这对于Steam远程游戏功能正常工作至关重要。

1. 在Steam库中右键点击《The Binding of Isaac Rebirth》
2. 点击右侧的齿轮图标，选择属性
3. 在常规选项卡中，找到启动选项字段
4. 输入："(REPENTOGONLauncher.exe的完整路径)" --isaac=%command%

注意：必须将(REPENTOGONLauncher.exe的完整路径)替换为REPENTOGON启动器可执行文件的完整路径。如果您的启动器是从旧版REPENTOGON自动下载的，启动器文件可能位于游戏安装目录下的REPENTOGONLauncher文件夹中。

Linux/Steam Deck安装指南

准备启动器文件

1. 在Steam Deck上，切换到桌面模式
2. 在Steam中，右键点击《The Binding of Isaac Rebirth》
3. 点击齿轮图标，选择属性
4. 导航到已安装文件，然后点击浏览打开游戏安装目录
5. 在Isaac安装目录内创建一个名为REPENTOGONLauncher的新文件夹
6. 下载REPENTOGON启动器并解压到新创建的REPENTOGONLauncher子目录中

配置Steam启动参数

1. 返回Steam属性窗口，导航到常规选项卡
2. 在启动选项字段中，复制并粘贴以下命令：

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

现在通过Steam启动Isaac将运行REPENTOGON启动器。

常见问题解决

启动器显示安装不兼容或损坏

如果启动器提示您的Isaac安装与REPENTOGON不兼容，请确认您拥有以下版本之一：

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

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

1. 在主启动器窗口中点击选择exe重新进行首次设置
2. 点击高级选项...，然后选择重新安装/修复REPENTOGON
3. 如果上述方法都失败，请导航到游戏安装文件夹，删除repentogon子文件夹，然后重新启动启动器

Steam远程游戏无法正常工作

为了让Steam远程游戏与REPENTOGON正常配合工作，Windows用户需要按照上述步骤配置启动参数，Linux/Steam Deck用户则必须配置启动参数。

成就和解锁内容丢失

《以撒的结合：悔改+》使用与基础悔改版本分开的存档文件。REPENTOGON允许您自由地从悔改版本导入缺失的成就和解锁内容，或将新获得的成就/解锁内容导出回悔改版本。

导入步骤：

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

如何配合Basement Renovator使用

Basement Renovator需要至少3.3.1版本才能与REPENTOGON配合工作：

1. 确保Basement Renovator已更新到最新版本
2. 确认REPENTOGON已正确安装并正常工作
3. 在Basement Renovator中，导航到文件→设置路径
4. 将.exe路径更改为指向您的REPENTOGONLauncher.exe

技术架构与版本兼容性

启动器的作用

REPENTOGON启动器解决了三个主要问题：

1. 通用加载解决方案：基于DLL的加载方法在某些Windows版本上不兼容，启动器提供了统一的解决方案
2. 版本管理：由于Repentance+的快速发布周期，REPENTOGON团队选择v1.9.7.12.J273作为发布版本，启动器可以无缝将游戏降级到兼容版本
3. 存档保护：不同版本间的存档文件结构差异可能导致数据丢失，启动器为Isaac可执行文件添加了多项保护措施

模组管理器集成

启动器内置的模组管理器不仅替代了游戏的模组管理逻辑，还显著提高了加载时间和模组管理效率。这是一个由启动器开发者开发的辅助项目，经过集成和优化后被保留在启动器中。

版本兼容性说明

当前版本的REPENTOGON运行在《以撒的结合：悔改+》v1.9.7.12.J273上。虽然启动器允许使用最新官方版本的Repentance+进行安装，但这意味着在使用REPENTOGON运行游戏时，游戏将缺少一些最新的官方补丁。

将像REPENTOGON这样的项目移植到游戏的新版本需要很长时间，并且可能引入许多需要时间来发现和修复的错误/不稳定因素。由于Repentance+仍在积极开发中，团队决定基于v1.9.7.12发布REPENTOGON+，以便模组制作者和玩家可以开始使用，并允许团队在不被迫移植到每个新补丁的情况下开始开发新功能。

获取帮助与支持

如果您遇到问题或有建议，可以在相应的GitHub Issues页面提交：

• REPENTOGON问题反馈
• 启动器问题反馈

报告错误或问题时，请包含相关的日志文件。这些可以通过主启动器窗口中的"检查游戏日志"按钮轻松定位。

您也可以访问The Modding of Isaac Discord服务器中的**#repentogon**频道获取社区支持。

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