BepInExPack_Valheim

BepInExPack_Valheim

适用于 Valheim 的 BepInEx 整合包。已预配置正确的模组入口点以及社区首选默认值。

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 的方式。

  1. 下载并安装 GaleThunderstore Mod Managerr2modman
  2. 点击页面顶部的 Install with Mod Manager 按钮
  3. 通过模组管理器运行游戏

安装(服务器,自动)

有一些托管专用服务器支持简单自动的 BepInEx 安装。 以下是已知的列表(列表会随了解情况更新)。 注意:部分链接可能是推广链接

ValHost

ValheimServerHosting

XGamingServer

安装(手动)

如果您要手动安装,请执行以下操作

  1. 从干净安装开始。再三确认您的 Valheim 文件夹是干净且未修改的

  2. 点击上方包页面上的 Manual Download 按钮下载压缩包,它看起来像这样:

    手动下载按钮

  3. 下载到电脑后,将压缩包解压到一个文件夹中。不要解压到游戏文件夹中。

  4. BepInExPack_Valheim 文件夹的内容移动到 <Steam 位置>\steamapps\common\Valheim

    移动 BepInExPack_Valheim 的内容

  5. 检查您是否正确安装。 如果操作正确,您的文件夹应该如下所示

    高亮显示

  6. 按照以下 Windows 或 Linux 游戏运行说明操作:

配置(Windows)

无需配置。直接运行游戏即可。如果一切正常,您会看到一个控制台弹出窗口。

配置(Linux,游戏)

  1. 使用 chmod u+x start_game_bepinex.sh 使 start_game_bepinex.sh 可执行。
  2. 在 Steam 中,进入游戏属性,将游戏启动参数设置为
	./start_game_bepinex.sh %command%

高级用户注意:您可以将 ./start_game_bepinex.sh 改为脚本的完整路径。这样您就可以将此包完全安装在游戏文件夹之外。 3. 通过 Steam 运行游戏。

此时您不会看到 BepInEx 是否工作的任何明确指示。 建议安装一个简单的插件来测试,例如 BepInEx.Utility 中的 MessageCenter

配置(Linux,服务器)

本指南假设您具备足够的 Linux 操作知识。 如果没有,建议您使用开箱即用支持此功能的服务器托管商。

  1. 使用 chmod u+x start_server_bepinex.sh 使 start_server_bepinex.sh 可执行。
  2. 编辑 start_server_bepinex.sh 来更改启动参数,就像您使用 Valheim 自带的启动脚本一样。
  3. 运行 start_server_bepinex.sh 启动服务器。

如果操作正确,您将在终端中看到 BepInEx 引导消息。

检查 BepInEx 版本和加载状态

如果 BepInEx 成功加载到游戏中,您应该会在任务栏中看到游戏旁边启动了一个 BepInEx 控制台窗口(Windows):

堆叠状态: 控制台窗口任务栏

展开状态: 控制台窗口任务栏2

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

控制台窗口

实用链接