UltimateShop

• API Update: Added ShopHelper#startBuy, ShopHelper#startSell, ShopHelper#getVaultBuyPrice, ShopHelper#getVaultSellPrice method.
• Added some mathematical function support. For more info, please view: ➗Math Calculate Format | UltimateShop Wiki

• Added new action: back. Can back to previous menus, if previous menu does not exist, will open the rollback menu you set. Updated default menu files, some back button use back action now.
• Fixed plugin print error on 26.2 servers.

• Added {display} placeholder support in price placehoder option, can display the item name if the price type is vanilla item or hook item.
• Improved GUI listener codes.

• ItemFormat Update: Fix tool component does not work well in some case.
• Added support for latest Dominion v4 version and drop it's old version support.
• Improved price display placeholder merge rule.

• The maximum purchase and sell quantity per transaction is limited to 9,999 start from this version.
• The loading of player cache has been changed from PlayerLogineEvent to PlayerJoinEvent.
• If the player cache has not completed reading, the plugin will no longer allow any transactions.
• When the server stops, it will be forced to wait for all ongoing asynchronous database tasks to complete before continuing with other work, to avoid player data loss and database errors.
• If a player joins the server but the player cache has not been loaded and quickly leaves the server, the player cache will remain on the server and cannot be cleared. This issue has now been fixed.
• Plugin will close the database connection, unregister all listener and PAPI extension and so on after disable.
• Plugin no longer reconnect the database when use reload command, to do that, you need restart the whole server.
• Fixed memory leak in some case.
• Reworked the cache system, and should have better performance now.
• Reworked the use time reset codes, and should have better performance and some issues fixed.
• Added support for display favourite remove message in favourite menu.
• Added new conditional symbol in auto product lore add system: @w, it will return true if the button exist in buy more menu and can only buy or sell product.
• Also updated default auto add lore message, now add to favourite menu and sell all line no longer display at buy more menu.
• Now prompt waiting for input message no longer use fixed plugin prefix.
• Other small changes and fixes.

• Reworked skull item builder codes, should have better performance now.
• Reworked gui listener codes, should have better performance.
• Other small changes and fixes.

• Improved codes of use times cache.
• Added {amount} placeholder support for buy/sell price not enough message.
• Added null catcher for PlaceholderAPI extension.
• Fixed random placeholder will print issue in some case.
• Other small changes and fixes.

• Added hook-item-method option in config.yml file.
• Fixed GUI issue when enabe menu or title circle update feature.
• Added menu.anti-dupe-checker option in config.yml file.
• GUI Open method and unregister method now force run in main thread.

• Added built-in number format feature.
• Added support for CraftEngine 26.4+ version and drop support for version below that.
• Fixed open action and close action does not work for buy more menu.
• Added {number:} built-in placeholder.
• Fixed item amount issue in multi display item format.

• Added /shop sellhand command.
• Added CoinsEngine 2.7.0 version support.
• Language missing key updater will use server language value first.

• Fixed plugin will print error when use skull item with base64 data in Spigot server.

• API Change: Added Cancellable support to ItemPreTransactionEvent. (Thanks P-Pang3)
• API Improve: Support ItemStack[] object type in API instead of Inventory only.
• API Fix: Fixed ItemFinishTransactionEvent buyOrSell can not work as well.
• Added {shop-id} placeholder support in shop menu title. (Thanks Happy-FZM)
• Title Update feature no longer require MythicChanger. (Thanks Happy-FZM)
• Added {item-material} placeholder in PlaceholderAPI extension to display product display item material ID. (Thanks Happy-FZM)
• Updated all language files by AI.
• Fixed menu click cooldown feature does not work well in some case.
• Fixed boss bar color codes in Spigot servers.
• Other small changes and fixes.

• Fixed default transport shop name does not exist in language file.
• A new settings.menu-settings option has been added to the shop configuration.You can configure all menu-related settings here. The menu settings defined in this section only apply to this specific shop, allowing you to create independent menu configurations for the shop without needing to create a separate menu configuration file.
• Added require-conditions option for single thing config.
• Added {amount} placeholder support in buy-conditions and sell-conditions.

• Added hide-message option in product config section.
• Added force-display-fail-message option in config.yml file. Default to false.

By default, we will auto force display fail message to make sure player know whether they have successfully clicked the product button. If set to false, we will not force display fail message and you can also use hide-message option in shop configs to hide the fail messages.

• Added math support in placeholder condition.

• This version bring COOLDOWN_TIMED and COOLDOWN_TIMER reset mode to free version.
• Added fail-type option support in fail-actions section.
• Fixed plugin can not load at Paper-1.17.1 version.

• Fixed NPE issue when use multi item as price and didn't set placeholder option for them.
• Fixed {amount} used in give/take actions return 0.0 in some case.
• If {amount} returns an integer, it will no longer include a decimal point.

• Added new action: action_bar.
• Added support for use built-in placeholder in lang placeholder.
• Fixed language option in config.yml does not work since 4.2.0.

