Minecraft 1.20.1, 1.21.1용 QuickShop-Hikari 플러그인

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

We have documents now! Finally!

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/PacketEvents based Virtual DisplayItem (better for performance) support.
• Multi-currency support: Use different currencies in shops from any economy that supports VaultUnlocked. We also support Vault by default!
• 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!

Or with addons to add more features

• Discount code
• Plan metrics
• DiscordSRV notifications

How to Install

QuickShop requires Minecraft 1.20+ to be run. Any versions below 1.20 were unsupported.

• Install Vault and an economy plugin supported by Vault.
• If you are using multi-currency, you will need an economy plugin that supports VaultUnlocked.
• Install optional ProtocolLib or PacketEvents which can greatly improve QuickShop performance.
• Spigot is no longer supported in recent updates. We recommend switching to Paper or its forks to ensure optimal performance.
• 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.

• /quickshop unlimited

Makes your Shop buy/sell Items in unlimited quantity or limited

• /quickshop setowner

Change the Shop Owner.

• /quickshop buy

Change the shop to buying items.

• /quickshop sell

Change the shop to selling items.

• /quickshop price

Change the buy/sell price of the item.

• /quickshop clean

Removes any loaded shop that doesn't have any items in stock.

• /quickshop find

Find the nearest shop that sells items that start with the provided text. E.g. /quickshop find dia will find the nearest shop that buys/sells diamonds.

• /quickshop fetchmessage

Fetch shop message manually from the database.

• /quickshop info

Show QuickShop information.

• /quickshop debug

Enable/Disable Debug Mode.

• /quickshop create [item]

Command to create the shop with the item in hand or specified.

• /quickshop currency

Command to specified the currency the shop using. The Economy plugin must support the Multi-Currency feature and be supported by QuickShop.

• /quickshop supercreate

Create a shop while bypassing any protection checks.

• /quickshop paste

Collects useful information and pastes it on Pastebin.

• /quickshop staff

Manage staff in your shop.

• /quickshop staff add

Add a player as staff to your shop.

• /quickshop staff del

Remove a player as staff from your shop.

• /quickshop staff clear

Remove all staff members from your shop.

• /quickshop staff list

Show all current staff members of your shop.

• /quickshop cleanghost

Remove all broken shops.

• /quickshop export

Export all shop data to a zip. This command is CONSOLE ONLY!

• /quickshop 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!

• /quickshop size

Change the bulk size. Requires the "allow-stacks" option in the config to be enabled for the command to work.

• /quickshop 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.

• /quickshop transfer

Transfer ALL shops from one player to another.

• /quickshop item

Change the item of the shop. Requires the "allow-stacks" option in the config to be enabled for the command to work.

• /quickshop removeworld

Remove all shops in a specific world.

• /quickshop name

Naming or un-naming a shop with a specific name.

• /quickshop permission

Tweaking the per-shop permissions, or add/remove player into/from specific groups.

• /quickshop database

View and manage QuickShop-Hikari status.

• /quickshop benefit

View and manage yout shop benefits.

Aliases:

• /shop
• /qs
• /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:

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 /quickshop create command. This command may bypass certain protections of not-supported protection plugins!

• quickshop.transfer