一个仿照 UnityModManager 设计的 BepInEx 模组管理器,基于 Tauri 2 + Vue 3 + Rust 构建。支持多游戏管理、BepInEx 自动下载安装、Mod 安装与启用/禁用、配置文件可视化编辑等功能。
- 多游戏管理:添加任意数量的游戏,各自独立管理
- BepInEx 管理:一键下载并安装 BepInEx(支持 x64 / x86),检测安装状态与完整性,支持重装和卸载
- Mod 管理:以文件夹为单位识别 Mod,支持启用/禁用(通过重命名 dll 实现)、删除、查看内部 dll 列表
- Mod 安装:拖拽
.zip/.dll文件安装,或输入直链 URL 下载安装,自动处理命名冲突 - 配置文件编辑:可视化编辑 BepInEx 及各 Mod 的
.cfg配置文件,自动保存,内置BepInEx.cfg中文字段说明 - 游戏启动:直接从软件内启动游戏
- 主题切换:深色 / 浅色 / 跟随系统
- 国际化:支持中文 / 英文界面切换
- HTTP 代理:支持配置代理,解决国内 GitHub 下载慢的问题
- 点击左侧边栏顶部的 首页
- 点击 添加游戏 卡片,在弹出的文件选择框中直接选择游戏的
.exe可执行文件 - 软件会自动识别游戏名称和可执行文件名,确认后点击 添加
- 游戏卡片出现在首页和左侧边栏
若需要移除游戏,将鼠标悬停在游戏卡片上,点击右上角的删除按钮即可(不会删除游戏文件)。
- 点击侧栏中的目标游戏,进入游戏主页
- 点击顶部状态栏中的 BepInEx 按钮,或点击 去安装 进入 BepInEx 管理页
- 根据提示选择版本:
- x64:适用于绝大多数现代游戏(64 位进程)
- x86:仅当游戏为 32 位进程时选择,不确定优先选 x64
- 点击 安装,等待下载和安装完成
- 安装完成后返回游戏主页,状态栏显示绿点即为已安装
如果下载速度慢,可在 设置 → HTTP 代理 中配置本地代理(例如
http://127.0.0.1:7890)。
进入游戏主页后,下方会列出所有已安装的 Mod(扫描 BepInEx/plugins 目录下的文件夹)。
| 操作 | 方法 |
|---|---|
| 启用 / 禁用 Mod | 点击 Mod 行左侧的开关 |
| 查看内部 dll | 点击 Mod 名称左侧的展开箭头 |
| 删除 Mod | 悬停 Mod 行,点击右侧垃圾桶图标 |
| 刷新列表 | 点击顶栏 刷新 按钮 |
| 打开插件目录 | 点击顶栏 打开目录 |
方式一:拖拽安装
将 .zip 压缩包或 .dll 文件直接拖拽到软件窗口上,松开即可安装:
- 拖入
.zip:解压后在 plugins 目录下创建同名文件夹 - 拖入
.dll:在 plugins 目录下创建同名文件夹并放入 dll
方式二:本地文件选择
点击顶栏 安装 Mod 按钮,在文件选择框中选择 .zip 或 .dll 文件。
方式三:URL 下载安装
点击顶栏 URL 安装 按钮,输入 .zip 或 .dll 文件的直链地址,软件自动下载并安装。
命名冲突处理
若安装时 plugins 目录中已存在同名文件夹,会弹出冲突对话框,提供三种选择:
- 自动重命名:在原名称后追加
_1、_2等后缀 - 覆盖:删除旧文件夹并替换为新内容
- 取消:放弃本次安装
- 在游戏主页点击顶部状态栏的 配置文件 按钮
- 左侧列出所有
.cfg文件(BepInEx 本体及各 Mod) - 点击文件名进入编辑界面,修改后自动保存(无需手动点保存)
- 打开
BepInEx.cfg时,每个配置项下方会显示中文说明
在游戏主页点击顶栏右侧的 启动游戏 按钮,直接从软件内启动对应游戏。
点击左侧边栏底部的 设置 进入设置页:
| 设置项 | 说明 |
|---|---|
| BepInEx 下载源 | GitHub 官方 或 镜像源(国内加速) |
| HTTP 代理 | 格式:http://127.0.0.1:7890,留空不使用 |
| 界面语言 | 中文 / English |
| 主题 | 深色 / 浅色 / 跟随系统 |
| 工具 | 版本要求 | 说明 |
|---|---|---|
| Node.js | ≥ 18 | 前端运行环境 |
| pnpm | ≥ 8 | 包管理器 |
| Rust | stable | 后端编译 |
| Tauri CLI | 2.x | 由 pnpm 脚本调用,无需全局安装 |
| Visual Studio Build Tools | 2019+ | Windows 编译 Rust 所需的 MSVC 工具链 |
Windows 用户还需安装 WebView2(Win11 已内置)。
git clone https://github.com/memsys-lizi/BepInExModManager.git
cd BepInExModManager
pnpm installpnpm tauri dev- 前端(Vite)热重载,修改
.vue文件后界面即时更新 - Rust 后端修改后会自动重新编译并重启应用
BepInExModManager/
├── src/ # 前端 Vue 源码
│ ├── api/ # Tauri 命令封装(invoke 调用层)
│ ├── assets/ # 全局 CSS、字体
│ ├── components/
│ │ ├── layout/ # 布局组件(标题栏、侧栏、顶栏)
│ │ └── ui/ # 通用 UI 组件(按钮、开关、弹窗等)
│ ├── i18n/ # 国际化翻译文件(zh.ts / en.ts)
│ ├── pages/ # 页面组件
│ │ ├── HomePage.vue # 游戏列表首页
│ │ ├── GameDetailPage.vue # 游戏 Mod 管理页
│ │ ├── BepInExPage.vue # BepInEx 安装管理页
│ │ ├── GameConfigPage.vue # 配置文件编辑页
│ │ └── SettingsPage.vue # 设置页
│ ├── router/ # Vue Router 路由配置
│ ├── store/ # Pinia 状态管理
│ └── types/ # TypeScript 类型定义
│
└── src-tauri/ # Rust 后端源码
├── icons/ # 应用图标(由 pnpm tauri icon 生成)
├── src/
│ ├── commands/
│ │ ├── game.rs # 游戏管理命令(图标提取、启动游戏等)
│ │ ├── bepinex.rs # BepInEx 管理命令(状态检测、下载安装)
│ │ ├── mods.rs # Mod 管理命令(扫描、启用禁用、安装)
│ │ └── config.rs # 配置文件读写命令
│ ├── models/ # 共享数据结构定义
│ └── lib.rs # 命令注册入口
└── tauri.conf.json # Tauri 配置文件
pnpm tauri build构建产物位于 src-tauri/target/release/bundle/:
bundle/
├── msi/ # Windows MSI 安装包
└── nsis/ # Windows NSIS 安装程序(.exe)
首次构建需编译所有 Rust 依赖,耗时约 10~20 分钟,后续增量构建速度较快。
准备一张 1024×1024 或更大的正方形 PNG,执行:
pnpm tauri icon your-icon.png命令会自动生成 src-tauri/icons/ 下所有平台所需的图标文件。
| 层 | 技术 |
|---|---|
| 桌面框架 | Tauri 2 |
| 前端框架 | Vue 3 + TypeScript |
| 构建工具 | Vite |
| 状态管理 | Pinia |
| 路由 | Vue Router 4 |
| 图标库 | Lucide Vue Next |
| 后端语言 | Rust |
| HTTP 客户端 | reqwest |
| 压缩包处理 | zip |
| 异步运行时 | Tokio |