SpinToWin-Trial | Funny reward game | Dynamic rate, cost condition & custom texture! | 1.14 - 1.21.5 icon

SpinToWin-Trial | Funny reward game | Dynamic rate, cost condition & custom texture! | 1.14 - 1.21.5 -----

Custom button - Texture UI - Custom frame - Last reward - Folia support - and so on!




English:
  • 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.
  • Fix some minor issues.
中文:

  • 对于低于版本1.16的用户,我们新增了自动将Hex色转换为common色的功能,避免出现调用Hex色导致插件消息的颜色看起来非常诡异。
  • 一些小问题的修复。
----------, Jun 5, 2025

  • Fixed 1.17 versions support.
----------, Mar 22, 2025

  • Added 1.21.4 version support.
    • Mainly added 1.21.4 resource pack format support, for plugin itself, it already support 1.21.4 before this update.
----------, Feb 15, 2025

  • Fixed plugin print error when use custom NBT data in ItemFormat if MythicChanger not installed.
----------, Feb 9, 2025

  • Added custom nbt support in ItemFormat if you have installed NBTAPI in your server.
  • Recoded ItemFormat sell method and fixed some issues related to this feature.
----------, Feb 9, 2025

  • Item Format update: Fixed some item format value do not correctly parsed.
----------, Jan 30, 2025

  • Item Format update: Fixed the issue where enchanted glow was parsed as a hide tool tip in some cases.
----------, Jan 25, 2025

  • Fixed condition do not check in some case.
----------, Jan 3, 2025

  • Build-in free GUI texture into the plugin without having to go to the Wiki to download it.
    • Expansion Pack Vol.1 is not included in plugin.
----------, Jan 3, 2025

  • Build-in free GUI texture into the plugin without having to go to the Wiki to download it.
    • Expansion Pack Vol.1 is not included in plugin.
----------, Jan 3, 2025

  • Happy new year! This update bring a fix for EcoArmor hook.
----------, Jan 1, 2025

  • Fixed hook item price check break.
----------, Dec 28, 2024

  • Fixed limit data didn't save when use MySQL database.
----------, Dec 22, 2024

  • Added Nexo item support.
  • Fixed Item Format error on 1.20.6 version.
----------, Dec 15, 2024

  • Fixed last reward can not obtain in Folia servers.
----------, Dec 12, 2024

  • Added Folia support.
  • Fixed console_command, op_command, player_command action do not work if server does not install MythicChanger.
  • Added new actiom: mythicmobs_spawn.
----------, Dec 10, 2024

  • Item Format update:
    • Added support for set material tag in tool rules.
    • Added support for set multi same attribute modifier.
----------, Dec 1, 2024

  • Added new Item Foramt arg: damage resistance, equippable.
  • Added new action type: conditional.
----------, Nov 9, 2024

  • Added 1.21.2/3 version support.
----------, Nov 4, 2024

  • Updated default UI config.
----------, Nov 2, 2024

  • Added new {xxx} built-in placeholder format support.
----------, Nov 2, 2024

  • Fixed errorManager be null error.
----------, Oct 16, 2024

  • Added /s2w givesaveitem command.
  • Added new save item method, this new method can 100% save item data, no data will lose. (Paper and 1.15+ server only)
  • Added paper-api.skull and paper-api.save-item option in config.yml file.
----------, Oct 14, 2024

  • Fixed skull can not display in latest 1.21.1 server core.
----------, Sep 19, 2024

  • Fixed skull can not display in latest 1.21.1 server core.
----------, Sep 19, 2024

  • Fixed HIDE_ATTRIBUTES item flag does not work for item does not have attribute modifier in 1.20.6 and higher version.
    • This is a bug from Mojang and we can do nothing for this. Plugin will auto add empty attribute modifier if you add hide attributes flag to solve this problem.
----------, Sep 8, 2024

  • Now you can use change-item section in Item Format.
----------, Sep 7, 2024

  • Added NeigeItems and eco support in price.
----------, Aug 26, 2024

  • Fixed error when selling items from eco plugin.
----------, Aug 26, 2024

  • Added new price type: Item Match. This new price type also require MythicChanger.
