制作过滤器

《Valheim》合成配方筛选 MOD 使用指南
【核心介绍】
为库存 GUI 的「合成」标签页添加配方分类筛选功能，支持按物品类型快速过滤显示可合成项。
【安装指南】
1. 必备前置：需先安装并启用「BepInEx」（本 MOD 依赖 BepInEx 运行）；
2. 下载 MOD 文件（`.dll`），放入游戏根目录 `/BepInEx/plugins/` 文件夹；
3. 首次启动游戏后，自动创建配置文件与分类文件，缺一不可；
4. 推荐使用「Vortex」模组管理器安装，可自动处理依赖与路径。
【功能详情】
✅ 已优化：
– 新增「合成」按钮悬停下拉菜单，按物品类型（如武器、资源、工具等）一键筛选；
– 支持鼠标滚轮切换当前筛选类型；
– 支持自定义快捷键切换上一个/下一个筛选项（需在配置中启用）；
– 支持自定义分类逻辑，通过编辑 `categories.json` 重新分组物品类型或修改显示名称；
– 分类默认按字母排序，含「None」的分类固定置顶并显示全部配方。
❌ 未修改：
– 不改变原游戏合成逻辑、配方数值或物品获取方式；
– 不修改物品本身的类型定义（分类依据来自游戏原始数据，非本 MOD 生成）。
✨ 额外调整：
– 提供完整示例 `categories.json`，含常用分组（如「Weapons」「Armor」「Tools」等）；
– 配置文件支持游戏内「配置管理器」（需另装模组）或手动编辑，实时生效。
【使用要求】
– 必须安装并运行「BepInEx」（v5.4.2100 或更高版本）；
– 仅适用于 Valheim 官方正式版（不支持测试分支或旧版存档兼容模式）；
– 无需「血与酒」「石之心」等扩展包，无硬件配置要求。
【兼容性说明】
– 兼容范围：所有不直接修改 `CraftingPanel` UI 类或覆盖 `CraftingFilter` 同名方法的 MOD；
– 不兼容模组：
– 「Advanced Crafting UI」（冲突于 UI 层级重绘）；
– 「Recipe Manager」（二者均接管配方筛选逻辑，不可共存）；
– 暂未推出兼容补丁。
【注意事项】
– 若某物品未出现在预期分类中，请检查其原始物品类型（如 `Trophie` 拼写错误，应为 `Trophy`），非本 MOD 错误；
– 修改 `categories.json` 后需重启游戏生效；
– 控制台指令 `craftingfilter reset` 可强制重载当前配置（需开启控制台 F5）；
– 自定义分类中任意条目含「None」即显示全部配方，慎用于多分类场景。
【更新日志】
– 2023 年 11 月 5 日新增鼠标滚轮切换筛选功能，配置项 `EnableScrollSwitch` 默认开启；
– 2023 年 9 月 12 日首发正式版，支持 JSON 分类配置与基础下拉筛选；
– 2023 年 8 月 30 日测试版发布，验证 BepInEx v5.4+ 兼容性。