REPENTOGON完整安装指南：3步开启以撒的结合脚本扩展新时代

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

想要为《以撒的结合：悔改》注入全新活力吗？REPENTOGON脚本扩展器正是你需要的终极工具！作为《以撒的结合：悔改》社区最强大的脚本扩展器，REPENTOGON通过LibZHL框架直接挂钩游戏，提供了前所未有的Lua API扩展、性能优化和错误修复功能。无论你是想要体验更多模组内容，还是计划开发自己的游戏扩展，这份完整的安装指南都能帮你轻松上手。

🚀 快速开始：REPENTOGON基础安装

安装REPENTOGON的第一步是获取启动器。你可以通过两种方式获得REPENTOGON启动器：手动下载或从旧版本自动升级。

获取启动器的两种方法

手动下载方式：

• 下载最新版本的REPENTOGON启动器
• 将启动器解压到你选择的目录中，不要直接解压到以撒的游戏安装文件夹内，也不要放在游戏安装目录下的repentogon文件夹中
• 这些文件夹后续需要被启动器访问或修改，因此启动器不能存放在这些位置

自动升级方式：

• 如果你之前安装了旧版本的REPENTOGON，它可能已经通知你有关Repentance+的更新，并自动下载了启动器，同时在桌面上创建了快捷方式
• 如果需要，你可以在游戏安装目录的REPENTOGONLauncher子文件夹中找到启动器文件

Windows平台安装步骤

运行REPENTOGONLauncher.exe或你的REPENTOGON快捷方式，启动器将打开初始设置窗口。启动器会在启动时检查更新，请尽量保持启动器最新以确保功能正常。

启动器的初始设置窗口会要求你指定《以撒的结合：悔改》可执行文件的位置。这个位置可能会被自动检测到。如果没有自动检测到，点击Select executable...按钮，找到你的isaac-ng.exe文件，然后点击Next继续。

如果启动器提示你的以撒安装版本与REPENTOGON不兼容，请注意你必须拥有以下任一版本：

• 《以撒的结合：悔改》v1.9.7.12.J273
• Steam上最新的官方《以撒的结合：悔改》版本
• 如果刚刚发布了新更新，请尝试更新启动器；如果这不起作用，请耐心等待！我们可能需要最多一天的时间为该版本发布新的补丁。

如果安装失败，或者启动器报告安装已损坏，你可能需要尝试以下方法之一：

• 在主启动器窗口中点击Choose exe重新进行首次设置
• 在主启动器窗口中点击Advanced options...，然后选择Re-install/Repair REPENTOGON
• 如果以上两种方法都失败，请导航到游戏的安装文件夹，删除repentogon子文件夹，然后重新启动启动器

🔧 高级配置：通过Steam启动REPENTOGON

如果你希望，你可以配置Steam启动以撒时运行REPENTOGON启动器。这对于Steam远程播放与REPENTOGON正常工作是必需的！

在Steam中，导航到《以撒的结合：重生》。点击屏幕右侧的齿轮图标，选择属性。这将打开一个新窗口。

在常规标签下，找到启动选项字段，输入"(REPENTOGONLauncher.exe的完整路径)" --isaac=%command%

重要提示：(REPENTOGONLauncher.exe的完整路径)必须替换为你的REPENTOGON启动器可执行文件的完整路径。请参考下面的示例。

如果你从旧版本的REPENTOGON自动下载了启动器，你的启动器文件可能位于游戏安装目录下，可以通过选择Steam菜单中的"已安装文件"来找到。

🐧 Linux/Steam Deck用户专属指南

对于Steam Deck用户，需要先退出到桌面模式。在Steam中，导航到《以撒的结合：重生》。点击屏幕右侧的齿轮图标，选择属性。这将打开一个新窗口。

导航到已安装文件，然后点击浏览。这将打开游戏的安装目录。在以撒的安装目录中创建一个名为REPENTOGONLauncher的新文件夹。

如果该文件夹已经存在并且已经包含REPENTOGONLauncher.exe文件，你可能已经从旧版REPENTOGON更新器中自动下载了启动器。这是可以的，你可以跳过下一步。

下载REPENTOGON启动器，然后将REPENTOGON启动器解压到新创建的REPENTOGONLauncher子目录中。

返回到之前的Steam菜单并导航到常规。在启动选项字段中，复制并粘贴以下内容：

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

现在通过Steam启动以撒将会启动REPENTOGON启动器。

🛠️ 开发者构建：从源代码编译REPENTOGON