• The language placeholder feature has been added, allowing for the display of customized language texts for different client languages.

This version has ended the Alpha testing status since version 4.1.0 and is expected to be the last version in 2025.

• Fixed the issue of errors when downloading MariaDB drivers.

• This version continuously improves the performance of plugins related to data processing based on community feedback.
• Optimized the logic of the auto reset feature.

• Added new action: update_gui.
• Added new option: menu.title-update.circle-update, if set to true, we will update gui title every second when player open GUI.
• The plugin's performance when processing database data has been optimized. This update requires sustained feedback from the community, as I, as the author, don't have that many "players" to test it with.

• Fixed MySQL database does not work as well start from 4.1.0.

• Added /shop updategui command.
• Added support for automatically updating the player's GUI when resetting buy times, sell times, and random placeholders. The display item for 'buy more menu' can now display up to 99 quantities.
• The default configuration file has been updated, enabling some useful features by default.
• ItemFormat Update: Fixed item damage can not being set to 0. Improved database codes.

• We plan to end support for versions below 1.20.5 (excluding 1.20.5) starting in January 2026.
• The "add lore" feature for display items now supports using multiple conditional symbols simultaneously.
• Added support for negation of conditional symbols.
• The suffix in display item add lore has been removed, and all suffixes have been merged into the conditional symbol (i.e., the prefix).
• The secret-shop-items option is now set in each shop configuration file instead of being uniformly set in config.yml.
• Items that have been hidden due to the secret shop items feature will no longer be tradable, instead of just being hidden in previous versions.
• You can now set secret rules in the config.yml file to consider hiding items based on the conditions met.

• Added time-offset section in config.yml file.

• Added error catcher for debuild item methods.

• Added new action: title, particle.
• When no economy plugin is detected in Vault, the plugin will repeat the detection to avoid the plugin failing to detect economy plugins linked to Vault due to different plugin startup sequences.
• Added placeholder support to some action options.
• Fixed PEconomy hook error message.

• Added not-open-when-invalid option support in buy more menu settings in config.yml file. If there is only a purchase button in the buy more menu and the product is not purchasable (meaning there is no buy price), then we consider this buy more menu to be invalid and cannot be opened, and the same applies to sell.
• Ignored double click in prefix GUI.
• The ItemFormat sell method is no longer case sensitive.
• Added hook item ID invalid catcher for MMOItems and CraftEngine plugin.

• Completely remaster the code of MySQL database feature.

Old version users need to reset the database to obtain the performance improvement brought by this update, otherwise the effect will be minimal.

• Removed sell.sell-all.hide-message and sell.sell-stick.hide-message option as they are not work anymore.
• Improved SellProductMethod.

• Fixed the issue where the normal Paper server would be recognized as a Folia server after Paper-1.21.8-Build # 53.
• Added /shop sellallhand command.
• Updated default example files.

• Added menu.secret-shop-items option in config.yml file.
• Updated example files for example shop and example daily shop, if you already generated them, try delete your UltiamteShop configs and they will auto regenerate new example files.
• Other small fixes and changes.

• Added multi characters support in product ID and button ID, for more info, please view plugin Wiki.

Users using MySQL before this update need delete old database to use multi characters in product or button ID, otherwise plugin will print error.

• Fixed plugin print error when disable server if MySQL enabled.
• Added take option in single thing configs, if set to false, plugin will consider the item be a requirement and will not cost it after player buy or sell the product.
• Fixed change-item option in ItemFormat does not work in latest version of MythicChanger.
• API Improve.

Added ShopHelper class to help developer quickly get target product or buy/sell price from ItemStack object.

• Added /shop search command.

This command currently only mentions text output of target product information, and in future versions it will mention GUI display of search results. Thanks to this API improvement, we plan to add the instruction/shop sellhand in the future.

• Other small fixes and changes.

• Fixed the issue where actions would be triggered repeatedly based on the quantity of items in the shop if the quantity of items is greater than 1.
• Added take-actions support in single thing configs.
• Fixed {amount} built-in placeholder sometimes print wrong value.
• Fixed issue realted to sell all.
• Some other fixes.

• Recoded some part of sell all feature, which now better supports products using the CLASSIC_ANY mode.
• Added sell-all option for product configuration. If set to false, the product cannot use sell all.

• A recent update to the Paper server recode the Save Item system, which caused Save Item files generated in previous versions to throw errors when read in later versions. This update fixes that issue and encourages users to proactively update their Save Item files to the new format.
• Added MiniMessage format support in auto add lore feature.
• Added modify-lore option support in buy more menu confirm item configs.
• Added {amount} and {item-name} placeholder support in display item's lore.
• Added cron built-in placeholder.
• Fixed typo in updatemysqltable command.
• Fixed small language file issue.

• For MySQL users: you have to use command /shop updatemysqltable command to update your MySQL table format to new version then restart the server.
• Fixed lastBuyTime and lastSellTime sometimes not saved.
• Fixed cooldownResetTime not saved in some case.
• Fixed item name not display correctly in some case. Some other fixes.
• Improved givesaveitem command.

