原创 工具 QFFindItem —— 全服物品快速检索，支持多物品库 + 自定义文件夹扫描！不再因为物品过多导致遗忘物品ID或其存放位置 1.3.1

插件简介​

• 支持 异步加载，不阻塞服务器主线程
• 支持 点击物品 ID / 名称 自动填入聊天框
• 支持 分页 与 前缀匹配 / 包含匹配 两种搜索模式
• 所有消息 完全自定义（message.yml）

功能特性​

内置物品库支持（配置开关）​

• MythicMobs（mythicmobs）
• SX-Attribute（sxattribute）
• NeigeItems（neigeitem）
• SX-Item（sxitem）
• RedmiAssyLib（ral）

自定义文件夹扫描​

• 可配置多个文件夹路径，递归扫描所有 .yml 文件
• 将 YAML 的 顶层 key 识别为物品 ID，并记录所在文件路径

搜索指令​

• /qffinditem <关键词> [页码] [true|false]
  
  • 在 内置物品库 中搜索
  • 第三个参数为 true 表示 前缀匹配（以关键词开头），false 或不填为 包含匹配
  • 在 自定义文件夹物品 中搜索
  • 同样支持前缀 / 包含匹配

交互式结果展示（玩家专用）​

• 点击物品 ID → 自动填入聊天输入框
• 点击物品 显示名称 → 自动填入聊天输入框（并将颜色代码 § 转为 &）
• 点击 上一页 / 下一页 按钮 → 自动跳转（无需重复输入指令）

缓存重载​

• /qffinditem reload 与 /qffinditemFile reload 均可重新加载配置与缓存

​

---

​

指令列表​

指令 说明 权限
/qffinditem <关键词> [页码] [true|false] 搜索内置物品库 qffinditem.use
/qffinditemFile <关键词> [页码] [true|false] 搜索自定义文件夹物品 qffinditem.use
/qffinditem reload 重载配置 & 消息 & 缓存 qffinditem.reload
/qffinditemFile reload 同上（独立重载文件缓存） qffinditem.reload
页码 与 匹配模式 均为可选参数。
若只输入关键词，则默认第 1 页 + 包含匹配。

​

页码 与 匹配模式 均为可选参数。

点击展开...

若只输入关键词，则默认第 1 页 + 包含匹配。
​

---

​

权限节点​

配置文件（config.yml）​

注意：文件夹路径为 绝对路径 或相对于服务器根目录的路径。

点击展开...

消息文件（message.yml）​

使用示例​

1. 搜索内置物品（包含匹配）​

2. 搜索内置物品（前缀匹配）​

3. 搜索自定义文件夹物品​

4. 点击翻页​

5. 重载缓存​

注意事项​

• 物品库兼容性：
  请确保你使用的物品库版本与插件支持的 API 一致。
• 自定义文件夹格式：
  仅支持 .yml 文件，且只读取 顶层 key（如 items: ... 则只识别 items）。如果子层级也需识别，请自行调整。
• 重复 ID 处理：
  不同来源（或不同文件）出现相同 ID 时，全部保留，并在结果显示中标注来源（内置库名称或文件路径），避免混淆。
• 性能：
  缓存加载为异步执行，不影响服务器 tick。搜索操作为内存遍历，对于数千个物品可轻松应对。

依赖（可选）​

• MythicMobs[4.x]（需启用时）
• SX-Attribute[2.x]（需启用时）
• NeigeItems（需启用时）
• SX-Item（需启用时）
• RedmiAssyLib（需启用时）

常见问题​

下载与安装​

1. 将插件 jar 文件放入 plugins 文件夹
2. 启动服务器
3. 根据需要编辑 config.yml 和 message.yml
4. 赋予相应权限（qffinditem.use）
5. 输入指令测试

反馈与支持​

• 本贴回复
• QQ群：254585408

QFFindItem 致力于让物品检索变得轻松高效，希望它能成为你服务器管理的得力助手！