Skip to content

Latest commit

 

History

History
88 lines (69 loc) · 4.96 KB

README.md

File metadata and controls

88 lines (69 loc) · 4.96 KB

Shop Search AddOn For QuickShop

Version: 2.0.6.4-RELEASE

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

ModrinthAvailableFor Ver Build Status

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)

QuickShop-Hikari Support

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)
  • Residence support for fetching the residence the shop is in (including subzones)

Check out the sample config.yml here.

Requires

OR

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.

How to contribute?

See more details here.

BStats Metrics

BigImage

Demo

How to use /finditem?

/finditem_usage alt text

Multiple search result pages:

alt text

Shows item enchantments:

alt text

Shows Potion colors and effects:

alt text

Shows custom item names and lore:

alt text