Quick Leagues & Quick Tournaments¶

Quick Leagues (QL) and Quick Tournaments (QT) are lightweight, cross-club events designed to fill up fast and start themselves. They work exactly like regular leagues / tournaments once underway — the only difference is how they're created and how players sign up.

A Quick Event can optionally charge a Bullseyes entry fee from each participant's wallet and pay it back to the top three finishers as a prize pool. See Bullseyes Wallet for how the coins themselves work.

Entry fees are platform-admin-only. Only ThrowSense can run a paid Quick Event. When a club owner or league admin creates a Quick Event, the entry-fee and payout fields are hidden and the event is always free to join. This keeps prize money on the platform, not individual clubs.

What's different from a regular event¶

Create a Quick League¶

Club admin / league admin → Leagues → Create league → tick "Quick League".

In addition to all the normal league fields (see Leagues) you get:

When the last seat fills, ThrowSense stamps QuickRosterFullAt, generates the division/fixture plan automatically, and kicks off the first fixture window.

Create a Quick Tournament¶

Ranking admin / league admin → Ranking → Create tournament → tick "Quick Tournament".

Same extra fields as a Quick League, plus the usual tournament knobs:

• Min / max participants — QTs that don't hit Min by the registration deadline are auto-cancelled and every paid entry fee is refunded.
• Registration closes at — when the clock runs out the bracket is generated immediately (no admin click needed).
• Entry fee and Payout % work exactly the same as in a Quick League.
• Average gate — same as a Quick League: leave the event open, or cap entry to a maximum verified 3-dart average (see Fair entry below).

Fair entry: average-based gating (📊)¶

A Quick Event can restrict who may join by verified 3-dart average, so a strong player can't stack an entry-level ladder (and a beginner isn't thrown against sharks). The gate is chosen per event when it's created:

Verify your average (once)¶

Settings → "Verified average". Enter your current 3-dart average and upload a screenshot as evidence, then submit. A platform admin / moderator — or any club owner, admin or moderator — reviews the request and approves or rejects it. Once approved, your verified average unlocks every average-capped event you qualify for. You only need to do this once; re-submit if your level changes.

Joining a capped event¶

• If your verified average is at or below the cap, you join like any other Quick Event.
• If it's above the cap — or you haven't verified yet — the Join button explains why and links you to the verification form.

Spotting free & fair events at a glance¶

Every competition listing — the dashboard, the league browser and the ranking home page — now carries highlight badges so you can read the terms before you open anything:

Regular (club) leagues and tournaments are always free to join, so they carry the 🆓 badge too.

How players experience a Quick Event¶

1. Dashboard banner. Every logged-in player sees a cross-club "Quick Events" banner on the league home page. It lists every open QL and QT with their seat fill / registration countdown, the 🎯 entry fee pill and 💰 current prize pool.
2. Confirm-join modal. Clicking "Join" opens a modal that spells out:
   • current wallet balance
   • entry fee and balance after this fee
   • prize pool before / after joining
   • estimated 🥇 🥈 🥉 payouts (minus 5 % house fee)
   • a blocked "Insufficient Bullseyes" warning with a link to top up, if the player can't afford it
3. Join. On confirmation, the entry fee is debited from the wallet and credited to the event's prize pool. Both the player and the event row update instantly.
4. Withdraw before start. Players can self-withdraw as long as the bracket hasn't been generated (QT) or the roster isn't full (QL) — the entry fee is refunded automatically and the prize pool shrinks by the same amount. Admins removing a participant trigger the same refund.
5. Play. Fixtures / bracket matches run like any normal event.
6. Payout. When the QT completes, coins are distributed to the finalists. When the last Quick League season completes, the top three captains of the top division receive their share.

Prize-pool mechanics¶

• Entry fees accumulate in PrizePoolCoins on the event row.
• On payout, ThrowSense retains 5 % as a house fee (shown as "5 % goes to ThrowSense" in the UI).
• The remaining 95 % is split according to the payout percentages you configured (default 60 / 30 / 10).
• Any rounding remainder or missing-winner share also goes to the house so the books balance exactly.
• Refunds — if the whole event is cancelled (QL season not started yet, QT auto-cancelled for lack of participants, admin delete), **every paid entry fee is refunded** to the original payer. No partial payouts.

Admin & moderator actions¶

Everything a league admin / moderator can do to a normal league or tournament also works on a Quick Event:

• Edit fee / payout % — allowed while the event hasn't started. Once the pool has been distributed (or the bracket generated for a QT, or the roster is full for a QL) these fields are locked to keep the ledger consistent.
• Remove a participant — refunds that player's entry fee.
• Cancel / delete the event — bulk refund to every paying player.
• Manually distribute prizes — for edge cases where the automatic payout hook didn't fire, an admin can post the final 🥇 🥈 🥉 player IDs and trigger the payout explicitly from the tournament admin page.

Troubleshooting¶

• "This player hasn't got enough Bullseyes to join." They need to top up at /wallet (see Bullseyes Wallet).
• "Prize pool shows 0 after payout." Expected — PayoutDistributedAt is stamped and the pool was paid out. The event's ledger entries (entry_fee, prize, refund_entry) stay in Wallet_Transactions for audit.
• A cancelled QT didn't refund. Refunds only apply to events where the bracket hasn't been generated. If a QT was cancelled mid-play, contact support.