A shop plugin that allows players to easily sell/buy any items from a chest without any commands.

对于不方便使用 Discord 或 Github Issue Tracker 的用户,也可在 QQ 社区群内 966701484 内寻求热心社区人员的帮助
We have documents now! Finally!
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!
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.
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 Required to transfer all owned shops to another player. * quickshop.find Required to use `/quickshop find ` * quickshop.fetchmessage Required to use `/quickshop fetchmessage` * quickshop.staff Required to use `/quickshop staff` and all its subcommands. * quickshop.preview Required to use the GUI Item Preview. * quickshop.currency Required to use the `/quickshop currency ` * quickshop.shopnaming Required to use the `/quickshop name ` * quickshop.permission Required to use the `/quickshop permission` * quickshop.benefit Required to use the `/quickshop benefit` ### Admin Permissions: * quickshop.unlimited Required to use `/quickshop unlimited` * quickshop.alwayscounting Required to use `/quickshop alwayscounting` * quickshop.setowner Required to use /quickshop 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. Required to sell blacklisted items (E.g. bedrock). * quickshop.price.restriction.bypass. 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 `/quickshop info` * quickshop.debug Required to use `/quickshop debug` * quickshop.paste Required to use `/quickshop paste` * quickshop.purge Required to use `/quickshop purge` * quickshop.create.admin Required to bypass any protection-checks while creating a shop using /quickshop 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 `/quickshop cleanghost` * quickshop.export Permission to use /quickshop export This permission is pointless since the command is console only. * quickshop.recovery Permission to use /quickshop recovery This permission is pointless since the command is console only. * quickshop.removeworld Permission to remove all shops in a world using /quickshop 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 `/quickshop database`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.
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.

Preview the item you will purchase before actual purchase to avoid scam!

Shop Control Panel allows tweaks to your shop with one click, no command needs!

