Skip to content

Raffles

🐸 Introduced in Frogge v0.3

Raffles are a ticket-based prize draw, distinct from Giveaways in a few real ways: tickets are credited by an admin (not a self-service entry button), the draw is weighted by ticket count rather than one-entry-one-chance, and there's a real gil pot with a winner/venue split. There's no end date. Rolling is always a manual admin action.

Quick Start

  1. Run /admin menu → Raffles → Add. Set its Name, Cost per Ticket, Winner %, and Num Winners from the detail screen.
  2. Credit tickets as people buy them: Add next to Add Tickets → pick the member → enter a quantity. (Or use /addtickets, see below.)
  3. Roll Winners when ready.

The Raffles home screen in Discord, listing two raffles with Add, Modify, Remove, and a View Old Raffles button. → A raffle's detail screen in Discord, showing Name, Cost per Ticket, Winner %, Num Winners, Auto Notify Winners, Posted to Channel, Add Tickets, Entries Report, and the Pot split.

  1. Open Raffles → + New Raffle, then fill in its Details on the raffle's own page.
  2. Credit tickets with the Add Tickets form (search for a member, enter a quantity).
  3. Roll Winners when ready.

The Raffles list page in the Dashboard, showing total/active/rolled counts and two raffle rows. → A raffle's page in the Dashboard, showing its Details, Pot, Add Tickets, posting, and Entrants sections.

Full reference

Creating & editing

A raffle's detail screen covers Name, Cost per Ticket (in gil, type k/m shorthand like 100k, capped at 999,999,999), Winner % (the winners' share of the pot, 0–100), Num Winners (1–10), and Auto Notify Winners (DM each winner when rolled). Unlike Giveaways, there's no visual customization (no description/thumbnail/color/emoji). Raffles are function-first.

Crediting tickets

Three equivalent ways to credit tickets, all landing in the same place:

  • The detail screen's Add button, next to Add Tickets (Discord) or the Add Tickets form (Dashboard): pick a member, enter a quantity.
  • /addtickets: a typed command (autocomplete over raffles that haven't been rolled yet, then a member and a quantity), kept alongside the picker flow specifically so crediting doesn't slow down during busy club hours.

The /addtickets command in Discord, showing raffle/user/quantity arguments filled in and a tooltip noting k/m shorthand is accepted.

Tickets can't be added once a raffle's been rolled.

The pot

The detail screen shows the live pot: total tickets sold × cost per ticket, split by Winner % into a winner share and a venue share. Both surfaces show the same numbers.

Posting & the entries report

Unlike Events/Giveaways/Profiles, raffle posting works from either surface: the posted tracker is a plain read-only info card (cost per ticket, entrant/ticket counts, the pot split, and winners once rolled) with no entry button of its own, so there's no interactive state only Discord can own. Post picks a channel; the Dashboard additionally has its own Refresh and Remove for an existing post, not just Discord's automatic keep-up-to-date.

Entries Report (either surface) downloads a .txt file of every entrant and their ticket count, sorted highest first.

Rolling winners

Roll Winners (re-labeled Re-Roll Winners after the first roll, with a confirmation before picking again) is available on both surfaces. The draw is ticket-weighted: someone with 20 tickets is proportionally more likely to win than someone with 2, not an equal chance regardless of ticket count. If your venue has a log channel configured (Settings → General), a rolled raffle posts a notice there automatically; if not, the roll confirmation shown to the admin says so explicitly rather than silently skipping it. There's no automatic rolling. Raffles have no end date, so someone always has to trigger it.

Old raffles

A rolled raffle stays on the main Raffles list for 3 days, then drops off it automatically and moves to View Old Raffles instead, on either surface: Discord gets a paginated, newest-rolled-first browser; the Dashboard's View Old Raffles (N) link opens the same raffle rows in one plain list. Nothing about an old raffle is read-only: Re-Roll Winners and the entries report still work from there, it's purely a decluttering cutoff for the main list.