Valheim Mod 安装指南
本指南涵盖在您的 Valheim 专用服务器上安装 BepInEx mod 框架、从 Thunderstore 和 Nexus Mods 添加 mod,以及配置 Valheim Plus 等热门 mod 包。有关基本服务器设置和连接说明,请参阅 Valheim 专用服务器设置指南。
BepInEx Mod 框架
BepInEx 是 Valheim 的标准 mod 加载器。几乎所有 Valheim mod 都需要它。它必须安装在服务器根目录中。
在服务器上安装 BepInEx
- 从 Thunderstore 页面或 BepInEx GitHub 发布页面下载最新的 BepInEx for Valheim 版本。专用服务器请使用 Unix/Linux x64 版本。
- 解压下载的压缩包。您应该会看到一个
BepInEx/文件夹和一个doorstop_libs/文件夹,以及根目录下的一些文件。 - 通过 SFTP 连接到您的服务器(请参阅 如何通过 SFTP 上传文件)。
- 将所有解压的文件和文件夹上传到服务器根目录(即包含
valheim_server.x86_64的目录)。 - 从 GPanel 重启服务器。BepInEx 将在首次运行时生成其文件夹结构。
首次安装 BepInEx 重启后,您将看到一个
BepInEx/ 文件夹,其中包含 plugins/、config/ 和 patchers/ 子目录。所有 mod 都放入 BepInEx/plugins/ 中。
验证 BepInEx 是否正常工作
重启后,在 GPanel 中检查服务器控制台输出,查看 BepInEx 初始化消息。您应该会看到类似以下的内容:
[Message: BepInEx] BepInEx 5.x.x.x - valheim_server
[Info : BepInEx] Loading [BepInEx.Chainloader]
如果这些消息没有出现,请参阅 Valheim 故障排除获取解决方案。
安装 Mod
安装 BepInEx 后,大多数插件的添加流程相同:
- 从 Thunderstore.io 或 Nexus Mods 下载 mod。
- 解压下载的压缩包。
- 通过 SFTP 将 mod 的
.dll文件(以及所需的配置或资源文件)复制到服务器的BepInEx/plugins/目录中。 - 重启服务器。
客户端 mod 与服务端 mod:某些 mod 必须同时安装在服务器和每位玩家的客户端上,其他则仅需安装在服务端。请查看 mod 的文档以确认需要安装的位置。
Mod 目录结构
安装几个 mod 后,您服务器的 BepInEx 目录应如下所示:
/ (server root)
BepInEx/
config/ ← mod configuration files (auto-generated on first run)
plugins/ ← place mod .dll files here
patchers/ ← preloader patchers (rarely used)
doorstop_libs/ ← BepInEx doorstop library
Valheim Plus
Valheim Plus 是最受欢迎的服务器修改包之一。它为游戏机制、玩家属性、建造等方面提供了丰富的配置选项。
安装 Valheim Plus
- 从 Thunderstore 页面或 GitHub 发布页面下载最新的 Valheim Plus 服务器版本。请确保下载 Unix/Linux 服务器版本。
- 解压压缩包。它包含 BepInEx 和 Valheim Plus 插件。
- 通过 SFTP 将所有内容上传到服务器根目录,如提示则覆盖现有的 BepInEx 文件。
- 重启服务器。配置文件将生成在:
BepInEx/config/valheim_plus.cfg - 通过 SFTP 编辑
valheim_plus.cfg,启用和配置您想要的功能。每个部分顶部都有一个enabled开关。 - 修改配置后重启服务器。
Valheim Plus 要求服务器和客户端版本一致。玩家必须在自己的游戏客户端上安装相同版本的 Valheim Plus 才能连接。版本不匹配将导致连接失败。
热门服务器兼容 Mod
| Mod | 描述 | 安装位置 |
|---|---|---|
| Epic Loot | 添加魔法物品掉落和词缀 | 服务器 + 客户端 |
| Plant Everything | 增强的农业和种植选项 | 服务器 + 客户端 |
| Jotunn (JVL) | 许多 mod 所需的 mod 框架/库 | 服务器 + 客户端 |
| Server Characters | 将角色数据锁定在服务器上以防止作弊 | 仅服务器 |
| WardIsLove | 扩展的守护/所有权管理 | 服务器 + 客户端 |
Mod 兼容性:Valheim 游戏更新后,mod 可能会失效,直到作者发布更新版本。更新游戏服务器之前,请务必检查 mod 页面上的兼容性说明。如果服务器在更新后变得不稳定,请移除最近添加的 mod,然后逐个重新添加以找出问题原因。
相关文章
- Valheim 专用服务器设置指南 — 启动配置、连接和世界存档
- Valheim 故障排除 — 常见问题和解决方案
- 如何通过 SFTP 上传文件
如果您在安装 mod 时遇到问题,请查看 Valheim 故障排除指南或提交支持工单,并附上您服务器的 GPanel 详细信息以及您正在尝试安装的 mod。