2025-06

全平台BepInEX安装指南

前言

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

然后你猜我为什么写这个？

因为好像除了windows上的算比较详细，其他平台的基本没一个中文文档写有（

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

以及 BepInEX 有 v5和v6-pre 版本之分

参见BepInEX官方文档

下载包

访问 github.com/BepInEx/BepInEx/releases

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

如果无法访问github（虽然大概率连这个blog都访问不到hh），可以去KGithub

或者如果下载速度过慢，在release页面右键复制下载链接，去bing搜 “github 加速” 找一个加速平台即可

Windows下

直接参见搜索引擎，例如：Bilibili专栏

如果无法访问github（那么大概率连这个blog都访问不到hh），可以去KGithub

或者如果下载速度过慢，在release页面右键复制下载链接，去bing搜“github 加速”找一个加速平台即可（从kgithub拿的链接记得把链接里的kgithub改掉）

Linux下

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

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

executable_name="XXX.x86_64";

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

chmod u+x ./run_bepinex.sh

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

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

./run_bepinex.sh %command%

如果你启用了Steam Play（proton），则不应使用linux原生包，而是解压windows版对应版本后，打开Steam游戏属性的高级启动选项，填入下列参数（若已有请先空格）：

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

MacOS下

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

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

executable_name="XXX.app";

如果没有在目录找到后缀名为“.app”的游戏文件，请，参见CSDN，在访达右键菜单或游戏文件夹属性选项卡取消“显示包内容”

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

pwd

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

"pwd/run_bepinex.sh" %command%

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

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

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

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

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

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

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

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

教程