REPENTOGON扩展器安装全流程指南

REPENTOGON作为《以撒的结合：悔改》的脚本扩展器，提供超过200个游戏接口支持复杂模组逻辑，通过优化渲染管线提升性能，同时解决原版游戏已知稳定性问题。本文将通过"准备-实施-验收"三阶框架，帮助您在各种环境下完成REPENTOGON扩展器的配置。

一、准备阶段：环境与资源就绪

1.1 系统环境预检

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

检查项	最低配置	推荐配置
内存	4GB	8GB
显卡	支持OpenGL 3.3	支持OpenGL 4.5
操作系统	Windows 7/10 64位或Linux	Windows 10/11 64位或Linux (Proton 6.3+)
运行时依赖	Visual C++ Redistributable 2019	Visual C++ Redistributable 2022

🔧 进阶系统检查命令

# Windows系统检查DirectX版本
dxdiag.exe

# Linux系统检查Proton版本
proton --version  # 应返回6.3或更高版本

# 检查OpenGL支持情况
glxinfo | grep "OpenGL version"  # Linux
# Windows可通过dxdiag的"显示"选项卡查看

1.2 游戏版本验证

确保《以撒的结合：悔改》已更新至最新版本：

1. 打开Steam客户端，进入游戏库
2. 右键点击《The Binding of Isaac: Rebirth》
3. 选择"属性" → "更新"，确保"自动更新"已启用
4. 验证游戏文件完整性："属性" → "本地文件" → "验证游戏文件的完整性"

✅ 验证标准：验证完成后应显示"所有文件均已成功验证"

二、实施阶段：分平台安装配置

2.1 获取源代码

首先克隆REPENTOGON项目仓库：

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

2.2 Windows系统安装步骤

1. 将下载的REPENTOGON压缩包解压到游戏根目录

   • 典型路径：C:\Program Files (x86)\Steam\steamapps\common\The Binding of Isaac Rebirth

2. 配置Steam启动选项：

   • 在Steam游戏库中右键点击游戏 → "属性"
   • 在"启动选项"框中输入：

   "C:\Program Files (x86)\Steam\steamapps\common\The Binding of Isaac Rebirth\REPENTOGONLauncher.exe" --isaac="%command%"
   

REPENTOGON Windows系统Steam启动选项配置界面 - 正确设置可确保扩展器优先加载

2.3 Linux系统安装步骤

1. 将下载的REPENTOGON压缩包解压到游戏根目录

   • 典型路径：~/.steam/steam/steamapps/common/The Binding of Isaac Rebirth

2. 配置Steam启动选项：

   • 在Steam游戏库中右键点击游戏 → "属性"
   • 在"启动选项"框中输入：

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

REPENTOGON Linux系统Steam启动选项配置界面 - 通过sed命令重定向启动器路径

3. 验证启动器文件结构：

REPENTOGON启动器文件结构 - 包含更新程序和核心运行库

✅ 验证标准：游戏目录下应存在repentogon文件夹，且包含REPENTOGONLauncher.exe及相关依赖文件

三、验收阶段：功能验证与故障排查

3.1 基础功能验证

1. 启动游戏，检查标题栏是否显示"REPENTOGON"字样
2. 按F1键打开调试控制台，确认能正常输入命令

REPENTOGON调试控制台 - 成功启动后可通过F1键打开，用于模组调试和命令执行

3.2 路径配置验证

使用Basement Renovator工具验证路径设置：

1. 打开Basement Renovator工具
2. 选择"File" → "Set Paths"
3. 确认所有路径正确指向游戏目录

Basement Renovator路径配置界面 - 正确设置游戏安装目录、资源文件夹和启动器路径

3.3 日志文件检查

查看游戏目录下的日志文件：

• zhl.log：核心框架运行状态记录
• repentogon.log：扩展器功能执行日志

✅ 验证标准：日志文件中应包含"REPENTOGON initialized successfully"条目，无错误或警告信息

🔍 常见故障排查

1. 启动器不加载

   • 检查游戏目录权限是否足够
   • 确认Windows防火墙未阻止启动器执行
   • Linux用户检查可执行权限：chmod +x REPENTOGONLauncher/REPENTOGONLauncher.exe

2. 控制台无法打开

   • 检查键盘F1键是否被其他程序占用
   • 验证repentogon.log中是否有控制台初始化错误
   • 尝试删除repentogon文件夹并重新安装

3. 游戏崩溃

   • 检查游戏版本与REPENTOGON版本兼容性
   • 尝试禁用其他模组后单独运行REPENTOGON
   • 查看崩溃日志定位问题模块

诊断工具箱

系统检查命令

检查内容	Windows命令	Linux命令
DirectX版本	dxdiag.exe	N/A
Proton版本	N/A	proton --version
OpenGL版本	通过dxdiag查看	`glxinfo
游戏文件验证	Steam客户端验证功能	Steam客户端验证功能

快速排查流程图

启动故障排查流程

1. 检查游戏目录是否存在REPENTOGONLauncher.exe → 否：重新安装
2. 检查日志文件是否有错误 → 是：根据错误信息修复
3. 尝试以管理员身份运行 → 问题解决？
4. 检查防火墙设置 → 问题解决？
5. 重新验证游戏文件 → 问题解决？

官方资源

• 安装文档：docs/docs/install.md
• API参考：docs/docs/index.md
• 更新日志：changelog.txt
• 版本信息：version.txt
• 示例项目：docs/docs/examples/