BepInEx整合包（英灵神殿专用）（2026-10-29更新）

鼓掌之间

转自：https://www.nexusmods.com/valheim/mods/3605

本整合包基于BepInEx 5.4.23.6版本制作，专为《英灵神殿》完成预配置，由英灵神殿社区的Azumatt、Vapok与Margmas共同维护。与上游原版BepInEx的具体差异与修改内容可查看Azumatt的代码仓库。若仅需调整整合包内容、无需更新BepInEx本体，我们通常会在Thunderstore平台递增版本号。例如版本号5.4.2202，并不代表BepInEx本体更新，一般只是针对游戏的小幅调整，或是说明文案等内容的修改。

BepInEx是一款通用的Unity游戏MOD开发框架，内置的工具与程序库可实现以下功能：

- 游戏启动时加载自定义代码（以下统称插件）
- 无需修改游戏原始文件，即可对游戏内的方法、类甚至整个程序集打补丁
- 支持插件配置，可将游戏日志输出至控制台、文件等指定位置
- 管理插件依赖关系

BepInEx是目前GitHub上最受欢迎的Unity游戏MOD工具之一。

BepInEx是目前GitHub上最受欢迎的Unity游戏MOD工具之一。

本整合包内容

本整合包已完成预配置，可直接用于《英灵神殿》的MOD安装与开发。相较于原版BepInEx，主要修改如下：

- 新增预配置的BepInEx.cfg文件，默认开启控制台，并设置了正确的MOD加载入口
- 新增必要脚本，支持在Linux设备上运行游戏本体与专用服务器，也支持通过r2modman启动
- 调整BepInEx预加载器，优化部分MOD的补丁加载效果
- 链式加载器加载完成后，强制将《英灵神殿》Game类的isModded（已安装MOD）标记设为真
- 控制台会打印本整合包的Thunderstore平台版本号；若仅需平台端调整，该版本号独立于BepInEx本体版本
- 支持插件使用语义化版本号格式，例如1.2.0-beta.1。原版BepInEx 5会将这类版本号的插件判定为“版本无效”并拒绝加载

问题与咨询

重要提示！
请勿在BepInEx官方Discord服务器寻求帮助

《英灵神殿》社区使用的是定制版BepInEx，BepInEx官方团队无法提供相关技术支持。

如果你遇到BepInEx通用问题、《英灵神殿》MOD运行问题，或是不确定问题归属，均可向下方任意一位维护者的Discord服务器求助。

《英灵神殿》BepInEx整合包现任维护者：
Azumatt

安装方法（游戏端·自动安装）

推荐使用此方式为游戏安装BepInEx。

1. 下载并安装Gale、Thunderstore Mod Manager或r2modman管理器。
2. 点击页面顶部的“使用管理器安装”按钮。
3. 通过MOD管理器启动游戏。

安装方法（服务器端·自动安装）

部分托管式专用服务器支持简单的一键自动安装BepInEx。
以下是已知的服务商列表（后续会持续更新）。
注：部分链接可能为推广链接