----------, Aug 25, 2024

  • Fixed Item Format does not work in 1.19~1.19.2.
----------, Aug 12, 2024

  • Added 1.21.1 support in Item Format.
----------, Aug 11, 2024

  • Fixed plugin print error when using command tab complete in some case.
----------, Aug 9, 2024

  • Fixed when use geneerateitemformat command, plugin sometimes print error in 1.21 version.
----------, Aug 3, 2024

  • Fixed ItemFormat parser does not work in version below 1.19.
----------, Jul 30, 2024

  • Added Standard Localized Item Name Translate feature.
    • Due to the fact that the Minecraft server does not store client language files, the plugin cannot know the name of the item you hold displayed on your client. Therefore, in most scenarios where the item name is displayed, we directly display its English name. Now this new feature will automatically download the client language file and translate your item name.
    • You have to setup this feature first to enable this feature.
  • Removed check-full-drop option in config.yml. Plugin now will always try drop reward items when player's inventory is full.
----------, Jul 20, 2024

  • Added VotingPlugin economy hook support.
  • Added ExecutableItems item hook support.
----------, Jul 12, 2024

  • Added VotingPlugin economy hook support.
  • Added ExecutableItems item hook support.
----------, Jul 12, 2024

  • Added price.ignore-item-format-keys option, useful for people want to use fuzzy checking item price.
  • Fixed ItemFormat sell method does not work in some case.
  • If this plugin print error on pre-1.21 server, for now it should be solved.
----------, Jun 26, 2024

  • Added 1.20.6 and 1.21 support
  • Added FoodComponent, ToolComponent and JukeboxPlayableComponent support in Item Format.
----------, Jun 23, 2024

  • Changed UI configs options key, don't worry, old UI config can still use in this version.
  • Fixed plugin ger error when use wrong UI id in /s2w open command.
  • Changed default empty-amount option value to 1 in UI config to fix auto reset system doesn't work as well with default value to 0.
----------, Jun 17, 2024

  • Fixed plugin print error when only use /s2w command without any args.
----------, May 29, 2024

  • Added auto-save.hide-message option, if set to true, we will no longer display auto save message at console.
----------, May 22, 2024

  • Fixed effect and entity_spawn at remote location action does not work as well.
----------, May 6, 2024

  • Updated default config.yml file.
----------, Apr 30, 2024

  • Added new option: item-price-mode.
  • Added new item price mode: ItemFormat, instead of require item must 100% equal than selled item, if 2 item's Item Format is same, we will also consider the item can be used. You can consider it as: fuzzy matching.
  • Fixed item price does not work issue since 3.0.0.
  • Renamed use-uuid-save-data option to data-save-mode.
----------, Apr 30, 2024

  • No longer support use Mini Message at item.
  • Added full new Item Format support.
  • Rewrite command manager codes.
  • Start use new language manager.
----------, Apr 29, 2024

  • Added 1.20.5 support.
----------, Apr 25, 2024

  • Now hex color code in PlaceholderAPI will also be parsed.
----------, Apr 18, 2024

  • Now repackaging EasySQL dependencies.
----------, Apr 11, 2024

  • Now repackaging EasySQL dependencies.
----------, Apr 11, 2024

  • Improved the speed of obtaining third-party plugin items.
----------, Mar 8, 2024

  • Removed double hook item check. Becuase our NBT check method has been used for months and no one said it has problems, so now we remove the second hook item check way and only use NBT check method for now. This will also improve plugin performance in some case.
----------, Mar 7, 2024

  • Removed check-condition option in config.yml, this option will always be true after this version.
----------, Feb 29, 2024

  • Added spin-ui.can-not-close-when-spinning option in config.yml. If enabled, player can not close spin UI when spinning.
  • Changed some config key, but old version's key is still supported.
  • Fixed component support.
----------, Jan 29, 2024

  • Fixed history gui title.
----------, Jan 28, 2024

  • Improved vanilla item name display.
