一篇关于如何在 PC 上为 R.E.P.O. 下载和安装模组的指南，使用 Thunderstore、Vortex，或不使用任何模组管理器。
R.E.P.O. 是一款 Unity 游戏，其模组本质上是 BepInEx 插件。几乎所有内容都在 Thunderstore 上，Nexus Mods 上的选择要少得多，如果你已经习惯用 Vortex 管理，它也可以帮你处理这部分。
我们安装的示例是 SharedHostUpgrades，它能让全队共享升级，而不只是购买升级的玩家自己受益。
系统需求
- 运行 Windows 10 或更高版本、或 Linux 的 PC。
- Steam 上的 R.E.P.O.。
- 一般模组列表大约需要 500 MB 的空闲空间。
- 如果走手动安装路线,需要 7-Zip 或类似工具。
R.E.P.O. 没有反作弊机制，所以给它安装模组没有被封禁的风险。
R.E.P.O. 模组来自哪里
主要有两个来源,规模并不对等。
Thunderstore 几乎是整个社区的聚集地。这里的模组都打包了机器可读的依赖列表,这也是为什么模组管理器能一键安装某个模组及其所需的一切。
Nexus Mods 也有 R.E.P.O. 分区,Vortex 支持它。这里的目录规模要小得多,大多数作者也不会在这里同步发布,但如果你已经在用 Vortex 管理其他游戏,用它来管理这里能找到的模组也是完全合理的选择。
不论用哪种方式，底层的加载器都是一样的：BepInExPack 会在游戏启动时进行挂钩，并从 BepInEx/plugins 加载 .dll 插件。
找到你的游戏文件夹
无论用哪种方法,包括模组管理器方案,你都会需要用到这个文件夹,哪怕只是为了排查问题。
在 Steam 库中右键点击 R.E.P.O.，然后依次点击 管理、浏览本地文件。默认的 Windows 安装路径是：
C:\Program Files (x86)\Steam\steamapps\common\REPO
你应该能看到 REPO.exe 和 REPO_Data。这就是 BepInEx 要放入的文件夹。
方法一 - Thunderstore Mod Manager
这是最常见的推荐方式,也是 Thunderstore 模组页面上 Install with Mod Manager 按钮所链接的方式。
- 安装 Thunderstore Mod Manager。它运行在 Overwolf 上，所以你也会顺带装上 Overwolf。
- 打开它，在游戏列表中选择 R.E.P.O.。
- 选择一个配置文件（profile）。Default 就够用；一旦你有不止一份想管理的模组列表，给每个朋友圈单独建一个命名配置文件会更好。
- 点击 Get mods，搜索 SharedHostUpgrades。
- 点击 Download，然后确认依赖弹窗。BepInExPack 会随之一并安装。
- 点击 Start modded。
警告 - Start modded 是唯一会应用你模组的启动方式。从 Steam 直接启动 R.E.P.O. 会运行原版游戏，几乎每个人都至少中过一次这个招。
方法二 - Gale
Gale 做的是同样的事情,但应用体积更小、速度更快,不需要 Overwolf,而且有正式的 Linux 版本。
- 从 Thunderstore 或 GitHub 下载 Gale。
- 启动它并选择 R.E.P.O.
- 打开 Browse mods，找到 SharedHostUpgrades，点击 Install。
- 点击 Launch game (modded)。
Gale 读写的配置代码与 Thunderstore Mod Manager 和 r2modman 相同，所以在朋友圈内混用不同管理器完全没问题。
方法三 - Vortex
如果你在 Skyrim、Fallout 或其他游戏中已经把 Vortex 当作日常工具,那么用它也值得。要注意的是,Vortex 从 Nexus Mods 拉取内容,而不是 Thunderstore,所以模组选择不同,SharedHostUpgrades 未必在那边能找到。
- 安装 Vortex 并登录你的 Nexus Mods 账号。
- 打开 Games 标签页，搜索 R.E.P.O.，悬停在图标上并点击 Manage。
- Vortex 可能会提示你安装它的 R.E.P.O. 扩展。接受，然后在提示时重启 Vortex。
- 先安装 BepInEx。Vortex 不会替你完成这一步，所以在通过 Vortex 安装插件之前，请按照下面的手动 BepInEx 安装步骤操作。
- 在 Nexus Mods 上找到一个模组，点击 Mod Manager Download，然后在 Vortex 中点击 Install 和 Enable。
- 从 Vortex 或 Steam 启动游戏。Vortex 是直接把文件部署到游戏文件夹中，而不是在启动时注入，所以一旦 BepInEx 就位，正常的 Steam 启动就能生效。
注意 - 最后一点正是 Vortex 与 Thunderstore 系管理器的真正区别所在。Vortex 会把文件永久性地写入磁盘；Thunderstore 系管理器则在游戏文件夹之外维护一份配置文件，并在每次启动时应用它。两种方式都没有错，但不要同时对同一份安装使用这两种方法，因为它们会在 BepInEx/plugins 上互相冲突。
方法四 - 手动安装
分两个阶段,第一阶段只需做一次。
安装 BepInEx：
- 打开 BepInExPack 页面，点击 Manual Download。
- 将压缩包解压到游戏文件夹之外的位置。
- 打开解压出的文件夹，再进入其中的
BepInExPack文件夹。 - 把
BepInExPack的内容复制到你的 R.E.P.O. 文件夹中，使BepInEx、doorstop_config.ini和winhttp.dll与REPO.exe位于同一层级。 - 启动一次游戏然后关闭，这会让 BepInEx 生成
BepInEx/plugins和BepInEx/config。
安装模组：
- 打开 SharedHostUpgrades 页面，点击 Manual Download。
- 解压压缩包。
- 把
.dll复制到REPO\BepInEx\plugins中。
压缩包中的 manifest.json、icon.png 和 README.md 只是 Thunderstore 的打包附属文件，可以不用管。
如果你选择手动安装,依赖关系就需要自己处理。查看该模组 Thunderstore 页面上的 Dependencies（依赖项）部分,并按列出的版本逐一安装每一项。
方法五 - TMC App
这个方法值得了解,但要附带一句实话。TMC App 是我们自己开发的模组管理器和服务器浏览器。它支持一键安装、sandbox(沙盒)(每个游戏可命名的模组配置文件,各自拥有独立的加载顺序和部署方式,无需重新下载即可切换),带实时延迟图表的服务器浏览器,以及 RCON。
R.E.P.O. 目前还不在其支持的游戏列表中。 添加一个游戏只需要四个 JSON 文件,不需要写代码,所以这是个小工作量而非重写,已经列入我们的计划。
需要说明的是,这个应用目前处于非常早期的开发阶段。 它自己的 README 也称其为“部分测试”,我们在这里不会夸大其词。目前它的定位是作为方法一到方法四之外的补充,而不是取代它们。如果你愿意尝试一下,对我们帮助很大,如果能反馈遇到的问题,那帮助就更大了。
它是基于 GPL-3.0 协议的开源项目,地址在 github.com/modcommunity/tmc-app。问题反馈和功能请求请提交到issue 跟踪器,欢迎提交 pull request,仓库中也记录了每个游戏的配置格式,如果你想自己添加 R.E.P.O. 支持也可以参考。
安装方法:
- Linux:一行命令,不需要 root 权限,也不需要包管理器。
curl -fsSL https://raw.githubusercontent.com/modcommunity/tmc-app/main/scripts/install.sh | sh
- Windows:从[发布页面](https://github.com/modcommunity/tmc-app/releases)下载
setup.exe或setup.msi。也有便携版,不过它不会注册启动器条目或tmc://链接处理器。 - macOS:同一个发布页面上的
.dmg文件。
主机端和客户端模组
R.E.P.O. 是合作游戏,所以这一点很重要。
模组大致可以分为三类:
| 类型 | 谁需要它 | 示例 |
|---|---|---|
| 仅主机 | 只有大厅主机需要 | 许多规则和经济调整类模组 |
| 所有人 | 大厅中的每个玩家都需要 | 会给所有人添加物品、敌人或 UI 的模组 |
| 仅客户端 | 只有你自己需要 | 外观装饰、镜头调整、个人体验优化 |
SharedHostUpgrades 改变了升级在全队之间的分配方式,属于共享状态的改动,所以整个房间的人都需要它。
模组的 Thunderstore 简介通常会说明它属于哪一类。如果没有说明,就默认所有人都需要,并为你的队伍导出一个配置文件（profile）。所有 Thunderstore 模组管理器都可以将配置导出为代码或文件,让其他人一键导入。
验证安装是否成功
BepInEx 会在游戏旁边打开一个控制台窗口。启动过程中留意这个窗口,你会看到每个插件按名称和版本被加载的记录。
如果完全没有出现控制台,说明 BepInEx 没有加载。原因要么是文件夹结构不对,要么是启动时没有通过你的模组管理器。
对于 SharedHostUpgrades,可以和另一个人一起开一个房间,购买一个升级,然后检查该升级是否对你们两人都生效了。
保持模组更新
Thunderstore 管理器会标记过期的模组,并可一键更新。Vortex 对 Nexus 上的模组也是同样的做法,会在模组列表中显示更新提示。
更新最好在游戏更新后进行,而不要在存档进行到一半时更新,因为版本变化可能会导致存档失效或使房间不同步。如果你想在不冒险破坏现有配置的情况下测试更新,可以先克隆一份配置文件,再对克隆版本进行更新。
卸载
- Thunderstore 管理器:在 Installed 列表中卸载,或者关闭该模组开关以保留文件供以后使用。
- Vortex:禁用或移除该模组,然后在 Mods 下点击 Purge Mods,将其文件从游戏文件夹中清除出去。
- 手动方式:从
BepInEx/plugins中删除对应的.dll或文件夹。
要恢复到干净的游戏状态,请从游戏文件夹中删除 BepInEx、doorstop_config.ini 和 winhttp.dll。Steam 的 验证游戏文件完整性 功能无法做到这一点,因为这些文件都不是 Steam 提供的。
故障排查
游戏能运行,但模组没生效。 是从 Steam 启动的,而不是从模组管理器启动的。
没有出现 BepInEx 控制台窗口。 BepInEx 没有安装在正确的位置。winhttp.dll 必须直接放在 REPO.exe 旁边。
模组在主机端生效,但对其他玩家没有任何效果。 该模组可能需要安装在每一个客户端上。请查看模组页面说明。
游戏更新后立即崩溃。 R.E.P.O. 的更新经常会破坏 BepInEx 模组的兼容性。清空 BepInEx/plugins 以确认这一点,然后等待模组作者跟进更新。
Vortex 和 Thunderstore 模组管理器互相冲突。 只选用其中一个。清除 Vortex 部署的文件,或清空 Thunderstore 的配置文件,但不要让两者同时作用于同一份游戏安装。
Linux 与 Proton。 将 R.E.P.O. 的 Steam 启动选项设置为 WINEDLLOVERRIDES="winhttp=n,b" %command%,以便 BepInEx 能够被加载。Gale 和 r2modman 在通过它们启动游戏时会自动为你完成这一设置。
结语
对绝大多数人来说,答案就是 Thunderstore 管理器:安装它,选择 R.E.P.O.,下载模组及其依赖,然后以 modded 模式启动。如果你已经习惯用 Vortex,那也是合理的选择,只要先自己安装好 BepInEx,并且不要混用两种方式。
多人合作方面稍微用心一点就能省不少麻烦。先弄清楚一个模组是仅主机端、仅客户端,还是所有人都需要,然后把配置文件分享给你的队伍,而不是各自比对模组列表。
如果你愿意帮点忙,TMC App 是开源项目,目前处于早期开发阶段,任何反馈对我们都非常有价值。
另请参阅
我们会尽力让本指南保持最新,但游戏本身、BepInEx 以及各个模组管理器都各自按照自己的节奏更新。如果本文内容与你实际看到的情况不符,欢迎告诉我们,或在本指南的 GitHub 仓库中提交一个 pull request。
如果你有任何问题,或者需要任何与模组相关的帮助,欢迎加入我们的 Discord 服务器!