BepInEx配置管理器完整使用指南-深圳市維司達科技有限公司

BepInEx配置管理器完整使用指南

【免费下载链接】BepInEx.ConfigurationManagerPlugin configuration manager for BepInEx项目地址: https://gitcode.com/gh_mirrors/be/BepInEx.ConfigurationManager

BepInEx.ConfigurationManager是一个专为BepInEx插件系统设计的配置管理工具，让用户无需编写复杂的GUI界面就能轻松调整插件行为。通过简单的按键操作，用户可以在游戏中实时修改插件的各项设置。

项目概述与核心特性

BepInEx.ConfigurationManager为游戏插件开发者提供了一个标准化的配置界面解决方案。其主要特性包括：

一键式配置界面访问（默认F1快捷键）
实时插件设置调整
自动兼容大多数BepInEx插件
直观的用户界面设计
支持键盘快捷键配置
丰富的元数据展示

安装与配置步骤

环境要求检查

在使用BepInEx.ConfigurationManager之前，请确保满足以下环境要求：

BepInEx 5：需要5.4.20或更新版本（仅mono）
BepInEx 6：需要夜间构建版本664或更新（仅IL2CPP）

详细安装流程

下载最新版本
- 从项目发布页面获取最新版本的BepInEx.ConfigurationManager
文件部署操作
- 将下载的插件解压到游戏根目录
- 确保DLL文件位于BepInEx\Plugins文件夹内
功能验证测试
- 启动游戏
- 按下F1键打开配置界面
- 确认插件设置正常显示

开发者兼容性指南

基础兼容配置

ConfigurationManager会自动显示插件Config中的所有设置，无需额外引用或配置。开发者只需确保：

创建专门的Config类存储设置
为配置项添加元数据描述
设置合理的值范围限制

配置项类型定制

创建滑块设置通过指定AcceptableValueRange来创建滑块控件：

CaptureWidth = Config.Bind("Section", "Key", 1, new ConfigDescription("Description", new AcceptableValueRange<int>(0, 100)));

创建下拉列表设置使用枚举类型或指定AcceptableValueList：

public enum MyEnum { Entry1, [Description("自定义显示名称")] Entry2 }

键盘快捷键支持

ConfigurationManager支持键盘快捷键配置，使用KeyboardShortcut类型：

private ConfigEntry<KeyboardShortcut> ShowCounter { get; set; } public Constructor() { ShowCounter = Config.Bind("Hotkeys", "Show FPS counter", new KeyboardShortcut(KeyCode.U, KeyCode.LeftShift)); } private void Update() { if (ShowCounter.Value.IsDown()) { // 处理按键按下事件 } }

高级配置管理

自定义配置管理器行为

通过ConfigurationManagerAttributes类可以覆盖默认的配置管理器行为：

// 覆盖高级设置和排序 Config.Bind("X", "1", 1, new ConfigDescription("", null, new ConfigurationManagerAttributes { IsAdvanced = true, Order = 3 }));

自定义设置绘制器

为单个设置添加自定义绘制器：

void Start() { Config.Bind("Section", "Key", "Some value", new ConfigDescription("Desc", null, new ConfigurationManagerAttributes{ CustomDrawer = MyDrawer }); } static void MyDrawer(BepInEx.Configuration.ConfigEntryBase entry) { GUILayout.Label(entry.BoxedValue, GUILayout.ExpandWidth(true)); }