Giveaways & predictions
Everything here runs from Discord slash commands. Only wallets with Manage Server or your configured initiator role can start events — so mods and founders run them with no overhead and nobody else can.
Giveaways¶
A giveaway draws a random winner when the timer ends.
Set an exact end instead of minutes when you want it to land at a specific
local time:
When the timer ends the card flips to GIVEAWAY ENDED, shows the winner, and the winner clicks Claim to open a private support thread that pings your claims role — no DMs to chase.
Prediction pools¶
A prediction pool rewards correct answers, not luck. Two kinds:
Members pick from your options; everyone who picked right can win.
Settle a pool after the outcome with /resolve — it shows an autocomplete
picker of your open pools:
Ties break on a published fair seed, so the result is auditable and nobody
can dispute it. Predictions wait for /resolve (they never auto-draw).
Collect entry info¶
Add the collect option to ask entrants for anything — a wallet for an airdrop,
a socials handle, a freeform note. Entering then opens a short form and the
answers are saved with the entry.
Write the fields comma-separated. Add :number for a numeric field, :long for
a paragraph, and a trailing * to make one required (up to 5 fields).
Gate who can enter¶
Two independent gates, on both /giveaway and /predict:
/giveaway prize:"Holder drop" verified:true # verified holders only
/giveaway prize:"OG reward" role:@OG # members with a role (dropdown)
verified:true— only members who've verified a wallet holding your collection.role:— a native role dropdown; only members with that role can enter. Takes precedence oververifiedwhen both are set. No wallet needed.
Announce winners in a dedicated channel¶
Set a winners channel in Studio → Integrations and every winner (auto-draw,
manual Draw winners, and /resolve) is announced there automatically, with the
Claim button. Leave it unset and winners stay in the giveaway's own channel.
Claiming a prize¶
When a winner taps Claim prize, a private support ticket (a Discord thread) opens and pings your team — native to VectorLabz, no third-party ticket bot.
- Delivery wallet — if you collected one at entry (
collect:"wallet*") it shows in the ticket immediately; otherwise the winner is asked for one at claim (optional — blank for a physical prize). - Where — under your claims channel if set, else the giveaway channel.
- Who — your claims role is pinged to fulfil it.
Set the winners channel, claims channel, and claims role once in Studio → Integrations — all optional, all self-serve.
Who sees what¶
Transparency is built in, with no ambiguity:
- Each member gets a private confirmation and a My entry button to re-check exactly what they submitted.
- Everyone sees the live entry count, the winners, and — for predictions — the answer plus a summary of how the server predicted.
- You (the creator) get the full roster with every value, wallet, and winner in Studio → Giveaways, searchable and exportable to CSV. It's private to owners — members never see each other's entries.
Field reference¶
| Field | Applies to | Notes |
|---|---|---|
prize |
both | Free text shown on the card |
minutes |
both | Entry window in minutes (default 60) |
ends + timezone |
both | Absolute end; each user sees it in their local time |
winners |
both | Number drawn |
verified |
both | Restrict entry to verified holders |
role |
both | Restrict entry to a Discord role (dropdown) |
collect |
both | Entry fields to collect (see above) |
type |
predict | exact or closest (required) |
prompt |
predict | The question shown to entrants |
options |
predict/exact | Comma-separated choices (≤5) |
pool |
predict | Caps the entry pool |
Note
One entry per member, enforced at the database. The winning draw and the revealed seed are recorded, so you can always show your work.