BepInEx 配置抽屉

[center][img width=300]https://raw.githubusercontent.com/Vapok/BepInEx.ConfigDrawers/main/Docs/icon_large.png[/img][/center]

[center][b]适用于 BepInEx 5 插件的游戏内配置管理器。[/b][/center]

[center][url=https://github.com/Vapok/BepInEx.ConfigDrawers/releases][img]https://img.shields.io/github/v/release/Vapok/BepInEx.ConfigDrawers?include_prereleases&style=flat-square[/img][/url] [url=https://thunderstore.io/c/valheim/p/Vapok/BepInEx_ConfigDrawers/][img]https://img.shields.io/thunderstore/v/Vapok/BepInEx_ConfigDrawers?style=flat-square[/img][/url] [url=https://www.nexusmods.com/valheim/mods/3909][img]https://img.shields.io/badge/Nexus%20Mods-3909-orange?style=flat-square[/img][/url] [url=https://discord.gg/5YAJkRFBXt][img]https://img.shields.io/discord/941785535977934898?label=Discord&logo=discord&style=flat-square[/img][/url] [url=https://file+.vscode-resource.vscode-cdn.net/home/vapok/Modding/BepInEx/ConfigDrawers/LICENSE.md][img]https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square[/img][/url][/center]
[line]
[heading]概述[/heading]
[b]BepInEx.ConfigDrawers[/b] 是一个基于 Unity uGUI 构建的 BepInEx 5 插件游戏内配置管理器。它提供了一个可折叠的抽屉界面，可停靠到屏幕的任意一侧，也可作为可移动窗口自由浮动，让你能够实时编辑插件配置而不会遮挡游戏画面。
[line]
[heading]功能[/heading]
[list]
[][b]停靠与浮动窗口[/b]：可停靠到屏幕左侧或右侧边缘，也可分离为可自由拖动、宽度可调的浮动窗口。[/]
[][b]搜索与筛选[/b]：对插件名称、分区、设置键和描述进行实时搜索筛选。[/]
[][b]原生设置绘制器[/b]：内置适用于基本类型（
[code]bool[/code]、
[code]int[/code]、
[code]float[/code]、
[code]string[/code]、
[code]enum[/code]）、向量（
[code]Vector2[/code]、
[code]Vector3[/code]、
[code]Vector4[/code]）和按键快捷键的绘制编辑器。[/]
[][b]多行文本编辑器[/b]：适用于长字符串、带占位符的格式化字符串和 JSON 配置的自动扩展编辑器。[/]
[][b]色谱取色器[/b]：HSV 色轮，支持十六进制/RGB 输入和调色板色板预设。[/]
[][b]数据网格与表格[/b]：用于配方和掉落列表等复杂结构化设置的多列表格视图。[/]
[][b]UI 缩放[/b]：针对不同屏幕分辨率可配置的缩放预设（小、正常、大）。[/]
[][b]热键重新绑定[/b]：点击标题栏中的热键按钮，然后按下任意键即可在游戏内重新绑定菜单切换快捷键。[/]
[][b]ServerSync 集成[/b]：自动识别服务器强制配置并显示同步状态指示器。[/]
[][b]旧版 IMGUI 兼容[/b]：自动抑制冲突的旧版
[code]ConfigurationManager.dll[/code] 热键，同时继续在现代抽屉中渲染旧版自定义绘制委托。[/]
[][b]配置文件浏览器与编辑器[/b]：浏览
[code]BepInEx/config/[/code] 中的原始配置文件，并使用全屏代码编辑器在游戏内直接编辑，支持实时语法高亮、行号、双行度量边栏和实时 JSON/YAML 验证。[/]
[][b]自定义 uGUI 与 IMGUI 绘制器[/b]：用于模组配置界面的原生程序化构建器 API（
[code]CustomUguiDrawer[/code]），并带有旧版 IMGUI 回退。请参阅 [url=https://github.com/Vapok/BepInEx.ConfigDrawers/blob/main/Docs/CUSTOM_DRAWERS.md]自定义绘制器指南[/url]。[/]
[/list][line]
[heading]操作与按键绑定[/heading]
[table][tr][th]操作[/th]
[th]默认输入[/th]
[th]描述[/th]
[/tr]
[tr][td][b]切换抽屉[/b][/td]
[td][code]F1[/code][/td]
[td]打开或关闭配置抽屉。[/td]
[/tr]
[tr][td][b]关闭 / 取消[/b][/td]
[td][code]Escape[/code][/td]
[td]关闭抽屉或取消当前输入字段编辑。[/td]
[/tr]
[tr][td][b]提交编辑[/b][/td]
[td][code]Enter[/code] / 失焦[/td]
[td]提交输入更改并保存配置。[/td]
[/tr]
[tr][td][b]停靠左侧 / 右侧[/b][/td]
[td][code][ Left ][/code] /
[code][ Right ][/code][/td]
[td]将抽屉吸附到左侧或右侧显示器边缘。[/td]
[/tr]
[tr][td][b]浮动窗口[/b][/td]
[td][code][ Float ][/code][/td]
[td]将抽屉分离为自由浮动窗口。[/td]
[/tr]
[tr][td][b]调整宽度[/b][/td]
[td]拖动边缘手柄[/td]
[td]拖动内侧边框手柄以调整抽屉宽度。[/td]
[/tr]
[tr][td][b]循环 UI 缩放[/b][/td]
[td][code][ Size: Norm ][/code][/td]
[td]在小（85%）、正常（95%）和大（108%）UI 缩放之间循环切换。[/td]
[/tr]
[tr][td][b]重新绑定切换键[/b][/td]
[td]点击热键按钮[/td]
[td]点击标题栏中的热键按钮，然后按下所需的键盘按键。[/td]
[/tr]
[/table][line]
[heading]配置设置[/heading]
设置存储在
[code]BepInEx/config/vapok.bepinex.configdrawers.cfg[/code]：
[table][tr][th]分区[/th]
[th]键[/th]
[th]默认值[/th]
[th]描述[/th]
[/tr]
[tr][td][code]General[/code][/td]
[td][code]Toggle Keybind[/code][/td]
[td][code]F1[/code][/td]
[td]打开和关闭抽屉的键盘快捷键。[/td]
[/tr]
[tr][td][code]Interface[/code][/td]
[td][code]Default Dock Position[/code][/td]
[td][code]Left[/code][/td]
[td]ConfigDrawer 默认停靠的屏幕边缘（
[code]Left[/code]、
[code]Right[/code] 或
[code]Float[/code]）。[/td]
[/tr]
[tr][td][code]Interface[/code][/td]
[td][code]Drawer Width[/code][/td]
[td][code]480[/code][/td]
[td]停靠时抽屉的宽度（像素）（360–720）。[/td]
[/tr]
[tr][td][code]Interface[/code][/td]
[td][code]UI Scale[/code][/td]
[td][code]1.0[/code][/td]
[td]整体 UI 缩放系数（0.75–1.75）。[/td]
[/tr]
[tr][td][code]Interface[/code][/td]
[td][code]Font Size[/code][/td]
[td][code]Normal[/code][/td]
[td]字体和布局缩放（
[code]Small[/code]、
[code]Normal[/code] 或
[code]Large[/code]）。[/td]
[/tr]
[tr][td][code]Interface[/code][/td]
[td][code]Translucency Opacity[/code][/td]
[td][code]0.95[/code][/td]
[td]背景表面不透明度（0.5–1.0）。[/td]
[/tr]
[tr][td][code]Interface[/code][/td]
[td][code]Hide Advanced Settings[/code][/td]
[td][code]true[/code][/td]
[td]默认隐藏高级设置，直到手动切换显示。[/td]
[/tr]
[tr][td][code]Compatibility[/code][/td]
[td][code]Auto Suppress Legacy Manager[/code][/td]
[td][code]true[/code][/td]
[td]自动禁用旧版 ConfigurationManager 的热键以防止重复窗口。[/td]
[/tr]
[/table][line]
[heading]安装[/heading]
Thunderstore / 模组管理器（推荐）
[list=1]
[]通过 r2modman 或 Thunderstore Mod Manager 安装
[code]BepInEx.ConfigDrawers[/code]。[/]
[]启动游戏并按
[code]F1[/code] 打开配置抽屉。[/]
[/list]手动安装
[list=1]
[]确保已安装 [b]BepInEx 5.4.x[/b]。[/]
[]从 [url=https://github.com/Vapok/BepInEx.ConfigDrawers/releases]Releases[/url] 下载最新发布包。[/]
[]将
[code]BepInEx.ConfigDrawers.dll[/code] 解压到你的
[code]BepInEx/plugins/[/code] 目录中。[/]
[/list][line]
[heading]构建自定义绘制器[/heading]
模组开发者可以创建自定义程序化 uGUI 配置绘制器，而无需依赖
[code]BepInEx.ConfigDrawers[/code]。只需将
[code]ConfigurationManagerAttributes.cs[/code][url=https://raw.githubusercontent.com/Vapok/BepInEx.ConfigDrawers/main/Docs/DropIn/ConfigurationManagerAttributes.cs][/url] 复制到你的模组项目中，即可在旧版
[code]CustomDrawer[/code] 回退之外使用
[code]CustomUguiDrawer[/code]。
有关代码示例、布局模式和完整的
[code]IUguiDrawerScope[/code] 构建器 API，请参阅 [url=https://github.com/Vapok/BepInEx.ConfigDrawers/blob/main/Docs/CUSTOM_DRAWERS.md]自定义绘制器指南[/url]。
[line]
[heading]作者与社区[/heading]
由 [b]Vapok[/b] 维护。
[list]
[][b]网站[/b]：[url=https://vapok.io/]vapok.io[/url][/]
[][b]Discord[/b]：[url=https://discord.gg/5YAJkRFBXt]Vapok Gaming Community[/url][/]
[][b]GitHub[/b]：[url=https://github.com/Vapok/BepInEx.ConfigDrawers]Vapok/BepInEx.ConfigDrawers[/url][/]
[][b]Thunderstore[/b]：[url=https://thunderstore.io/c/valheim/p/Vapok/]Vapok Mods[/url][/]
[/list]