? Shop Search AddOn for QuickShop
别再满地图找告示牌了。让你的玩家通过一条指令搜索服务器上的所有商店。
/finditem 会打开一个即时、分页的图形用户界面(GUI),显示所有购买或出售玩家所需物品的商店,包括价格、库存、所有者、位置以及一键传送按钮。无需在聊天中刷屏,也不需要在 Discord 里置顶 Wiki 页面,只需搜索并前往即可。
? 60秒快速体验
- 将 jar 文件放入
plugins/目录 - 重启服务器(会自动生成
config.yml) - 在游戏中运行
/finditem
这就是全部设置。之后的内容都是可选的优化项。
✨ 为什么你的玩家会爱上它
- 即时结果。 输入物品名称,即可在一个整洁的分页 GUI 中获取服务器上所有匹配的商店,你可以选择按价格或库存排序。
- 一键传送。 安全且可配置的传送功能,直接传送到商店;支持可选延迟和“别把我扔进岩浆里”的安全着陆检测,或者将他们传送到最近的传送点。
- 搜索结果不会遗漏细节。 附魔、药水颜色与效果、自定义物品名称和描述(lore),以及自定义模型数据都会正确显示,而不仅仅是基础物品名称。
- 避免无效行程。 库存为空的商店会被自动跳过,并且你可以设置最大距离限制,防止玩家将玩家传送到地图另一端去一家商店。
- 完全可定制品牌风格。 每条消息都支持十六进制颜色代码,GUI 按钮/标题/描述均可编辑,大额价格会自动缩短(例如
$10,210,100→$10.21M)以保持可读性。 - 专为大规模设计。 商店同步和搜索经过优化,即使在拥有数千个商店的服务器上也能保持高速运行。
?️ 实战演示
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
? 命令速查表
| 命令 | 作用 |
|---|---|
/finditem TO_SELL <item> |
查找出售此物品的商店(以便你知道去哪里买) |
/finditem TO_BUY <item> |
查找购买此物品的商店(以便你知道去哪里卖) |
/finditem TO_SELL * / TO_BUY * |
浏览服务器上的所有商店 |
/finditem hideshop |
从搜索结果中隐藏你当前查看的商店 |
/finditem revealshop |
使隐藏的商店再次可被搜索到 |
/finditemadmin reload |
无需重启即可重新加载 config.yml |
别名 /searchshop、/shopsearch 和 /searchitem 开箱即用。如果 TO_SELL/TO_BUY 标签在你的服务器上读起来别扭,也可以在配置文件中重命名它们。
完整的命令列表、所有权限节点以及带详细注释的
config.yml请参阅 GitHub Wiki。
? 完美兼容以下插件
启动时自动检测,无需额外设置:
| 插件 | 提供功能 |
|---|---|
| PlayerWarps | 在结果中显示每个商店最近的传送点 |
| EssentialsX Warps | 同样使用 Essentials 的传送点 |
| WorldGuard | 显示商店所在的区域 |
| Residence | 显示商店所在的领地(及子区域) |
| BentoBox | 将锁定岛屿上的商店排除在搜索结果之外 |
这些插件都不是必需的。仅安装 QuickShop-Hikari 和 Vault 即可完美运行。
⚙️ 为真实服务器打造
- 同时支持 Paper 和 Folia
- 细粒度的权限控制,涵盖搜索、传送、延迟绕过和安全检查绕过
- 商店所有者可以通过一条命令将自己的商店从搜索结果中隐藏
- 支持世界和材质黑名单,以保持结果干净并防止利用漏洞的物品出现
- 可选的距离限制,确保在大型世界中搜索结果保持本地化
? 依赖要求
- QuickShop-Hikari v6.3.0.0+
- Vault 以及一个兼容的经济插件
- Paper 1.20+(支持 Folia)
? 链接
免费开源,采用 GPLv3 许可证。通过 bStats 收集匿名使用统计数据以帮助确定下一步的开发重点,不收集任何个人数据。
? Shop Search AddOn for QuickShop
Stop walking the whole map looking for a sign. Let your players search every shop on the server in one command.
/finditem opens an instant, paginated GUI showing every shop buying or selling the item your player wants, complete with price, stock, owner, location, and a one-click teleport button to get there. No walkie-talkie chat spam, no wiki page pinned in Discord, just search and go.
? Try it in 60 seconds
- Drop the jar in
plugins/ - Restart your server (a
config.ymlis generated for you automatically) - Run
/finditemin game
That's the whole setup. Everything past this point is optional polish.
✨ Why your players will love it
- Instant results. Type an item name, get every matching shop on the server in a clean paginated GUI, sorted by price or stock, your choice.
- One-click teleport. Safe, configurable teleportation straight to the shop, with an optional delay and a "don't drop me in lava" landing check, or send them to the nearest warp instead.
- Nothing gets lost in search. Enchantments, potion colors and effects, custom item names and lore, and custom model data all show up correctly, not just the base item name.
- No wasted trips. Out-of-stock shops are skipped automatically, and you can cap results to a max distance so players aren't sent halfway across the map for one shop.
- Fully brandable. Every message supports hex colors, GUI buttons/titles/lore are editable, and large prices auto-shorten (
$10,210,100→$10.21M) to keep things readable. - Built for scale. Shop syncing and searches are optimized to stay fast even on servers running thousands of shops.
?️ See it in action
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
? Command cheat sheet
| Command | What it does |
|---|---|
/finditem TO_SELL <item> |
Find shops selling this item (so you know where to buy it) |
/finditem TO_BUY <item> |
Find shops buying this item (so you know where to sell it) |
/finditem TO_SELL * / TO_BUY * |
Browse every shop on the server |
/finditem hideshop |
Hide the shop you're looking at from search results |
/finditem revealshop |
Make a hidden shop searchable again |
/finditemadmin reload |
Reload config.yml without a restart |
Aliases /searchshop, /shopsearch, and /searchitem all work out of the box too, and the TO_SELL/TO_BUY labels can be renamed in config if they read awkwardly for your players.
Full command list, every permission node, and a fully annotated
config.ymlare on the GitHub Wiki.
? Plays nicely with
Auto-detected on startup, zero extra setup required:
| Plugin | What it adds |
|---|---|
| PlayerWarps | Shows the nearest warp to each shop in results |
| EssentialsX Warps | Same, using Essentials warps |
| WorldGuard | Shows which region a shop sits in |
| Residence | Shows which residence (and subzone) a shop sits in |
| BentoBox | Keeps shops on locked islands out of search results |
None of these are required. It works great with just QuickShop-Hikari and Vault installed.
⚙️ Built for real servers
- Runs on both Paper and Folia
- Fine-grained permissions for search, teleport, delay bypass, and safety-check bypass
- Shop owners can hide their own shop from search with a single command
- World and material blacklisting to keep results clean and free of exploit items
- Optional distance limit so search results stay local on huge worlds
? Requirements
- QuickShop-Hikari v6.3.0.0+
- Vault with a compatible economy plugin
- Paper 1.20+ (Folia supported)
? Links
Free and open source, GPLv3 licensed. Anonymous usage stats via bStats help prioritize what to build next, no personal data collected.
下载 Shop Search
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Shop Search
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Shop Search
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Shop Search
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Shop Search
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Shop Search
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Shop Search
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Shop Search
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Shop Search
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Shop Search
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
服务器管理员新增功能
- 管理员现在可以隐藏/显示任意玩家的商店:拥有
finditem.admin权限的玩家可以在自己未拥有的商店上使用/finditem hideshop和/finditem revealshop命令。 - 在拥有大量商店的服务器上运行
/finditem时显著减少卡顿:此前每次搜索都会通过扫描完整的商店列表来检查每个商店的隐藏状态,导致性能开销随商店数量的平方增长,并在单个游戏刻内占用主线程。现在该检查已改为即时查找,并且在执行更耗时的权限检查之前,会先过滤掉不售卖所搜物品的商店。 - 修复了当结果数量恰好是 45 的倍数(例如 90 或 450 个商店)时,“最后一页”按钮打开空白页面的问题。
技术变更
ShopSearchActivityStorageUtil在维护globalShopsList的同时保留了位置索引;isShopHidden、getPlayerVisitCount、getShopOwnerUUID、访问追踪以及隐藏/显示功能现均使用 O(1) 复杂度的即时查找,而非线性扫描- 搜索匹配阶段现在作为覆盖所有商店的区域任务一次性执行,而非为每个商店分别创建调度器任务、Future 和超时机制,且匹配检查的顺序已优化为先执行最廉价/最具选择性的检查
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。






评论 0
登录后参与评分
还没有评论,来抢沙发吧