🔍 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

1. Drop the jar in plugins/
2. Restart your server (a config.yml is generated for you automatically)
3. Run /finditem in 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

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.yml are on the GitHub Wiki.

🔌 Plays nicely with

Auto-detected on startup, zero extra setup required:

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

• Wiki & full config reference
• Report a bug / request a feature
• Source code
• Contributing guide

Free and open source, GPLv3 licensed. Anonymous usage stats via bStats help prioritize what to build next, no personal data collected.