Be careful! This version has changed a lot of code. It has not been tested by many users. Unless you are running a small server, please do not use it for production. The latest stable version is: 3.7.0 (free version is 3.6.8).

• Added full MiniMessage support. Except for a few cases, the plugin supports the use of the MiniMessage format almost everywhere.
• For Paper server users above 1.17.1, you will automatically use the MiniMessage format and the Color Parser built into the plugin will no longer be available.
• However, we certainly consider that it is quite troublesome to convert the built-in Color Parser of the plugin into MiniMessage, and many users still like our Color Parser. In the past, two characters (&e) could solve the problem, but now multiple characters () are required. Therefore, Paper users above 1.17.1 can still use the Built-in Color Parser, and we will automatically convert it to MiniMessage format for you.
• The plugin will be split into two versions, Paper version and Spigot version.
• Paper users with versions above 1.17.1 will use the Paper version, otherwise you will use the Spigot version. They just use different APIs, and the other functions they provide are basically the same, unless it is clearly stated in the Wiki that this function is only available in the Paper version.
• For this reason, the paper-api section of the config.yml file will no longer be available.
• Fixed an issue where the plugin would fail in versions lower than 1.17.1, because the plugin incorrectly called some code that was only available in versions 1.17.1 and above.
• Added automatic item translation function. For Paper version users, we can automatically display the name of the item according to the player's client language.
• For users of versions lower than 1.16, we have added a new function to automatically convert Hex colors to common colors to avoid the situation where the colors of plugin messages look very strange due to calling Hex colors.
• Added component options to ItemFormat and fixed some minor issues.
• The items folder of the plugin will be treated as a separate item management configuration file, just like the items folder of the MythicMobs plugin.
• The format of each item configuration file in the items folder follows ItemFormat.
• In ItemFormat, an item option has been added that can be used to deserialize items, so ItemFormat can now directly read items that you have previously saved.
• The /shop saveItem command has been improved, and you can now add bukkit or itemformat at the end of the command to determine how we will save the item.

• Added new action: buy_more_menu and sell_all_menu.
• Updated default shop configs.
• Added cache.load-delay option in config.yml file.
• Added display-item.calculate-amount option in config.yml file. If set to true, if your product default amount is 10, and you purchase it x64 in one time, we will display 640 as result in amount placeholder.
• Fixed 1.17 version support.
• Added CraftEngine item hook support.

• Fixed typo in setrandomplaceholder and resetrandomplaceholder command.
• Added 2 API events: ItemPreTransactionEvent, ItemFinshTransactionEvent.
• Recoded ItemFormat sell method and fixed some issues related to this feature.
• Added open-once option support for open-actions33333333
• Updated language files.

• Fixed buy-actions always execute once.

• Added support for customizing config keys of conditions for various single things. You can set them to the same value to avoid setting conditions for both products and prices at the same time.
• Item Format update: Fixed the issue where enchanted glow was parsed as a hide tool tip in some cases.
• Item Format update: Fixed some item format value do not correctly parsed.
• Added support for auto refresh use times or random placeholder if refresh time reached in some case.
• If we can not auto refresh, we will print "never" message to the next placeholder.
• Updated default config.

• Fixed EcoArmor hook does not work as well.
• Fixed plugin error when use /shop reload if auto save is disabled.

• Fixed database issue.

• Improved Folia support.
• Added placeholder.auto-settings.add-discount-in-all-price-amount.black-shops option in config.yml file.
• Updated default product configs which uses v3 new condition format in sell-limits-conditions.
• Added placeholder support in reset-time option.
• Fixed buy times or sell times get reset when use /shop reload or server restart if using MySQL database.
• Added Nexo item support.
• Fixed ANY and CLASSIC_ANY price mode do not display price if picked price player don't have enough money or item.
• Improved buy/sell times feature.
• Improved MySQL dababase performance.
• Improved cache manager codes.
• Fixed the issue where vanilla items always have a space at the end of their names.

• Update to latest.

• You need regenerate ALL your configs before update to this version.
• This includes 1.21.2/3 support added and many things recoded.

• Updated to latest.

• Updated to latest.

• Update to latest.

• Fixed ItemFormat parser does not work in version below 1.19.

• Updated to latest version.

• Fixed cache listener in 1.19.4 or lower version.
• Improved default product and menu configs, 150+ products included! (Thanks kingakis)
• Added @n conditional symbol in display item add lore system, useful in buy more menu.

• Fixed 1.19 or lower version GUI support.

• Fixed effect action does not work.
• Fixed spawn_entity, op_command action does not work with Folia.

• Fixed op_command action print error with Folia.

• Removed display-name.add-name option in config.yml.
• For now buy more menu confirm button use it's Item Format name option as it's display name instead of display-name.add-name option in config.yml.
• Updated default buy more menu.

• First release on Modrinth.