Marketplace
Plugin

WoolWheel

@Warrior1321 1 sold
WoolWheel

About

WoolWheel adds a physical, in-world prize wheel to your server — a giant upright disc built from colored wool that players spin with the press of a button, just like the wheels at carnivals and game shows. Every block, tick sound, and slowdown is rendered live in the world, so the whole lobby watches the wheel crawl to a stop under the glowstone pointer.

A real wheel, built in the world

  • Auto-build command — run /wheel create and a solid upright disc is generated facing you, filled with colored wedges, a wooden rim, and a glowstone pointer on top. Size is configurable per wheel.
  • Hand-build support — prefer to build your own? Use /wheel scan and the plugin detects the wheel you built by hand, including custom rims.
  • Button-operated — bind any button to a wheel with /wheel setspin. Players press it to spin; blocks and buttons are protected from griefing automatically.

Cinematic spin animation

  • True continuous rotation — slice boundaries sweep across the disc smoothly instead of colors jumping, driven by a configurable ease-out curve: fast launch, long suspenseful crawl to the stop.
  • Randomized landing — the wheel stops at a random point inside the winning color, never predictably dead-center.
  • Pointer ticks — a click sound plays every time a slice passes under the pointer, rising in pitch as the wheel slows.
  • Rare-win suspense — when a slice below the rarity threshold wins, the wheel flashes the winning slice, plays a beacon-activate sound, and builds tension before the reward is revealed. Tune the threshold, flash count, timing, and sounds in config.

Configurable prizes, command-based rewards

  • Weighted color slices — each wheel defines its colors and relative chances (lower = rarer). Any of the 16 wool colors can be used, and multiple wheels with different slices are supported.
  • Loot tables per color — every slice has its own list of reward commands, each with its own weight. When the color lands, one reward is randomly picked, so lower chances mean rarer pulls — perfect for tiered loot within a single color.
  • Works with any plugin — rewards run as console commands with {player} and {uuid} placeholders, so you can hook into crates, economy, rank plugins, and more.
  • Optional broadcast — announce wins to the whole server, with display names and MiniMessage formatting.

Roll economy

  • Give, take, and set spin rolls per player — globally or for a specific wheel.
  • Per-wheel toggles for consuming rolls, one spin per wheel, and button cooldowns.

Fully configurable

  • Clean config split: config.yml for behavior and animation, wheels.yml for wheel definitions, messages.yml for every player-facing string (MiniMessage supported).
  • /wheel reload applies changes with no restart.
  • PlaceholderAPI supported.

Commands & permissions

  • /wheel give|take|set — manage player rolls (woolwheel.give / woolwheel.take / woolwheel.set)
  • /wheel setspin|unbind — bind buttons to wheels (woolwheel.setspin)
  • /wheel create|scan — build or detect a physical wheel (woolwheel.create)
  • /wheel test — force a spin without consuming a roll (woolwheel.test)
  • /wheel list|info|reload — administration (woolwheel.admin / woolwheel.reload)

Requires Paper 1.20 or newer. A configured "fortune" wheel ships as a working default — install, bind a button, and spin.

Updates

Initial releaseLatestSeptember 14, 2026

Reviews

No reviews yet — buyers can leave one from their dashboard.

35credits
Source code includedLifetime access & free updates
@Warrior1321Creator
Sales
1
Latest version
Initial release
Published
September 14, 2026
Updated
September 14, 2026
© 2026 Codella AI - All rights reserved.