← Back to docs
Setup Docs

Prize Draws (Enterprise)

Enterprise only. Prize Draws turn effort into chances at a real prize. Players collect tickets (earned by playing, bought in the shop, or given by staff) and each lottery enters the tickets held when it closes, then picks its winners in a way anyone can check afterwards. Prize Draws aren't offered on the self-serve platform, on any plan; see How Plan Tiers Actually Differ.

Switching It On

On an Enterprise platform, the Lottery card appears under Sections in Adventure Settings. Switch it on, give the section the name your players will see (it's "Lottery" until you rename it), and write the Prize rules, in your words: who can take part, the key dates, anything legal. Players open those rules from the journey and the Lottery page, with the ways to earn tickets, the lotteries and any awards listed under them automatically.

Everything else is run from Manage Content → Lottery, which each cohort has for itself. Game Masters and administrators run it; NPCs can only look.

Step 1: A Ticket Item

A lottery enters the tickets of one ticket item, so make one first: a new item of type Lottery ticket. Then decide how players get it:

Tickets can't be used or handed on like other items; they wait in the player's Wallet, in the Backpack, until a lottery takes them. Spending currency on a ticket counts as spent, for good.

Step 2: Schedule a Lottery

New lottery asks for:

Schedule one for the end of each month the program runs. A lottery that has locked is the record: it can't be edited or deleted.

How a Lottery Stays Fair

  1. Lock. At the close, the list of entered tickets is frozen and its fingerprint is published (and emailed to the addresses you gave). Locking also names a future round of drand, a public randomness service. That number doesn't exist yet, for anyone, BLUERABBIT included.
  2. Run. Once that round is out, the published rule orders every entrant. More tickets means better odds; nobody can win twice in one lottery. Everyone online at the result time watches it happen.
  3. Pay. If a winner can't be paid, the next person in the fixed order moves up. Anyone can re-check the whole lottery from its record page.

All of this runs on its own at the times you set. A lottery's record page also has Run now (close it now; the result follows about a minute later), Lock the ticket list and Run it now for when you need to act by hand.

Giving Tickets and Setting Budgets

On the Lottery page, staff can give tickets to a player, and see recent gifts. A Game Master gives without limit unless budgeted. Ticket budgets on Manage Content → Lottery let someone else give tickets too: pick the giver (a player, an NPC or a Game Master), the ticket, how many they may give in total, and optionally only to the players of one organization. The form always says what's left before a gift.

Tickets waiting for a lottery counts each ticket's tickets earned by playing, bought and given, and how many players hold them. Issue owed tickets gives everyone every ticket still owed for work already finished, the same sweep every lottery runs before it locks.

Automatic Awards and Rounds

Besides lotteries, prizes can go to the leaderboard: automatic awards to the top players, the top guilds or the biggest climb, measured on a round or on the whole board at a date. A guild prize goes to every member of the winning guild or to one contact; the prize is an item (and how many) or just words. Rounds split the program into periods; the leaderboard then shows a tab per round, and can mark the paying places with the prize (switches in the Leaderboard card under Sections). A started round's start is fixed, and an ended one is the record.

Approving and Delivering Prizes

Winners wait in the prize queue until staff act on them:

A winner is celebrated on their next page in the Adventure.

Lottery-Day Emails

For each lottery day you can send an entries email (once a ticket list has locked) and a results email (once every result is out). Nothing sends by itself: Preview it, Send me a test, then Send, which works through the players in batches and can be resumed. Each goes out once only.

A player who stopped this Adventure's automatic emails (on My Account, or with the link at the foot of an automatic email) gets neither of these emails. The panel says how many players that is before you press Send, and the summary counts them as skipped. A lottery they win still shows in their notifications, and a gift card still arrives in its own email.

What Players See

A Lottery page (named as you named the section) with every lottery, its prize, its countdown and its result; a record page per lottery with the winners, their own tickets and a check anyone can run; My tickets; their tickets in the Backpack's Wallet; and, if you place them in the Journey Builder, a lottery widget and the rules card on the map.

Related