---

✨ 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

Admin commands

Command	What it does
/lottery draw	Force a draw now
/lottery addpot [number]	Add money to the pot
/lottery reload	Reload config + messages
/lottery admin	Admin help
/lottery testdraw [iterations]	Simulate the draw many times and report the win distribution — proves the draw is fair, pays no one

🔑 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

All nodes

Node	Grants
lottery.buy	/lottery buy
lottery.status	/lottery status
lottery.gui	/lottery gui
lottery.history	/lottery history
lottery.draw	/lottery draw
lottery.reload	/lottery reload
lottery.addpot	/lottery addpot
lottery.admin	/lottery admin, /lottery testdraw
lottery.cooldown.bypass	Skip the buy cooldown
lottery.ticketlimit.bypass	Ignore the ticket limit
lottery.ticketlimit.<rank>	A higher per-rank ticket limit

🧩 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.

---