Home›Java›Mods›QuickShop-Hikari - A powerful, user-friendly and reliable ChestShop plugin [1.20-1.21]
![QuickShop-Hikari - A powerful, user-friendly and reliable ChestShop plugin [1.20-1.21]](https://www.spigotmc.org/data/resource_icons/100/100125.jpg?1645208352){kind=icon}
ModsJava
QuickShop-Hikari - A powerful, user-friendly and reliable ChestShop plugin [1.20-1.21]
Java mod listed for Minecraft 1.20–1.21. Downloads from the MC Java Mods app on Android.
⬇ Download on SpigotQuickShop-Hikari
![[IMG]](//proxy.spigotmc.org/012182fe595b23c930b703f8ac237000b63cb063/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f47686f73742d6368752f517569636b53686f702d48696b6172692e737667)
![[IMG]](//proxy.spigotmc.org/11f1534870c2d3fac7fca48c1b97608f7ab8623c/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f636f6e7472696275746f72732f47686f73742d6368752f517569636b53686f702d48696b617269)
![[IMG]](//proxy.spigotmc.org/7e3681ceced8b5556ca211775363e6bb4a529f00/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6a6176612d76657273696f6e25323031372532422532302863757272656e746c79253230697325323031372d2d3138292d6f72616e6765)
![[IMG]](//proxy.spigotmc.org/3414cca3d5c8e74817a90a1d9ea0cd1d3a34c195/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6d696e6563726166742d6a61766125323065646974696f6e253230312e32302532422d626c756576696f6c6574)
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.
![[IMG]](//proxy.spigotmc.org/a9a1b1c3654664df0a65bc64c2b883a551a7bc57/68747470733a2f2f757365722d696d616765732e67697468756275736572636f6e74656e742e636f6d2f33303830323536352f3135343733323532372d38353963346265642d313534382d343162632d626462662d3363313935346633363864632e6a7067)
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.
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.
What you're thinking, maybe it's all here!
Maybe we're one of the few store plugins with transactional consistency?
Can you get started with QuickShop-Hikari already? Then take a look at the more advanced features we can offer.
Our large number of optional Addons allows to improve and enrich the player experience based on Hikari.
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!
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
QuickShop requires Minecraft 1.20+ to be run. Any versions below 1.20 were unsupported as of 6.2.0.7.
Note: Most features can be accessed by control panel or interaction with the shop, in most cases, you don't need those commands.
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:
How to create a shop
To create a shop, place down a chest and left-click it with the number of items you want to sell.
For example: If I want to sell 16 diamonds will I need to hold 16 diamonds in my hand and left-click the chest with it. (Need allow-stacks: true and permission).
![[IMG]](//proxy.spigotmc.org/be7721b88da8ea362a5d79328d8094068684da19/68747470733a2f2f63646e2e646973636f72646170702e636f6d2f6174746163686d656e74732f3934343330303631323835363731333233362f3937353430323037383234393832383430322f315f312e676966)
You will then be prompted to type in the chat, how much you would like to sell this item for.
Note: You may encounter issues with the chat system if you're on a BungeeCord network that utilizes a global chat plugin like BungeeChat. In such a case will you need to use commands to create a shop!
After you completed those steps should an item be displayed on top (Can be toggled off in the configuration) and a sign with info be placed on the side of the chest.
A Shop may not be created if there is no space around the chest to place down a sign.
How to buy/sell Items
To buy or sell an Item from/to a Shop will you need to left-click the sign.
You will then be prompted to write the amount you want to buy/sell in chat.
Whether a shop sells or buys items depends on the displayed info on the sign.
![[IMG]](//proxy.spigotmc.org/f5cd6b9fcaa833b25b208d0a5e1c80aae7932971/68747470733a2f2f63646e2e646973636f72646170702e636f6d2f6174746163686d656e74732f3934343330303631323835363731333233362f3937353430313632333638333733393637382f322e676966)
Advanced Features
Item Preview GUI
Preview the item you will purchase before actual purchase to avoid scam!
![[IMG]](//proxy.spigotmc.org/7a43e908faa816a0195c4b839eef740ac71cb65c/68747470733a2f2f63646e2e646973636f72646170702e636f6d2f6174746163686d656e74732f3934343330303631323835363731333233362f3934343330313338393132313734393032322f6974656d2d707265766965772e676966)
Shop Control Panel
Shop Control Panel allows tweaks to your shop with one click, no command needs!
![[IMG]](//proxy.spigotmc.org/5db42b688d19c699e82288a87bc2e4d64ea17356/68747470733a2f2f63646e2e646973636f72646170702e636f6d2f6174746163686d656e74732f3934343330303631323835363731333233362f3937353430313234343236363938373534302f3135343734333437342d34653332616465362d346630372d343562312d386363662d3536323765613165323566372e676966)
Shop Staff
Shop owner can able to managing shop staff by using the command `/qs staff <add/del/list> <player>`, which allow shop staff to access your shop to manage the stock.
Ender Chest Inventory Linkage
Install OpenInv and openinv compatibility module and you will be able to use `/qs echest` to link your quick shop to your ender chest inventory! So all your echest shops can share with your ender chest inventory!
Rules-Based Price Limiter
Create rules to limit shops' prices with specific materials!
Translation OTA & Override system
Unlike other plugins, QuickShop uses CrowdinOTA technology to update our translation over the air. You can always enjoy the latest translations. All translations will keep updated with the cloud.
If you need to customize the translation, you can follow our guide to use the override customize system!
Shop Purger
Purge shops that owner no longer active or banned!
Our compatibility modules also offer purge player shops while it leave teams/islands/lands.
Interaction Controller & Direct Trade
Custom the click behavior through interaction.yml!
You can sell or buy 1 or all things directly by sneaking clicking (or any behavior you configured).
Item Stacking
Enable the allow-stack option in config.yml, then you can create a stacking shop by holding more than one item in hand. So players must buy items that are multiples of their holding.
![[IMG]](//proxy.spigotmc.org/d61b60c9e2c53d73dc683cf6ed6f1a4579638643/68747470733a2f2f63646e2e646973636f72646170702e636f6d2f6174746163686d656e74732f3934343330303631323835363731333233362f3934343330313539393336393631373432382f737461636b696e672e676966)
Per shop permission management
Have you ever considered putting another player in full charge of your shop?
Or just ban a player to avoid him purchase your shop?
You can do this now with per shop permission management.
Compatibility Modules
QuickShop-Hikari officially provides some plugins compatibility modules to make them work more closely with QuickShop, here is a list that we currently support:
ShopSearch by Ronsane
Adds a /finditem command in game for searching through all the shops on the server.
[Download]
Known Incompatible Plugins
Some plugins may not work together with QuickShop and there is little we can do on our side to fix this.
You can help us to translate QuickShop into as many languages as possible!
![[IMG]](//proxy.spigotmc.org/41490928ccc94e745d1b5e4516681a823086715d/68747470733a2f2f63646e2e646973636f72646170702e636f6d2f6174746163686d656e74732f3934343330303631323835363731333233362f3934343330313832313936393731313137342f323032322d30322d31395f3031323633302e706e67)
You can find the currently worked on translations over at Crowdin:
https://crowdin.com/project/qs-hikari
![[IMG]](//proxy.spigotmc.org/72517d2397060100d62252797c27d02ec51cf53b/68747470733a2f2f6261646765732e63726f7764696e2e6e65742f717569636b73686f702d68696b6172692f6c6f63616c697a65642e737667)
Can't find your language? Open an issue on Issue Tracker!
FAQ
Q: Can I create a shop that sells AND buys items?
A: No. Each shop can only sell or buy but not both at once. You can however use a double-chest to have two shops. One buying and one selling the item.
Q: Can I use item currency like diamonds?
A: No. We won't add it. But you can choose some economy plugins that allows you to use item currency.
Q: The plugin doesn't respond when creating a shop. Is it broken?
A: Some plugins may cancel the Shop-creation. Most commonly is this the case with protection plugins. You can disable the shop.protection-checking in the config to bypass this.
Q: How can I create a Shop selling stacks?
A: To create such a shop, follow these steps:
A: Yes. Enable the custom-item-stacksize option in the config.yml and reload the plugin. Afterward, can you use /qs stack <size>
Q: My shop was broken/denied by XXX non-protection plugin. Why?
A: QuickShop creates a fake BlockBreakEvent to check if you can build in that area. Some plugins may interfere with this event by canceling it. Try Use protection listener filter to fix it.
Q: How can I migrate from H2 to MySQL, MariaDB (or vice-versa)?
A: /qs export to export all shops from your database, then swtich the data-source and /qs recovery to restore all shops from exports.
Q: The plugin is giving a NoDefClassFound/NoMethodFound error in the console, why?
A: This may be caused either by odd plugins that QuickShop does (not) support or by having a damaged/corrupted jar of QuickShop. Try to update the plugin and also test it with ONLY QuickShop installed. If the issue persists, report it to us on GitHub!
Q: How can I change or delete some messages?
A: Edit the messages in your message.json file. To remove a message, just change its content to an empty String ("").
Q: Can you add support for plugin X?
A: Maybe. Please open an issue on our GitHub for this.
Q: Hikari cannot load on 1.18(.0) and 1.18.1.
A: <1.18.2 have conficting issue with Adventure lib, upgrade to 1.18.2
Q: It cannot load on 1.7/1.8/1.9/1.10/1.11/1.12/1.13/1.14/1.15/1.16/1.17.
A: See "Tested Minecraft Versions", we only support 1.18(.2) and up.
Migrate from QuickShop-Reremake
QuickShop-Hikari is different from Reremake and data are not compatible with each other.
Hikari offers a converter that allows you to convert the data from Reremake to Hikari.
https://quickshop-community.github.io/QuickShop-Hikari-Documents/docs/addon/reremake-migrator
Bug Reports
Github Issue Tracker
Supports
Discord Server
User Documentation
We don't have documentation yet, it looks like if you have questions you can only ask on our Discord channel
Developer API
Maven repository & QuickShopAPI
Javadoc can be download use Maven or checked there.
Can I repost/reprint this plugin to xxx like mcbbs etc?
We allow you to repost this plugin for free or non-free in other places as long as you follow two basic rules:
Metrics
![[IMG]](//proxy.spigotmc.org/88638e3bd0ebe36241839d3d7865106ea8db701b/68747470733a2f2f6273746174732e6f72672f7369676e6174757265732f62756b6b69742f517569636b53686f702d48696b6172692e737667)
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.
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.
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!
- 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!
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!
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.
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.
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
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!
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!
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 staff add <player>
- /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.
- /shop
- /qshop
- /qsshop
- /quickshop
- /chestshop
- /cshop
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:
Spoiler: Pro Owner: Detailed Permissions
Player Permissions:
- quickshop.use
Required for any QuickShop Actions. - quickshop.create.sell
Required to make a shop (Sell-Mode) - quickshop.create.buy
Required to make a shop (Buy-Mode) or to switch from Sell to Buy-Mode. - quickshop.create.stacks
Required to allow selling items in stacks. - quickshop.create.changeitem
Allows a player to change a shop's item. - quickshop.create.changeamount
Allows a player to change the item amount per buy/sell. - quickshop.create.changeprice
Allows a player to change the buy/sell price of their shops. - quickshop.create.double
Allows a player to create a double chest shop. - quickshop.create.cmd
Required to have access to the /qs create command.
This command may bypass certain protections of not-supported protection plugins! - quickshop.transfer
Required to transfer all owned shops to another player. - quickshop.find
Required to use /qs find <item> - quickshop.fetchmessage
Required to use /qs fetchmessage - quickshop.staff
Required to use /qs staff and all its subcommands. - quickshop.preview
Required to use the GUI Item Preview. - quickshop.currency
Required to use the /qs currency <currency> - quickshop.shopnaming
Required to use the /qs name <name> - quickshop.permission
Required to use the /qs permission - quickshop.benefit
Required to use the /qs benefit
- quickshop.unlimited
Required to use /qs unlimited - quickshop.alwayscounting
Required to use /qs alwayscounting - quickshop.setowner
Required to use /qs setowner - quickshop.other.destroy
Allows the player to remove/destroy the shops of others. - quickshop.other.open
Allows the player to open chests of other shops and take/put items from/into it. - quickshop.other.price
Allows the player to change the price of someone's shop. - quickshop.transfer.other
Required to transfer ALL shops of someone to another player.
- quickshop.refill
Allows the player to refill their shops using a command, essentially making the shop having unlimited items. - quickshop.empty
Allows the player to clear the shop's inventory. - quickshop.clean
Allows the purging/removal of any Shops that have no items in stock. - quickshop.bypass.<ItemID>
Required to sell blacklisted items (E.g. bedrock). - quickshop.price.restriction.bypass.<RuleName>
Required to bypass a specific price limit rule. - quickshop.alerts
Required to receive notifications about possible cheating, plugin warnings and updates. - quickshop.info
Required to use /qs info
- quickshop.debug
Required to use /qs debug - quickshop.paste
Required to use /qs paste - quickshop.purge
Required to use /qs purge - quickshop.create.admin
Required to bypass any protection-checks while creating a shop using /qs supercreate - quickshop.tax
Permission to bypass the tax fee. - quickshop.tax.bypassunlimited
Permission to bypass the tax fee but only in the unlimited shop. - quickshop.cleanghost
Permission to remove any broken shop using /qs cleanghost - quickshop.export
Permission to use /qs export
This permission is pointless since the command is console only. - quickshop.recovery
Permission to use /qs recovery
This permission is pointless since the command is console only. - quickshop.removeworld
Permission to remove all shops in a world using /qs removeworld - quickshop.other.changeitem
Allows the player to change the item of someone's shop. - quickshop.other.changeamount
Allows the player to change the bulk amount of someone's shop. - quickshop.other.shopnaming
Allows the player to change the name of someone's shop. - quickshop.bypass.namefee
Allows the player to bypass the fee of shop naming. - quickshop.database
Permission to use /qs database
How to create a shop
To create a shop, place down a chest and left-click it with the number of items you want to sell.
For example: If I want to sell 16 diamonds will I need to hold 16 diamonds in my hand and left-click the chest with it. (Need allow-stacks: true and permission).
You will then be prompted to type in the chat, how much you would like to sell this item for.
Note: You may encounter issues with the chat system if you're on a BungeeCord network that utilizes a global chat plugin like BungeeChat. In such a case will you need to use commands to create a shop!
After you completed those steps should an item be displayed on top (Can be toggled off in the configuration) and a sign with info be placed on the side of the chest.
A Shop may not be created if there is no space around the chest to place down a sign.
How to buy/sell Items
To buy or sell an Item from/to a Shop will you need to left-click the sign.
You will then be prompted to write the amount you want to buy/sell in chat.
Whether a shop sells or buys items depends on the displayed info on the sign.
Advanced Features
Item Preview GUI
Preview the item you will purchase before actual purchase to avoid scam!
Shop Control Panel
Shop Control Panel allows tweaks to your shop with one click, no command needs!
Shop Staff
Shop owner can able to managing shop staff by using the command `/qs staff <add/del/list> <player>`, which allow shop staff to access your shop to manage the stock.
Ender Chest Inventory Linkage
Install OpenInv and openinv compatibility module and you will be able to use `/qs echest` to link your quick shop to your ender chest inventory! So all your echest shops can share with your ender chest inventory!
Rules-Based Price Limiter
Create rules to limit shops' prices with specific materials!
Translation OTA & Override system
Unlike other plugins, QuickShop uses CrowdinOTA technology to update our translation over the air. You can always enjoy the latest translations. All translations will keep updated with the cloud.
If you need to customize the translation, you can follow our guide to use the override customize system!
Shop Purger
Purge shops that owner no longer active or banned!
Our compatibility modules also offer purge player shops while it leave teams/islands/lands.
Interaction Controller & Direct Trade
Custom the click behavior through interaction.yml!
You can sell or buy 1 or all things directly by sneaking clicking (or any behavior you configured).
Item Stacking
Enable the allow-stack option in config.yml, then you can create a stacking shop by holding more than one item in hand. So players must buy items that are multiples of their holding.
Per shop permission management
Have you ever considered putting another player in full charge of your shop?
Or just ban a player to avoid him purchase your shop?
You can do this now with per shop permission management.
Compatibility Modules
QuickShop-Hikari officially provides some plugins compatibility modules to make them work more closely with QuickShop, here is a list that we currently support:
- AdvancedRegionMarket (Remove shops when region reset)
- BentoBox (Remove shops while the member was kicked out of the team)
- Clearlag (Prevent clear the QuickShop displays if you hadn't installed ProtocolLib)
- GriefPrevention (Remove shops on untrusted, unclaimed,
expired, resized, etc.) - Lands (Remove shops while member leaves)
- NoCheatPlus (anti-cheat compatibility)
- OpenInv (Offers a command `/qs echest` to link with your EnderChest)
- PlotSquared (Remove shops when a player is untrusted)
- Towny (Remove shops while resident left or plot clear/destroyed; Taxes go town bank account etc.)
- Residence (Region creation/purchase control.)
- WorldEdit (Remove shops while blocks removed by WorldEdit)
- WorldGuard (Register flags to control creates and trades in allowed regions, you usually don't need this)
- SuperiorSkyblock (Remove shops when a player kicked, un co-op, island reset etc.)
ShopSearch by Ronsane
Adds a /finditem command in game for searching through all the shops on the server.
[Download]
Known Incompatible Plugins
Some plugins may not work together with QuickShop and there is little we can do on our side to fix this.
- Pretty much any BungeeCord Chat plugin.
You need install Compat-BungeeCord to fix this. - Plugins cancelling BlockBreakEvents
If you are a server administrator (with quickshop.alert privileges), you will receive an admin-only message instructing you how to configure the filter.
Or you can directly disable the protection-checks, but it will allow players to create shops everywhere!
- ChatControl Pro/Red
You can use /qs amount <amount> to set the price instead.
You can help us to translate QuickShop into as many languages as possible!
You can find the currently worked on translations over at Crowdin:
https://crowdin.com/project/qs-hikari
Can't find your language? Open an issue on Issue Tracker!
FAQ
Q: Can I create a shop that sells AND buys items?
A: No. Each shop can only sell or buy but not both at once. You can however use a double-chest to have two shops. One buying and one selling the item.
Q: Can I use item currency like diamonds?
A: No. We won't add it. But you can choose some economy plugins that allows you to use item currency.
Q: The plugin doesn't respond when creating a shop. Is it broken?
A: Some plugins may cancel the Shop-creation. Most commonly is this the case with protection plugins. You can disable the shop.protection-checking in the config to bypass this.
Q: How can I create a Shop selling stacks?
A: To create such a shop, follow these steps:
- Set "allow-stacks" to true in the config.yml and reload the plugin.
- Give the player (Yourself) the permission quickshop.create.stacks
- Hold the number of items to buy/sell and create the shop as normal.
A: Yes. Enable the custom-item-stacksize option in the config.yml and reload the plugin. Afterward, can you use /qs stack <size>
Q: My shop was broken/denied by XXX non-protection plugin. Why?
A: QuickShop creates a fake BlockBreakEvent to check if you can build in that area. Some plugins may interfere with this event by canceling it. Try Use protection listener filter to fix it.
Q: How can I migrate from H2 to MySQL, MariaDB (or vice-versa)?
A: /qs export to export all shops from your database, then swtich the data-source and /qs recovery to restore all shops from exports.
Q: The plugin is giving a NoDefClassFound/NoMethodFound error in the console, why?
A: This may be caused either by odd plugins that QuickShop does (not) support or by having a damaged/corrupted jar of QuickShop. Try to update the plugin and also test it with ONLY QuickShop installed. If the issue persists, report it to us on GitHub!
Q: How can I change or delete some messages?
A: Edit the messages in your message.json file. To remove a message, just change its content to an empty String ("").
Q: Can you add support for plugin X?
A: Maybe. Please open an issue on our GitHub for this.
Q: Hikari cannot load on 1.18(.0) and 1.18.1.
A: <1.18.2 have conficting issue with Adventure lib, upgrade to 1.18.2
Q: It cannot load on 1.7/1.8/1.9/1.10/1.11/1.12/1.13/1.14/1.15/1.16/1.17.
A: See "Tested Minecraft Versions", we only support 1.18(.2) and up.
Migrate from QuickShop-Reremake
QuickShop-Hikari is different from Reremake and data are not compatible with each other.
Hikari offers a converter that allows you to convert the data from Reremake to Hikari.
https://quickshop-community.github.io/QuickShop-Hikari-Documents/docs/addon/reremake-migrator
Bug Reports
Github Issue Tracker
Supports
Discord Server
User Documentation
We don't have documentation yet, it looks like if you have questions you can only ask on our Discord channel
Developer API
Maven repository & QuickShopAPI
Javadoc can be download use Maven or checked there.
Can I repost/reprint this plugin to xxx like mcbbs etc?
We allow you to repost this plugin for free or non-free in other places as long as you follow two basic rules:
- Keep the link to the original resource (This one) and the source code link.
- Don't remove the author's name or claim that are the original authors.
- For MineBBS reposters: This resource is currently on hold pending a decision, please do not repost without authorization at MineBBS.
Metrics
× DO NOT USE REVIEW FOR BUG REPORTING ×
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.20, 1.20.6, 1.21
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
QuickShop-Hikari - A powerful, user-friendly and reliable ChestShop plugin [1.20-1.21] is a free Minecraft Java mod. Compatible with Minecraft 1.20, 1.20.6, 1.21. Downloaded 70,729 times (via Spigot). Download it and open it directly in the game.