✨ Why LotteryReloaded

A ground-up rewrite of the classic Lottery plugin, rebuilt for current Paper: MiniMessage for every message, Brigadier commands, a holder-based GUI, and a draw that runs entirely on the main thread so your data file can't be corrupted by overlapping updates.

The draw is genuinely fair — your chance is exactly proportional to your share of the tickets — and you can prove it with a built-in simulation command.

🎟️ Features

• Weighted draws — buy more tickets, get better odds. Nothing more, nothing less.
• Two draw modes — a repeating interval (every N minutes) or fixed times of day.
• A real economy loop — configurable ticket cost, pot contribution, a flat pot bonus, taxes to a server account, and per-ticket refunds when a draw is cancelled.
• No-win chance — optionally let a draw roll part of the pot over to the next round for a building-jackpot feel.
• Per-rank ticket limits — different caps per permission, plus a buy cooldown.
• Offline winners are paid and notified the next time they log in.
• Configurable GUI — a main menu and a paginated "all players" view, fully editable.
• Draw history — /lottery history shows the most recent winners and pots.
• Win / no-win / reminder commands, toggleable buy and reminder messages, and a Modrinth update check.
• PlaceholderAPI support for scoreboards, tab lists, and holograms.

📦 Requirements

| | |
|---|---|
| Server | Paper (API 26.1.2+) |
| Java | 25 |
| Required | Vault + an economy provider (EssentialsX Economy, CMI, …) |
| Optional | PlaceholderAPI |

Drop the jar in plugins/, start the server, edit the generated files, and run /lottery reload. The plugin disables itself with a clear message if no economy is found.

⌨️ Commands

/lottery (alias /lotto)

| Command | What it does |
|---|---|
| /lottery buy [number] | Buy tickets (default 1) |
| /lottery status | Your tickets, the pot, time until the draw, last winner |
| /lottery gui | Open the lottery menu |
| /lottery history | The most recent draws |
| /lottery togglebuymsg | Mute/unmute others' buy messages |
| /lottery toggleremindmsg | Mute/unmute reminders |

🔑 Permissions

Every node defaults to operator, so grant what your players need through LuckPerms (or set them to true). Two bundle nodes make this easy:

• lottery.player.all → buy, status, gui, history
• lottery.admin.all → draw, reload, addpot, admin

🧩 PlaceholderAPI

%lottery_drawtime%    time until the next draw (counts down live)
%lottery_pot%         the current pot
%lottery_gtickets%    total tickets this round
%lottery_ptickets%    your tickets
%lottery_winner%      the last winner

⚙️ Configuration at a glance

Everything is in config.yml, and all text is MiniMessage in messages.yml (colours, gradients, hex — and other plugins' placeholders via <papi:'id'>). Highlights:

• Switch between interval draws and fixed daily draw times.
• Set ticket cost, pot contribution, a flat pot bonus, tax percentage, and the server tax account.
• Tune the minimum players, ticket limits per rank, and the buy cooldown.
• Enable a no-win chance with a configurable pot rollover.
• Run console commands on a win, a no-win, or each reminder.

The menus in gui.yml and globaltickets.yml are fully editable — materials, slots, names, lore, and what each button does.

💬 Support

• 📖 Full documentation: see the Wiki

If you hit a bug or have a request, open an issue.