- [https://valhost.net/?ref=30893](https://valhost.net/?ref=30893)
- [https://valheimserverhosting.com/?via=bepinex](https://valheimserverhosting.com/?via=bepinex)
- [https://link.xgamingserver.com/BepInEx](https://link.xgamingserver.com/BepInEx)

安装方式（手动安装）

若选择手动安装，请按以下步骤操作：

1. 先确保游戏为纯净安装状态，再三确认你的《英灵神殿》游戏文件夹未经过任何修改
2. 点击上方资源包页面的「手动下载」按钮下载压缩包
3. 下载完成后，将压缩包解压到任意文件夹中，请勿直接解压到游戏文件夹
4. 将BepInExPack_Valheim文件夹内的所有内容，移动到<Steam安装路径>\steamapps\common\Valheim目录下

5. 检查安装是否正确。操作无误的话，你的游戏文件夹结构应如下所示

随后根据你的系统，参照下方对应说明启动游戏：

配置说明（Windows系统）

无需额外配置，直接启动游戏即可。安装正常的话，启动时会弹出一个控制台窗口。

配置说明（Linux系统·游戏端）

1. 执行命令chmod u+x startgamebepinex.sh，为startgamebepinex.sh文件添加可执行权限。
2. 打开Steam，进入游戏属性设置，将游戏的启动参数设置为：
./startgamebepinex.sh %command%
进阶用户提示：你可以将./startgamebepinex.sh替换为脚本的完整路径，这样就可以将整合包完全安装在游戏文件夹之外。
3. 通过Steam启动游戏。

此时你不会看到明显的BepInEx运行提示。
建议安装一个简单的插件来测试，比如BepInEx.Utility中的MessageCenter插件。

配置说明（Linux系统·服务器端）

本指南假设你具备足够的Linux操作基础。
如果没有相关经验，建议使用自带BepInEx支持的服务器托管服务。

1. 执行命令chmod u+x startserverbepinex.sh，为startserverbepinex.sh文件添加可执行权限。
2. 编辑startserverbepinex.sh文件，像修改《英灵神殿》原生启动脚本一样修改启动参数。
3. 运行startserverbepinex.sh启动服务器。

安装正确的话，你会在终端中看到BepInEx的启动引导信息。

配置说明（macOS系统）

《英灵神殿》提供原生macOS版本，如今BepInEx也可在Apple Silicon芯片设备上原生运行。

1. 执行命令chmod u+x start_game_bepinex.sh，为start_game_bepinex.sh脚本添加执行权限
2. 在Steam中打开游戏属性，将游戏启动参数设置为：
/bin/bash ./start_game_bepinex.sh %command%
3. 通过Steam启动游戏

在Apple Silicon设备上，脚本默认以原生模式运行游戏，这是上游官方的默认设置，且官方已在《英灵神殿》上完成测试（对应BepInEx项目issue #1402）。不过我们暂未在本整合包中实测该模式。如果你的MOD无法加载，请打开start_game_bepinex.sh文件，将archpreference参数设为"x86_64"，强制通过Rosetta转译运行。Intel芯片的Mac无需修改任何设置。

查看BepInEx版本与加载状态

若BepInEx成功加载进游戏，Windows系统的任务栏中会出现BepInEx控制台窗口：

- 堆叠状态

- 展开状态


控制台中仅显示灰色/白色文字（信息与通知）则代表无错误问题。红色为致命错误，深红色为普通错误，黄色为警告，深灰色为调试信息，其他颜色均为自定义消息。


实用链接

- BepInEx：基础插件编写教程
- BepInEx：实用MOD开发插件推荐
- BepInEx：运行时游戏方法补丁教程
- 《英灵神殿》MOD开发Discord社区
- 《英灵神殿》维基 或 《英灵神殿》MOD开发维基资源

BepInEx整合包（英灵神殿专用）下载地址：

游客，如果您要查看本帖隐藏内容请回复

乌苏里江

感谢分享

kingji123

感谢分享

x215809842

nEx整合包（英灵神殿专用） ...›参与/回复主题

kabu123kabu

666666666666

aaa47067

66666666666

rsargre

66666666666666

sscyx

6666666666666

闲来无所事

66666666666666666666666666

从小就打猎

66666666666666

Чǔ┋总☆

感谢分享

2372367412@qq

1111111111111111111111111111

rainmanwt

谢谢谢谢谢谢谢谢谢谢谢谢谢谢谢谢谢谢谢谢谢谢谢谢

Crazy吾王

66666666666666666666666666666

ws00318398

6666666666666

fanmao

谢谢分享~~~

wangzhai@vip.qq

66666666666666666666666666

monawang

6666666666666666666

rmllqh

感谢分享

jzh123321

感谢分享！

中华雄风

zzzzzzzzzzzzzzz

dna123

66666666666666666

city成

66666666666666

littlebee0218

66666666666666

aaacbb456

感谢分享！！

ZC452961059

6666666666666666666666

mepeg88

666666666666666666666666666

TartarusJ

6666666666

wangzhai@vip.qq

有没有学习版可以用的

lllwwwjjj1207

谢谢谢谢