MiniLottery

Buy a ticket, win the pot, and check the draw was fair.

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

Step up and grab a ticket. MiniLottery turns your shop points into a raffle drum. Every ticket sold makes the pot fatter, the clock runs down, and when it hits zero one player walks off with the jackpot. The part I like best is the receipt. I publish the hash of a secret seed before a single ticket is sold, then reveal the seed after the draw, so anybody can redo the sum and see the pick was honest.

Supported Features

• A draw you can check: every round seals a secret seed and shows its hash before selling a ticket, so nobody can claim the pick was rigged.
• Tickets for points: players buy in with shop points, and the pot is simply everything the round has sold.
• Draws on a timer: a winner comes out every so many minutes with no admin doing anything at all.
• The jackpot rolls over: if too few players bought in, the whole pot rolls into the next round, so a quiet hour just builds a bigger prize for later.
• A cap on tickets: stop one rich player owning every draw by limiting how many tickets a single player may hold, or set it to zero for no cap.
• A cut for the house: keep a share of each pot as a point sink, or leave it at zero and the winner takes the lot.
• Reminders before the draw: a shout goes out ahead of each draw, so nobody misses their chance to get in.
• Recent winners on show: the main command lists the last few winners, which is the cheapest hype there is.
• Anyone can verify: one command shows the revealed seed, the hash and the winning number, so a player can check the maths without asking you.
• Safe when things go wrong: a win is written down before the payout goes out, and a held win is paid on the next boot, so a crash never double pays and never eats a jackpot.
• Discord winner posts: each winner and each rollover can post to Discord with the revealed seed, and a really big payout can add an @here.
• Reads in your language: choose a language in the config and every line the lottery says comes from a plain text file you can edit, so your players read the draw in their own words.

Console & RCON Commands

Command	What It Does	Where
MiniLottery.Reload	Refresh config.json while the server keeps running.	Both
MiniLottery.Draw	Force a draw right now.	Both
MiniLottery.TestDiscord	Post a quick test to your webhook.	Console

Player Commands

The /lottery word comes from config.json, so rename it to suit your server.

Command	What It Does
/lottery	Show the pot, your tickets, your odds, the time to the next draw and recent winners.
/lottery buy <n>	Buy tickets for the open round.
/lottery verify	Show the last draw's seed and hash so you can check it was fair.

Permissions

Node	What It Unlocks
The node you set in the config	Limits who may play. Leave it blank and everybody can.

Permissions is optional. With the plugin missing I fail open and everybody may play. The gate only bites when you have set a node and Permissions is actually 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
• A Windows server running ArkAscendedServer through the AsaApi loader
• ArkShop or WShop, and one of the two is required, since the shop is the bank that charges for tickets and pays the winner
• Permissions (optional, works without it, only needed to say who may play)
• A Discord webhook (optional, works without it)

Installation

1. Unzip the download and drop the MiniLottery folder into ArkApi/Plugins/. Keep the folder named MiniLottery, since AsaApi only loads a plugin when the folder and the DLL names match.
2. Open MiniLottery/config.json and set your ticket price, your draw minutes and the rest of the rules.
3. Want Discord posts? Put your webhook URL into discord.json and turn Enabled on there.
4. Restart the server through AsaApiLoader.exe.
5. Look in ArkApi.log for the loaded line, then type /lottery in game and you are open for business.

Support & Help

Something acting up, or a question before you open the drum? Come and find me on Discord and we will get your lottery rolling: https://discord.gg/8GGaEzWk9p

Frequently Asked Questions

What does MiniLottery do?

MiniLottery runs a point lottery on your server. Players buy tickets with shop points, the pot grows with every sale, and on a timer one ticket wins the whole thing. Every draw can be checked afterwards, so a big win never turns into an argument.

How do I install MiniLottery?

Unzip the download and drop the MiniLottery folder into ArkApi/Plugins/, keeping its name so it matches the DLL. Set your ticket price and draw timing in config.json, then restart the server through the AsaApi loader and watch ArkApi.log for the loaded line.

How do players know the draw was not rigged?

Each round publishes the hash of a secret seed before anybody buys in. After the draw the seed itself is revealed, and one command shows the seed, the hash and the winning number, so any player can work the pick out again by hand.

What happens if only one player buys a ticket?

Nothing is lost. You set how many different players a real draw needs, and if fewer bought in the whole pot rolls into the next round. A quiet hour just builds a fatter jackpot for when people are back.

What if the server crashes right at the draw?

The win is written down before the payout leaves, and any win still owed is paid on the next boot. So a crash at the worst possible second means nobody is paid twice and nobody loses a jackpot.

Does it run without ArkShop?

It needs a points shop, but it does not care which one. ArkShop and WShop are both welcome here, and the drum spins on whichever one is installed and switched on. The shop is the bank, because tickets are charged and winners are paid in shop points, so with no shop at all the ticket booth stays shut.

Was any AI content used in the making of this?

The source code itself was fully created by myself. I do use ChatGPT occasionally to generate product images, and I do use ChatGPT to generate the website descriptions. I do this because I don't speak native English perfectly. I am natively from Sweden, so I use GPT to help translate and write product descriptions. I also will sometimes use GPT to write better English logs. Majority of my Free plugins are open source, so you can review the code yourself and freely fork and edit it to your liking.