All Mods Resource Packs Data Packs Shaders Modpacks Plugins
Shop Search
Projects / Plugins

Shop Search

by myzticbean • Downloads: 0 • Followers: 0
Install / Download
Description
Gallery
Changelog
Versions

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

ModrinthAvailableFor

🚀 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
Searching for an item Search results
Multiple result pages
Potion effects and colors shown in results Custom item names and lore preserved

📜 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.yml are 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

📚 Links

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

All Versions

+ Add Version
Name Game version Platforms Published Downloads Actions
26.2
Folia Paper Purpur
23h ago 1
26.2
Folia Paper Purpur
23h ago 1
26.2
Folia Paper Purpur
23h ago 1
26.2
Folia Paper Purpur
23h ago 1
26.1.2
Folia Paper Purpur
23h ago 1
26.1.x
Folia Paper Purpur
23h ago 1
1.21.x
Folia Paper Purpur
23h ago 1
1.21.x
Folia Paper Purpur
23h ago 1
1.21.x
Folia Paper Purpur
23h ago 1
1.21.x
Paper Purpur
23h ago 1
1.21.x
Paper Purpur
23h ago 1
1.21.x 1.20.x
Paper Purpur Spigot
23h ago 1
1.21.x
Paper Purpur Spigot
23h ago 1
1.21.x 1.20.x
Bukkit Paper Purpur Spigot
23h ago 1
1.21.x
Paper Purpur Spigot
23h ago 1
1.21.4 1.20.6
Paper Purpur Spigot
23h ago 1
1.21.x 1.20.x
Paper Purpur Spigot
23h ago 1
1.21.x 1.20.x
Paper Purpur Spigot
23h ago 1
1.21.x 1.20.x
Paper Purpur Spigot
23h ago 1
1.21.x 1.20.x
Paper Purpur Spigot
23h ago 1
1.21 1.20.6
Paper Purpur Spigot
23h ago 1
1.20.6 1.19.4
Paper Purpur Spigot
23h ago 1
1.20.6 1.19.4
Paper Purpur Spigot
23h ago 1
1.20.6 1.19.4 1.18.2 +2
Paper Purpur Spigot
23h ago 1
1.20.x 1.19.x 1.18.2 +1
Paper Purpur Spigot
23h ago 1
1.20.4 1.19.4 1.18.2 +2
Paper Purpur Spigot
23h ago 1
1.20.4 1.19.4
Paper Purpur Spigot
23h ago 1
1.20.4 1.19.4 1.18.2 +2
Paper Purpur Spigot
23h ago 1
1.20.4 1.19.4 1.18.2 +2
Paper Purpur Spigot
23h ago 1
1.20.4 1.19.4 1.18.2 +2
Paper Purpur Spigot
23h ago 1
### What's new for server owners
  • Admins can now hide/reveal any player's shop**: players with finditem.admin can use /finditem hideshop and /finditem revealshop on shops they don't own.
  • Much less server lag when running /finditem on servers with many shops**: every search used to check each shop's hidden status by scanning the full list of shops, so the cost grew with the square of your shop count and landed on the main thread in a single tick. That check is now an instant lookup, and shops that don't sell the searched item are filtered out before the more expensive permission checks run.
  • Fixed the "last page" button opening an empty page when the number of results was an exact multiple of 45 (e.g. 90 or 450 shops).

### Changes (technical)
  • ShopSearchActivityStorageUtil keeps a location index alongside globalShopsList; isShopHidden, getPlayerVisitCount, getShopOwnerUUID, visit tracking and hide/reveal now use O(1) lookups instead of linear scans
  • Search match phase now runs as one region task over all shops instead of one scheduler task, future and timeout per shop, with the match checks reordered cheapest/most selective first
