[QuickShop Addon] Shop Search - QuickShop Addon Shop Search 商店搜索

这是一个适用于 QuickShop Reremake 与 Hikari 的附加插件，可为服务器内所有商店提供物品搜索功能，并新增游戏内命令 /finditem。

💡插件简介

Shop Search AddOn For QuickShop 是一个 QuickShop 附加组件，支持在游戏内搜索全服商店中的物品。

⭐功能特性

• 按收购/出售商店搜索物品
• 按物品类型搜索
• 支持基于关键词的物品搜索
• 支持通过物品 custom model data 搜索自定义物品
• 商店排序方式可在配置中自定义
• 对附魔物品，在结果中显示附魔信息
• 若物品带有 hide_enchants 标记，则隐藏其附魔信息
• 对药水类物品，在结果中显示药水效果
• 可将特定商店从搜索结果中隐藏
• 支持完全安全的直接传送到商店功能（可在 config.yml 中配置）
• 自动忽略缺货商店
• 支持世界黑名单（位于黑名单世界中的商店不会出现在搜索结果中）
• config.yml 中的所有消息均支持十六进制颜色代码，可自由定制颜色表现

✨集成功能

• 支持与 PlayerWarps（by Olzie-12）集成，在搜索结果 GUI 中显示每个商店最近的 warp
• 支持与 EssentialsX Warps 集成，用于获取最近的 warp
• 由于技术限制，Essentials 的全局 warp 列表每 15 分钟分批更新一次，之后会用于所有搜索请求
• 如果你新增了一个 warp，并希望立即更新，请执行 /finditemadmin reload
• 请注意：这一点仅适用于 Essential Warps
• 支持 WorldGuard 区域识别，可获取商店所在的 WorldGuard 区域
• 如果存在区域重叠，将选择优先级最高的区域

🎮配置文件

• 已提供带有字段说明的示例 config.yml：Link

🔧图片预览

• .SpoilerTarget"> Spoiler: Images
• 多页搜索结果
• 显示物品附魔
• 显示药水颜色与效果
• 显示自定义物品名称与 lore

💡运行要求

必需条件

• QuickShop-Hikari v6.2.0.11 或更高版本

默认前提

• 已安装兼容的经济插件
• 已安装 Vault 1.7.3 或更高版本

Java 要求

• 服务器运行环境需要安装 Java 21 或更高版本

🎮安装与使用

• 将插件放入服务器的 plugins 文件夹
• 重启服务器
• 完成后即可使用

⭐权限节点

• finditem.use - 允许玩家使用 /finditem 命令
• finditem.admin - 供 OP 使用，包含以下所有权限
• finditem.reload - 允许使用 /finditemadmin reload 重载配置
• finditem.shoptp - 若配置中启用了 allow-direct-shop-tp，玩家需要此权限才能传送
• finditem.hideshop - 允许执行 /finditem hideshop 或 /finditem revealshop

🔧命令用法

搜索商店中的物品

/finditem {Arg1} {Arg2}

• Arg1: TO_BUY 或 TO_SELL（可在 config.yml 中自定义）
• Arg2: 来自 Tab 自动补全的物品类型（使用 Bukkit item types）

按物品显示名称关键词搜索

/finditem {Arg1} {Arg2}

• Arg1: TO_BUY 或 TO_SELL（可在 config.yml 中自定义）
• Arg2: 物品显示名称中的任意单词

重载配置

/finditemadmin reload

• 重载 config.yml

✨隐藏商店功能

• 你可以将自己的商店隐藏，使其不出现在 /finditem 搜索结果中
• 面向你想隐藏的箱子商店时执行 /finditem hideshop
• 请注意：必须看着箱子商店本体，不是 商店告示牌
• 隐藏后，该商店将不再出现在搜索结果中
• 若要重新公开隐藏的商店，请面向该隐藏的箱子商店执行 /finditem revealshop
• 执行以上两个命令需要 finditem.hideshop 权限

❓问题与功能追踪

• 如果你遇到任何错误，请在 here 创建新的 issue
• 请尽量详细描述你遇到的问题
• 如有可能，请附上控制台日志
• 你也可以在同一链接中查看当前正在开发中的功能列表（如果有）

🔧获取支持

• 请不要在评论区或讨论区发布问题
• 联系作者的最佳方式是通过 QuickShop-Hikari 官方 Discord 服务器：[ link ]

⭐评价与支持

• 如果你觉得这个插件有帮助，请为插件评分

捐赠支持

• 开发和维护这类插件需要投入大量时间与精力
• 如果你愿意支持作者长期维护本插件，欢迎通过 here 进行捐赠
• 捐赠金额不限，任何支持都非常感谢

本页面提供带字段说明的示例 config.yml，并附上权限节点链接，方便你快速查阅。

⭐配置文件

• 带有每个字段说明的示例 config.yml：
• Link

✨权限

• 权限列表：
• Link