零基础避坑指南：REPENTOGON模组安装全流程，5分钟解决90%玩家遇到的问题

模组安装是提升《以撒的结合：悔改》游戏体验的关键步骤，而REPENTOGON作为最强模组之一，能带来大量错误修复、额外功能和性能优化。本指南将带你避开常见陷阱，轻松完成模组安装，让你快速享受增强后的游戏体验。

一、为什么选择REPENTOGON？——模组价值解析

REPENTOGON是一款革命性的《以撒的结合：悔改》EXE模组，它通过API级别的增强，为游戏提供了诸多实用功能：

• 错误修复：解决原版游戏中存在的各类BUG，提升游戏稳定性
• 性能优化：优化游戏运行效率，减少卡顿和加载时间
• 功能扩展：增加新的游戏机制和功能，丰富游戏玩法
• 兼容性强：支持最新的Repentance+版本，与大多数主流模组兼容

二、安装前准备工作

1. 兼容性检测

在安装REPENTOGON之前，请确保你的系统和游戏满足以下条件：

项目	最低要求	推荐配置
操作系统	Windows 7/8/10 64位 或 Linux	Windows 10/11 64位 或 SteamOS
游戏版本	《以撒的结合：悔改》v1.7.9以上	《以撒的结合：悔改》最新版本
存储空间	至少2GB可用空间	5GB以上可用空间
其他	.NET Framework 4.7.2	.NET Framework 4.8

小贴士：你可以在Steam游戏库中右键点击《以撒的结合：悔改》，选择"属性"，在"本地文件"选项卡中查看游戏版本。

2. 获取REPENTOGON启动器

有两种方式获取REPENTOGON启动器：

手动下载

1. 访问项目仓库：git clone https://gitcode.com/gh_mirrors/re/REPENTOGON
2. 进入下载目录，找到启动器安装包

自动升级 如果你之前安装过旧版REPENTOGON，系统会自动检测更新并提示下载最新启动器

风险提示：请确保从官方渠道获取启动器，避免下载第三方修改的版本，以防恶意软件感染。

三、开始安装：不同平台操作指南

Windows与Linux平台安装对比

步骤	Windows平台	Linux/Steam Deck平台
1. 创建目录	无需专门创建，建议安装在非系统盘	切换到桌面模式，在游戏安装目录创建"REPENTOGONLauncher"文件夹
2. 解压文件	将启动器解压到任意目录（不要直接放入游戏文件夹）	将下载的启动器文件解压到创建的"REPENTOGONLauncher"文件夹
3. 运行启动器	双击REPENTOGONLauncher.exe	需通过Steam启动选项配置
4. 配置游戏路径	启动器会自动检测或手动选择isaac-ng.exe	需设置Steam启动选项

Windows平台详细步骤

操作目标：正确运行启动器并配置游戏路径

1. 双击REPENTOGONLauncher.exe或桌面快捷方式
2. 首次运行会打开初始设置窗口并检查更新
3. 如果系统未能自动检测到游戏路径，点击"选择可执行文件"并定位到isaac-ng.exe

操作目标：配置Steam启动选项（如需通过Steam启动）

1. 在Steam游戏库中右键点击《以撒的结合：悔改》，选择"属性"
2. 在"启动选项"字段中输入："REPENTOGONLauncher.exe完整路径" --isaac=%command%

图：游戏模组安装之Windows平台Steam启动选项设置界面

Linux/Steam Deck平台详细步骤

操作目标：创建启动器目录并解压文件

1. 切换到桌面模式
2. 在游戏安装目录中创建名为REPENTOGONLauncher的新文件夹
3. 将下载的启动器文件解压到该子目录中

图：游戏模组安装之Linux平台启动器文件结构示例

操作目标：配置Steam启动选项

1. 在Steam的游戏属性中找到"启动选项"字段
2. 复制并粘贴以下命令：

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

图：游戏模组安装之Linux平台Steam启动选项配置界面

备选方案：如果上述命令不起作用，尝试手动创建启动脚本，设置正确的路径后再配置Steam启动选项指向该脚本。

四、安装验证与常见问题解决

验证安装是否成功

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

• 游戏标题栏显示"Binding of Isaac: Repentance (+ REPENTOGON vX.X.X)"
• 游戏目录中出现zhl.log和repentogon.log日志文件
• 所有模组功能正常运作，无错误提示

常见问题解决方案

问题1：启动器报告安装损坏

• 解决方案：重新启动启动器并接受所有更新提示；在主窗口中点击"选择可执行文件"重新进行初始设置；点击"高级选项"然后选择"重新安装/修复REPENTOGON"

问题2：成就丢失

• 解决方案：从标题屏幕按~键打开REPENTOGON控制台，导航到"工具" -> "游戏选项"，选择"保存管理"选项卡，点击"从Repentance导入"来恢复丢失的成就

图：游戏模组安装之成就恢复功能界面

五、拓展应用与优化

使用Basement Renovator工具

操作目标：配置Basement Renovator与REPENTOGON配合使用

1. 确保Basement Renovator版本至少为3.3.1
2. 在Basement Renovator中，导航到"File" -> "Set Paths"
3. 将".exe路径"更改为指向您的REPENTOGONLauncher.exe

图：游戏模组安装之Basement Renovator路径配置界面

模组冲突解决方案

1. 冲突检测：启动游戏时留意启动器报告的模组冲突提示
2. 解决策略：
   • 禁用冲突模组中功能重叠的部分
   • 更新模组到最新版本
   • 调整模组加载顺序（在模组管理器中拖拽调整）
3. 冲突排查：如果无法确定冲突来源，可以通过禁用一半模组的方式逐步排查

小贴士：保持模组数量在合理范围内（建议不超过20个），可以减少冲突概率并提高游戏性能。

性能优化建议

1. 图形设置：降低分辨率和特效等级可以显著提升帧率
2. 模组管理：定期清理不再使用的模组，禁用不常用功能
3. 缓存清理：定期删除游戏目录下的缓存文件
4. 后台程序：关闭不必要的后台程序，释放系统资源
5. 驱动更新：保持显卡驱动为最新版本

通过以上步骤，你已经成功安装并配置了REPENTOGON模组。现在，你可以享受增强后的《以撒的结合：悔改》游戏体验，探索更多模组功能带来的乐趣！如果遇到其他问题，可以查阅官方文档或在社区寻求帮助。