Classic Lottery
Released
Stellarfrog 's Classic Lottery system for DXRP
A classic DarkRP lottery. Type /lotto (or /lottery) to start a lottery and buy a ticket; others join with the same command; when the timer ends, one random entrant wins the whole pot. Fully zero-sum and economy-safe — cancelled lotteries refund everyone.
Super basic it will be a good ground to build from.
# 🎟️ Classic Lottery — Server Owner Guide
*Updated for the Announcements & Stats update (July 2026).*
Everything you need to get Classic Lottery set up and running on your server.
Three systems in one addon: **Scratchers** (11 instant-win tickets), **Powerball** (progressive jackpot draw), and the classic **/lotto** pot lottery — now with server-wide win announcements, a public odds panel, and an admin economy dashboard.
---
## 📦 Installation
1. Add **Classic Lottery** (`classic-lottery`) to your network via the DXRP portal.
2. That's it — no map entities, no spawning, no setup. Everything opens through chat commands.
3. Requires your server's economy to be on (`MoneyEnabled`). If money is disabled, all lottery actions are disabled automatically.
On first run the addon creates `classic_lottery.json` in the host's data folder — your settings, the jackpot, all pending tickets, and the economy stats live there from then on.
---
## 💬 Player Commands
| Command | What it does |
|---|---|
| `/scratchers` | Opens the scratcher shop. Buy tickets ×1 / ×5 / ×10. The header shows the **live Powerball jackpot**. |
| `/scratch` | Opens your ticket fan. Scratch one by hand — or hit **⚡ Scratch All** to burn through the whole stack. |
| `/powerball` | Opens the Powerball picker — choose 5 numbers (1–35) + 1 Powerball (1–12), or Quick Pick. |
| `/lottoodds` | Opens the **Odds & Payouts** panel — every ticket's real win chance (1 in X) and the full Powerball prize ladder. Also a button in the shop. |
| `/lotto` (or `/lottery`) | Buys a $50 ticket in the classic pot lottery and starts the 60-second draw. |
| `/lottohelp` | Prints the command list in chat. |
There is **no keybind** — `/scratch` is the universal opener (DXRP addons can't register custom keybinds).
**Wins pay out instantly.** A fully scratched winner is removed and paid on the spot — no redeem step. Powerball winners are paid automatically after each draw, even if they've logged off. Winners get a chime; hitting a ticket's **top prize** gets a little rising fanfare. Losing cards that were one symbol short show a "😩 SO CLOSE" call-out.
Players holding unscratched tickets get a **one-time reminder** in chat when they first spawn each session.
---
## 🛠️ Admin Commands
All require the **Spawn Entity** permission (`CommandSpawnEntity`) in your rank setup.
| Command | What it does |
|---|---|
| `/lottoconfig` | Opens the in-game admin config panel. |
| `/lottostats` | Opens the **economy dashboard** — total wagered, paid out, house net, and payout % per game, with a reset button. |
| `/powerballdraw` | Forces an immediate Powerball draw. |
---
## ⚙️ Configuration (`/lottoconfig`)
Changes apply **live**, are **saved automatically**, and are **synced to every player's screens** — prices shown in the shop, on card faces, and in the odds panel always match what's charged.
**Scratchers**
| Setting | Default | Range | What it does |
|---|---|---|---|
| Ticket Price × | 1.00× | 0.25–5.00 | Scales every scratcher's cost. |
| Reward × | 1.00× | 0.25–3.00 | Scales every payout **and** the prize numbers shown on the card. |
**Powerball**
| Setting | Default | Range | What it does |
|---|---|---|---|
| Draw Frequency | 30 min | 5–120 min | Time between automatic draws. |
| Ticket Price | $500 | $0–$100,000 | Cost per Powerball entry. |
| Jackpot Seed | $50,000 | $0–$10,000,000 | The jackpot's **reset floor** after a jackpot win. Editing it only moves the live jackpot if the pot hasn't grown yet — an accumulated jackpot is never wiped. |
| Jackpot Rake | 40% | 0–100% | Share of each ticket price added to the jackpot. |
| Jackpot Ticker | 10 min | 0–60 min | How often the server announces the current jackpot + time to next draw. **0 = off.** |
**Announcements**
| Setting | Default | Range | What it does |
|---|---|---|---|
| Big-Win Feed | $1,000 | $0–$1,000,000 | Any scratcher or Powerball win at/above this amount is announced server-wide ("🎉 {player} won $X on {ticket}!"). **0 = off.** |
---
## 🎫 Scratcher Tiers
11 tickets, cheap to premium. Match 3 symbols to win (Golden Ticket needs 4). Every ticket's true odds are public — players can check the **1 in X** win chance per tier in `/lottoodds`. Overall the tiers return roughly 75–82% to players, making the lottery a healthy money **sink**.
| Ticket | Price | Top Prize |
|---|---|---|
| Lucky 7s | $50 | $500 |
| Cash Splash | $100 | $1,000 |
| Neon Sevens | $150 | $2,000 |
| Wildcard × | $200 | $4,000 |
| Gold Rush | $250 | $5,000 |
| Triple Threat | $400 | $10,000 |
| Bank Heist | $600 | $15,000 |
| High Roller | $800 | $25,000 |
| Diamond Jackpot | $1,000 | $50,000 |
| Platinum Vault | $2,500 | $125,000 |
| Golden Ticket | $5,000 | $500,000 |
Limits: max **250** unredeemed tickets per player, max **25** per purchase.
Every ticket's outcome is decided **server-side at purchase** — a client can never fabricate a win, and **⚡ Scratch All** resolves on the server too (one summary line: tickets scratched, wins, total won).
---
## ⭐ Powerball
- Pick **5 main numbers (1–35)** + **1 Powerball (1–12)**. Max **10 tickets per player per draw**.
- Default **40%** of every ticket price feeds the jackpot; the rest is a money sink.
- The jackpot **rolls over** every draw with no winner. Jackpot winners split it evenly.
- The **jackpot ticker** keeps the pot visible: every 10 minutes (configurable) the server announces the jackpot and the countdown to the next draw.
| Match | Prize |
|---|---|
| 5 + PB | 💰 **JACKPOT** |
| 5 | $50,000 |
| 4 + PB | $10,000 |
| 4 | $2,500 |
| 3 + PB | $1,000 |
| 3 | $250 |
| 2 + PB | $100 |
| 1 + PB | $50 |
| 0 + PB | $25 |
Draws run automatically on the host every 30 minutes (configurable). Offline winners are still paid — prizes go to their account balance.
---
## 🎰 Classic Pot Lottery (`/lotto`)
The old-school DarkRP lottery: $50 a ticket, one entry per player, 60-second countdown, one random winner takes the whole pot. If fewer than 2 players enter, everyone is refunded. Fully zero-sum.
---
## 📈 Economy Dashboard (`/lottostats`)
Admin-only. Live totals since the last reset, persisted across restarts:
- **Scratchers** — tickets sold, total wagered, total paid out, house net, payout %.
- **Powerball** — tickets sold, wagered, paid, rake collected, house net, payout %.
- **House net total** across both games, and a **Reset stats** button (admin-gated).
Use it to sanity-check the sink: if payout % drifts far above ~80%, someone's been lucky — or you've set Reward × generously.
---
## 💾 Persistence & Restarts
Everything important survives a restart: all `/lottoconfig` settings, the live Powerball jackpot, **all pending Powerball tickets**, **all unscratched scratcher tickets**, and the economy stats.
Scratcher tickets also **survive disconnects** — a player who logs off with 20 unscratched tickets gets them right back in `/scratch` next session (outcomes were locked in at purchase, so nothing can change in between). The only things that reset on reboot are the in-progress `/lotto` pot (refund-safe, it just clears) and the Powerball draw countdown, which restarts from full.
---
## ❓ FAQ
**Nothing happens when players use the commands.**
Check that money/economy is enabled on your server — every lottery action is gated on it.
**Who can access the admin panels?**
Anyone with the `CommandSpawnEntity` permission (config, stats, and forced draws). There is no separate lottery-admin rank, so grant that permission carefully.
**The announcements are too chatty / not chatty enough.**
Both knobs are yours: set **Jackpot Ticker** to 0 to silence the jackpot announcements, and raise or lower the **Big-Win Feed** threshold (or set it to 0) to control which wins get celebrated server-wide.
**Can players see the real odds?**
Yes — `/lottoodds` shows the genuine per-ticket win chance computed from the actual prize tables, plus the full Powerball ladder and live jackpot. Transparency is a feature: it builds trust in the games.
**If I raise the Jackpot Seed, will it wipe a big rolled-over jackpot?**
No. The seed is the reset floor for after a jackpot win. Editing it only moves the live pot if the jackpot hasn't accumulated anything yet.
**Is it exploit-proof?**
Ticket outcomes are rolled on the host at purchase, all payments and Scratch All resolve host-side, and failed payouts are rolled back. Clients only ever reveal what the server already decided.
---
*Made by StellarFrog - community & support at Cosmic-Networks*
configs saves to its own file, classic_lottery.json, in the game's FileSystem.Data folder — not in Config.Current, so the snapshot system doesn't touch it. Host writes it on any /lottoconfig change, rake, or draw, and reloads it on start. Should survive restarts and snapshot restores fine.
For more updates and more teasers for future developments/help or more detailed question come to https://discord.gg/3S8WkmmfQp My discord username is StellarFrog
Super basic it will be a good ground to build from.
# 🎟️ Classic Lottery — Server Owner Guide
*Updated for the Announcements & Stats update (July 2026).*
Everything you need to get Classic Lottery set up and running on your server.
Three systems in one addon: **Scratchers** (11 instant-win tickets), **Powerball** (progressive jackpot draw), and the classic **/lotto** pot lottery — now with server-wide win announcements, a public odds panel, and an admin economy dashboard.
---
## 📦 Installation
1. Add **Classic Lottery** (`classic-lottery`) to your network via the DXRP portal.
2. That's it — no map entities, no spawning, no setup. Everything opens through chat commands.
3. Requires your server's economy to be on (`MoneyEnabled`). If money is disabled, all lottery actions are disabled automatically.
On first run the addon creates `classic_lottery.json` in the host's data folder — your settings, the jackpot, all pending tickets, and the economy stats live there from then on.
---
## 💬 Player Commands
| Command | What it does |
|---|---|
| `/scratchers` | Opens the scratcher shop. Buy tickets ×1 / ×5 / ×10. The header shows the **live Powerball jackpot**. |
| `/scratch` | Opens your ticket fan. Scratch one by hand — or hit **⚡ Scratch All** to burn through the whole stack. |
| `/powerball` | Opens the Powerball picker — choose 5 numbers (1–35) + 1 Powerball (1–12), or Quick Pick. |
| `/lottoodds` | Opens the **Odds & Payouts** panel — every ticket's real win chance (1 in X) and the full Powerball prize ladder. Also a button in the shop. |
| `/lotto` (or `/lottery`) | Buys a $50 ticket in the classic pot lottery and starts the 60-second draw. |
| `/lottohelp` | Prints the command list in chat. |
There is **no keybind** — `/scratch` is the universal opener (DXRP addons can't register custom keybinds).
**Wins pay out instantly.** A fully scratched winner is removed and paid on the spot — no redeem step. Powerball winners are paid automatically after each draw, even if they've logged off. Winners get a chime; hitting a ticket's **top prize** gets a little rising fanfare. Losing cards that were one symbol short show a "😩 SO CLOSE" call-out.
Players holding unscratched tickets get a **one-time reminder** in chat when they first spawn each session.
---
## 🛠️ Admin Commands
All require the **Spawn Entity** permission (`CommandSpawnEntity`) in your rank setup.
| Command | What it does |
|---|---|
| `/lottoconfig` | Opens the in-game admin config panel. |
| `/lottostats` | Opens the **economy dashboard** — total wagered, paid out, house net, and payout % per game, with a reset button. |
| `/powerballdraw` | Forces an immediate Powerball draw. |
---
## ⚙️ Configuration (`/lottoconfig`)
Changes apply **live**, are **saved automatically**, and are **synced to every player's screens** — prices shown in the shop, on card faces, and in the odds panel always match what's charged.
**Scratchers**
| Setting | Default | Range | What it does |
|---|---|---|---|
| Ticket Price × | 1.00× | 0.25–5.00 | Scales every scratcher's cost. |
| Reward × | 1.00× | 0.25–3.00 | Scales every payout **and** the prize numbers shown on the card. |
**Powerball**
| Setting | Default | Range | What it does |
|---|---|---|---|
| Draw Frequency | 30 min | 5–120 min | Time between automatic draws. |
| Ticket Price | $500 | $0–$100,000 | Cost per Powerball entry. |
| Jackpot Seed | $50,000 | $0–$10,000,000 | The jackpot's **reset floor** after a jackpot win. Editing it only moves the live jackpot if the pot hasn't grown yet — an accumulated jackpot is never wiped. |
| Jackpot Rake | 40% | 0–100% | Share of each ticket price added to the jackpot. |
| Jackpot Ticker | 10 min | 0–60 min | How often the server announces the current jackpot + time to next draw. **0 = off.** |
**Announcements**
| Setting | Default | Range | What it does |
|---|---|---|---|
| Big-Win Feed | $1,000 | $0–$1,000,000 | Any scratcher or Powerball win at/above this amount is announced server-wide ("🎉 {player} won $X on {ticket}!"). **0 = off.** |
---
## 🎫 Scratcher Tiers
11 tickets, cheap to premium. Match 3 symbols to win (Golden Ticket needs 4). Every ticket's true odds are public — players can check the **1 in X** win chance per tier in `/lottoodds`. Overall the tiers return roughly 75–82% to players, making the lottery a healthy money **sink**.
| Ticket | Price | Top Prize |
|---|---|---|
| Lucky 7s | $50 | $500 |
| Cash Splash | $100 | $1,000 |
| Neon Sevens | $150 | $2,000 |
| Wildcard × | $200 | $4,000 |
| Gold Rush | $250 | $5,000 |
| Triple Threat | $400 | $10,000 |
| Bank Heist | $600 | $15,000 |
| High Roller | $800 | $25,000 |
| Diamond Jackpot | $1,000 | $50,000 |
| Platinum Vault | $2,500 | $125,000 |
| Golden Ticket | $5,000 | $500,000 |
Limits: max **250** unredeemed tickets per player, max **25** per purchase.
Every ticket's outcome is decided **server-side at purchase** — a client can never fabricate a win, and **⚡ Scratch All** resolves on the server too (one summary line: tickets scratched, wins, total won).
---
## ⭐ Powerball
- Pick **5 main numbers (1–35)** + **1 Powerball (1–12)**. Max **10 tickets per player per draw**.
- Default **40%** of every ticket price feeds the jackpot; the rest is a money sink.
- The jackpot **rolls over** every draw with no winner. Jackpot winners split it evenly.
- The **jackpot ticker** keeps the pot visible: every 10 minutes (configurable) the server announces the jackpot and the countdown to the next draw.
| Match | Prize |
|---|---|
| 5 + PB | 💰 **JACKPOT** |
| 5 | $50,000 |
| 4 + PB | $10,000 |
| 4 | $2,500 |
| 3 + PB | $1,000 |
| 3 | $250 |
| 2 + PB | $100 |
| 1 + PB | $50 |
| 0 + PB | $25 |
Draws run automatically on the host every 30 minutes (configurable). Offline winners are still paid — prizes go to their account balance.
---
## 🎰 Classic Pot Lottery (`/lotto`)
The old-school DarkRP lottery: $50 a ticket, one entry per player, 60-second countdown, one random winner takes the whole pot. If fewer than 2 players enter, everyone is refunded. Fully zero-sum.
---
## 📈 Economy Dashboard (`/lottostats`)
Admin-only. Live totals since the last reset, persisted across restarts:
- **Scratchers** — tickets sold, total wagered, total paid out, house net, payout %.
- **Powerball** — tickets sold, wagered, paid, rake collected, house net, payout %.
- **House net total** across both games, and a **Reset stats** button (admin-gated).
Use it to sanity-check the sink: if payout % drifts far above ~80%, someone's been lucky — or you've set Reward × generously.
---
## 💾 Persistence & Restarts
Everything important survives a restart: all `/lottoconfig` settings, the live Powerball jackpot, **all pending Powerball tickets**, **all unscratched scratcher tickets**, and the economy stats.
Scratcher tickets also **survive disconnects** — a player who logs off with 20 unscratched tickets gets them right back in `/scratch` next session (outcomes were locked in at purchase, so nothing can change in between). The only things that reset on reboot are the in-progress `/lotto` pot (refund-safe, it just clears) and the Powerball draw countdown, which restarts from full.
---
## ❓ FAQ
**Nothing happens when players use the commands.**
Check that money/economy is enabled on your server — every lottery action is gated on it.
**Who can access the admin panels?**
Anyone with the `CommandSpawnEntity` permission (config, stats, and forced draws). There is no separate lottery-admin rank, so grant that permission carefully.
**The announcements are too chatty / not chatty enough.**
Both knobs are yours: set **Jackpot Ticker** to 0 to silence the jackpot announcements, and raise or lower the **Big-Win Feed** threshold (or set it to 0) to control which wins get celebrated server-wide.
**Can players see the real odds?**
Yes — `/lottoodds` shows the genuine per-ticket win chance computed from the actual prize tables, plus the full Powerball ladder and live jackpot. Transparency is a feature: it builds trust in the games.
**If I raise the Jackpot Seed, will it wipe a big rolled-over jackpot?**
No. The seed is the reset floor for after a jackpot win. Editing it only moves the live pot if the jackpot hasn't accumulated anything yet.
**Is it exploit-proof?**
Ticket outcomes are rolled on the host at purchase, all payments and Scratch All resolve host-side, and failed payouts are rolled back. Clients only ever reveal what the server already decided.
---
*Made by StellarFrog - community & support at Cosmic-Networks*
configs saves to its own file, classic_lottery.json, in the game's FileSystem.Data folder — not in Config.Current, so the snapshot system doesn't touch it. Host writes it on any /lottoconfig change, rake, or draw, and reloads it on start. Should survive restarts and snapshot restores fine.
For more updates and more teasers for future developments/help or more detailed question come to https://discord.gg/3S8WkmmfQp My discord username is StellarFrog