LotteryReloaded

Minecraft 版本： 26.1.2

平台： paper

标签： economy game-mechanics

---

✨ 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.` | 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.

---