🔍 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.