----------, Jan 28, 2024

  • Let us say Hello to adventure component. Start from this version, SpinToWin will fully support text using component format, including:
    • Message send by our plugins.
    • Item from our plugins.
    • GUI title in our plugins.
    • The component support use custom font, style, click(hover) event and so on. It's more modern but not easy to use.
  • Legacy color format is still support if you didn't enable use-component option in config.yml.
  • Added support for sell suspicious sand/gravel which includes loot item.
  • Now GUI title will also support use PlaceholderAPI's placeholder.
----------, Jan 25, 2024

  • Readded %amount% and %times% placeholder in reward items.
----------, Jan 16, 2024

  • Fixed vanilla item with more than 1 amount price check since 2.8.0.
  • Improved double hook item price check feature.
----------, Jan 16, 2024

  • Fixed dynamic amount.
----------, Jan 13, 2024

  • After version 2.8.0, the Item Format used the name option as the display name for the item. However, previous versions used the display option as the display name for the item. Now, the plugin will read both options simultaneously to avoid situations where the new version cannot recognize the corresponding custom item name after the old version configuration is loaded.
----------, Jan 13, 2024

  • No longer package EasySQL project, plugin will auto download it after first load. Plugin is 300Kb+ smaller than before.
----------, Jan 13, 2024

  • Added NeigeItems translate hook.
  • Fixed %display% placeholder always display item type name instead of custom display name.
----------, Jan 12, 2024

  • Fixed op player will lose op after using op_command action.
  • Now items option use ItemFormat simple version.
    • For SpinToWin, you can now use flags, enchants option in item option.
  • Cleaned the codes.
  • Removed /s2w updateconfigs command.
  • Added use-component-title option in config.yml, default to false, if set to true, we will use TextComponent in the GUI title.
  • Added empty_amount option in UI configs, can set the checked empty amount in auto_close_when_empty and auto_reset_when_empty amount, default to 0, set to 13 to make the UI can reset after each spin.
  • Added font option in UI configs, can set the GUI title font.
----------, Jan 11, 2024

  • Fixed price check problem encountered while detecting newer versions of MMOItems.
    • This lead to if your server has MMOItems, plugin will has item price check problem with EcoItems, EcoArmor, NeigeItems.
----------, Jan 10, 2024

  • Improved math calculate codes.
  • Now if the reward item you set in config does not exist, we will auto use STONE to replace it instead put error in console.
----------, Jan 5, 2024

  • Removed announcements and commands option in reward config, please use actions option instead.
  • Added new action: op_command, can run command as op.
----------, Jan 4, 2024

  • Removed GamePoints price hook, use CoinsEngine instead.
----------, Dec 29, 2023

  • Added new action: entity_spawn.
    • Spawn a zombie: entity_spawn: ZOMBIE
    • Spawn a zombie at specified location: entity_spawn: ZOMBIE;;world;;0;;0;;0
  • Added new action: mythicmobs_spawn.
    • Spawn a MM mob: mythicmobs_spawn: Magic_Skeleton;;1 (1 is level)
    • Spawn a MM mob at specified location: mythicmobs_spawn: Magic_Skeleton;;world;;0;;0;;0
----------, Dec 28, 2023

  • Improved language system.
    • Now if plugin find your language file missing some keys, plugin will auto generate default value for it so you no need to manually update langauge file anymore.
    • Now message.yml can be deleted after first load, if you delete it, plugin will generate new language file after next load. (not reload)
----------, Dec 23, 2023

  • Rollback some changes to fixes error with data save system.
----------, Nov 16, 2023

  • Improved plugin performance in the server.
For free version:
  • Removed MySQL database limit, now free version can also use MySQL database!
  • Removed third plugin hook limit, now free version can also use third plugin like MMOItems, EcoItems, Vault and so on!
----------, Nov 7, 2023

  • Added auto save feature for local data save. (MySQL is already auto save)
----------, Nov 6, 2023

  • Improved placeholder condition.
    • Added *= check symbol, which means placeholder is not equal with specified value.
    • Added *!= check symbol, which means placeholder is not contains value string.
    • Now =,>,>=,<,<= check symbol supports decimal.
----------, Nov 2, 2023

  • Now math calculates use Crunch instead.
----------, Oct 24, 2023

  • Added new action: sound.
Those updates are premium version only:
  • Added RoyaleEconomy price support.
  • Removed lower case support in economy-plugin and hook-plugin option, now the 2 option value must 100% same as plugin name.
