全平台BepInEX安装指南

前言

BepInEX 是一个强大的Unity跨平台modding框架

注意，截至本文发布之前，BepInEX对arm架构没有官方支持，若无另行说明，请自行参考其他x64游戏转arm的教程

以及 BepInEX 有 v5和v6-pre 版本之分，v6仍未发布稳定版，且与v5不兼容

参见BepInEX官方文档

下载包

访问 github.com/BepInEx/BepInEx/releases

在 Assets 处选一个下载（建议先看完本文下面）

如果无法访问github（虽然大概率连这个blog都访问不到hh），下面为原连接，请复制后自行寻找GitHub加速平台：

Windows下

参见搜索引擎，如Bilibili专栏

或者（本文不对视频中除builds.bepinex.dev的链接负责，但该链接不包含v5版本。非BepInEX安装的部分可以自行跳过）：

Linux下

类似windows，下载对应linux版本，解压到游戏根目录即可，目录结构类似专栏图示

然后用自己发行版中的文本编辑器打开 run_bepinex.sh，在 executable_name= 那行填入游戏的可执行文件名称，如下，注意大小写：

1
executable_name="XXX.x86_64";

然后在当前目录打开终端，运行如下命令赋予sh脚本可执行权限：

1
chmod u+x ./run_bepinex.sh

最后直接运行脚本，或在终端执行即可

若要在Steam启动游戏时自动运行BepInEX，请打开游戏属性的高级启动选项，填入下列参数（若已有请先空格）：

1
./run_bepinex.sh %command%

如果你启用了Steam Play（Proton兼容层），则不应使用linux原生包，而是解压windows版本到游戏目录

然后打开Steam游戏属性的高级启动选项，填入下列参数来启动BepInEX（若已有请先空格）：

1
WINEDLLOVERRIDES="winhttp.dll=n,b" %command%

MacOS下

类似linux，解压对应版本，修改脚本，配置启动权限，运行

要定位Steam游戏目录，可以在Steam右键游戏，通过 浏览本地文件 按钮定位到游戏目录

一般位于： /Users/当前用户/Library/Application Support/Steam/steamapps/common

用文本编辑器打开 run_bepinex.sh，在 executable_name= 那行填入游戏的可执行文件名称，如下，注意大小写：

1
executable_name="XXX.app";

如果没有在目录找到后缀名为“.app”的游戏文件，请注意当前打开的目录，不要找到app包后继续点击显示包内容

若要在Steam自动运行BepInEX，先在游戏根目录右键打开终端，运行如下命令获取完整路径，并复制：

1
pwd

或者右键文件夹，在文件夹属性中复制路径

再打开游戏属性的高级启动选项，填入下列参数（若已有请先空格）：

1
"pwd/run_bepinex.sh" %command%

里边的“pwd”换成上面复制的内容，最终类似：

1
"/Users/username/Library/Application Support/Steam/steamapps/common/xxx/run_bepinex.sh" %command%

使用il2cpp编译的unity游戏在macos上可能无法运行 BepInEX

若要在arm平台上运行，请在游戏根目录新建一个“.sh”文件，比如 run.sh，在文本编辑器输入：

1
2
#!/bin/sh
arch -x86_64 /bin/bash "pwd/run_bepinex.sh"

同样替换掉 pwd，再 chmod u+x ./run.sh赋予执行权限

运行此新建的脚本即可正常在arm平台加载BepInEX

此方法可能对某些非universal app包不可用

对于macOS 26+的玩家，由于苹果的新程序运行签名机制，安装时需要另外改动，参见github.com/cauyxy/bepinex-mac-patcher

附加步骤包括替换BepInEX/core文件夹中的BepInEX.Preloader.dll，替换run_bepinex.sh脚本，在 设置/安全与隐私 中允许执行 libdoorstop.dylib，要下载上述所有文件，见蓝奏云（密码：2345）