QuickShop-Hikari - A powerful, user-friendly and reliable Ch

QuickShop-Hikari

Please note this page is for the spigot-support versions of QuickShop-Hikari. Please note SpigotMC resource page kinda of outdated, please check this resource on Modrinth for latest overview and demo gallery.

We have documents now! Finally
Make sure check the documents for review all features, addons, compatibility modules and configurations.

对于不方便使用 Discord 或 Github Issue Tracker 的用户，也可在 QQ 社区群内 966701484 内寻求热心社区人员的帮助

Looking for Suggested Plugin Pairs?
Try out my Vault fork which has various enhancements for plugin authors to take advantage of, and Folia Support.

VaultUnlocked: https://www.spigotmc.org/resources/vaultunlocked.117277/

Optimized for large network
We write high-performance code that leverages your multi-core processors and moves time-consuming tasks to asynchronous threads.
More features but more robustness.

• Asynchronous execution of disk or network I/O tasks.
  
• Leverage multi-core processors for batch execution of tasks.
  
• A sophisticated store lookup caching system to easily cope with raging events on busy redstone servers.
  
• Compatible with Chat plugin on both BungeeCord and Velocity.
  
• Driven by permission nodes, each function can be precisely controlled by a permission node.
  
• Packet based display item, lagfree.

Optimized for small home server
We write optimized code that provides a wide range of features while saving your server resources. At the same time, QuickShop-Hikari is easy to use even for newbies.

• Follow the simple installation guide, get QuickShop-Hikari ready in 10 mins
• Built-in H2 database, no need to install MySQL, tuned default configurations, just out of the box!

Optimized for players from worldwide

• Easy to use, hold item, click the chest, enter the price, start your business!
• Right-click the shop sign to open the control panel and easily manage common operations.
  
• Say goodbye to scams and preview items for sale in stores before you buy.
  
• Add assistants to help you manage your store, or split with others to automatically distribute benefits.
  
• Leverage QuickShop-Hikari's language system and take advantage of the TranslatableComponent to automatically switch to your client's display language for players from all over the world.
• much much more!

Take the control, plugin is yours
What you're thinking, maybe it's all here!

• Controls the different groups maxmium stores amount.
• Too expensive? Too cheap? Say no!
• Charge fees to players who created shops in period.
• Blacklist the items from selling? You get it!
• Use other blocks as shop? You can!

No exploits, stay safe!
Maybe we're one of the few store plugins with transactional consistency?

• Packet based display item, hoppers can do nothing!
  
• Transaction system, make sure rollback all economy and inventory operations when error occurs.
• Good coding, working on most types of boundarycases.

More technical? Take it a step further!
Can you get started with QuickShop-Hikari already? Then take a look at the more advanced features we can offer.

• Protection Checker, protection plugins can automatically adapt to us whether is known and unknown.
• Per shop permission management, allow the players themselves to control all types of access to their stores as well. Hide from search result? Ban a player for purchase? You can do them!
• Customize your control to your heart's content, just do what you want.

Enhance your experience with extensions
Our large number of optional Addons allows to improve and enrich the player experience based on Hikari.

• DiscordSRV
• Discount
• DisplayControl
• Dynmap
• EcoEnchants
• Limited
• List
• Plan
• Reforges
• much more coming soon!

Refuse to be a maverick, cooperation is the way to go!
We have created a large number of compatibility components to make other plugins work well with QuickShop-Hikari!

• AdvancedRegionMarket
• AngelChest
• BentoBox
• ChestProtect
• Clearlag
• EliteMobs
• GreifPrevention
• Lands
• PlotSquared
  
• Residence
  
• SuperiorSkyBlock
  
• Towny
• WorldEdit
• WorldGuard
• much more coming soon

It's all in the words
We polished QuickShop-Hikari to make it more reliable and usable. Today, the QuickShop series is one of the most popular free store plugins on Bukkit, and QuickShop-Hikari goes one step further by offering tons of detailed switches that can be tweaked.
Take a look at our configurations!

Want to learn more without installing QuickShop-Hikari?
Check out our gallery on Modrinth.

Openness and inclusiveness
QuickShop-Hikari is free and open source software and our source code is hosted on Github. As long as you comply with the GPLV3 license, you are free to edit, build, and distribute your own fork of QuickShop-Hikari.

More content under construction.

------------------------------------------
old thread:

Features

• Easy to use, simply click and type price to create the shops.
  
• NBT Data, Enchantment, Tool Damage, Potion, and Mob Egg supports.
  
• Dynamically switch the display language according to the client language, internationalization friendly.
  
• Unlimited store support.
  
• Blacklist support & bypass permissions.
  
• Shops that buy and sell items in a double-chest.
  
• UUID support (of course)
  
• A cool item preview both in chat and GUI.
  
