ConfigForge

[center]
[size=7][b][color=#00e5ff]CONFIGFORGE[/color][/b][/size]
[size=4][b]面向 BepInEx 5 的下一代游戏内配置管理器[/b][/size]
[i]快速、现代、响应式的配置 GUI，零资源包依赖。[/i]
[/center]

[line]

[size=5][b]🌟 为什么选择 ConfigForge？[/b][/size]

基于传统 IMGUI 构建的配置管理器长期存在以下问题：下拉菜单向下展开时超出显示边界、选项展开时被屏幕裁剪、大型模组包下性能迟缓、输入数字时在输入完成前就被强制截断的输入错误，以及完全缺乏预设配置档案管理。

[b]ConfigForge 从零开始构建，正是为了解决这些痛点，同时引入强大的新工具。[/b]

[line]

[size=5][b]✨ 突出特性[/b][/size]

[size=4][b]🛡️ 智能视口与自动翻转弹窗[/b][/size]
[list]
[][b]永不截断：[/b]下拉菜单、颜色选择器和上下文菜单会动态计算可用屏幕空间。如果某个选项会超出屏幕或窗口底部，它会[b]自动向上翻转[/b]。[/]
[][b]屏幕钳制：[/b]严格的安全区域视口钳制确保每个按钮、菜单和滑块在任何显示器分辨率（1080p、1440p、4K、超宽屏和 Steam Deck）下都 100% 可见且可点击。[/]
[][b]实时可见性：[/b]模组在运行时隐藏或显示的设置（[i]Browsable[/i]）会在窗口打开期间立即更新，并在最后一行下方保留安全内边距。[/]
[/list]
[size=4][b]⚠️ 热键冲突检测器[/b][/size]
[list]
[]审计所有已安装模组中注册的全部 [b]KeyboardShortcut[/b] 和 [b]KeyCode[/b] 设置。[/]
[]立即用警告徽章标记重叠的热键（例如 [color=#ffb74d][b]⚠️ 冲突：F5 被 Mod A 和 Mod B 同时使用[/b][/color]）。[/]
[]可直接在矩阵视图中重新绑定任一冲突的快捷键，无需在数百个设置中逐一查找。[/]
[/list]
[size=4][b]🔄 已修改设置实时对比[/b][/size]
[list]
[]专用的[b]已修改[/b]标签页汇总所有模组中当前与其默认值不同的每一项设置。[/]
[]使用一键[b]↺ 重置[/b]按钮还原单项设置，或使用[b]重置所有已修改项[/b]恢复全部（带确认对话框）。[/]
[/list]
[size=4][b]💾 配置档案与预设管理器[/b][/size]
[list]
[]创建命名的配置快照（例如 [i]Hardcore Survival[/i]、[i]Performance Modded[/i]、[i]Creative Builder[/i]）。[/]
[]一键即时切换预设。[/]
[]使用[b]复制到剪贴板[/b]和[b]从剪贴板导入[/b]与好友或服务器成员分享配置。[/]
[/list]
[size=4][b]🎨 13 款手工打造主题与平滑缩放[/b][/size]
[list]
[][b]零资源包依赖：[/b]100% 程序化抗锯齿纹理，采用双线性过滤，游戏过程中零 GC 分配。[/]
[][b]Ctrl + 鼠标滚轮缩放：[/b]从 [b]75% 到 300%[/b] 的平滑实时 DPI 缩放，配有专用滑块和一键快捷药丸按钮（[b]100%[/b]、[b]125%[/b]、[b]150%[/b]、[b]200%[/b]、[b]自动[/b]）。[/]
[][b]13 款内置主题：[/b]
[list]
[]Forge Dark（电光青 / 深板岩 - 默认）[/]
[]Nordic Frost（北极冰 / 极地板岩）[/]
[]Cyber Ember（炽热亮橙 / 黑曜石）[/]
[]Obsidian Slate（极简高对比单色）[/]
[]Forest Grove（林地苔藓 / 翡翠与金）[/]
[]Crimson Abyss（天鹅绒哥特 / 血红与玫瑰）[/]
[]Synthwave Neon（80 年代复古 Outrun / 热洋红与青）[/]
[]Solar Flare（温暖浓缩咖啡 / 璀璨金琥珀）[/]
[]Deep Ocean（深海海沟 / 生物荧光海蓝宝石）[/]
[]Amethyst Void（暮光虚空 / 电光皇家紫）[/]
[]Matrix Terminal（赛博朋克磷光 / CRT 终端绿）[/]
[]Dracula Dark（标志性 Dracula 配色 / 柔和紫与薄荷）[/]
[]Nordic Daylight（清爽纸感浅色主题 / 蓝宝石钴蓝）[/]
[/list][/]
[/list]
[size=4][b]⌨️ 输入拦截[/b][/size]
[list]
[]在 Valheim 中，游戏输入门控被挂钩，因此窗口打开时点击、镜头移动、攻击、交互和按键不会渗入游戏（通过 [b]Ctrl+B[/b] 或配置切换）。[/]
[]干净的鼠标锁定与可见性管理会在关闭时无缝恢复你的镜头捕获。[/]
[/list]
[line]

[size=5][b]🎛️ 支持的设置类型与绘制器[/b][/size]

[list]
[][b]布尔值：[/b]带激活状态颜色（ON / OFF）的平滑动画切换开关。[/]
[][b]数字与范围：[/b]整数滑块带整数吸附 + 带延迟输入缓冲的文本字段（输入时不会过早钳制）。[/]
[][b]枚举与列表：[/b]可搜索、自动翻转的下拉弹窗，支持枚举和 AcceptableValueList。[/]
[][b]按键绑定：[/b]交互式按键录制覆盖层，支持修饰键（Ctrl、Shift、Alt，Escape 取消，Delete 清除）。[/]
[][b]颜色：[/b]浮动颜色选择器，带 RGB/HSV 滑块、Alpha 滑块、Hex（#RRGGBB / #RRGGBBAA）输入和调色板色块。[/]
[][b]向量与四元数：[/b]多轴输入卡片（X、Y、Z、W），支持独立浮点解析。[/]
[][b]字符串：[/b]简洁的单行文本字段带一键清除按钮，或可展开的多行文本区域。[/]
[][b]ServerSync 兼容性：[/b]服务器锁定的设置显示简洁的 [color=#00e5ff][b]Server[/b][/color] / [color=#81c784][b]Synced[/b][/color] 徽章，显示服务器与本地值，并阻止未经授权的客户端编辑。[/]
[][b]自定义绘制器：[/b]100% 鸭子类型兼容第三方 [i]ConfigurationManagerAttributes.CustomDrawer[/i] 委托。[/]
[/list]
[line]

[size=5][b]⌨️ 操作与快捷键[/b][/size]

[list]
[][b]F1：[/b]打开 / 关闭 ConfigForge 窗口（可在设置中重新绑定）。[/]
[][b]Escape：[/b]多阶段关闭（关闭打开的弹窗 ➔ 取消文本字段焦点 ➔ 清空搜索 ➔ 关闭窗口）。[/]
[][b]Ctrl + F：[/b]聚焦全局搜索框。[/]
[][b]Ctrl + B：[/b]切换游戏输入拦截开/关。[/]
[][b]Ctrl + Z / Ctrl + Y：[/b]撤销 / 重做设置更改（批量重置和预设作为单步撤销）。[/]
[][b]Ctrl + 鼠标滚轮：[/b]实时动态缩放 UI。[/]
[][b]拖动标题栏：[/b]将窗口移动到屏幕任意位置。[/]
[][b]拖动右下角：[/b]调整窗口尺寸。[/]
[/list]
[line]

[size=5][b]📦 安装[/b][/size]

[size=4][b]通过模组管理器（Vortex、r2modman、Gale）[/b][/size]
[list=1]
[]通过你选择的模组管理器下载并安装。[/]
[]确保已安装 [b]BepInExPack[/b] 作为前置依赖。[/]
[/list]
[size=4][b]手动安装[/b][/size]
[list=1]
[]确保游戏目录中已安装 [b]BepInEx 5[/b]。[/]
[]下载发布压缩包。[/]
[]将 [b]ConfigForge.dll[/b] 解压到 [b]<GameDirectory>/BepInEx/plugins/ConfigForge/[/b] 文件夹中。[/]
[]启动游戏并按 [b]F1[/b] 打开管理器。[/]
[/list]
[line]

[size=5][b]🛠️ 配置与存储[/b][/size]

[list]
[]模组配置设置保存至：
[font=Courier New]BepInEx/config/com.jubaroo.configforge.cfg[/font][/]
[]已保存的预设档案存储于：
[font=Courier New]BepInEx/config/ConfigForge/Presets/[/font][/]
[/list]