Shop owner can able to managing shop staff by using the command /quickshop staff <add/del/list> <player>, which allow shop staff to access your shop to manage the stock.
Install OpenInv and openinv compatibility module and you will be able to use /quickshop echest to link your quick shop to your ender chest inventory! So all your echest shops can share with your ender chest inventory!
Create rules to limit shops' prices with specific materials!
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!
Purge shops that owner no longer active or banned!
Our compatibility modules also offer purge player shops while it leave teams/islands/lands.
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).
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.

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.

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 /quickshop 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.)
* EcoEnchants (Show EcoEnchants's enchantments)
* Reforges (Show Reforges stuff in preview item GUI)
Adds a /finditem command in game for searching through all the shops on the server.
[Download]
Forward in-game notifactions to Discord EmbedMessage and DM players.
Showcase your server recent QuickShop-Hikari activities like purchases and shops list.
Add discount codes to your QuickShop-Hikari server with custom name, rate, range, expired time and
price threshold.
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.
To solve the BungeeCord Chat conflicting, download and install Compat-BungeeCord compatibility module under versions.
* Plugins handling 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 /quickshop 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!
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:
1. Set "allow-stacks" to true in the config.yml and reload the plugin.
2. Give the player (Yourself) the permission quickshop.create.stacks
3. Hold the number of items to buy/sell and create the shop as normal.
Q: Can I create a shop that bypasses the default vanilla stack-size?
A: Yes. Enable the custom-item-stacksize option in the config.yml and reload the plugin. Afterward, can you use /quickshop stack
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: See Docs
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: 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/1.18/1.19.
A: See "Tested Minecraft Versions", latest version only supports 1.20 and above.
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
Javadoc can be download use Maven or checked there.
We allow you to repost this plugin for 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.
Unsupported
Required
Умови використання, зміни та поширення цього товару.
14.02.2026 · Modrinth
Скриншоти та зображення з оригінальної сторінки Modrinth.











































Опубліковані версії та оригінальні файли Modrinth.
14.02.2026 · 39 431 завантаження
#The layout of signs for shops.
layout:
#The layout of BUYING shops.
BUYING:
line1: "header"
line2: "trading"
line3: "item"
line4: "price"
#The layout of FROZEN shops.
FROZEN:
line1: "header"
line2: "trading"
line3: "item"
line4: "price"
#The layout of SELLING shops.
SELLING:
line1: "header"
line2: "trading"
line3: "item"
line4: "price"
Added support for wildcard patterns in the item blacklist configuration, allowing users to block entire categories of items with simple patterns.
Features
```java
InteractionManager manager = QuickShop.getInstance().getInteractionManager();
manager.interaction(new MyTradeInteraction());
manager.behavior(new MyTradeBehavior());
```
- Replaced some Apache Commons calls that could be easily replaced with built-in java methods, reduces some calls by ~ 1100ms/method call
- Deprecated the ShopType enum, and the ShopTypeEvent. These are replaced with the new IShopType interface and implementing classes.
- The new event is ShopTypeEnhancedEvent.
- This allows for third-party addons to add their own shop types, and simplifies code checks for translations.
- Updated config system to use Boosted-yaml
- this allows for auto-updating of config files without complex update scripts
- this also allows for the config system to not be minecraft-dependent.
- Replaced logical PaperLib calls with native PaperAPI calls.
28.07.2025 · 29 071 завантаження
Here's an outline for some features that may arrive in 6.2.0.11:
01.04.2025 · 15 285 завантаження
Remember to backup your DB before updating.
This build fixes an exploit in the GUI system that was recently outlined.
See discord changelog for event system here
The shop control panel system has been overhaul to separate it into different classes. This allows third-party
plugins to add additional components to the control panel easily. There was also an added event, ControlComponentGenerateEvent,
which is called PRE, MAIN, and POST of a ControlComponent being generated. The MAIN phase supports changing
the ControlComponent object with a custom one that will replace the original during control panel sending.
About:
Custom Packet Factories:
PacketFactory for game versions 1.20.x and 1.21.x.Error Handling and Logging:
ShopItemEvent.java for a more consistent structure.ShopNameEvent.java.ShopOwnerNameEvent.java.ShopOwnerEvent.java.ShopPlayerGroupEvent.java.ShopPriceEvent.java.ShopTypeEvent.java.ShopUnlimitedEvent.java.ShopDisplayEvent.java.ShopTaxAccountEvent.java.event/packet/handler/PacketHandlerAddedEvent.java.event/packet/handler/PacketHandlerInitEvent.java.23.01.2025 · 8 280 завантаження
25.08.2024 · 11 122 завантаження
21.07.2024 · 5 600 завантаження
Full Changelog: https://github.com/QuickShop-Community/QuickShop-Hikari/compare/6.2.0.5...6.2.0.6
14.06.2024 · 5 768 завантаження
/qs clean may delete all stores/qs cleanghost may delete all stores08.06.2024 · 2 196 завантаження
/quickshop cleanghost won't delete the stores that trading blacklisted items29.05.2024 · 2 419 завантаження
Ahhh forget to update version number!
29.05.2024 · 1 390 завантаження
quickshop.alert that should be use as quickshop.alerts in PlayerListener29.05.2024 · 1 420 завантаження
quickshop.alert that should be use as quickshop.alerts in PlayerListener15.05.2024 · 2 500 завантаження
Warning! Due to Minecraft's major update to ItemStack, downgrading is not an option! Please backup all data before upgrading!
Reremake users: This is the last chance to complete your migration from Reremake to Hikari before you upgrade to 1.20.5/1.20.6. The migration requires QuickShop-Reremake to be up and running. After upgrading to 1.20.5/1.20.6, Reremake will no longer work properly.
1.18, 1.19 users: All versions 1.18 and 1.19 have been marked as “End Of Life” and these versions are no longer supported. It may be broken in a future update. Please consider upgrading to 1.20.x!
It's been a long time! This release has been delayed several times due to huge changes in 1.20.5/1.20.6. But anyway, 6.2.0.0 is here now!
Display entity support for display-itemdisplay-type to 3 to enable ItemDisplay entity/quickshop history enhance/quickshop history owned, /quickshop history accessible and /quickshop history global to allow you query multiple stores transaction history in single queryowned: Select all shops which you're owneraccessible: Select all shops which you have per-shop permission to access the store historyglobal: Select all shops on this server (require permission)/quickshop benefit command may not save when remove usersWe added localized text and Tab completion to allow all users to use QuickShop-Hikari's built-in debugging tools.
These debug commands are for debugging purposes only and have no operational confirmation. Using them incorrectly may result in inconsistent status or loss of data. Figure out what happens before you execute them.
All commands are started with prefix: /quickshop debug
dev/debug/devmode: Toggle debug modesigns: Print the coordinates of the all identifiable information sign for the store you are looking atupdateplayersigns <player name>: Refresh the contents of the store information boards in all designated players' stores.force-shops-reload: Unload all loaded stores and re-load them (to refresh the state)force-shoploader-reload: Unload and delete them from memory, then re-execute the ShopLoader sequence to reload all stores from the database.check-shop-status/check-shop-debug: Prints quite useful store status debugging information to confirm the current state of the store in memorytoggle-shop-load-status: Simulate store loading/unloading without changing the chunks loading stateset-property: Register/change the Java property sheet to change specific behavior via property switch without touch startup command line (They are usually changed through the startup parameters). For security reasons, this command is restricted to change QuickShop-Hikari properties only, any request to change any other properties will be denied.reset-shop-caches: Reset store lookup cache for benchmark/or debugging possible cache update issuesreset-dbmanager: Force reset of SQLManager, only for MySQL data sources, using this command on H2 will cause the plugin to crashdump-db-connections: Dump SQLManager's Current Active Queries on chat.stop-db-any-queries: Force close SQLManager's currently active queries.toggle-db-debugmode: Toggles the debugging state of SQLManager and prints the executed SQL statements and performance timings on the console when SQLManager debug mode is enabled.dump-hikaricp-status: Printing status information for HikariCP.set-hikaricp-capacity: Dynamically change the size of HikariCP's connection pool to allow more connections to be fetched urgently.item-info: Prints the NBT data for the item in hand (if any) and the item in the store (if any). If the item is in the hand and is looking at a store, it will also output the item match.mark-all-shops-dirty: Forces all store change status indicators to be flagged as changes not saved in order to force a refresh of their current data into the database.clean-display-entities: Scans all loaded blocks and removes any entities recognized as QuickShop DisplayItem. Useful when uncleared entities appear after changing the DisplayItem type.Thanks to these friends on Ko-fi for their support in this update, they are:
(The names are in no particular order)
21.04.2024 · 2 860 завантаження
17.04.2024 · 1 890 завантаження
10.04.2024 · 1 917 завантаження
getShops may returns the shops that not in selection and cause accident deletion if they in same chunk999999999999999999999999999999.99 with default new generated configurationquickshop.use permission node was ignored/qs staff clear and /qs staff remove won't save to database after modified staff list/qs toggledisplay to turned it off if server enabled display auto despawnSeveral new Startup Flags have been added to allow users to fine-tune the internal implementation, which will be made available on-demand by developers in the support channel.
22.02.2024 · 3 728 завантаження
22.02.2024 · 1 671 завантаження
DoubleChest instances in inventory management, ensuring proper functionality.6.0.0.9) across various modules for improved performance and compatibility.14.02.2024 · 1 879 завантаження
(6.0.0.8 is a hot patch for 6.0.0.7)
07.02.2024 · 1 836 завантаження
/quickshop history command will stuck when user using MySQL.06.02.2024 · 1 714 завантаження
If you meet HikariPool-1 - Connection is not available, request timed out after 30000ms. errors in past versions, please upgrade to this version and see if it still happening, and join our Discord server to participate in the discussion of the issue. We are investigating this issue and releasing mitigation measures.
05.02.2024 · 1 423 завантаження
05.02.2024 · 1 197 завантаження
/quickshop history feature is applying more database pressure due to log_purchase not being configured with proper indexing. This hot patch will create an index for log_purchase to alleviate the performance issue.04.02.2024 · 1 647 завантаження
This is a hot-patch for 6.0.0.0 major update.
Although all updates is addon related, but you also need update QuickShop-Hikari it self.
03.02.2024 · 1 823 завантаження
Focalors & Furina, Artist Tiko
For the Lunar New Year, QuickShop-Hikari has received a new major update that includes several feature updates for large networks and transaction-oriented servers. At the same time, we also fixed some bugs.
The new Shop History feature allows you to open a store history panel for all past trade requests that have occurred in this store.
At the same time, you will be able to see your Most Valuable Customers, showing those players who have made the most transactions in your store.
The panel also will allow you to view the number and value of transactions for the last 24h, 3d, 7d, 30d, all-time, and unique purchasers count.
This feature is based on a long-existing transaction logging system, so after you upgrade, you can view the transaction history that created before the upgrade.
New command /quickshop sign <material> that allow users to change their shop's info sign material.
Added New command /quickshop transferownership for shop transfer.
* This new command will allow player request to transfer a shop to another player, without re-create the shop.
* To complete the transfer, the requested player must accept the transfer request.
* To avoid ambiguity, the old /quickshop transfer command is now renamed /quickshop transferall.
New command /quickshop suggestprice that calculates the most expensive price, the cheapest price, the average price, and the median price for other stores on this server that have the same items and selling patterns as the current store, so that players can set appropriate prices for their stores.
/quickshop discount listall/quickshop list are now presented in a paged format, and you can toggle the paging by appending a number. No more crowding the chat box when there are tons of stores.shop.info-panel.show-enchantments, shop.info-panel.show-effects, shop.info-panel.show-durability, to allow you disable some information on shop info panel to avoid too much data crowned your chat.SERVER_ROOT/libraries) is now supported to reduce network requests and traffic consumption./quickshop transferownership instead /quickshop setowner.Shop#getRemainingStock and Shop#getRemaingingSpace now supports async call, to retrieve cached data from database.respect-item-flag option doesn't work.14.01.2024 · 2 072 завантаження
08.01.2024 · 1 272 завантаження
05.01.2024 · 1 499 завантаження
05.01.2024 · 916 завантаження
/qs permisison doesn't save the changes03.01.2024 · 1 125 завантаження
Fixed a security issue:
Missing store ownership check when a player modifies a user's store permissions using the /qs permission command. This allows the user to take over arbitrary store permissions, including the administrator store.
This patch will not revoke permissions, you will need to do a check on the store's already set Per-player permissions property to avoid pre-existing exploits.
For past versions, you can disable the command interface for the per-player permission system to avoid new exploits /lp group default permission set quickshop.permission false.
However, upgrading is still recommended.
Considering that this security vulnerability allows for store privilege escalation (including unlimited stores, aka AdminShop) and allows for the modification of store transaction contents, prices, and disruption of the server's economic system, we strongly recommend that you plan an update immediately and utilize LuckPerms through the guide to disable this feature before you maintain it.
02.01.2024 · 682 завантаження
/qs reload will cause OngoingFeeWatcher to be executed earlyquickshop-hikari to version 5.2.0.9.3.12.1.2.16.2.EcoEnchants to version 11.2.0.eco to version 6.68.0.LandsAPI to version 6.42.15.towny to version 0.100.0.17.Incremented EconomyCore dependency to version 0.1.2.6-Pre3.
Refactor
ContainerShop.QuickShop.19.12.2023 · 1 581 завантаження
This is a quick update to prevent QuickShop-Hikari running on server which installed EcoEnchants v11+ to avoid data corruption.
Also updated Adventure Lib to 4.15.0 for MC 1.20.3+ compatibility.
10.12.2023 · 1 303 завантаження
This update introduces support for Spigot 1.20.4.
16.11.2023 · 2 216 завантаження
As always, we keep it updated with bug fixes and performance improvements.
-Dcom.ghostchu.quickshop.shop.ContainerShop.updateShopSignOnLoad debug startup flag was added, when it set to true, the shop will update their signs when shop enter the loaded state from unloaded state, This will result in lower performance, but will improve the update lag of the signs. Startup use only on servers that are confirmed to have this issue.isValid() check issuequickshop-hikari dependency across multiple modules.Updated BlueMapAPI, Plan, ChestProtectAPI, EcoEnchants, LandsAPI, openinvapi, worldedit-bukkit, Reforges, towny, item-nbt-api-plugin, specialsource-maven-plugin, placeholderapi, EconomyCore, csvjdbc, slf4j-jdk14, commons-text, commons-compress, and various net.kyori artifacts to their latest versions.
New Features
reremake-migrator module.MockPlugin class for mocking plugin behavior.Implemented a new ShopLogsMigrate class for migrating shop logs to a database.
Bug Fixes
Fixed null-safe comparison in griefprevention compatibility module.
Refactor
VirtualDisplayItemManager.isValid method in BukkitInventoryWrapper.BukkitInventoryWrapperManager.Util and Log classes.Adjusted PerfMonitor to use Log.Caller directly.
Documentation, Style, Tests, Chores, Revert
14.10.2023 · 1 905 завантаження
This is a cumulative update to fix bug reports received since the last LTS release.
We have partnered with the developers of Mohist and worked on improving the stability of QuickShop-Hikari on Hybird Server.
In the latest Mohist 1.20.1/.2 you can run QuickShop-Hikari perfectly and QuickShop-Hikari protects its store containers from being accessed by other mods pipes or machines.
Also, in the latest version of Mohist 1.20.1/.2, QuickShop-Hikari is able to use most of the Mod containers as store containers.
/quickshop debug reset-shop-caches subcommand to allow user purge all caches from memory to debugging the cache issues.To inform you of warnings about QuickShop-Hikari in accordance with our Privacy Transparency Policy.
We received a data breach alert from the Rollbar* cloud service informing us that our Access Token (post_server_items) had been compromised and a forced reset was performed on our affected Token, not only QuickShop-Hikari but also QuickShop-Reremake affected.
However, our Access Token (post_server_items) is distributed with Jar, so whether it was compromised or not doesn't affect us in any way - it's inherently public and we use it for public purposes. As a result, this forced reset caused the Rollbar to no longer be able to report bugs in older versions of QuickShop-Hikari, where we distributed the new Access Token (post_server_items).
We practice our privacy policy and therefore all submitted data is submitted in the minimal sample and anonymized. Your data is therefore not affected. Although no QuickShop-Hikari is actually affected, you can always disable the error log reporting feature if you want.
* Rollbar is a service used by QuickShop-Hikari AND QuickShop-Reremake that used for collecting error logs that generated by QuickShop plugin.
*This warning only affects developers who sign up for Rollbar (that's me), and based on current research, this warning has no effect on QuickShop users.
24.09.2023 · 1 648 завантаження
Cheers! Catching up with the tail end of September, we're releasing the first of LTS build of Cyno before October rolls around.
An LTS release is a quality-proven version that we release every so often (usually for a longer period of time).
Long-term stable support releases are selected by observing user reports, logging in automated bug reporters, and manual testing.
The LTS version is suitable for operation in large networks and production environments. It is recommended that you upgrade.
For non-1.20.x versions of the Spigot server, you may need to manually download the appropriate NBTAPI plugin.
Versions marked as End Of Life will no longer provide active technical support and we strongly recommend that you upgrade as soon as possible.
The migration script for Hikari-3.x has been removed, so if you are upgrading from Hikari-3.x, please download the last stable version of Hikari-3.x that supports Hikari-3.x to upgrade, and then upgrade to this LTS version.
We have always valued the privacy of our users, so to ensure our privacy transparency and your right to know, we have publicized changes to our data collection list.
The following statistical metrics have been added to the data collection list.
24.09.2023 · 949 завантаження
23.09.2023 · 872 завантаження
This build tested with Spigot server sofware CraftBukkit version 3877-Spigot-17ca32d-f070277 (MC: 1.20.2) (Implementing API version 1.20.2-R0.1-SNAPSHOT).
To use the VDI system on 1.20.2, use the ProtocolLib build from PR #2501, which is available here.
[ADDON] Reremake-Migrator now able to migrate the translations from Reremake from MineDown syntax to MiniMessage syntax and also convert file format from JSON to YAML.
22.09.2023 · 1 031 завантаження
This update brings the initial 1.20.2 update, this build tested with Spigot server sofware CraftBukkit version 3877-Spigot-17ca32d-f070277 (MC: 1.20.2) (Implementing API version 1.20.2-R0.1-SNAPSHOT).
21.09.2023 · 1 047 завантаження
As usual, we add more features to QuickShop-Hikari by releasing new versions, optimizing performance and fixing bugs. Sit back with a cup of tea and enjoy the new update!
shop_map's world field data length now extended to 255 for better handling modded server worlds.20.09.2023 · 929 завантаження
Re-published cause last update actually still using 5.1.1.1 code base.
20.09.2023 · 1 040 завантаження
19.09.2023 · 1 288 завантаження
18.09.2023 · 932 завантаження
17.09.2023 · 923 завантаження
Artist: Ghost_chu - Server group photo
Another regular update for QuickShop-Hikari! In this update we've made a special update to privacy protection, increasing user control over data collection and sending. In addition to this, we have fixed several bugs, optimized performance, and brought some extended feature updates.
The Minecraft 1.20.2 is coming soon, and we'll be adapting the new version as soon as it's released, so we'll see you again in 1.20.2! (If there are no new bugs that need to be fixed urgently ;))
/quickshop paste report.shop.blacklist-lores setting doesn't work at all.ShopManager#getShopsViaCache and ShopManager#getShopsIncludeAttachedViaCache interfaces./plugins/bStats/config.yml to disable bStats.06.09.2023 · 994 завантаження
4.x to 5.x is a major breaking update, read the 5.x main-changelog here before upgrading from 4.x to 5.
/qs find outputs now support hover item previewing/qs list outputs now support hover item previewing/qs list now supports tab-completing for online players if player have permission to listing other shopsprice-restriction.yml was limit to up to 999999999999999999999999999999.99 (1.0E30) to adapt decimal (32,2) to avoid over database data type limit to prevent SQLException, this change will only affect the new generated configuration.PackageUtil#parsePackageProperly doesn't work when user disabled debug logger, it also affected -Dcom.ghostchu.quickshop properly args.31.08.2023 · 953 завантаження
4.x to 5.x is a major breaking update, read the 5.x main-changelog here before upgrading from 4.x to 5.
This is a hot fix for 5.0.0.5 version.
backup-policy settings.We're planned apply the rate-limit to more modules in future to avoid affect server performances by players maliciously actions.
31.08.2023 · 843 завантаження
4.x to 5.x is a major breaking update, read the 5.x main-changelog here before upgrading from 4.x to 5.
backup-policy settings.We're planned apply the rate-limit to more modules in future to avoid affect server performances by players maliciously actions.
30.08.2023 · 841 завантаження
4.x to 5.x is a major breaking update, read the 5.x main-changelog here before upgrading from 4.x to 5.
29.08.2023 · 773 завантаження
4.x to 5.x is a major breaking update, read the 5.x main-changelog here before upgrading from 4.x to 5.
[Preview Item] button doesn't work and only print the command help.utf8 chatset rather than utf8mb4. Thanks 针织薄外套 (kioproject) and Clxdy (clxdywindows) report it.utf8mb4 charset.27.08.2023 · 869 завантаження
4.x to 5.x is a major breaking update, read the 5.x main-changelog here before upgrading from 4.x to 5.
/qs debug set-property <key-value> sub command to dynamically change the JVM property.0.1329ms per record to 0.0061ms per record by moving cost tasks into a async executor, it improved the performance on busy server when there have LOTS of debug logs on server main thread.-Dquickshop-hikari-disable-debug-logger=true will able to disable the debug logger's stack trace completely when you running a huge server, but remember you will need re-enable it before reporting the bugs/errors to us.24.08.2023 · 949 завантаження
A small fix for multiple NPE on the server who set tax-account to empty string.
5.0.0.0 is a BREAKING UPDATE with ton of BREAKING CHANGES, and will kill most of 3rd-party addons.
It may also lead to data corrupt, world corrupt, MAKE SURE YOU CREATE A FULL BACKUP BEFORE INSTALL THE UPDATE.
Latest LTS build: 4.2.2.12
September is coming, welcome to the new "Cyno" update!
Cyno update mainly makes drastic changes to the underlying code of QuickShop-Hikari in order to solve some performance issues and historical problems.
[SystemAccount]/qs setowner Ghost_chu (Username)/qs setowner 7351a6fd-a09a-4c2d-aae9-86252d079a4c (UUID)/qs setowner [SystemAccount] (Username based System account)| Real Exists Player | Virtual System Account |
|---|---|
/qs nolonger as main-command, but /quickshop instead. /qs still presents in config.yml as a alias of /quickshop./qs setowner result may won't save into database.This addon added EcoEnchants support for:
Click Here To EcoEnchants Addon Wiki

This addon added Reforges support for:
Click Here To Reforges Addon Wiki

The following Maven dependencies were updated.
@tdiant
23.08.2023 · 1 070 завантаження
5.0.0.0 is a BREAKING UPDATE with ton of BREAKING CHANGES, and will kill most of 3rd-party addons.
It may also lead to data corrupt, world corrupt, MAKE SURE YOU CREATE A FULL BACKUP BEFORE INSTALL THE UPDATE.
Downgrade without backup is impossible
Latest LTS build: 4.2.2.12
September is coming, welcome to the new "Cyno" update!
Cyno update mainly makes drastic changes to the underlying code of QuickShop-Hikari in order to solve some performance issues and historical problems.
[SystemAccount]/qs setowner Ghost_chu (Username)/qs setowner 7351a6fd-a09a-4c2d-aae9-86252d079a4c (UUID)/qs setowner [SystemAccount] (Username based System account)| Real Exists Player | Virtual System Account |
|---|---|
/qs nolonger as main-command, but /quickshop instead. /qs still presents in config.yml as a alias of /quickshop./qs setowner result may won't save into database.This addon added EcoEnchants support for:
Click Here To EcoEnchants Addon Wiki

This addon added Reforges support for:
Click Here To Reforges Addon Wiki

The following Maven dependencies were updated.
@tdiant
15.07.2023 · 1 516 завантаження
This should be the last one revision of 4.2.2, it is stable enough and I will focus on adding new features in 4.3/4.2.3, stay tuned!
09.07.2023 · 926 завантаження
14.06.2023 · 1 317 завантаження
14.06.2023 · 724 завантаження
14.06.2023 · 750 завантаження
shop.disable-quick-create doesn't work at all.09.06.2023 · 1 091 завантаження
/qs item won't trigger the display update even the shop item already changed. It caused the display desync.09.06.2023 · 808 завантаження
/qs item won't trigger the display update even the shop item already changed. It caused the display desync.08.06.2023 · 725 завантаження
Fixed VirtualDisplayItem on Minecraft 1.20.
08.06.2023 · 786 завантаження
This is a quick fix for Bukkit/Spigot 1.20 compatibility.
08.06.2023 · 854 завантаження
/qs displaycontrol <auto/enable/disable> to allow players control client display behavior.24.05.2023 · 909 завантаження
/qs buy use wrong permission, it now following the quickshop.create.control as same as /qs sell behavior.Permission for Debug type logs generator.ignoreProtocolLibEnableStatus statup flag allow user disable ProtocolLib enable status check.17.04.2023 · 1 192 завантаження
Rewritten buggy old VirtualDisplayItem system with better one, also fixed dupelicated displays in past versions.
Thanks @Kaya @KrunchyTaco @Lufano @maty and @YuanYuanOwO for reporting it!
17.04.2023 · 788 завантаження
THIS IS A BETA BUILD, DO NOT INSTALL ON YOUR LIVE SERVER UNLESS YOU HAVE FULL BACKUP
Technical update, rewritten the unstable and buggy virtual display item system.
14.04.2023 · 985 завантаження
Just bump the version number
14.04.2023 · 804 завантаження
Warning: This update contains API changes, some 3rd-party addons may stop working after update.
/qs paste may stop working if updater has been disabled or failed to check the updates.25.03.2023 · 1 021 завантаження
4.2.0.1's hot fix for removing debug STDOUT.
24.03.2023 · 716 завантаження
Important: Running QuickShop-Hikari on the Spigot server now requires an NBT-API dependency, Paper and its Fork are not affected.
It has been a year since the first stable release of QuickShop-Hikari.
Thank you to everyone who supported and used QuickShop-Hikari, your great suggestions and ideas made QuickShop-Hikari get epic feature enhancements in the past year.
And thanks to the early supporters and beta testers for their hard work testing so that QuickShop-Hikari becomes more stable and runs smoothly!
Potion -> Potion of Speed, or Speed-> Potion of Speed.) They are now displayed in the same format as the client.-foo:bar)./qs cleanghost command to use new BatchBukkitExecutor.20.03.2023 · 826 завантаження
4.13.04.3.00.4.711.03.2023 · 823 завантаження
Long time no see! After a nice holiday and a busy exam week, I'm gradually getting back to my old update frequency and planning new functional updates.
But how, I hope you enjoy the update :)
Paper users: If you're running into java.lang.NoClassDefFoundError with addons installed but doesn't working, it's a Paper new plugin loader bug, make sure you have update to Paper-#445 or higher.
/qs export command will create an IOException and doesn't work at all./qs import command doesn't work if database configured prefix.14.02.2023 · 1 132 завантаження
There are important notes on this update, please read the changelog
EN: Since 4.1.0.3, QuickShop-Hikari are disallowed to be load that the server located at Mainland China due potential legal risks, please read Regional legal restrictions. This decision should won't affect any users out of mainland China.
ZH: 自 4.1.0.3 以来,由于可能的法律风险,QuickShop-Hikari 将不再允许位于中国大陆地区的服务器加载,请阅读区域法律限制.
We have updated our privacy policy to reflect the changes we have made.
We are now sending you our new privacy policy to ensure that you are informed.
We will send an IP lookup request to CloudFlare to determine if your server is located in mainland China. For more information, please see: Regional legal restrictions.
The URL we will request: https://cloudflare.com/cdn-cgi/trace.
31.01.2023 · 1 031 завантаження
30.01.2023 · 698 завантаження
Special thanks to @Spaex for reports and help debugging
30.01.2023 · 828 завантаження
The first release after the Lunar New Year!
Guys how are you? We're starting to get back to normal life after lighting up a lot of fireworks (hah) to celebrate the Lunar New Year, so now allow me to serve up a stack of delicious updates!
/qs discord to toggle the DM.list has been added into main-line, this addon allow player to check all shops they owned, check the document here.limited has been added into main-line, this addon allow store owners to set a limit on the number of sales for their store over a period of time,check the document here.shopitemonly has been added into main-line, this addon prevents players from putting non-store items into store containers, check the document here.20.01.2023 · 993 завантаження
Happy Lunar New Year!
We're celebrating our major event - the Lunar New Year!
Like Christmas, Lunar New Year is a fairly important holiday in mainland China. People leave their work behind and return to their hometowns to reunite with their loved ones and family and celebrate the new year of the lunar calendar together.
I'd like to send Lunar New Year wishes to everyone in the lovely Minecraft community!
This update is a major update, please take care to backup your server and database.
It is very difficult to roll back without a backup.
/qs debug purgeplayerscache to purge PLAYERS database table.%qs_metrics_recent_purchases_global_all_x% - Count all purchases in recent x days with all types%qs_metrics_recent_purchases_global_selling_x% - Count all purchases in recent x days which only selling shops%qs_metrics_recent_purchases_global_buying_x% - Count all purchases in recent x days which only buying shops%qs_metrics_recent_purchases_global_buying_x% - Count all purchases in recent x days which only buying shops%qs_metrics_recent_purchases_player_all_x% - Count all purchases in recent x days with all types%qs_metrics_recent_purchases_player_selling_x% - Count all purchases in recent x days which only selling shops for single player%qs_metrics_recent_purchases_player_buying_x% - Count all purchases in recent x days which only buying shops for single player%qs_metrics_recent_purchases_player_buying_x% - Count all purchases in recent x days which only buying shops for single player%qs_metrics_recent_transactionamount_global_all_x% - Count all purchases transaction amount in recent x days with all types%qs_metrics_recent_transactionamount_global_selling_x% - Count all purchases transaction amount in recent x days which only selling shops%qs_metrics_recent_transactionamount_global_buying_x% - Count all purchases transaction amount in recent x days which only buying shops%qs_metrics_recent_transactionamount_global_buying_x% - Count all purchases transaction amount in recent x days which only buying shops%qs_metrics_recent_transactionamount_player_all_x% - Count all purchases transaction amount in recent x days with all types%qs_metrics_recent_transactionamount_player_selling_x% - Count all purchases transaction amount in recent x days which only selling shops for single player%qs_metrics_recent_transactionamount_player_buying_x% - Count all purchases transaction amount in recent x days which only buying shops for single player%qs_metrics_recent_transactionamount_player_buying_x% - Count all purchases transaction amount in recent x days which only buying shops for single player%qs_shopmanager_global_total_all% - Count all shops in this server%qs_shopmanager_global_total_selling% - Count all selling shops in this server%qs_shopmanager_global_total_buying% - Count all buying in this server%qs_shopmanager_global_total_loaded% - Count loaded shops in this server%qs_shopmanager_global_total_unloaded% - Count unloaded shops in this server%qs_shopmanager_player_total_all% - Count all shops in this server for single player%qs_shopmanager_player_total_selling% - Count all selling shops in this server for single player%qs_shopmanager_player_total_buying% - Count all buying in this server for single player%qs_shopmanager_player_total_loaded% - Count loaded shops in this server for single player%qs_shopmanager_player_total_unloaded% - Count unloaded shops in this server for single player%qs_metadata_fork% - Gets the QuickShop fork name%qs_metadata_version% - Gets the QuickShop version/qs debug updateplayersigns <player> command to allow batch updates all shops info sign for a specific player.QuickShopAPI#getSemVersion for returning a Semver object.ShopCreateSuccessEvent event.The following features could not be included in 4.0.0.0 due to time constraints. We are celebrating the Lunar New Year, and as soon as our holiday is over, I will get back to development work and bring them to QuickShop-Hikari.
The following features have been confirmed and are in the process of being implemented.
12.01.2023 · 892 завантаження
This is a small optional bug fix for Hikari.
We're working on Hikari-v4.0.0.0 and focus on performance optimize (multi-threaded, async, caching etc.), improve loading logic, boost startup speed and improve user experience so it will ready for large network.
Also, this is a great opportunity to make feature requests to us (because this change to the API will create changes, and once the API is fixed, it will be difficult for us to make major feature changes)
You can create your feature request on our Discusstions or Issue Tracker, Looking forward to seeing your thoughts.
09.01.2023 · 604 завантаження
This might be last version of v3 branch, we're developing Hikari v4!
Unless there are major errors in this version, it is unlikely that we will release a new version in a short time.
11 and cause dupilicate upgrade.N/A
N/A
06.01.2023 · 797 завантаження
shop.async-owner-name-fetch has been added into configuration. #[BETA] Should we async fetch the owner name?
#If you enable this option, the calls for ContainerShop#ownerName will return the cached result.
#If the request out of cache, QuickShop-Hikari will allow up to 20 ms for sync fetch username.
#Then it will turn to background and return "N/A" this time.
#This may cause some display problems (e.g. the info sign will show that the shop owner is N/A)
#But once the cache is completed for fetching in the background, the next request will return the correct username
#This is very useful for large servers, because sometimes players may accidentally load a large number of long ago shops, resulting in a large number of main route IO requests for username queries and causing a spike in lagging
async-owner-name-fetch: false
usercache.json to boost initialization cache for improve the cache hit rateEssentialsX data sources, now QuickShop will also use EssentialsX's data for mapping query (still, in parallel)/qs staff uuidquery tasks from server thread to standalone async thread to avoid tps loss/qs unlimited uuid query tasks from server thread to standalone async thread to avoid tps loss/qs benefit uuid query tasks from server thread to standalone async thread to avoid tps loss/qs staff uuid query tasks from server thread to standalone async thread to avoid tps loss/qs transfer uuid query tasks from server thread to standalone async thread to avoid tps loss/qs permission uuid query tasks from server thread to standalone async thread to avoid tps loss05.01.2023 · 641 завантаження
Check the change log in https://modrinth.com/plugin/quickshop-hikari/version/3.6.1.0
This version hot fixed username lookup bugs in 3.6.1.0 and 3.6.1.1.
05.01.2023 · 701 завантаження
Hot fix for 3.6.1.0 for startup NPE on some server
05.01.2023 · 624 завантаження
NOTE: Due the API changes, you might need also update your Addons and Compatibility Modules.
WARNING: Due the database updates, downgrade from 3.6.1.0 without backup is impossible, BACKUP BEFORE INSTALLING THE UPDATE.
CrowdinOTA back online with alternative.
We moved from Crowdin Content Delivery Network to ourself CloudFlare based infrastructure, see this article for details.
By updating to 3.6.1.0, the CrowdinOTA feature will re-enabled on your server.
If it is inconvenient to update the plug-in at this time (for example, code audit is required), you can make the following adjustments to your startup script to switch your existing installation to the new CrowdinOTA endpoint (required QuickShop-Hikari 3.6.0.2 or 3.6.0.3):
-Dcom.ghostchu.quickshop.localization.text.SimpleTextManager.enableCrowdinOTA=true -Dcom.ghostchu.quickshop.localization.text.SimpleTextManager.crowdinHost=https://crowdinota.hikari.r2.quickshop-powered.top
it should looks like this:
java -Xmx4G -Dcom.ghostchu.quickshop.localization.text.SimpleTextManager.enableCrowdinOTA=true -Dcom.ghostchu.quickshop.localization.text.SimpleTextManager.crowdinHost=https://crowdinota.hikari.r2.quickshop-powered.top -jar paper.jar nogui
InventoryWrapper#mklink).InventoryWrapper#locate.QuickShop#getPlayerFinder has been replaced by FastPlayerFinder.
qs_playersPlease see Database Schema page for latest database schema.
Thanks for supporters on Ko-fi for donation ❤
30.12.2022 · 761 завантаження
Hi there, before the change log content, I want kindly ask you to upgrade your Hikari instance to 3.6.0.3 and I will show you for why.
Today (2022/12/30), I have received a e-mail from Crowdin Team and here is the content:
Hi there,
Greetings from Crowdin, hope you're going great🎄
Sorry to bother you during the holiday season, but our team did an annual review and we noticed that your team is actively using [Over-The-Air Content Delivery](https://support.crowdin.com/content-delivery/)feature, which is a paid option. The price is based on the number of requests ($3/1M requests) and the transferred data ($2/10GB) - if you have up to 1M requests and 10GB of data transfer, CDN is free.
According to our database, there were already sent 19M requests and 50GB of data was transferred for a total amount of 72 USD. You can also see this information in the [Payments](https://crowdin.com/settings#payments)tab, and I'm also sharing the document with detailed statistics about your OTA usage in the last months; please find it attached.
There is no need for you to pay the previous debt, but as you are already aware that CDN is a paid option, we kindly ask you to remove CDN from your code at your earliest convenience (preferably within the next month), so no new debt will grow or we can discuss the suitable ways for you to pay for future OTA usage if you would like to keep using it
Please let me know your thoughts on the matter
Looking forward to hearing from you,
And the attachment cdn_usage.txt:
+----------+----------+-----------------------+
| date | requests | transferred_gigabytes |
+----------+----------+-----------------------+
| Apr 2022 | 1241624 | 4.729 |
| May 2022 | 1374644 | 3.768 |
| Jun 2022 | 2477846 | 6.025 |
| Jul 2022 | 2649011 | 6.571 |
| Aug 2022 | 2814239 | 6.446 |
| Sep 2022 | 2255808 | 4.454 |
| Oct 2022 | 2257621 | 5.098 |
| Nov 2022 | 2087014 | 4.902 |
| Dec 2022 | 1924092 | 7.711 |
I was shocked that I never noticed Crowdin Over-The-Air Distribution as a paid feature. Because it is freely available and unlimited in my Open Source Plans account.
Then I have a quick re-check for the Pricing pages and Crowdin's KB, I still can't find a description of Over-The-Air as a paid feature and its billing standard.
Well, as the email said, "Now I know that it is a charging function", so I deleted the Distributions of Remake and Hikari from the Crowdin Control Panel, and hoped Crowdin would not charge me any more.
After that, I replied this email:
I'm sorry I didn't realize that my program has so many users and CDN requests!
Follow your advice, I have already removed Distributions from Crowdin's control panel after I received this mail and I will also remove Crowdin Over-The-Air related codes from the next version.
I am very grateful for your willingness to waive my bill for last month.
Since I can't control my users to upgrade to a new version that without Crowdin OTA functionality, I want to know if I will still receive bills from Crowdin OTA functionality after I removed all Distributions from Crowdin control panel?
Thank you for informing me about it.
Later, I was so shocked by Crowdin Team's reply.
Hi there,
If deleting only distribution (but keeping it in your code still) there will be no data transfer, but there will still be requests
In general, if you do not plan to use it as a paid feature, it would be great to delete it from your code as well
Well, I can't force anyone to update their plugin, this is users right.
So I continued to contact Crowdin Team and got the following reply.
Thank you for your quick reply!
My code uses GPLv3 license and distributes precompiled JARs in binary form.
I will release a new version that removes OTA functions as soon as possible, but I cannot force users to upgrade to a new version (if users are unwilling to uninstall my software from their devices). I have not designed telemetry and remote disabled functions for my software.
At the same time, my Distributions ID has been distributed along with the source code for a long time.
So I want to confirm the following questions to you:
1. Whether the Over The Air function can be completely disabled by myself or Crowdin Team, or whether I must pay the bill for any invalid request.
2. If I delete the Crowdin Project associated with it and recreate it, will the invalid request of the project before deletion continue to be charged.
3. If I do not pay the relevant bills, only the Over The Air function will be disabled or the entire account (even for the Open Source plan).
4. Whether Open Source plans to have a free Over The Air quota, because for a long time in the past, I did not notice that Crowdin mentioned the cost of Over The Air.
5. Earlier, I agreed to participate in the test invitation of Crowdin Enterprise and created the project and account (Open Source plan). But I didn't really use it because I was an open source project.
Should I contact customer support and delete my account and project in Crowdin Enterprise to avoid unnecessary bills?
Reply:
Hi Ghost,
Thanks and yes, we understand you cannot force users to use the new version of the app, so for now, what's needed for you is just to remove the OTA functions from your app's code and release the new version. As long as users switch the version, the number of requests will decrease
Currently, we calculate all the requests sent to the distribution and even if you remove the account\project\disctibition, the requests will still be sent to AWS (Over-the-Air technology is built on top of AWS infrastructure)
I'm afraid we also cannot stop the requests sent to AWS as they are external, and we cannot simply control that on our end so a solution for now, let's agree to the following:
you remove OTA feature from your code and release the new version of the app;
we keep monitoring the number of requests received from your users;
in a month, we'll get back to you with the latest statistic - there is a big chance the number of requests will drop significantly and you will fit the free tier of CDN usage (up to 1M requests and 10GB of data transfer).
during this month, there won't be a need to pay any bill for CDN;
you're also welcome to keep your accounts in Crowdin :)
Does it sound fine to you?
Alright, I agree.
Since 3.6.0.3, the function of CrowdinOTA is completely disabled from plugin.
For other versions, you should not be able to get the latest translated files from the cloud because we terminated Distributions, the backup translation of the plug-in will replace CrowdinOTA, and you do not need to make any other changes.
For earlier versions that do not yet support offline backup translation, the plug-in may stop working, you must upgrade to any version that support offline translations.
Once again, I am very sorry for the inconvenience.
Sandtechnology and I are building our own infrastructure for QuickShop, which we are actively discussing and conducting technical verification.
Once we have a viable alternative, we will test it and add it to the official version.
Everything looks great, no bugs found.
23.12.2022 · 685 завантаження
Last update before 2023! Merry Christmas and Happy New Year!
display-item-use-name./qs reload command.19.12.2022 · 770 завантаження
This is a hotfix for 3.6.0.0.
/overrides/<locale>/messages.yml18.12.2022 · 843 завантаження
Merry Christmas, everyone!
We brought a Christmas update from QuickShop Hikari! Don't worry, Santa Claus will put the update in your chimney.
~~Until it is blackened by smoke and becomes outdated.~~
New addons Plan and Discount now joined QuickShop-Hikari addon's family!
Scroll down to read change logs about our addons!
| Plan | Discount |
|---|---|
![]() |
![]() |
N/A
ShopInfoPanelEvent added into QuickShop-Hikari, event will raise after user clicked shop container and info panel printed.CommonUtil#parseTime(String) method to allow developer convert a Zulu Time (2022-12-17T10:31:37Z) or UNIX Timestamp in seconds 1671273097 to Java Date.Plan addon allow server owners to showcase the recent QuickShop-Hikari activities on the server.
Recorded data can be displayed from Hikari v2.0.0.0 onwards, but only after version 3.6.0.0 can Item amount in Purchase History be displayed correctly.
Global ScopeDue the Plan limitations, We can't add more data into the list because the maxmium columns are hardcoded limited to 5 in server scope.
And still is Plan limitations, the list sorting is disturbed, so the display order is not the actual order.
Due the Plan limitations, We can't add more data into the list because the maxmium columns are hardcoded limited to 4 in server scope.
And still is Plan limitations, the list sorting is disturbed, so the display order is not the actual order.
| Global Purchases | Player Purchases |
|---|---|
![]() |
![]() |
| Global Shops | Player Shops |
|---|---|
![]() |
![]() |
Due the Plan limitations, translate Plan addon is impossible.
Discount Addon added Discount Code in your QuickShop-Hikari server.
/qs discount commands.To create a discount code, you need use discount command:
/qs discount create <code> <code-type> <rate> [max-usage] [threshold] [expired-time]
Command pretty long, but you have in-game command assistant to help you in your tab complete hint.

/qs discount config <code> addshop)To use a Discount Code, you need install them before purchase shops.
/qs discount install <code>
The installed code will remember during this session.
To uninstall a Discount Code, you need use command:
/qs discount uninstall <code>
To use info subcommand, you can query the code creator, range, remaining usage, expired time, threshold and discount rate.
/qs disount info

To remove your a specified discount code, execute command:
/qs discount remove <code>
You need install a discount code first, then you click the shop you want to check, a promot message will show up when you can enjoy the discount in this shop.
If code not accepted by target shop, you will also receive a warning message when you click it.

You need install a discount code first, then purchase a shop that accept your code.
Then discount will applied to your puchase, and your remaining count will be consumed.

NOTE: If the above additional conditions are not met, the Discount Code will not be applied and you will not get a discount, but at the same time, the Discount Code will not be consumed, and the prompt message will contain the specific reason.
An expired discount code will automaticlly removed while server startup or in 30mins.
Before they got purged, players who use a expired code will receive a error message that says the code has been expired.
Expired time accepts both Zulu Time format and UNIX Timestamp in seconds format:

There have a such pretty online website can help you convert the time:
https://www.unixtimestamp.com/
For Zulu Time (ISO 8601 Extended) format:
yyyy-MM-dd'T'HH:mm:ssZZ
Note that the server time zone is used for calculations during the conversion.
Since Nov 20, 2018, I have spent thousands of hours on QuickShop series projects, I have maintain these projects for up to four years.
The fifth year is coming, I would appreciate it if you could light up Star and Fork buttons for Github Repository❤.
Full Changelog: https://github.com/Ghost-chu/QuickShop-Hikari/compare/3.5.0.3...3.6.0.0
17.12.2022 · 549 завантаження
Christmas is coming! We've launched a new Beta version of Addon: Discount.
Now create a Discount Code and let others enjoy discounts in your store!
To create a discount code, you need use command /qs discount create, there have few options you can custom including:
* code name (e.g XMAS50OFF)
* code type
* PLAYER_ALL_SHOPS for all your shops
* SPECIFIC_SHOPS
* SERVER_ALL_SHOPS for all shops on this server (administrator)
* max usage (like you can use this code up to 5 times)
* -1 for unlimited
* price rate
* percentage: 30% is -70%
* fixed: 50 is -50$
* threshold (e.g only purchase over 500$ in one time then you can enjoy -50$ discount)
* -1 for unlimited
* expire time
* -1 for unlimited
* Support UNIX timestamp in seconds format.
* Support Zulu standard format.
Follow the in-game tab-completer to fill arguments to create a discount code.


There is time format example:

By execute command /qs discount install <code> to install a discount code, then it will applied to every purchase that applicable your installed discount code.

If discount codes are available, you will receive a prompt message when you clicking the shop.

By execute the command /qs discount info, you will able to check discount code information that you installed.

16.12.2022 · 559 завантаження
In 3.6.0.0-beta1, our addon family welcomed a new member, Plan.
By install Plan integration, our addon will add a new page and few panel into your overview and per-player metric page.
It is worth mentioning that QuickShop-Hikari has been available for statistical purposes since it was published, but we have never formally written extensions for it to show the data.
The purchase related history has a bug in the past QuickShop Hikari, which causes all the item amount data of Purchases to be zero.
Since 3.6.0.0-beta1, this error has been repaired and new data has been recorded normally.
WARNING: If you executed /qs database purgelogs before, all your metrics will be purged.
In global metrics summary panel, you will able to check the total shops and total purchases on your server.

In global metrics purchases panel, you will able to check recent 1000 purchases in recent 365 days.
Even deleted and invalid shops are included.
We intentionally limited the size of the displayed dataset to avoid database pressure on large networks.

In global metrics shops panel, you will able to check all actived shops on your server, even shop out of stock or out of space.
Deleted shops are excluded.

Not only global, but also per player metrics!
By clicking Playerbase -> Player List -> <username>, you will able to access Plan per-player profile page.
In per-player profile page, expand the Plugins menu on the left nav, you will able to see QuickShop-Hikari panels.
In player metrics summary panel, you will be able to check how many shops that player owned.

In player metrics purchases panel, you will be able to check this player recent 50 purchases.
We intentionally limited the size of the displayed dataset to avoid database pressure on large networks.

In player metrics shops panel, you will be able to check this player all shops on this server.

15.12.2022 · 568 завантаження
Tested on Paper git-Paper-334 (MC: 1.19.3)
15.12.2022 · 528 завантаження
java.lang.ClassNotFoundException: com.comphenix.protocol.wrappers.WrappedDataValue.java.lang.RuntimeException: Failed to find NMS class: network.syncher.DataWatcher$b.For 1.19.3 users, no impacts of those bugs, if you hit java.lang.ClassNotFoundException: com.comphenix.protocol.wrappers.WrappedDataValue on 1.19.3, upgrade ProtocolLib.
Tested on Paper 1.19.2 and Paper 1.19.3.
15.12.2022 · 540 завантаження
15.12.2022 · 601 завантаження
overrides folder with locale code as name, and same name yaml file inside folder.hack for example, and add a same name language to game client by using Resources Pack, and QuickShop-Hikari will detect new language and loading translation from custom languages.debug.delete-corrupt-shops doesn't work. (contributed by @Nlkomaru)ShopPlayerGroupSetEvent now provides player's uuid in event.There is quick preview of new features:




11.12.2022 · 490 завантаження
Today is my birthday! 🎂 And here is birthday update!
This is a beta build, don't install on live server unless you have full backup.
overrides folder with locale code as name, and same name yaml file inside folder.hack for example, and add a same name language to game client by using Resources Pack, and QuickShop-Hikari will detect new language and loading translation from custom languages.ShopPlayerGroupSetEvent now provides player's uuid in event.There is quick preview of new features:




08.12.2022 · 734 завантаження
/qs database purgehistory for purge x days ago logs from your database.27.11.2022 · 1 158 завантаження
/qs find now supports Item Reference/qs export command doesn't work anymore.24.11.2022 · 744 завантаження
/qs lookup create command always report name must applied to regex \w.20.11.2022 · 523 завантаження
Warning: This is a major update, have a lots internal changes, please make sure you have backup for worlds, databases and configs!
Warning: This update contains database structure changes, downgrade without backup is impossible and may kill your shop data!
/qs find command when any of shop not loaded correctly.config.ymltrying-fix-banlance-insuffient now removed from configuration since it doesn't work well, most economy plugin can handle balance cache correctly, if something doesn't work, it should be economy plugin side issue./qs debug sql <sql> function now completely removed from source code and binary.plugin.yml from Github Repository Contributors, thanks for contributing!19.11.2022 · 448 завантаження
BACKUP YOUR DATA BEFORE INSTALL SNAPSHOT BUILDS, NEVER RUN SNAPSHOT ON LIVE SERVER
/qs find command when any of shop not loaded correctly.18.10.2022 · 428 завантаження
A hot fix for last version that fixed purchase failed bug.
17.10.2022 · 604 завантаження

This update is sponsored by the club cat, say "Hello" to "Huahua".
/qs paste reported paste missing the Timings, Transactions and Cron logs.img1:

img2:

12.09.2022 · 108 завантаження
custom-command-alias feature, it has been broked for a long time and should working now!/qs taxaccount command may produce NullPointerException.28.08.2022 · 75 завантаження
Fixed a bug that MySQL driver report exception: Unknown column 'SHOPS.id' in 'on clause'.
27.08.2022 · 373 завантаження
This update tooked a little long of time due my personal things, but anyway, it's here and enjoy it!