如果你是一名开发者，或者想要从源代码构建REPENTOGON，这里提供了完整的构建指南。项目的性质要求我们使用与游戏相同的编译器，因此明确需要Windows系统以及以下工具：

• CMake 3.13或更高版本
• Git
• Visual Studio 2019或更高版本

CMake配置步骤

我们假设在整个教程中使用Git Bash以及CMake GUI。

步骤1：递归克隆仓库

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

步骤2：启动CMake

步骤3：在"Where is the source code"下，导航到克隆仓库的根目录（在大多数情况下名为REPENTOGON）。

步骤4：在"Where to put the binaries"下，选择任何文件夹。这是生成文件将存放的位置。

步骤5：在CMake GUI的底部，点击"Configure"。

• 如果这是第一次构建，系统会提示你输入更多信息
• 编译器必须与你的Visual Studio版本匹配
• 平台必须是Win32
• 将所有其他选项保留为默认值，然后按Finish

步骤6：配置完成后，点击"Generate"。这将在你之前指定的文件夹中创建一个.sln文件。

步骤7：在Visual Studio中打开生成的.sln文件。

步骤8：构建项目。除非你是开发者，否则我们建议使用Release模式以获得更好的性能。

步骤9：构建完成后，将resources、resources-repentogon、dsound.dll、freetype.dll、libzhl.dll、Lua5.4.dll和zhlREPENTOGON.dll复制到游戏的文件夹中。

可选地，可以将ISAAC_DIRECTORY设置设置为游戏的根目录，以便在构建后自动复制这些文件。

🎮 验证安装：确认REPENTOGON正常运行

安装完成后，你可以通过几种方式验证REPENTOGON是否成功运行：

游戏内控制台验证

启动游戏后，打开"Tools"菜单，选择"Debug Console"。如果看到"REPENTOGON Console"窗口，说明安装成功。你可以输入"help"命令查看可用功能。

日志文件检查

安装成功后，游戏目录会自动生成三个重要的日志文件：

• zhl.log- LibZHL框架日志
• repentogon.log- REPENTOGON核心日志
• dsound.log- 音频模块日志

如果这三个文件都正常生成，说明REPENTOGON已经成功加载。

功能测试

你还可以尝试使用一些REPENTOGON特有的功能，如存档导入、高级调试命令等，来确认所有模块正常工作。

❓ 常见问题与故障排除

安装失败怎么办？

如果遇到安装失败，按以下步骤排查：

1. 重新检查游戏可执行文件路径是否正确
2. 使用修复安装功能
3. 清理旧的安装文件后重试
4. 必要时完全重新安装

Steam远程播放不工作？

确保你已经按照"通过Steam启动REPENTOGON"部分的说明配置了启动选项。这是Steam远程播放正常工作的必要条件。

Linux/Steam Deck特殊问题

对于Linux和Steam Deck用户，特别注意文件权限设置。确保所有相关文件都有正确的执行权限。如果遇到问题，尝试在终端中手动运行启动器以查看详细错误信息。

📚 深入学习：REPENTOGON核心功能

REPENTOGON不仅仅是一个简单的脚本扩展器，它提供了完整的Lua API扩展系统。你可以通过官方文档深入了解所有可用功能。

Lua API文档：REPENTOGON对Lua API进行了大量添加和修改，并增加了许多新功能。你可以在官方文档中找到完整的API参考。

核心模块：如果你想要深入了解REPENTOGON的工作原理，可以查看以下核心模块：

• Lua API扩展：libzhl/functions/ - 所有Lua函数扩展的源代码
• 游戏钩子系统：include/HookSystem.h - 了解REPENTOGON如何与游戏交互
• 脚本扩展核心：repentogon/LuaInterfaces/ - Lua接口实现的核心代码

🎉 开始你的REPENTOGON之旅

现在你已经掌握了REPENTOGON的完整安装和配置方法。无论你是普通玩家想要体验更多模组内容，还是开发者想要创建自己的游戏扩展，REPENTOGON都能为你提供强大的支持。

记住，正确的安装是享受优质游戏体验的第一步。如果在使用过程中遇到任何问题，记得参考官方文档或社区讨论，总有解决方案等着你。现在，让我们一起开启《以撒的结合：悔改》的全新旅程吧！

官方文档：docs/docs/install.md - 获取最新的安装指南和详细说明核心功能源码：repentogon/LuaInterfaces/ - 深入了解Lua接口实现

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