### What's new for server owners
  • Noticeably faster searches on large servers** — the shop list sync that runs every 15 minutes (and on startup) has been rewritten to scale linearly instead of getting slower the more shops your server has. Servers with thousands of shops will see a significant drop in that sync time.
  • Search results now always respect your configured sorting method** — previously, browsing all shops (/finditem TO_BUY *) ignored your shop-sorting-method setting and always sorted by a fixed method. It now behaves the same as all other searches.
  • Snappier GUI clicks** — shop teleportation and custom command execution on GUI click are now faster under the hood, with less redundant work per click.
  • Java 25 & Paper API 26.x support** — ready for the latest server versions out of the box.
  • New: limit search results by distance** ([#107](https://github.com/myzticbean/QSFindItemAddOn/issues/107)): a new shop-search-max-distance config option lets you hide shops that are too far away from the searching player. Set it to a block radius (e.g. 1000) to keep results local. Disabled by default (set to 0).
  • Fixed /finditem silently doing nothing when searching enchanted books** ([#110](https://github.com/myzticbean/QSFindItemAddOn/issues/110)), most noticeable with custom-enchantment plugins installed — a per-shop item check was running off the main thread and any error there was being swallowed instead of shown to the player.
  • Fixed shops in unloaded chunks showing 0 stock/space and dropping out of search results** ([#111](https://github.com/myzticbean/QSFindItemAddOn/issues/111)): with search-loaded-shops-only: false, a matched shop whose chunk wasn't currently loaded could report as out of stock even when it wasn't, and get silently filtered out. FindItem now double-checks with a live read before discarding a shop like that.
  • Faster stock/space checks on servers with lots of unloaded shops**: instead of force-loading a shop's chunk just to count what's inside it, FindItem now asks QuickShop-Hikari for its own stored stock/space figure first. Chunk loading is now a last resort, used only when QuickShop has no stored figure yet. This should also resolve reports of /finditem only listing a handful of shops after updating QuickShop-Hikari to 6.3.x — its stock/space check changed to return 0 for any shop in an unloaded chunk, which ignore-empty-chests: true (the default) then silently dropped from results.
  • Fixed a typo in the sample custom-commands list in config.yml: {PLAYER} is not a valid placeholder, {PLAYER_NAME} is.

### Changes (technical)
  • Upgraded to Paper API 26.x / Java 25
  • Added PlatformBridge abstraction (BukkitPlatformBridge) to decouple platform-specific calls from core logic
  • Refactored QSHikariAPIHandler: consolidated three duplicate shop-search methods into a single searchShops(Predicate, boolean, Player) method, removing ~70 lines of duplication
  • Optimized syncShopsListForStorage from O(n²) nested loop to O(n) HashMap lookup — significant speedup on servers with large shop counts
  • fetchAllItemsFromAllShops now respects the configured shop-sorting-method (previously hardcoded to method 1)
  • Eliminated per-shop QS version string parse in stock/space cache lookup — replaced with boolean flag computed once at startup
  • MC version regex in GUI compiled once as static final instead of on every menu open
  • Tab-completion material list in BuySubCmd / SellSubCmd built once statically instead of per instance
  • Shop location string parsed once per GUI click and passed to all handlers, instead of being re-parsed by each handler independently
  • Cleaned up ShopSearchActivityStorageUtil: loadShopsFromFile now calls syncShops() consistently; marked Reremake-era addShop overload and getShopOwner as @Deprecated
  • Added shop-search-max-distance config option ([#107](https://github.com/myzticbean/QSFindItemAddOn/issues/107)): filters out shops beyond a configurable block radius from the searching player; 0 disables (default); cross-world shops are always included; bumped config version to 22
  • QSHikariAPIHandler.searchShops: merged the per-shop permission check and item-match filtering into a single scheduler hop (processShopMatchFuture) so item/meta reads always happen on the entity's region thread instead of ForkJoinPool.commonPool(); per-shop failures are now logged and skipped instead of failing the whole search ([#110](https://github.com/myzticbean/QSFindItemAddOn/issues/110))
  • CmdExecutorHandler.handleShopSearch: added .exceptionally handling to all three search futures so an unexpected failure logs and notifies the player instead of the command silently doing nothing ([#110](https://github.com/myzticbean/QSFindItemAddOn/issues/110))
  • Fixed a thread-safety violation introduced by the #110 fix: QuickShop-Hikari's cache-backed stock/space read (Util.ensureThread(true)) requires running off the main thread, but #110 moved the entire per-shop check — including that stock read — onto the region thread, which would throw on any QuickShop-Hikari v6+ install. QSHikariAPIHandler.processShopMatchFuture now splits into two phases: permission/item-meta matching stays on the region thread (preserving #110's fix), while stock/space reads and list insertion (finalizeMatchedShop) move to a virtual thread so QuickShop-Hikari's threading contract is satisfied ([#111](https://github.com/myzticbean/QSFindItemAddOn/issues/111))
  • Matched shops with a cached/DB stock reading of 0 are now re-verified live if their chunk isn't loaded: QSHikariAPIHandler hops to the shop's own region (FoliaLib#runAtLocation), force-loads the chunk, re-reads stock/space, then unloads the chunk again if it was the one that loaded it ([#111](https://github.com/myzticbean/QSFindItemAddOn/issues/111))
  • shopsFoundList changed from ArrayList to CopyOnWriteArrayList since matched shops are now added concurrently from multiple virtual threads
  • Bumped QuickShop-Hikari to 6.3.0.0-SNAPSHOT-12 and Paper API to 26.2.build.111-stable; migrated all Shop#getLocation() calls to Shop#bukkitLocation() (QuickShop-Hikari made Shop generic, so the raw-typed getLocation() call now erases to Object instead of org.bukkit.Location)
  • Bumped QuickShop-Hikari to the released 6.3.0.2 and migrated to its new CodeMC repository (repo.codemc.io/repository/ghost-chu/); the split quickshop-api / quickshop-bukkit:shaded artifacts were replaced by a single com.ghostchu:quickshop-hikari dependency, which QuickShop now publishes there
  • Stock/space resolution now follows a ladder: unlimited shop → live read if the chunk is loaded → QuickShop's persisted inventory count cache (ShopManager#queryShopInventoryCacheInDatabase) → chunk force-load as a last resort
  • Search stock reads use QuickShop-Hikari 6.3.0.0's ShopInventory#getRemainingStockAsync() and are composed into the existing CompletableFuture chain, removing the per-shop 5-second blocking join()
  • Fixed a thread-safety violation: QuickShop-Hikari's ShopManager#queryShopInventoryCacheInDatabase asserts its caller is already off the main/region thread and throws otherwise. QSHikariAPIHandler.processShopMatchFuture's dispatch into finalizeMatchedShop is now pinned to the virtual-thread executor so it never runs on the region thread
  • Removed the Util.ensureThread(true) assertion from the stock/space cache read — QuickShop-Hikari's own getters no longer require an off-main caller as of 6.3.0.0, and the explicit virtual-thread dispatch above now guarantees it regardless
  • Migrated off Shop#getPrice() (deprecated for removal in 6.3.0.0) to ShopPrice#price()
### What's new for server owners
  • Noticeably faster searches on large servers** — the shop list sync that runs every 15 minutes (and on startup) has been rewritten to scale linearly instead of getting slower the more shops your server has. Servers with thousands of shops will see a significant drop in that sync time.
  • Search results now always respect your configured sorting method** — previously, browsing all shops (/finditem TO_BUY *) ignored your shop-sorting-method setting and always sorted by a fixed method. It now behaves the same as all other searches.
  • Snappier GUI clicks** — shop teleportation and custom command execution on GUI click are now faster under the hood, with less redundant work per click.
  • Java 25 & Paper API 26.x support** — ready for the latest server versions out of the box.
  • New: limit search results by distance** ([#107](https://github.com/myzticbean/QSFindItemAddOn/issues/107)): a new shop-search-max-distance config option lets you hide shops that are too far away from the searching player. Set it to a block radius (e.g. 1000) to keep results local. Disabled by default (set to 0).
  • Fixed /finditem silently doing nothing when searching enchanted books** ([#110](https://github.com/myzticbean/QSFindItemAddOn/issues/110)), most noticeable with custom-enchantment plugins installed — a per-shop item check was running off the main thread and any error there was being swallowed instead of shown to the player.
  • Fixed shops in unloaded chunks showing 0 stock/space and dropping out of search results** ([#111](https://github.com/myzticbean/QSFindItemAddOn/issues/111)): with search-loaded-shops-only: false, a matched shop whose chunk wasn't currently loaded could report as out of stock even when it wasn't, and get silently filtered out. FindItem now double-checks with a live read before discarding a shop like that.
  • Faster stock/space checks on servers with lots of unloaded shops**: instead of force-loading a shop's chunk just to count what's inside it, FindItem now asks QuickShop-Hikari for its own stored stock/space figure first. Chunk loading is now a last resort, used only when QuickShop has no stored figure yet. This should also resolve reports of /finditem only listing a handful of shops after updating QuickShop-Hikari to 6.3.x — its stock/space check changed to return 0 for any shop in an unloaded chunk, which ignore-empty-chests: true (the default) then silently dropped from results.
  • Fixed a typo in the sample custom-commands list in config.yml: {PLAYER} is not a valid placeholder, {PLAYER_NAME} is.

### Changes (technical)
  • Upgraded to Paper API 26.x / Java 25
  • Added PlatformBridge abstraction (BukkitPlatformBridge) to decouple platform-specific calls from core logic
  • Refactored QSHikariAPIHandler: consolidated three duplicate shop-search methods into a single searchShops(Predicate, boolean, Player) method, removing ~70 lines of duplication
  • Optimized syncShopsListForStorage from O(n²) nested loop to O(n) HashMap lookup — significant speedup on servers with large shop counts
  • fetchAllItemsFromAllShops now respects the configured shop-sorting-method (previously hardcoded to method 1)
  • Eliminated per-shop QS version string parse in stock/space cache lookup — replaced with boolean flag computed once at startup
  • MC version regex in GUI compiled once as static final instead of on every menu open
  • Tab-completion material list in BuySubCmd / SellSubCmd built once statically instead of per instance
  • Shop location string parsed once per GUI click and passed to all handlers, instead of being re-parsed by each handler independently
  • Cleaned up ShopSearchActivityStorageUtil: loadShopsFromFile now calls syncShops() consistently; marked Reremake-era addShop overload and getShopOwner as @Deprecated
  • Added shop-search-max-distance config option ([#107](https://github.com/myzticbean/QSFindItemAddOn/issues/107)): filters out shops beyond a configurable block radius from the searching player; 0 disables (default); cross-world shops are always included; bumped config version to 22
  • QSHikariAPIHandler.searchShops: merged the per-shop permission check and item-match filtering into a single scheduler hop (processShopMatchFuture) so item/meta reads always happen on the entity's region thread instead of ForkJoinPool.commonPool(); per-shop failures are now logged and skipped instead of failing the whole search ([#110](https://github.com/myzticbean/QSFindItemAddOn/issues/110))
  • CmdExecutorHandler.handleShopSearch: added .exceptionally handling to all three search futures so an unexpected failure logs and notifies the player instead of the command silently doing nothing ([#110](https://github.com/myzticbean/QSFindItemAddOn/issues/110))
  • Fixed a thread-safety violation introduced by the #110 fix: QuickShop-Hikari's cache-backed stock/space read (Util.ensureThread(true)) requires running off the main thread, but #110 moved the entire per-shop check — including that stock read — onto the region thread, which would throw on any QuickShop-Hikari v6+ install. QSHikariAPIHandler.processShopMatchFuture now splits into two phases: permission/item-meta matching stays on the region thread (preserving #110's fix), while stock/space reads and list insertion (finalizeMatchedShop) move to a virtual thread so QuickShop-Hikari's threading contract is satisfied ([#111](https://github.com/myzticbean/QSFindItemAddOn/issues/111))
  • Matched shops with a cached/DB stock reading of 0 are now re-verified live if their chunk isn't loaded: QSHikariAPIHandler hops to the shop's own region (FoliaLib#runAtLocation), force-loads the chunk, re-reads stock/space, then unloads the chunk again if it was the one that loaded it ([#111](https://github.com/myzticbean/QSFindItemAddOn/issues/111))
  • shopsFoundList changed from ArrayList to CopyOnWriteArrayList since matched shops are now added concurrently from multiple virtual threads
  • Bumped QuickShop-Hikari to 6.3.0.0-SNAPSHOT-12 and Paper API to 26.2.build.111-stable; migrated all Shop#getLocation() calls to Shop#bukkitLocation() (QuickShop-Hikari made Shop generic, so the raw-typed getLocation() call now erases to Object instead of org.bukkit.Location)
  • Bumped QuickShop-Hikari to the released 6.3.0.2 and migrated to its new CodeMC repository (repo.codemc.io/repository/ghost-chu/); the split quickshop-api / quickshop-bukkit:shaded artifacts were replaced by a single com.ghostchu:quickshop-hikari dependency, which QuickShop now publishes there
  • Stock/space resolution now follows a ladder: unlimited shop → live read if the chunk is loaded → QuickShop's persisted inventory count cache (ShopManager#queryShopInventoryCacheInDatabase) → chunk force-load as a last resort
  • Search stock reads use QuickShop-Hikari 6.3.0.0's ShopInventory#getRemainingStockAsync() and are composed into the existing CompletableFuture chain, removing the per-shop 5-second blocking join()
  • Fixed a thread-safety violation: QuickShop-Hikari's ShopManager#queryShopInventoryCacheInDatabase asserts its caller is already off the main/region thread and throws otherwise. QSHikariAPIHandler.processShopMatchFuture's dispatch into finalizeMatchedShop is now pinned to the virtual-thread executor so it never runs on the region thread
  • Removed the Util.ensureThread(true) assertion from the stock/space cache read — QuickShop-Hikari's own getters no longer require an off-main caller as of 6.3.0.0, and the explicit virtual-thread dispatch above now guarantees it regardless
  • Migrated off Shop#getPrice() (deprecated for removal in 6.3.0.0) to ShopPrice#price()
### What's new for server owners
  • Noticeably faster searches on large servers** — the shop list sync that runs every 15 minutes (and on startup) has been rewritten to scale linearly instead of getting slower the more shops your server has. Servers with thousands of shops will see a significant drop in that sync time.
  • Search results now always respect your configured sorting method** — previously, browsing all shops (/finditem TO_BUY *) ignored your shop-sorting-method setting and always sorted by a fixed method. It now behaves the same as all other searches.
  • Snappier GUI clicks** — shop teleportation and custom command execution on GUI click are now faster under the hood, with less redundant work per click.
  • Java 25 & Paper API 26.x support** — ready for the latest server versions out of the box.
  • New: limit search results by distance** ([#107](https://github.com/myzticbean/QSFindItemAddOn/issues/107)): a new shop-search-max-distance config option lets you hide shops that are too far away from the searching player. Set it to a block radius (e.g. 1000) to keep results local. Disabled by default (set to 0).
  • Fixed /finditem silently doing nothing when searching enchanted books** ([#110](https://github.com/myzticbean/QSFindItemAddOn/issues/110)), most noticeable with custom-enchantment plugins installed — a per-shop item check was running off the main thread and any error there was being swallowed instead of shown to the player.
  • Fixed shops in unloaded chunks showing 0 stock/space and dropping out of search results** ([#111](https://github.com/myzticbean/QSFindItemAddOn/issues/111)): with search-loaded-shops-only: false, a matched shop whose chunk wasn't currently loaded could report as out of stock even when it wasn't, and get silently filtered out. FindItem now double-checks with a live read before discarding a shop like that.

### Changes (technical)
  • Upgraded to Paper API 26.x / Java 25
  • Added PlatformBridge abstraction (BukkitPlatformBridge) to decouple platform-specific calls from core logic
  • Refactored QSHikariAPIHandler: consolidated three duplicate shop-search methods into a single searchShops(Predicate, boolean, Player) method, removing ~70 lines of duplication
  • Optimized syncShopsListForStorage from O(n²) nested loop to O(n) HashMap lookup — significant speedup on servers with large shop counts
  • fetchAllItemsFromAllShops now respects the configured shop-sorting-method (previously hardcoded to method 1)
  • Eliminated per-shop QS version string parse in stock/space cache lookup — replaced with boolean flag computed once at startup
  • MC version regex in GUI compiled once as static final instead of on every menu open
  • Tab-completion material list in BuySubCmd / SellSubCmd built once statically instead of per instance
  • Shop location string parsed once per GUI click and passed to all handlers, instead of being re-parsed by each handler independently
  • Cleaned up ShopSearchActivityStorageUtil: loadShopsFromFile now calls syncShops() consistently; marked Reremake-era addShop overload and getShopOwner as @Deprecated
  • Added shop-search-max-distance config option ([#107](https://github.com/myzticbean/QSFindItemAddOn/issues/107)): filters out shops beyond a configurable block radius from the searching player; 0 disables (default); cross-world shops are always included; bumped config version to 22
  • QSHikariAPIHandler.searchShops: merged the per-shop permission check and item-match filtering into a single scheduler hop (processShopMatchFuture) so item/meta reads always happen on the entity's region thread instead of ForkJoinPool.commonPool(); per-shop failures are now logged and skipped instead of failing the whole search ([#110](https://github.com/myzticbean/QSFindItemAddOn/issues/110))
  • CmdExecutorHandler.handleShopSearch: added .exceptionally handling to all three search futures so an unexpected failure logs and notifies the player instead of the command silently doing nothing ([#110](https://github.com/myzticbean/QSFindItemAddOn/issues/110))
  • Fixed a thread-safety violation introduced by the #110 fix: QuickShop-Hikari's cache-backed stock/space read (Util.ensureThread(true)) requires running off the main thread, but #110 moved the entire per-shop check — including that stock read — onto the region thread, which would throw on any QuickShop-Hikari v6+ install. QSHikariAPIHandler.processShopMatchFuture now splits into two phases: permission/item-meta matching stays on the region thread (preserving #110's fix), while stock/space reads and list insertion (finalizeMatchedShop) move to a virtual thread so QuickShop-Hikari's threading contract is satisfied ([#111](https://github.com/myzticbean/QSFindItemAddOn/issues/111))
  • Matched shops with a cached/DB stock reading of 0 are now re-verified live if their chunk isn't loaded: QSHikariAPIHandler hops to the shop's own region (FoliaLib#runAtLocation), force-loads the chunk, re-reads stock/space, then unloads the chunk again if it was the one that loaded it ([#111](https://github.com/myzticbean/QSFindItemAddOn/issues/111))
  • shopsFoundList changed from ArrayList to CopyOnWriteArrayList since matched shops are now added concurrently from multiple virtual threads
  • Bumped QuickShop-Hikari to 6.3.0.0-SNAPSHOT-12 and Paper API to 26.2.build.111-stable; migrated all Shop#getLocation() calls to Shop#bukkitLocation() (QuickShop-Hikari made Shop generic, so the raw-typed getLocation() call now erases to Object instead of org.bukkit.Location)
### What's new for server owners
  • Noticeably faster searches on large servers** — the shop list sync that runs every 15 minutes (and on startup) has been rewritten to scale linearly instead of getting slower the more shops your server has. Servers with thousands of shops will see a significant drop in that sync time.
  • Search results now always respect your configured sorting method** — previously, browsing all shops (/finditem TO_BUY *) ignored your shop-sorting-method setting and always sorted by a fixed method. It now behaves the same as all other searches.
  • Snappier GUI clicks** — shop teleportation and custom command execution on GUI click are now faster under the hood, with less redundant work per click.
  • Java 25 & Paper API 26.x support** — ready for the latest server versions out of the box.
  • New: limit search results by distance** ([#107](https://github.com/myzticbean/QSFindItemAddOn/issues/107)): a new shop-search-max-distance config option lets you hide shops that are too far away from the searching player. Set it to a block radius (e.g. 1000) to keep results local. Disabled by default (set to 0).
  • Fixed /finditem silently doing nothing when searching enchanted books** ([#110](https://github.com/myzticbean/QSFindItemAddOn/issues/110)), most noticeable with custom-enchantment plugins installed — a per-shop item check was running off the main thread and any error there was being swallowed instead of shown to the player.

### Changes (technical)
  • Upgraded to Paper API 26.x / Java 25
  • Added PlatformBridge abstraction (BukkitPlatformBridge) to decouple platform-specific calls from core logic
  • Refactored QSHikariAPIHandler: consolidated three duplicate shop-search methods into a single searchShops(Predicate, boolean, Player) method, removing ~70 lines of duplication
  • Optimized syncShopsListForStorage from O(n²) nested loop to O(n) HashMap lookup — significant speedup on servers with large shop counts
  • fetchAllItemsFromAllShops now respects the configured shop-sorting-method (previously hardcoded to method 1)
  • Eliminated per-shop QS version string parse in stock/space cache lookup — replaced with boolean flag computed once at startup
  • MC version regex in GUI compiled once as static final instead of on every menu open
  • Tab-completion material list in BuySubCmd / SellSubCmd built once statically instead of per instance
  • Shop location string parsed once per GUI click and passed to all handlers, instead of being re-parsed by each handler independently
  • Cleaned up ShopSearchActivityStorageUtil: loadShopsFromFile now calls syncShops() consistently; marked Reremake-era addShop overload and getShopOwner as @Deprecated
  • Added shop-search-max-distance config option ([#107](https://github.com/myzticbean/QSFindItemAddOn/issues/107)): filters out shops beyond a configurable block radius from the searching player; 0 disables (default); cross-world shops are always included; bumped config version to 22
  • QSHikariAPIHandler.searchShops: merged the per-shop permission check and item-match filtering into a single scheduler hop (processShopMatchFuture) so item/meta reads always happen on the entity's region thread instead of ForkJoinPool.commonPool(); per-shop failures are now logged and skipped instead of failing the whole search ([#110](https://github.com/myzticbean/QSFindItemAddOn/issues/110))
  • CmdExecutorHandler.handleShopSearch: added .exceptionally handling to all three search futures so an unexpected failure logs and notifies the player instead of the command silently doing nothing ([#110](https://github.com/myzticbean/QSFindItemAddOn/issues/110))
[2.0.8.1-SNAPSHOT] Build-260517 by myzticbean on Oct 15, 2026
Download
### Changelog
  • Java 25 & Paper API 26.x support**: ready for the latest server versions out of the box.
  • Noticeably faster searches on large servers**: the shop list sync that runs every 15 minutes (and on startup) has been rewritten to scale linearly instead of getting slower the more shops your server has. Servers with thousands of shops will see a significant drop in that sync time.
  • Search results now always respect your configured sorting method**: previously, browsing all shops (/finditem TO_BUY *) ignored your shop-sorting-method setting and always sorted by a fixed method. It now behaves the same as all other searches.
  • Snappier GUI clicks**: shop teleportation and custom command execution on GUI click are now faster under the hood, with less redundant work per click.
  • New: limit search results by distance** ([#107](https://github.com/myzticbean/QSFindItemAddOn/issues/107)): a new shop-search-max-distance config option lets you hide shops that are too far away from the searching player. Set it to a block radius (e.g. 1000) to keep results local. Disabled by default (set to 0).

  • _PS: This is a snapshot build and bugs may arise._**
### Changes
  • QS-Reremake support has been dropped completely
  • GUI click is now async
  • Added debug mode control via command: /finditemadmin debug-mode {enable | disable}
  • Bumped Paper API version to 1.21.11-R0.1-SNAPSHOT
  • Bumped Kyori's adventure-api to 4.26.1
  • Bumped worldguard-bukkit to 7.0.16
  • Bumped playerwarps-api to 7.10.0
  • Removed Spigot API dependency
  • Bumped Quickshop-Hikari to 6.2.0.11
  • Folia support by Jsinco
  • Bumped essentialsX to 2.21.2

### Bug fixes
  • Fixed a bug during loadShopsFromFile if one of the loaded shops was null by adding a null check
  • Bug fix for update checker, notify snapshot version availability for snapshot users only (#102)
[2.0.8.0-SNAPSHOT] Build-260308 by myzticbean on Oct 15, 2026
Download
## Bug fixes
  • fix(folia): teleporting to shops on folia

_PS: Folia support is in early stages and bugs may arise._
[2.0.8.0-SNAPSHOT] Build-260225 by myzticbean on Oct 15, 2026
Download
## Changes
  • Folia Support
  • QS-Hikari 6.2.0.11 Support

_PS: Folia support is in early stages and bugs may arise._
  • QS-Reremake support has been dropped completely
  • GUI click is now async
  • Added debug mode control via command: /finditemadmin debug-mode {enable | disable}
  • Version bumps for dependencies.
  • Support for Quickshop-Hikari 6.2.0.11-RELEASE-CANDIDATE-2

NOTE: This is a snapshot version and is only compatible with QS-Hikari v6.2.0.11-RELEASE-CANDIDATE-2. If you are using QS-Hikari v6.2.0.10, then use AddOn [v2.0.7.7-RELEASE](https://modrinth.com/plugin/shop-search/version/2.0.7.7-RELEASE).

### Changes
  • GUI click is now async
  • Some performance tweaks
  • Added debug mode control via command: /finditemadmin debug-mode {enable | disable}
  • Internal API changes to make it compatible with QS-Hikari v6.2.0.11
  • QS-Reremake support has been dropped completely
### Changes
  • Bumped Spigot dependency to 1.21.8-R0.1-SNAPSHOT
  • Bumped QS-Hikari dependency to 6.2.0.10
  • Bumped Bentobox dependency to 3.7.3
  • Internal refactoring that shouldn't impact gameplay
### Bug fixes
  • Fixed /finditem hideshop//finditem revealshop not working for newly created shop
  • Added support for custom-model-data to the GUI filler item
  • Added support for {SHOP_WORLD} placeholder in custom commands

### Changes
  • Optimized the size of the shops.json file
  • Updated config version to 21
### Changes
  • Updated dependencies to latest version
  • Fixed a bug teleporting to a shop without essentials (Thanks Jaden!)
### Bug fixes
  • Fix for /finditem shows only 'searching...' but no GUI [Thanks @Jsinco!]

If you would also like to contribute to the plugin updates, check out the github repository [here](https://github.com/myzticbean/QSFindItemAddOn).
### Changes
  • JDK version upgraded from 17 to 21
  • Added check to exclude shops of buying shops for owners who don't have enough money.
  • Bentobox integration to ignore shops in locked islands

### Bug fixes
  • Hideshop/revealshop should work with double chests also
  • fixed item meta not showing correctly in Search GUI
  • Player Warps dependency updated
  • Added config option to suppress update notifications in chat
``yaml
suppress-update-notifications: false
`
  • Added config option to configure blacklisted materials
`yaml
blacklisted-materials:
  • "BARRIER"
  • "STRUCTURE_BLOCK"
  • "COMMAND_BLOCK"
``
  • Added runnable custom commands on GUI item click. New related config options added.
  • Added a new permission to bypass safety check for shop tp.
### Changes
  • Added runnable custom commands on GUI item click. New related config options added.
  • Added a new permission to bypass safety check for shop tp (finditem.shoptp.bypass-safetycheck).
### Changes

### Bug fixes
### Changes
### Changes
## Release 2.0.6.1
### Bug fixes
## Release 2.0.6.0
### Changes (Feature request [#23](https://github.com/myzticbean/QSFindItemAddOn/issues/23))
  • Plugin updated for Minecraft version 1.20.5.
  • Changed 15Min Scheduled Task to run in async thread (should help with lag).
  • Reremake implementation will no longer be updated. Last support is for QS-Reremake v5.1.2.5.
  • Changed logger statements to show Main/Async thread state.
  • Structural changes in the config.yml, specifically for shop-gui related options.
  • Fixed an issue with showing large numbers in currency.
  • Added new feature to format currency format. For example: $10,210,100 will be shown as $10.21M. New config option to toggle it:
``yaml
shop-gui:
use-shorter-currency-format: true
`
  • New config option added as below to toggle if players should be allowed to warp to locked warps (Only for PlayerWarps).
`yaml
player-shop-teleportation:
nearest-warp-tp-mode:
do-not-tp-if-warp-locked: true
``
  • Config version is now 15.
## Release 2.0.5.7
### Bug fixes
## Snapshot 2.0.5.7
### Bug fixes

_Note: This is a snapshot build, and not recommended for use on production servers right now._
## Release 2.0.5.6 (Recommended Update)
### Bug fixes
  • Fix the lag issue caused due to new QS-Hikari cache feature impl ([#12](https://github.com/myzticbean/QSFindItemAddOn/issues/12))
  • Fixed a code refactoring bug where search all shops would return no shops for Quickshop Reremake
  • Added a INFO level logger to log time taken for a search process
## Release 2.0.5.5 (RECOMMENDED UPDATE)
### Bug fixes
### Features
### Bug fixes

🌟 Related Projects

Similar modifications and resources you might like

View all →
AxTrade
A

AxTrade

by ArtillexStudios

A lightweight but feature rich & multi-currency trade plugin with a simple configuration.

0
plugin
Auction House Plugin
A

Auction House Plugin

by ElaineQheart

Use /ah to open the auctionHouse.

0
plugin
EssentialsC [1.20.6-26.3+ | Folia Support ]
E

EssentialsC [1.20.6-26.3+ | Folia Support ]

by _GodlyCow

No Legacy Bloat. Folia Support. Maintained. Fully toggable modules !

0
plugin
Donut Orders
D

Donut Orders

by NAIZO

A player-driven buy-order marketplace.

0
plugin
Shop Search Icon
Download Shop Search
Select game version
Select platform