筛选和排序已打开的箱子，并在附近的容器中查找物品。

索尼克宝箱筛选

瓦尔海姆BepInEx模组，用于附近容器的箱子筛选控制。

身份

作者	音速DM
插件名称	音速宝箱筛选器
插件 GUID	com.sonicdm.valheim.sonicchestfilters
组装	音速宝箱筛选器.dll
版本	1.0.1
配置文件	BepInEx/config/com.sonicdm.valheim.sonicchestfilters.cfg

功能

• 筛选： 一个实时更新的约顿巨人风格瓦尔海姆式文本框，位于打开的箱子界面中。与查询不匹配的已占用槽位会被隐藏；空槽位仍可用于存放物品。匹配使用 * 对本地化名称、标记和预制件进行通配符和子字符串搜索。
• 清除筛选： 再次显示所有槽位并清空格子。
• 排序： 一键操作。合并可堆叠物品，然后按类型、本地化名称和品质排序。再次点击可反向排序。需要拥有该箱子；拖动物品时不会进行排序。
• 找到物品： 控制台/聊天命令 定位 使附近符合条件的宝箱发光（匹配规则与过滤器相同）。例如： 找到树脂, 定位 （持有物品）， 定位清晰.

当 附近制作分叉 已安装，此模组的 定位 命令未注册。请使用NCF的 附近 / 定位 相反，筛选和排序仍然有效。

滤镜仅视觉生效，关闭宝箱后重置。排序会将新布局写入容器背包。

配置

配置文件生成于：

BepInEx/config/com.sonicdm.valheim.sonicchestfilters.cfg

设置也可以通过兼容的模组配置界面进行更改（例如官方BepInEx配置管理器）。

配置组：

• [通用] 已启用、自动重载配置、调试日志
• [容器] 物品定位所用的范围和资格
• [UI] 启用过滤框，启用排序按钮
• [物品定位] 已启用, 最大高亮数, 持续秒数, 发光颜色 (已启用 在加载附近制作分叉时被忽略）

安装

模组管理器（r2modman / Thunderstore）

1. 安装 霜巨人 （以及 BepInExPack）然后 索尼克宝箱筛选，或将本地包导入到配置文件中。
2. 启动一次以生成配置文件。

推荐的 r2modman 插件布局（与其他已管理模组相同的模式）：

BepInEx/plugins/SonicDM-SonicChestFilters/ SonicChestFilters.dll manifest.json README.md CHANGELOG.md icon.png

手动

1. 为英灵神殿安装BepInExPack。
2. 放置 SonicChestFilters.dll 在 BepInEx/plugins/ （或如上所述的子文件夹）。

制作人员

• 作者： 索尼克DM

建造（开发者）

针对 Valheim / BepInEx 托管 DLL 的本地文件夹进行构建。请将该文件夹路径传给 -Lib目录 （不要提交这些引用）。

.\build.ps1 -LibDir "path\to\ValheimRefs" .\build.ps1 -LibDir "path\to\ValheimRefs" -Package .\package.ps1 -LibDir "path\to\ValheimRefs" .\package.ps1 -SkipBuild

package.ps1 在以下位置构建一个与Thunderstore兼容的zip文件： dist/ 每 雷暴商店包文档:

• manifest.json, README.md, 图标.png （256×256），可选 更新日志，以及 音速宝箱过滤器.dll 在 压缩包根目录
• 在打包前验证清单字段、UTF-8 自述文件和图标尺寸

发布（开发者）

GitHub 托管的 Actions 不能 编译这个模组（英灵神殿 已管理 动态链接库保留在本地）。发布版本从你的机器上切出：

1. 碰撞 插件版本，csproj <版本>，以及 manifest.json 版本号 一起。
2. 添加一个 ## X.Y.Z 至 更新日志.
3. 本地打包（.\package.ps1，然后发布：

.\release.ps1 -SkipPackage # 使用现有的 dist\SonicChestFilters-X.Y.Z.zip # 或者 .\release.ps1 # 先打包再发布

release.ps1 验证版本、标签 vX.Y.Z，推送并创建一个GitHub Release，其正文为匹配的CHANGELOG部分，并附带Thunderstore zip文件。该 释放 标签推送时的工作流会刷新这些备注，前提是标签先完成推送。