LotteryReloaded

<div align="center"> !(https://cdn.modrinth.com/data/cached_images/197be7a972787bf31d2b73fe52cd8f85454a0b55.webp) # LotteryReloaded **A modern, fair, server-side lottery for Paper.** Players buy tickets with in-game money, the pot grows, and at set intervals — or fixed times of day — a winner is drawn with odds proportional to the tickets they hold. !(https://img.shields.io/badge/Paper-26.1.2+-blue) !(https://img.shields.io/badge/Java-25-orange) !(https://img.shields.io/badge/Vault-required-red) !(https://img.shields.io/badge/PlaceholderAPI-optional-green) </div> --- ## ✨ Why LotteryReloaded A ground-up rewrite of the classic *(https://www.spigotmc.org/resources/lottery.22137/)* 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 ` | 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 | <details> <summary><b>Admin commands</b></summary> | Command | What it does | |---|---| | `/lottery draw` | Force a draw now | | `/lottery addpot ` | Add money to the pot | | `/lottery reload` | Reload config + messages | | `/lottery admin` | Admin help | | `/lottery testdraw ` | Simulate the draw many times and report the win distribution — proves the draw is fair, pays no one | </details> ## 🔑 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` <details> <summary><b>All nodes</b></summary> | 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 | </details> ## 🧩 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