BepInExPack_Valheim

Valheim 的 BepInExPack

这是 BepInEx 5.4.23.3 为Valheim预配置的整合包。它由Valheim社区的Azumatt、Vapok和Margmas维护。与上游BepInEx的具体改动和差异可见于 Azumatt的仓库如果需要对整合包进行更改，但BepInEx本身不需要更新，通常我们会为Thunderstore递增版本号。例如：[mono]5.4.2202[/mono]，这并不意味着BepInEx本身需要更新，很可能只是对游戏做了小幅改动，或者描述等内容需要调整。

BepInEx 是一个用于 Unity 模改的通用框架。
BepInEx 包含用于以下用途的工具和库：

[]在启动时将自定义代码（以下简称插件*）加载到游戏中；

在无需修改原始游戏文件的情况下，修补游戏内的方法、类甚至整个程序集；
配置插件并将游戏日志输出到控制台或文件等目标位置；
* 管理插件依赖。

BepInEx当前 GitHub上最受欢迎的Unity模组工具之一.

### 本包内容

此整合包已预配置，可直接用于英灵神殿模组制作。 
特别是，与基础 BepInEx 版本相比的变化包括：

• 已添加预配置的 [mono]BepInEx.cfg[/mono]，启用了控制台并为模组设置了正确的入口点。
  

添加了在Linux机器上或通过r2modman运行游戏和专用服务器所需的脚本
已编辑BepInEx预加载器，以帮助部分模组进行修补
在链式加载器加载后，强制将 Valheim 游戏类的 isModded 标志设为 true。
Thunderstore版本的包会输出到控制台，因为它与实际BepInEx版本是分开的，如果只需要更改站点的话。

问题、疑问等。
🔴重要❗🔴
不要在这时寻求帮助 BepInEx 官方 Discord

《英灵神殿》社区运行的是定制版BepInEx，官方BepInEx团队无法提供帮助。

如果你在使用BepInEx时遇到一般性问题、在Valheim上运行的模组出现问题，或不确定是哪一种情况，请从下列任意一位维护者的Discord服务器寻求帮助。

### 当前 Valheim 的 BepInEx 维护者：
阿祖玛特
马格玛斯
* 瓦波克

### 安装（游戏，自动）

这是在该游戏上安装BepInEx的推荐方法。

• 下载并安装 盖尔, 雷霆商店模组管理器 或 r2modman
  

点击 使用模组管理器安装 页面顶部的按钮
3. 通过模组管理器运行游戏

### 安装（服务器，自动）

有一些托管专用服务器支持简单且自动的 BepInEx 安装。 
以下是已知内容的列表（随着了解更多，列表会持续更新）。 
注：部分链接可能是推广链接

[](https://valhost.net/?ref=30893)

[](https://valheimserverhosting.com/?via=bepinex)

[](https://link.xgamingserver.com/BepInEx)


### 安装（手动）

如果你要手动安装，请按以下步骤操作

• 请先进行全新安装。务必再三确认你的英灵神殿文件夹是 干净且未修改
  

2. 点击上方包页面上的“手动下载”按钮以下载压缩包，它看起来像这样：

   
3. 保存到你的电脑后，将压缩包解压到一个文件夹中。 不要解压到游戏文件夹中。
4. 将 [mono]BepInExPack_Valheim[/mono] 文件夹中的内容移动到 [mono]<Steam 安装位置>\steamapps\common\Valheim[/mono]。

    BepInExPack 的移动内容Valheim](https://valtools.org/resources/images/DragNDropManualInstall.png)
5. 请检查是否已正确安装。
    如果操作正确，你的文件夹将如下所示

   
5. 请按照以下Windows或Linux游戏运行说明操作：

#### 配置（Windows）

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

#### 配置（Linux，游戏）

• 让[mono]开始游戏为bepinex.sh[/mono]可执行文件添加执行权限，使用[mono]chmod u+x start游戏BepInEx.sh[/mono]。
  

2. 在Steam中，进入游戏属性，将游戏的启动参数设置为
   

开始游戏bepinex.sh %command%

给高级用户的提示：你可以更改 [mono]./start游戏将bepinex.sh[/mono]改为脚本的完整路径。这样你就可以完全在游戏文件夹之外安装此整合包。
3. 通过Steam运行游戏。

此时此刻，你不会看到任何明确迹象表明 BepInEx 正在运行。
建议通过安装一个简单的插件来测试，例如 来自 BepInEx.Utility 的 MessageCenter.

#### 配置（Linux，服务器）

本指南假定您已具备足够的Linux操作知识。 
如果没有，建议你使用一个开箱即支持该功能的服务器主机。

• 设置[mono]开始服务器bepinex.sh[/mono] 可执行文件，用 [mono]chmod u+x start服务器bepinex.sh[/mono]。
  

2. 编辑 [mono]start服务器[mono]bepinex.sh[/mono] 来更改启动参数，就像使用 Valheim 自带的启动脚本一样。
3. 运行 [mono]start服务器bepinex.sh[/mono] 来启动服务器。

如果操作正确，你将在终端中看到 BepInEx 引导信息。


### 正在检查 BepInEx 版本和加载状态

如果BepInEx成功加载到游戏中，你应该会在任务栏中看到游戏旁边启动了一个BepInEx控制台窗口（Windows）：

已叠加：


已扩展：


确认控制台中只有灰色/白色文本（信息和消息），没有错误或问题。红色是致命错误，暗红色是错误，黄色是警告，深灰色是调试信息，其他颜色都是自定义消息。



### 实用链接

• BepInEx：编写基础插件教程
  

BepInEx：实用的模组制作插件
BepInEx：在运行时修补游戏方法
英灵神殿模组讨论Discord群组
英灵神殿 Wiki 或 英灵神殿模组维基来源