MiniLottery

MiniLottery runs a provably fair point lottery on your ARK server. Players buy tickets with shop points and one winner takes the whole jackpot in a fair draw.

MiniLottery is a self running point sink for ARK Survival Ascended. I built it so your shop points have somewhere to go and every draw is fair you can check for yourself. Each round makes a secret seed, and its SHA-256 hash shows up front so no one can rig the pick. Players buy tickets with ArkShop points, the pot grows, and a winner is drawn on a timer. If too few play, the pot rolls into the next round so the jackpot keeps building.

Supported Features

• Provably fair draws: every round makes a secret seed and shows its SHA-256 hash before the draw, so players can prove the pick was not rigged.
• Buy tickets with points: players run /lottery buy <n> to buy tickets. The pot is the sum of all ticket sales.
• Auto draws on a timer: a winner is drawn every DrawEveryMinutes, no admin action needed.
• Jackpot rollover: if fewer than MinPlayers bought in, the whole pot rolls into the next round so the jackpot grows.
• Fair ticket cap: MaxTicketsPerPlayer stops one rich player from owning every draw. Set it to 0 for no cap.
• Optional house cut: HouseCutPct lets the server keep a share of each pot, or leave it at 0 so the winner gets everything.
• Draw reminders: WarnBeforeMinutes shouts a heads up before each draw so players do not miss it.
• Recent winners on show: /lottery lists the last few winners to build hype.
• Verify any draw: players run /lottery verify to see the revealed seed and hash and check the math themselves.
• Crash safe payouts: a win is written before the payout and any held win is paid on the next boot, so a crash never double pays or skips a winner.
• Discord winner posts: each winner and rollover can post to Discord with the revealed seed, and a big payout adds an @here ping.

Console & RCON Commands

Player Commands

Command names live in config.json, so you can rename them to fit your server.

Permissions

If Permissions.dll is not installed, MiniLottery fails open and everyone can play. The gate only kicks in when you set a node and Permissions is loaded.

Config

To see every configuration option, visit our docs. To edit your config files the easy way, open our configuration editor.

Requirements

• AsaApi v2.01 or newer
• Windows server
• ArkShop, required. The lottery needs it to charge for tickets and pay the winner.
• Permissions, optional, works without it. Only needed if you want to gate who can play.
• Discord, optional, works without it. Turn it on for winner and rollover posts.

Installation

1. Unzip the download and drop the MiniLottery folder into ArkApi/Plugins/ so the folder name matches the DLL name.
2. Open MiniLottery/config.json and set your TicketPrice, DrawEveryMinutes, and the rest of the rules.
3. If you want Discord posts, set Discord.Enabled to true and paste your WebhookURL.
4. Restart the server with AsaApiLoader.exe.
5. Watch ArkApi.log for the line Loaded plugin MiniLottery to know it came up clean.

Support & Help

Need a hand or hit a snag? Join the Discord and I will help you get it running: https://discord.gg/8GGaEzWk9p

Frequently Asked Questions

What does MiniLottery do? MiniLottery runs a point lottery on your ARK server. Players buy tickets with shop points, the pot grows, and one winner is drawn on a timer and takes the pot. Every draw is provably fair, so players can check the pick was not rigged.

Does MiniLottery need ArkShop? Yes. MiniLottery uses ArkShop points to charge for tickets and pay the winner, so ArkShop must be installed and turned on. If ArkShop is off or missing, the lottery will not run.

How do I install MiniLottery? Unzip the download and drop the MiniLottery folder into ArkApi/Plugins/ so the folder name matches the DLL. Edit config.json, then restart the server with AsaApiLoader.exe. Watch ArkApi.log for the loaded line to confirm MiniLottery started clean.

Is the lottery really fair? Yes. MiniLottery makes a secret seed each round and shows its SHA-256 hash before the draw. The winning ticket comes from the seed and the entry list, then the seed is revealed so /lottery verify lets anyone recompute the pick and prove it was fair.

What happens if not enough players buy? If fewer than MinPlayers bought in, MiniLottery does not pay out. The whole pot rolls into the next round instead, so the jackpot keeps growing until enough players join.

MiniLottery v0.0.1