COWMODSКаталог модов

Shop Search

An add-on for the QuickShop Hikari spigot plugin. Adds a /finditem command in game for searching through all the shops on the server.

Автор: myzticbean9,3 тыс.29обновлён 14 окт. 2026 г.
ЭкономикаУтилиты

Описание

🔍 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 itemSearch results
Multiple result pagesEnchantments shown in results
Potion effects and colors shown in resultsCustom item names and lore preserved

📜 Command cheat sheet

CommandWhat 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 hideshopHide the shop you're looking at from search results
/finditem revealshopMake a hidden shop searchable again
/finditemadmin reloadReload 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:

PluginWhat it adds
PlayerWarpsShows the nearest warp to each shop in results
EssentialsX WarpsSame, using Essentials warps
WorldGuardShows which region a shop sits in
ResidenceShows which residence (and subzone) a shop sits in
BentoBoxKeeps 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.

Галерея

/finditem usage/finditem usageMultiple search result pagesShows item enchantments

Последние версии

Все версии →
beta

2.0.8.3-SNAPSHOT-36

2.0.8.3-SNAPSHOT-36
14 окт. 2026 г.135Minecraft: 26.2folia, paper, purpur
Скачать
Что нового
### 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
release

2.0.8.2-RELEASE

2.0.8.2-RELEASE
11 сент. 2026 г.397Minecraft: 26.2folia, paper, purpur
Скачать
Что нового
### 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()`
beta

2.0.8.2-SNAPSHOT-32

2.0.8.2-SNAPSHOT-32
5 сент. 2026 г.73Minecraft: 26.2folia, paper, purpur
Скачать
Что нового
### 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()`
beta

2.0.8.1-SNAPSHOT-31

2.0.8.1-SNAPSHOT-31
9 авг. 2026 г.189Minecraft: 26.2folia, paper, purpur
Скачать
Что нового
### 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`)
beta

2.0.8.1-SNAPSHOT-28

2.0.8.1-SNAPSHOT-28
7 авг. 2026 г.103Minecraft: 26.1.2folia, paper, purpur
Скачать
Что нового
### 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))
beta

Build-260517

2.0.8.1-SNAPSHOT
17 мая 2026 г.496Minecraft: 26.1, 26.1.1, 26.1.2folia, paper, purpur
Скачать
Что нового
### 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._**
release

2.0.8.0-RELEASE

2.0.8.0-RELEASE
17 мая 2026 г.726Minecraft: 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.11folia, paper, purpur
Скачать
Что нового
### 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)
beta

Build-260308

2.0.8.0-SNAPSHOT
8 мар. 2026 г.580Minecraft: 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.11folia, paper, purpur
Скачать
Что нового
## Bug fixes - fix(folia): teleporting to shops on folia _PS: Folia support is in early stages and bugs may arise._
beta

Build-260225

2.0.8.0-SNAPSHOT
1 мар. 2026 г.318Minecraft: 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.11folia, paper, purpur
Скачать
Что нового
## Changes - Folia Support - QS-Hikari `6.2.0.11` Support _PS: Folia support is in early stages and bugs may arise._
beta

2.0.8.0-SNAPSHOT

2.0.8.0-SNAPSHOT
1 февр. 2026 г.453Minecraft: 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.11paper, purpur
Скачать
Что нового
- 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).