Перейти к содержимому
Mineforgian

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.

Загрузки
7K
Подписчики
28
Обновлён
17 мая 2026 г.
Лицензия
GPL-3.0-only

Опубликован 18 февраля 2024 г.

Исходный кодСообщить об ошибке

Shop Search AddOn For QuickShop

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

MC Ver

Features

  • Search items based on buying/selling shops
  • Search items by item type
  • Supports query based item search
  • Supports item custom model data for custom items
  • Configurable shop sorting methods
  • Displays enchantments in the result for enchanted items
  • Hides item enchants if item has hide_enchants flag
  • Displays potion effects in the result for Potion items
  • Hide certain shops from appearing in search lists
  • Supports completely safe direct shop teleportation (configurable in config.yml)
  • Ignores shops that are out of stock by default
  • Support for world blacklisting (Shops in blacklisted worlds are ignored in the search result)

Hexcode color support

  • All messages in the config.yml support hexcodes.

View all shops on server

  • You can do /finditem TO_BUY * or /finditem TO_SELL * to view all shops on the server. As of this version, the sequence is always randomized. Sorting options are a work in progress.

Shop visit count

  • You can choose to display shop visits count in the shop lore in Search GUI. Just add the placeholder {SHOP_VISITS} in the shop-gui-item-lore in config.yml. To prevent visit spamming, a new config property shop-player-visit-cooldown-in-minutes has been added. Please don't use decimals here.

Customizable command aliases

  • You can find a property in config.yml called command-alias where you can specify your own list of command aliases for /finditem command. If you don't wish to add any, just make it as:
command-alias: []

Integrations

  • Supports PlayerWarps (by Olzie-12) integration. It shows the nearest warp to each shop in the search result GUI.
  • Supports EssentialsX Warps integration for fetching nearest warps.
    • Global warps list for essentials is updated in batches every 15 minutes due to technical limitations, which is then used in every search query.
    • If you added a new warp and want it to get updated immediately, run /finditemadmin reload
    • Remember, this applies only to Essential Warps.
  • WorldGuard region support for fetching the WorldGuard region the shop is in (if overlapping regions, highest priority will be chosen)

Check out the sample config.yml here.

Requires

Assumptions

  • A compatible economy plugin is installed
  • Vault 1.7.3 or higher is installed

Issue Tracking

Please create a new issue here if you encounter any errors. Please try to explain in detail about your issue, and attach your console log if possible. You can also find the list of features currently being worked on (if any) in the same link.

BStats Metrics

BigImage

Ченджлог

2.0.8.1-SNAPSHOTБета26.1, 26.1.1, 26.1.2 · 17 мая 2026 г.

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): 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.

2.0.8.0-RELEASEРелиз1.21.9, 1.21.10, 1.21.11 · 17 мая 2026 г.

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Бета1.21.9, 1.21.10, 1.21.11 · 8 марта 2026 г.

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Бета1.21.9, 1.21.10, 1.21.11 · 1 марта 2026 г.

Changes

  • Folia Support
  • QS-Hikari 6.2.0.11 Support

PS: Folia support is in early stages and bugs may arise.

2.0.8.0-SNAPSHOTБета1.21.9, 1.21.10, 1.21.11 · 1 февраля 2026 г.
  • 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.

2.0.8.0-SNAPSHOTБета1.21.8, 1.21.9, 1.21.10 · 31 октября 2025 г.

NOTE: This is a snapshot version and is only compatible with QS-Hikari v6.2.0.11 snapshots. If you are using QS-Hikari v6.2.0.10, then use AddOn v2.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
2.0.7.7-RELEASEРелиз1.21.6, 1.21.7, 1.21.8 · 24 сентября 2025 г.

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
2.0.7.6-RELEASEРелиз1.21.3, 1.21.4, 1.21.5 · 28 мая 2025 г.

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

Комментарии

Загружаем…