• Chat Control Panel to change the settings of your shop. Just click to modify everything.
• World/region protection plugins support, and lots of compatibility modules can be downloaded.
  
• ProtocolLib based Virtual DisplayItem (better for performance) support.
  
• Multi-Currency supports, use different currency in shops that from GemsEconomy, TheNewEconomy or any economy that support Reserve. We also support Vault(default) of course!
  
• Tax and ongoing fee support!
  
• Hide commands from help if the player had no permission.
  
• Sign header color and clear description on the info sign for different shops status.
  
• MiniMessage support, create fancy messages as you want.
  
• H2 (local) or MySQL (remote) support.
  
• Advanced transaction mechanism, rollback any Inventory/Economy operation when it failed to execute to prevent player dupes.
  
• InventoryWrapper API offers custom inventory ability for developers.
• Advanced Event Bus to allow user block protection check event transfer to a specific plugin.
• Fast cache layer, handle more than 1k+ shops without any lag! (Require ProtocolLib installed)
• Per-shop permission management.
• Shop benefits between shop owner and other players!
  
• Much much more! Cannot put them all in there!

How to Install
QuickShop requires Minecraft 1.20+ to be run. Any versions below 1.20 were unsupported as of 6.2.0.7.

• Install Vault and an economy plugin supported by Vault.
  If you using Multi-Currency, an option in config.yml that allows you to switch to GemsEconomy/TNE or Reserve!
• Install optional ProtocolLib which can greatly improve QuickShop performance.
• If you're a Spigot user, Hikari will use NMS to set important stuffs, make sure your Hikari version support your Spigot version.
  • Or use Paper or it's fork so we can smooth cross-version.
• Download QuickShop jar and put it in your plugins folder.
• Download other compatibility modules or add-ons if you need them.
  • Only install compatibility modules that you need, they're not open box to use, you need configure them.
  • Most cases, Hikari can handle region protections by itself, you don't need them.
• Turn on the server and here we go!

Commands
Note: Most features can be accessed by control panel or interaction with the shop, in most cases, you don't need those commands.

• /qs unlimited
  Makes your Shop buy/sell Items in unlimited quantity or limited
  
• /qs setowner <player>
  Change the Shop Owner.
• /qs buy
  Change the shop to buying items.
• /qs sell
  Change the shop to selling items.
• /qs price <price>
  Change the buy/sell price of the item.
• /qs clean
  Removes any loaded shop that doesn't have any items in stock.
• /qs find <item>
  Find the nearest shop that sells items that start with the provided text. E.g. /qs find dia will find the nearest shop that buys/sells diamonds.
• /qs fetchmessage
  Fetch shop message manually from the database.
• /qs info
  Show QuickShop information.
• /qs debug
  Enable/Disable Debug Mode.
• /qs create <price> [item]
  Command to create the shop with the item in hand or specified.
• /qs currency <currency name>
  Command to specified the currency the shop using.
  The Economy plugin must support the Multi-Currency feature and be supported by QuickShop. We support GemsEconomy and TNE now.
• /qs supercreate
  Create a shop while bypassing any protection checks.
• /qs paste
  Collects useful information and pastes it on Pastebin.
• /qs staff
  Manage staff in your shop.
  • /qs staff add <player>
    Add a player as staff to your shop.
  • /qs staff del <player>
    Remove a player as staff from your shop.
  • /qs staff clear
    Remove all staff members from your shop.
  • /qs staff list
    Show all current staff members of your shop.
• /qs cleanghost
  Remove all broken shops.
  
• /qs export
  Export all shop data to a TXT file.
  This command is CONSOLE ONLY!
• /qs recovery
  Recover all shops from a TXT file or Paste.
  This command is CONSOLE ONLY and may remove/override any existing shop on your Server! Make a backup first and try it with a clean database!
• /qs size
  Change the bulk size.
  Requires the "allow-stacks" option in the config to be enabled for the command to work.
• /qs purge
  Purge the old shops, for more information please check the purge option in config.yml
  Requires the "purge" option in the config to be enabled for the command to work.
• /qs transfer
  Transfer ALL shops from one player to another.
  
• /qs item
  Change the item of the shop.
  Requires the "allow-stacks" option in the config to be enabled for the command to work.
• /qs removeworld
  Remove all shops in a specific world.
• /qs name
  Naming or un-naming a shop with a specific name.
• /qs permission
• Tweaking the per-shop permissions, or add/remove player into/from specific groups.
• /qs database
• View and manage QuickShop-Hikari status.
• /qs benefit
• View and manage yout shop benefits.

Aliases:

• /shop
• /qshop
• /qsshop
• /quickshop
• /chestshop
• /cshop

(customize the aliases in config.yml ;)

Permissions
If you're a lazy owner, simply give the player "quickshop.player" permission node which contains all needs to let the player create and use quick shops.

But if you're a pro owner, there is also a detailed list to allow control of everything: