如何安装REPENTOGON：从入门到精通的完整指南

REPENTOGON是《以撒的结合：悔改》的一款革命性EXE模组，通过API级别增强提供错误修复、额外功能和性能优化。本REPENTOGON安装教程将从准备工作到高级配置，全方位指导您完成安装过程，同时提供实用的REPENTOGON配置指南，确保您获得最佳的游戏体验。

一、准备篇：安装前的必要准备

1.1 系统需求检查

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

• 已安装《以撒的结合：悔改》最新版本（支持Repentance+）
• Windows 10/11或Linux系统（包括Steam Deck）
• 至少1GB可用存储空间
• 管理员权限（用于文件写入和系统配置）

💡 技巧提示：建议在安装前关闭所有安全软件，避免其误拦截REPENTOGON的必要文件操作。

1.2 获取REPENTOGON安装文件

获取REPENTOGON有两种方式：

手动下载方式：

1. 访问官方发布渠道获取最新版本的REPENTOGON启动器
2. 将下载的压缩包解压到非游戏目录的任意位置

通过Git克隆仓库： 如果您熟悉命令行操作，可以通过以下命令克隆项目仓库：

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

⚠️ 注意事项：请勿将REPENTOGON直接解压到以撒的游戏安装文件夹中，这可能导致文件冲突。

二、安装篇：分平台安装步骤

2.1 Windows平台安装步骤

1. 导航到您解压REPENTOGON的文件夹
2. 双击REPENTOGONLauncher.exe启动安装程序
3. 在初始设置窗口中，启动器会自动尝试检测游戏路径
4. 如果检测失败，点击"选择可执行文件"按钮并定位到isaac-ng.exe
5. 点击"安装"按钮完成安装过程

💡 新手提示：Windows用户可以将REPENTOGONLauncher.exe发送到桌面快捷方式，方便日后启动。

2.2 Linux/Steam Deck平台安装步骤

1. 切换到Steam Deck的桌面模式（如果使用Steam Deck）
2. 在游戏安装目录中创建REPENTOGONLauncher文件夹
3. 将下载的启动器文件解压到该文件夹

4. 打开终端，导航到游戏安装目录，执行以下命令设置权限：

chmod +x REPENTOGONLauncher/REPENTOGONLauncher.exe

💡 新手提示：Steam Deck用户可以在发现软件中心安装"Konsole"终端模拟器，方便执行命令操作。

三、配置篇：启动选项与工具集成

3.1 配置Steam启动选项

Windows系统：

1. 在Steam库中右键点击《以撒的结合：悔改》
2. 选择"属性"，在"启动选项"字段中输入：

"您的REPENTOGONLauncher.exe完整路径" --isaac=%command%

例如："D:\repentogon\REPENTOGONLauncher.exe" --isaac=%command%

Linux/Steam Deck系统：

1. 在Steam库中右键点击《以撒的结合：悔改》
2. 选择"属性"，在"启动选项"字段中输入：

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

3.2 集成Basement Renovator工具

1. 确保您的Basement Renovator版本至少为3.3.1
2. 打开Basement Renovator，导航到"File" -> "Set Paths"
3. 在".exe Path"字段中，浏览并选择您的REPENTOGONLauncher.exe

⚠️ 注意事项：每次REPENTOGON更新后，您可能需要重新配置此路径。

四、优化篇：提升游戏体验的设置

4.1 图形与性能优化

1. 启动游戏后按~键打开REPENTOGON控制台
2. 导航到"Tools" -> "Performance"
3. 根据您的硬件配置调整以下选项：
   • 降低分辨率以提高帧率
   • 禁用不必要的视觉效果
   • 调整纹理质量

💡 技巧提示：低端配置电脑建议关闭"动态光影"和"抗锯齿"选项以获得更流畅的游戏体验。

4.2 保存同步设置

为确保您的游戏进度在多设备间同步：

1. 在REPENTOGON控制台中，进入"Game Options"
2. 选择"Save Management"选项卡
3. 启用"Steam Cloud Sync"选项
4. 点击"Sync Now"手动触发一次同步

五、问题解决篇：常见故障排除

5.1 启动问题排查流程

启动器无法打开 → 检查系统权限 → 重新下载启动器 → 检查杀毒软件拦截
   ↓
游戏启动后无反应 → 验证游戏文件完整性 → 检查REPENTOGON日志 → 重新安装
   ↓
模组功能异常 → 更新至最新版本 → 检查冲突模组 → 重置配置文件

5.2 成就丢失问题解决

如果安装REPENTOGON后发现成就丢失：

1. 从游戏标题屏幕按~键打开REPENTOGON控制台
2. 导航到"Tools" -> "Game Options"
3. 选择"Save Management"选项卡
4. 点击"从Repentance导入"按钮恢复成就

5.3 验证安装成功的方法

启动游戏后，通过以下方式确认REPENTOGON安装成功：

• 游戏标题栏显示"Binding of Isaac: Repentance (+ REPENTOGON vX.X.X)"
• 游戏目录中出现zhl.log和repentogon.log日志文件
• 按~键可以打开REPENTOGON控制台

通过本完整指南，您已掌握REPENTOGON的安装、配置和优化技巧。无论您是新手还是资深玩家，这些步骤都能帮助您顺利体验这款强大模组带来的增强功能。如有其他问题，请查阅项目文档或寻求社区支持。