Dynasty Wheel - La Roue du Coven

By
daemaris

server side mod - lucky wheel

✦ DYNASTY WHEEL — THE COVEN'S WHEEL ✦

Vote for your server, earn tokens, and try your luck at the Witches' wheel.

Fabric 1.21.1 · 100% server-side · Nothing for players to install

✦ SUMMARY

1. How does it work ?

2. Drop Rates

3. Chat Announcements

4. Commands

5. Installation

6. FAQ

✦ How does it work?

Vote for the server on the voting site (/vote command in game).
Automatically receive 2 Solaris Tokens per vote — even if you are offline, they will be waiting for you the next time you log in.
Right-click with a token in hand: the Coven's Wheel opens and the items scroll by, slowing down…
Whatever stops under the hopper is yours!

◆ Drop Rates

The wheel works like a gacha: each tier has its own percentage, fully configurable.

Tier	Chance	Contents
✦ Mythic Cosmetic	0.02%	Exclusive Armourer's Workshop cosmetics — announced to the whole server
◆ Rare Decoration	0.5%	Decorative blocks from the modpack's mods
★ Enchanted Item	2%	Weapons, armor and tools with 2 to 4 random enchantments
Reward	97.48%	Useful resources: food, ores, XP, golden apples, diamonds…

The draw happens before the animation: closing the menu or logging out won't let you re-roll the wheel, and the reward is always delivered.

📣 Chat Announcements

On every vote, the whole server is notified, with a clickable [Vote] button that opens the voting page directly.
When a mythic cosmetic drops, a "The Witches have spoken" announcement appears for everyone, along with a fanfare. Hover over the item in chat to see its full tooltip.

⚙ Features

100% server-side: vanilla chest menu, players don't need to download anything.
Automatic NuVotifier integration, compatible with every voting site that uses Votifier.
Pending tokens for offline players, delivered when they log in.
Fully configurable tiers, percentages and rewards (JSON file).
Rewards in /give command format (components supported) or as console commands.
Random enchantments that are compatible with each other, with no curses.
Automatic detection of modded blocks for the decoration tier.
Customizable chat messages with & color codes.
Hot-reload of the configuration, without restarting the server.
Simulation command to check the rates over thousands of draws.

⌨ Commands

Command	Access	Effect
`/vote`	Everyone	Clickable voting link and pending tokens
`/roue`	Everyone	Help and number of tokens owned
`/roue taux`	Everyone	Shows the chance of each tier
`/roue donner <players> [n]`	OP	Gives tokens (events, battle pass…)
`/roue vote <username>`	OP	Simulates a vote for testing
`/roue simuler [n]`	OP	Runs n dry draws and shows the distribution
`/roue mods`	OP	Lists the mods that add blocks
`/roue recharger`	OP	Reloads the configuration

Commands use French names (roue = wheel, taux = rates, donner = give, simuler = simulate, recharger = reload).

📦 Installation

Install Fabric Loader (0.16+) and Fabric API for Minecraft 1.21.1.
Install NuVotifier-Fabric and set it up with your voting site.
Put Dynasty Wheel in the server's mods folder.
Start the server: the configuration is created in config/dynasty_wheel/config.json.

Dependencies: Fabric API (required) · NuVotifier-Fabric (recommended, for automatic votes)

❓ FAQ

Do players need to install the mod?
No. Everything happens server-side, and the menu uses the vanilla chest.

Can I add items from other mods?
Yes, as long as the mod is installed on the server. An item from a missing mod is simply skipped, without crashing the server.

Does it work with Dynasty Pass?
Yes: a battle pass reward can be the command roue donner {player} 1 to hand out tokens.