🔍 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.
| Version | Minecraft | Loader | Download |
|---|---|---|---|
|
2.0.8.3-SNAPSHOT-36 |
26.2
|
folia, paper, purpur
|
Download |
|
2.0.8.2-RELEASE |
26.2
|
folia, paper, purpur
|
Download |
|
2.0.8.2-SNAPSHOT-32 |
26.2
|
folia, paper, purpur
|
Download |
|
2.0.8.1-SNAPSHOT-31 |
26.2
|
folia, paper, purpur
|
Download |
|
2.0.8.1-SNAPSHOT-28 |
26.1.2
|
folia, paper, purpur
|
Download |
|
Build-260517 2.0.8.1-SNAPSHOT |
26.1, 26.1.1, 26.1.2
|
folia, paper, purpur
|
Download |
|
2.0.8.0-RELEASE |
1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11
|
folia, paper, purpur
|
Download |
|
Build-260308 2.0.8.0-SNAPSHOT |
1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11
|
folia, paper, purpur
|
Download |
|
Build-260225 2.0.8.0-SNAPSHOT |
1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11
|
folia, paper, purpur
|
Download |
|
2.0.8.0-SNAPSHOT |
1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11
|
paper, purpur
|
Download |
|
2.0.8.0-SNAPSHOT |
1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10
|
paper, purpur
|
Download |
|
2.0.7.7-RELEASE |
1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8
|
paper, purpur, spigot
|
Download |
|
2.0.7.6-RELEASE |
1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5
|
paper, purpur, spigot
|
Download |
|
2.0.7.5-RELEASE |
1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5
|
bukkit, paper, purpur, spigot
|
Download |
|
2.0.7.4-RELEASE |
1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4
|
paper, purpur, spigot
|
Download |
|
2.0.7.3-RELEASE |
1.20.6, 1.21.4
|
paper, purpur, spigot
|
Download |
|
2.0.7.2-RELEASE |
1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3
|
paper, purpur, spigot
|
Download |
|
2.0.7.1-RELEASE |
1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3
|
paper, purpur, spigot
|
Download |
|
2.0.7.0-RELEASE |
1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1
|
paper, purpur, spigot
|
Download |
|
2.0.7.0-SNAPSHOT |
1.20, 1.20.6, 1.21, 1.21.1
|
paper, purpur, spigot
|
Download |
|
2.0.6.4-RELEASE |
1.20.6, 1.21
|
paper, purpur, spigot
|
Download |
|
2.0.6.3-RELEASE |
1.19.4, 1.20.6
|
paper, purpur, spigot
|
Download |
|
2.0.6.2-RELEASE |
1.19.4, 1.20.6
|
paper, purpur, spigot
|
Download |
|
2.0.6.1-RELEASE |
1.16.5, 1.17.1, 1.18.2, 1.19.4, 1.20.6
|
paper, purpur, spigot
|
Download |
|
2.0.6.0-RELEASE |
1.17.1, 1.18.2, 1.19.3, 1.19.4, 1.20.4, 1.20.5
|
paper, purpur, spigot
|
Download |
|
2.0.5.7-RELEASE |
1.16.5, 1.17.1, 1.18.2, 1.19.4, 1.20.4
|
paper, purpur, spigot
|
Download |
|
2.0.5.7-SNAPSHOT |
1.19.4, 1.20.4
|
paper, purpur, spigot
|
Download |
|
2.0.5.6-RELEASE |
1.16.5, 1.17.1, 1.18.2, 1.19.4, 1.20.4
|
paper, purpur, spigot
|
Download |
|
2.0.5.5-RELEASE |
1.16.5, 1.17.1, 1.18.2, 1.19.4, 1.20.4
|
paper, purpur, spigot
|
Download |
|
2.0.5.4-RELEASE |
1.16.5, 1.17.1, 1.18.2, 1.19.4, 1.20.4
|
paper, purpur, spigot
|
Download |