----------, Oct 22, 2023

  • Now if language message is empty, plugin won't send message to player with blank content.
----------, Oct 8, 2023

  • Now plugin will close inventory after try reset player data.
v.2.5.1 Changes:
  • Updated plugin.yml softdepend.
----------, Sep 30, 2023

  • Added action system. Old commands and announcements option can still be used in this version, however, we will remove them in future updates.
  • Added custom button feature, you can now add more buttons in spin UI.
  • Added RedisEconomy price support.
----------, Sep 19, 2023

  • Fixed "exp" type price does not work.
----------, Sep 7, 2023

  • Added built-in placeholder support in button display name.
----------, Sep 6, 2023

  • Added PlaceholderAPI support in button display name.
----------, Sep 5, 2023

  • New hook item price rework! Now SpinToWin will use fuzzy matching item NBT method to check item price. This means:
    • Plugin have dynamic lore (like EcoItems use PlaceholderAPI in lore), stat (like MMOItems) will 100% support, your dynamic items won't get ignored by price system anymore just becuase they have different lore, NBT or so on.
    • This new check system is in BETA, if players fail to be checked by this new price system, old price system will still work for them, this means plugin now have 2 ways check plugin item price!
----------, Sep 3, 2023

  • Added PlaceholderAPI support in button item lore.
----------, Sep 3, 2023

  • Added auto_reset_timer_after_first_spin option in UI config, if set to a number above 0, UI data will auto be reseted after the seconds you set here.
Below changes are premium version only:
  • Added PEconomy plugin price hook.
----------, Sep 2, 2023

  • Added a "start-apply" option for each price selection. Now, whenever a player spins in the UI, a "spin times" value is recorded. Our plugin offers different prices based on the number of spins, and previously, you could only specify the range of spins for a price to take effect using the "apply" option. With the new "start-apply" option, you can set a range with just the starting value, without an endpoint. For example, the price will remain effective after the 5th spin.
  • Introduced the "last_reward_times" option in the UI configuration. In the past, when the "reserve" option was enabled, players couldn't claim the last reward because the previously claimed rewards wouldn't disappear. Now, you can use this value to allow players to receive the last reward after exceeding a certain number of spins.
  • Reverted the mechanism from the previous version where, if the number of rewards in the UI exceeded the number of UI slots, it would randomly select a suitable number of rewards. This mechanism now only takes effect when the "reserve" option is enabled. Otherwise, the plugin will always select a fixed number of rewards, ignoring any extras.
----------, Aug 27, 2023

