Roulex

Animated Physical Roulettes for Your Economy

This isn't a donate case at spawn. It's an economy item.

Every other roulette/crate plugin does the same thing: a crate sits at spawn, you buy a key, you click it, done.

Roulex is different. Roulettes are physical items that live in the player's inventory — not a block bolted to your spawn. That one change turns a gimmick feature into an actual economy system:

• Players can trade unopened roulettes with each other
• Players can sell them on your market/AH plugin like any other commodity
• Players can lose them on death, turning PvP and dungeons into real risk/reward
• Rare roulettes become sought-after items with their own market value — not a currency sink, but a currency

Set droppable: false on any roulette and it locks to that player instead — so you decide, per-roulette, whether it's a tradeable economy item or a personal reward. Nothing else on the market gives you that choice.

System requirements

• Java 17+
• Server version 1.19+
• Server software: Paper, Spigot

Key Features

• Physical Economy Items — Roulettes are real inventory items, not spawn-block gimmicks. Trade them, sell them, drop them on death — build an actual player-driven market around them instead of a one-and-done key system.
• Unlimited Roulettes — Create as many roulettes as you want via separate config files, each with its own ID, appearance, and rewards. Run a free starter roulette and a rare PvP-drop roulette side by side.
• Fully Customizable GUI:
  • Adjustable window size (27–54 slots).
  • Dedicated reel row where the seamless right-to-left spinning animation plays.
  • Custom informational elements (e.g., a "Possible Rewards" button) to guide and entice players.
• Flexible Animations & Dynamic Sounds — Control total spin duration, start/end spin speeds, and how smoothly the reel brakes to a stop. Assign different sound effects, volumes, and pitches to trigger at specific percentages of the spin animation — make a cheap roulette feel instant, and a rare one feel like an event.
• Two Reward Types:
  • Give an item directly.
  • Run a console command (grant ranks, currency, permissions).
  • Fully configure the drop chance (weight), display name, and lore for every single reward.
• Vault Economy Integration — Make roulettes free or paid, with fully configurable opening costs using your server's in-game currency. Feed straight back into your existing economy instead of running a separate crate-key currency.
• Permission & Preview System:
  • Restrict access to specific roulettes via permissions.
  • Preview mode for players without permission — the GUI opens and shows what they could win, but the start button is disabled to encourage rank upgrades.

Why servers are switching to Roulex

• A crate at spawn is a transaction. A roulette in someone's inventory is an asset.
• Rare roulettes appreciate in trade value organically — you don't have to manufacture scarcity, the item system does it for you.
• PvP servers get a genuine reason to hunt players carrying roulettes.
• Market/AH plugins instantly gain a new tradeable category with zero extra setup.

Commands

/roulex give <player> <roulette> [amount] - give a roulette item to a player
/roulex reload - reload configuration
/roulex info - plugin info
/roulex enable <roulette_file_name> - enable roulette file
/roulex disable <roulette_file_name> - disable roulette file

Permissions

roulex.reload - Allows reloading Roulex configuration files
roulex.give - Allows giving roulette items to players
roulex.admin - Grants access to all Roulex administrative commands
roulex.open.roulette.<roulette id> - Allows opening a specific roulette
roulex.enable - Access to /roulex enable
roulex.disable - ccess to /roulex disable