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.