
BepInExPack_Valheim
适用于 Valheim 的 BepInEx 整合包。已预配置正确的模组入口点以及社区首选默认值。
查看大图Valheim 用 BepInExPack
这是 BepInEx 5.4.23.3 包,但已为 Valheim 预先配置好。它由 Valheim 社区的 Azumatt、Vapok 和 Margmas 维护。与上游 BepInEx 的具体改动和差异可以在 Azumatt 的仓库 中查看。如果需要对包进行更改但 BepInEx 本身不需要更新,通常我们会为 Thunderstore 递增版本号。例如:5.4.2202,这并不意味着 BepInEx 本身需要更新,很可能只是针对游戏的小改动或描述中需要更改的内容等。
BepInEx 是一个用于 Unity 模组开发的通用框架。 BepInEx 包含以下工具和库,用于:
- 在游戏启动时将自定义代码(以下称为插件*)加载到游戏中;
- 在运行时修补游戏内的方法、类甚至整个程序集,而无需修改原始游戏文件;
- 配置插件并将游戏日志输出到控制台或文件等指定位置;
- *管理插件依赖关系。
BepInEx 目前是 GitHub 上最流行的 Unity 模组工具之一。
此包的内容
此包已预先配置好,可直接用于 Valheim 模组开发。 具体来说,与基础 BepInEx 版本相比的改动包括:
- 添加了预配置的
BepInEx.cfg,启用了控制台并为模组设置了正确的入口点。 - 添加了在 Linux 机器上或通过 r2modman 运行游戏和专用服务器所需的脚本
- 编辑了 BepInEx 预加载器以帮助某些模组的修补
- 强制在链式加载器加载后将 Valheim Game 类的 isModded 标志设为 true。
- 包的 Thunderstore 版本会打印到控制台,因为如果只需要网站端改动,它与实际的 BepInEx 版本是分开的。
问题、疑问等
🔴重要❗🔴 请勿在 官方 BepInEx Discord 中寻求帮助
Valheim 社区运行的是 BepInEx 的定制版本,官方 BepInEx 人员无法提供帮助。
如果您遇到 BepInEx 的普遍问题、在 Valheim 上运行的模组问题,或不确定是哪个的问题,请向以下维护者中任意一位的 Discord 寻求帮助。
当前 Valheim 的 BepInEx 维护者:
安装(游戏,自动)
这是推荐的游戏内安装 BepInEx 的方式。
- 下载并安装 Gale、Thunderstore Mod Manager 或 r2modman
- 点击页面顶部的 Install with Mod Manager 按钮
- 通过模组管理器运行游戏
安装(服务器,自动)
有一些托管专用服务器支持简单自动的 BepInEx 安装。 以下是已知的列表(列表会随了解情况更新)。 注意:部分链接可能是推广链接
安装(手动)
如果您要手动安装,请执行以下操作
从干净安装开始。再三确认您的 Valheim 文件夹是干净且未修改的
点击上方包页面上的 Manual Download 按钮下载压缩包,它看起来像这样:

下载到电脑后,将压缩包解压到一个文件夹中。不要解压到游戏文件夹中。
将
BepInExPack_Valheim文件夹的内容移动到<Steam 位置>\steamapps\common\Valheim。
检查您是否正确安装。 如果操作正确,您的文件夹应该如下所示

按照以下 Windows 或 Linux 游戏运行说明操作:
配置(Windows)
无需配置。直接运行游戏即可。如果一切正常,您会看到一个控制台弹出窗口。
配置(Linux,游戏)
- 使用
chmod u+x start_game_bepinex.sh使start_game_bepinex.sh可执行。 - 在 Steam 中,进入游戏属性,将游戏启动参数设置为
./start_game_bepinex.sh %command%
高级用户注意:您可以将 ./start_game_bepinex.sh 改为脚本的完整路径。这样您就可以将此包完全安装在游戏文件夹之外。
3. 通过 Steam 运行游戏。
此时您不会看到 BepInEx 是否工作的任何明确指示。 建议安装一个简单的插件来测试,例如 BepInEx.Utility 中的 MessageCenter。
配置(Linux,服务器)
本指南假设您具备足够的 Linux 操作知识。 如果没有,建议您使用开箱即用支持此功能的服务器托管商。
- 使用
chmod u+x start_server_bepinex.sh使start_server_bepinex.sh可执行。 - 编辑
start_server_bepinex.sh来更改启动参数,就像您使用 Valheim 自带的启动脚本一样。 - 运行
start_server_bepinex.sh启动服务器。
如果操作正确,您将在终端中看到 BepInEx 引导消息。
检查 BepInEx 版本和加载状态
如果 BepInEx 成功加载到游戏中,您应该会在任务栏中看到游戏旁边启动了一个 BepInEx 控制台窗口(Windows):
堆叠状态:

展开状态:

确认控制台中只有灰色/白色文本(Info 和 Message)以排除错误或问题。红色是致命错误,暗红色是错误,黄色是警告,深灰色是调试信息,其他任何颜色都是自定义消息。




还没有人评论,去客户端里说两句吧。
评论在新手盒子客户端中发表,这里同步展示。