Changelog:
  • Now plugin support you set unlimited rewards for a spin UI, if your rewards amount is more than reward slots amount, plugin will randomly pick the rewards. (Random picked rewards won't saved, this means players can just reopen the spin UI to get new random pick)
Those changes are premium version only.
  • Added EcoBits plugin prices hook.
  • Added eco item prices hook.
  • Fixed EcoItems item prices hook. (You MUST update your EcoItems plugin to latest version because it's author changed its API)
----------, Aug 26, 2023

  • Added spin-button-cooldown option in config.yml file. (This feature has been added before, this update just add a option to customize it)
  • Fixed the issue of hook plugin item amount in prices option.
  • Fixed player sometimes get 2 rewards when they click spin button too quick.
  • Fixed color codes does not work well at placeholder option in UI prices configs.
  • Fixed plugin still generate new models for Expansion Pack frames and icons even they are already exists.
How to update to this version?
Added those contents in your config.yml file, if not, it still OK, plugin will generate a default value for new options.
Code (YAML):
# Set to -1 to disable cooldown system.
spin-button-cooldown
: 20
----------, Aug 13, 2023

  • Fixed plugin still generates yml data even you are using MySQL database.
----------, Aug 12, 2023

This update includes changes to the configuration file. Please read this update log carefully. Since the release of v2, we have been focusing on improving the user update experience. Therefore, despite significant changes to the configuration file, you can continue using the old file format without making any adjustments. However, we cannot guarantee that the support for the old configuration file format will be maintained in future updates.
  • In this update, we have made adjustments to the settings related to adding Lore to all reward items in SpinToWin. We realized that there was a limitation where only one line of Lore could be added. Therefore, in this update, we have made the following changes:
    • The options "last-reward-item-add-lore" and "common-reward-item-add-lore" have been moved from the "message.yml" file to the "config.yml" file. Additionally, these options have been changed to List type, allowing for multiple lines of Lore to be added.
    • In the "config.yml" file, we have added a new option called "add-lore-at-first-or-last". This option will determine whether the added Lore should be placed at the beginning or the end.
  • Previously, we were using the player's name as the data storage object, but we realized that this approach is insecure as players can change their usernames. Therefore, we have made a change and now we use the player's UUID as the storage object.
    • We have added a new option called "use-uuid-save-data" in the "config.yml" file. If you wish to continue using the player's name as the storage object, please set this option to false. For users of older versions, if you have not added this option to your "config.yml" file, the plugin will assume that this option is set to false.
  • Fixed PlaceholderAPI and color code does not working well in announcement option in UI configs.
  • Fixed player data not saved when server stopping.
  • Fixed config.yml not being reloaded with /s2w reload.
  • Now plugin will close all player's spin UI when plugin is reloading or server is stopping.
  • Now plugin will still try connect to MySQL database if your password is empty.
How to update to this version?
You should add those contents to config.yml:
Code (YAML):
# If set to false, we will use player name save data.
use-uuid-save-data
: true
# If set to true, we will add lore at first line.
# If set to false, we will add lore at last line.
add-lore-at-first-or-last
: false
last-reward-item-add-lore
:
 - '&3 (Will obtain if all rewards have claimed! )'
common-reward-item-add-lore
:
  - '&7Rate
: %rate%%'
----------, Aug 12, 2023

  • Finally fixed plugin always generate new custom model data for textures that already registered custom model data for them.
  • Added %display% and %amount% built-in placeholder. You can use them in commands, announcements, price placeholder and so on!
  • Added new placeholder option format: placeholders.<Use Times>.
Code (YAML):
placeholders:
  1
: "First Spin Display"
  2
: "You have spined 1 time, the second time?"
  3
: "Good luck!"
  • Now replace item can use hook plugin item.
Code (YAML):
replace:
  hook-plugin
: Oraxen
  hook-item
: test
  amount
: 1
  • Now display, lore, cmd option also support modify hook plugin item, like:
Code (YAML):

rewards
:
  1
:
    hook-plugin
: ItemsAdder
    hook-item
: 'cosmetics:icr_cream'
    display
: '& #8b5cf6Ice Cream'
    lore
:
     - '&f'
      - '&fBackpack Cosmetics'
    commands
:
     - 'lp user %player_name% permission set cosmetics.ice_cream'
    give-item
: false
    amount
: 1
    rates
:
      default
: 1
      vip
: 5
    rates-conditions
:
      vip
:
        - 'permission
: group.vip'
----------, Aug 8, 2023

Changelog:
  • Fixed plugin print error on disable.
Hot to update to this version:
  • Just copy to /plugins/ folder
----------, Aug 2, 2023

  • Hotfix for the resource pack.
----------, Aug 1, 2023

Changelog:
  • Fixed plugin always generate new custom model data even the icon/frame item model already generated.
  • Improved error system, now plugin won't spam your console if its catch error.
How to update to this version?
  • Just drop to /plugins/ folders.
----------, Aug 1, 2023

Changelog:
  • Added auto copy resource pack features. Default support ItemsAdder plugin, you can set your own copy rule to support other plugins!
How to update to this version?
  • Added those contents in your config.yml file:
Code (YAML):
auto-copy-resourcepack:
  enabled
: true
  # If you are using Oraxen, please change this to Oraxen.
  # Other plugins is OK, you just need put correct path in path option.
  plugin
: "ItemsAdder"
  # If you are using Oraxen, please change this to "/pack/assets".
  path
: "/contents/flipcard/resourcepack/"
----------, Jul 31, 2023

Changelog:
  • Fixed plugin will fail to copy resourcepack when you are first use auto-copy-resourcepack feature.
  • Plugin will auto add white color code to your GUI title if you are try using ItemsAdder or Oraxen image symbol, placeholder.
  • Added history_gui and history_size_dynamic option in UI config, this will help you edit history GUI!
How to update to this version?
  • Just copy to your plugins folder. (if you need use 2 new histroy gui options, just add them by yourself, plugin won't get error if you didn't add the 2 options)
----------, Jul 30, 2023

Changelog:
  • Changed auto-copy-resourcepack.path option default value, it was flipcard's, now fixed to spintowin.
How to update to this version:
  • Don't need update to this version if you have downloaded 2.0.6, just change auto-copy-resourcpack.path value to /contents/spintowin/resourcepack.
----------, Jul 30, 2023

Changelog:
  • Added auto copy resource pack features. Default support ItemsAdder plugin, you can set your own copy rule to support other plugins!
How to update to this version?
  • Added those contents in your config.yml file:
Code (YAML):
auto-copy-resourcepack:
  enabled
: true
  # If you are using Oraxen, please change this to Oraxen.
  # Other plugins is OK, you just need put correct path in path option.
  plugin
: "ItemsAdder"
  # If you are using Oraxen, please change this to "/pack/assets".
  path
: "/contents/flipcard/resourcepack/"
----------, Jul 29, 2023

  • Added limits-conditions option in UI config.
  • Now limits use this new format:
屏幕截图 2023-07-28 101456.png
----------, Jul 28, 2023

  • Fixed plugin always only print 1 TabComplete result.
----------, Jul 28, 2023

  • Fixed rates option does not work well.
  • Breaking change: Now rates option does not support permission as sub-option, because we find YAML format does not allow use do that, now use this format:
屏幕截图 2023-07-27 183956.png
----------, Jul 27, 2023

  • Fixed default example UI config.
----------, Jul 27, 2023

  • Added chinese language file, if you have generated plugin config files, you have to regenerate plugin config files to get the new language files.
----------, Jul 26, 2023

Changes from premium version:
  • Added UltraEconomy and CoinsEngine support. (However, free version can not use this)
  • Improved limit system, please view Wiki to know more.
  • Added %uses% and %times% built-in placeholder.
  • Other fixes and improves.
  • Added permission based rate system!
    • In this system, rewards rate is based on player permission, you can set different reward rate for VIP players or MVP players.
    • This also can be a check, if players already have VIP rank, they won't be able to get VIP rank reward because you set this rewards rate to 0 for players who already have VIP permission.
    • Enjoy this update, more features will be added soon as we recode prices and rewards system in past 2.0.0 update.
  • Fixed vanilla item price check. (>1 amount)
  • Added MythicMobs v4 support. (However, free version can not use this)
  • Added PlaceholderAPI support in rates system. (Wow)
  • Added rates-conditions sub-option in rewards option.
  • Added announcement sub-option in rewards option.
  • Added times sub-option in rewards option.
  • Added math support in rate option.
  • Now rates option also support PlaceholderAPI.
  • Better vanilla item support for prices.
  • Added custom skull support.
  • Added apply and cost option for spin UI. (just like FlipCard)
  • Fixed double EcoItems hook.
  • Added spin limit system.
  • Added permission-limit-check option in config.yml, default to false, if set to true, spin limit system will be enabled.
  • Added new permission: spintowin.limit.<Spin UI config name>.<limits>.
  • Added default value for options in config.yml.
  • Breaking message file change: Renamed click-false option to click-price-not-meet, added click-limit-reached option.
  • Breaking message file change: Added only-in-game-open-command option, this message will be displayed at console when using wrong open sub-command arg.
  • Fixed console print error when using wrong command arg in console.
  • Updated help command.
  • Added /spintoin resetlimit command.
  • Other fixes and improves.
Changes for free version:
  • Removed some UI config option can not change limit.
----------, Jul 12, 2023

  • Updated config file.
----------, Jun 19, 2023

  • Updated UI config.
----------, May 27, 2023

  • Released on SpigotMC.
----------, May 27, 2023

Resource Information
Author:
----------
Total Downloads: 17,086
First Release: May 27, 2023
Last Update: Jun 5, 2025
Category: ---------------
All-Time Rating:
1 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings