SpinToWin 4.3.0b

SpinToWin
Custom spinning menus, interactive prize wheels, and Ichiban Kuji-style rewards for your Minecraft server.

SpinToWin is a configurable animated reward plugin that lets server owners create collectible prize pools, repeatable draws, event lotteries, and custom wheel experiences.

Combine resource-pack inventory menus with interactive circular wheels, weighted rewards, personalized probabilities, flexible entry costs, configurable actions, and a special Last Reward.

Create a limited pool where every prize can only be claimed once per round, or keep rewards available for repeatable draws. Give players a reason to complete the entire collection with an additional final prize, and connect the experience to your server's existing currencies, custom items, permissions, and progression systems.

Rewards, prices, conditions, menus, and wheel appearance are configured through YAML, without writing Java code.

Please note: Resource packs are required for the intended visual experience. Circular Wheel UI additionally requires ArcMenu and both the ArcMenu and SpinToWin resource packs. ArcMenu's mouse mode does not require a client mod.

* The wheel mode show above require you install another plugin called ArcMenu which is also a paid plugin.

Features
Two Ways to Present Your Rewards

• Inventory Spin UI combines custom textures, configurable reward slots, animated selection frames, and menu buttons.
• Circular Wheel UI displays rewards around an interactive wheel with mouse hover effects, tooltips, and animated spins.
• Both interface types support reward weights, prices, repeatable or non-repeatable pools, Last Rewards, and reward history.
• Use different interfaces for different activities, such as seasonal events, collectible prize sets, or currency-based draws.

Ichiban Kuji-Style & Repeatable Reward Pools

• Non-repeatable mode removes claimed reward entries from a player's eligible pool for the current round.
• Players can work toward collecting every available prize instead of repeatedly receiving the same reward entry.
• Claimed entries can disappear from the display or become configurable replacement items where supported by the interface.
• Repeatable mode keeps rewards available after they are drawn, allowing the same entry to be won again.
• Each player's progress is tracked separately for each configured interface.

A Special Last Reward

• Configure an additional Last Reward to give players a clear goal beyond individual draws.
• Build a prize pool where completing the round also grants a special bonus.
• Choose a specific draw number for the Last Reward instead of relying on the default round length.
• The Last Reward is granted in addition to the normal winning reward on the qualifying draw.
• Circular wheels include a dedicated Last Reward display with configurable label, background, border, position, and pulsing animation.

Interactive Circular Wheels

• Choose equal-sized sectors for a consistent visual layout or weight-proportional sectors to represent the current reward weights.
• Animate either a rotating wheel with a fixed pointer or a rotating pointer with a fixed wheel.
• Spins accelerate, rotate, decelerate, and land on the selected reward.
• Configure spin duration, revolution count, idle rotation, sector colors, wheel size, reward icon size, and pointer appearance.
• Hover over sectors to inspect reward names and Lore, with optional enlargement, highlighting, and outlines.
• Changing rewards, weights, or sector colors does not require recreating wheel textures.

Equal-sized sectors still use weighted reward selection. Sector appearance and selection probability are separate settings.

Reward Pools Beyond the Visible Slots

• Inventory menus can contain more rewards than their visible display area.
• Larger pools automatically scroll through their entries while idle, letting players preview rewards before drawing.
• During a spin, rewards and the selection frame move in opposite directions before stopping on the winner.
• Rewards outside the current display window remain eligible for selection.
• Circular wheels also support more than the default inventory layout's 14 reward entries.

Weighted Rewards & Personalized Probabilities

• Assign relative weights to rewards; SpinToWin calculates their selection probabilities automatically.
• Use mathematical expressions and PlaceholderAPI values in supported reward-weight settings.
• Configure different weights according to permissions, worlds, biomes, or placeholder conditions.
• Make selected rewards unavailable to players who do not qualify by assigning them zero weight.
• Optionally display calculated reward probabilities in reward Lore and wheel tooltips.
• Circular wheels update dynamic weights at the start of each draw, keeping weight-based sectors aligned with that draw's selection.

Flexible Prices & Staged Draw Costs

• Charge vanilla items, supported custom items, economy balances, experience points, or experience levels.
• Create free draws for introductory rewards or event participation.
• Apply prices to specific draw numbers, or activate a price from a chosen draw onward.
• Configure individual costs for different stages of a round.
• Combine price conditions with permissions, worlds, and other supported checks.
• Custom price rules can check PlaceholderAPI values and execute configured actions to integrate with other server systems.
• Customize the price text shown on the spin button so players can see the required cost.

Item Rewards, Command Rewards & Custom Actions

• Give actual items, execute actions, or combine both in the same reward.
• Use an item as a display icon while disabling item delivery for command-only rewards.
• Configure fixed or random item quantities.
• Run console commands or player commands to deliver rewards from other plugins.
• Celebrate wins with messages, announcements, titles, action bars, sounds, particles, and potion effects.
• Additional actions include teleportation, entity spawning, and MythicMobs mob spawning.
• Combine delays, random selection, chance checks, and conditional actions to build more varied reward sequences.

Custom Items & Economy Integrations

• Custom-item integrations include ItemsAdder, Oraxen, Nexo, MMOItems, EcoItems, EcoArmor, MythicMobs, ExecutableItems, CraftEngine, NeigeItems, and eco.
• Economy integrations include Vault, PlayerPoints, CoinsEngine, ExcellentEconomy, UltraEconomy, EcoBits, PEconomy, RedisEconomy, RoyaleEconomy, and VotingPlugin.
• Use supported custom items as prizes or as the cost of entering a draw.
• Supported item-ID matching can recognize custom price items independently of changes to their displayed Lore.
• Optional MythicChanger integration provides additional item-matching rules for item prices.
• Save an item held in your hand and reuse it in supported item configurations.

Customizable Menus & Visual Themes

• Configure inventory titles, menu sizes, reward paths, replacement items, button positions, names, and Lore.
• Create custom buttons that execute configured actions.
• Style circular wheels with configurable canvas dimensions, backgrounds, title panels, borders, corner decorations, and button hover colors.
• Adjust wheel tooltip text size and Last Reward presentation.
• Includes inventory examples and two circular-wheel examples covering equal sectors with wheel rotation and weighted sectors with pointer rotation.

Reward History, Limits & Round Management

• Players can inspect rewards recorded for their current round through a dedicated history interface.
• Circular-wheel history includes pagination for browsing larger collections.
• Enable usage limits and assign different allowances through configurable conditions, including permission-based groups.
• Configure automatic round resets and menu closing when a pool reaches its completion threshold.
• Optionally reset a round after a configured interval following the first spin.
• Administrators can open interfaces for other players, reset round progress, reset usage limits, and reload configuration through commands.

Localization & Resource-Pack Workflow

• Includes English and Simplified Chinese language files.
• Optionally select each player's language using their Minecraft client locale.
• Use language placeholders in supported interface text, item names, Lore, and messages.
• Supports legacy color codes, hex colors, and compatible MiniMessage formatting.
• Includes a resource-pack generation and copying workflow for integrating SpinToWin assets into an existing server pack.
• Configure automatic copying to resource-pack directories used by plugins such as ItemsAdder or Oraxen.