REPENTOGON开源模组扩展器安装与配置指南

REPENTOGON作为《以撒的结合：忏悔+》的开源模组扩展工具，提供了强大的游戏自定义能力和功能增强。本指南将通过"准备-部署-进阶"三阶架构，帮助你快速完成环境配置并掌握高级功能，实现模组开发与游戏体验的全面升级。

一、环境准备：系统检查与资源获取

验证系统兼容性

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

• 操作系统：Windows 10/11 64位或Linux（包括Steam Deck桌面模式）
• 游戏版本：《以撒的结合：忏悔+》最新Steam官方版或v1.9.7.12.J273版本
• 硬件配置：至少4GB内存，500MB可用存储空间

⚠️注意：确保游戏已通过Steam正常运行过一次，以生成必要的配置文件和存档目录。

获取REPENTOGON资源

获取项目源代码有两种方式：

通过Git克隆（推荐）：

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

手动下载： 访问项目仓库下载最新发布的源代码压缩包，解压至非中文路径的本地目录。

预检查清单

在继续安装前，请完成以下检查：

• [ ] 游戏路径不含中文和特殊字符
• [ ] 已关闭任何游戏修改器或作弊软件
• [ ] 确保Steam云同步功能已启用
• [ ] 备份现有存档文件（位于文档/My Games/Binding of Isaac Rebirth）

💡技巧：使用md5sum命令验证下载文件的完整性，确保与项目提供的校验值一致。

二、部署实施：多平台安装流程

Windows系统：启动器向导安装

1. 启动器配置 进入项目目录，双击运行REPENTOGONLauncher.exe，启动器将自动引导你完成初始设置：

   • 选择《以撒的结合》游戏安装路径
   • 确认模组存储目录
   • 选择是否创建桌面快捷方式

2. Steam启动配置 为确保通过Steam正常启动REPENTOGON：

   1. 在Steam库中右键点击《以撒的结合：重生》
   2. 选择"属性"，切换到"常规"选项卡
   3. 在"启动选项"中输入：

   "D:\path\to\REPENTOGONLauncher.exe" --isaac=%command%
   

   其中D:\path\to替换为你的实际安装路径

   

Linux/Steam Deck系统：终端指令部署

1. 文件部署 在Steam中找到游戏属性，通过"浏览本地文件"进入安装目录，执行以下命令：

   # 创建启动器目录
   mkdir -p REPENTOGONLauncher
   # 解压启动器文件到目标目录
   unzip REPENTOGONLauncher.zip -d REPENTOGONLauncher/
   # 设置执行权限
   chmod +x REPENTOGONLauncher/REPENTOGONLauncher.exe
   

   

2. 启动参数配置 在Steam启动选项中输入以下命令：

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

   

⚠️注意：Steam Deck用户需要先切换到桌面模式，完成配置后可返回游戏模式运行。

环境验证步骤

安装完成后，通过以下步骤验证环境是否配置正确：

1. 启动游戏，观察启动画面是否显示REPENTOGON版本信息
2. 按~键打开控制台，输入version命令查看版本详情
3. 检查repentogon/logs目录下是否生成正常的启动日志
4. 尝试加载一个模组，确认模组功能正常运行

三、进阶配置：功能优化与扩展应用

存档管理与迁移

REPENTOGON提供强大的存档管理功能，支持忏悔与忏悔+版本间的进度迁移：

1. 在游戏标题界面按~键打开控制台
2. 通过左侧菜单导航至"工具" > "游戏选项"
3. 切换到"存档管理"选项卡
4. 点击"从忏悔导入"按钮迁移成就和解锁内容

💡技巧：定期使用"导出存档"功能创建备份，防止意外数据丢失。

Basement Renovator集成配置

为实现地图编辑器与REPENTOGON的无缝协作：

1. 确保Basement Renovator版本≥3.3.1
2. 打开Basement Renovator，导航至"文件" > "设置路径"
3. 在".exe路径"字段中指定REPENTOGON启动器路径：

   C:\path\to\REPENTOGONLauncher\REPENTOGONLauncher.exe
   

性能优化建议

针对不同硬件配置，可通过以下方式提升性能：

1. 图形优化：

   • 在控制台输入render.setQuality(2)降低渲染质量
   • 禁用不必要的视觉效果：render.disablePostProcessing(true)

2. 内存管理：

   • 限制同时加载的模组数量
   • 定期使用lua.collectgarbage()命令清理内存

3. 启动参数优化：

   • 添加--lowmemory参数减少内存占用
   • 使用--nolog参数禁用详细日志记录（仅在问题解决后使用）

官方资源与社区支持

获取更多帮助和资源：

• 项目文档：docs/index.md
• API参考：docs/repentogon.md
• 示例模组：docs/examples/
• 社区论坛：通过游戏内"帮助"菜单访问

通过以上步骤，你已完成REPENTOGON的完整安装与配置。这个强大的开源工具将为你的《以撒的结合》体验带来无限可能，无论是创建独特模组还是优化游戏体验，都能提供坚实的技术支持。