Giveaway Plugin — Ori Discord Bot
What does the giveaway plugin do?
Section titled “What does the giveaway plugin do?”Ori’s giveaway plugin lets Discord server admins create provably fair giveaways with a single button click. Members enter via a Discord button — no commands to type. Every giveaway generates a public page at g-[code].ori.gives showing live entry count, prize details, and cryptographic proof that the winner was selected fairly. Free for all servers.
Dashboard-managed
Section titled “Dashboard-managed”Giveaways are created, monitored, and ended entirely from the Ori dashboard at oribot.org. There are no slash commands to learn. You configure everything visually — prize name, duration, channel, winner count — and Ori handles the rest.
Public giveaway pages
Section titled “Public giveaway pages”Each giveaway gets a unique public page at a URL like g-abc123.ori.gives. This page is visible to anyone — no login required. It shows the prize, the server running the giveaway, a live entry count, a countdown timer, and the cryptographic proof that the draw is fair.
Provably fair winner selection
Section titled “Provably fair winner selection”When a giveaway is created, Ori commits a cryptographic seed before any entries are accepted. After the draw, the seed is revealed and anyone can independently verify that the winner was selected fairly. The admin cannot influence the outcome. See How does provably fair selection work? below for the full explanation.
One-click entry
Section titled “One-click entry”Members enter by clicking the “Enter” button on the giveaway embed in Discord. One click, they’re in. No commands to type, no external sites to visit.
Live countdown and entry counter
Section titled “Live countdown and entry counter”The Discord embed shows a countdown timer and an entry counter that update periodically. The ori.gives page shows the entry count in real time.
Public verification after draw
Section titled “Public verification after draw”After the giveaway ends, the ori.gives page becomes a permanent receipt showing the winner, the revealed seed, and a verification link. Anyone can re-compute the draw in their browser to confirm the result.
How do I set up a giveaway?
Section titled “How do I set up a giveaway?”- Open the Ori dashboard at oribot.org.
- Select your server.
- Click Plugins, then Giveaway.
- Click Create Giveaway.
- Enter the prize name.
- Set the duration (hours or days).
- Optionally add a description.
- Choose the channel where the giveaway embed will appear.
- Click Create — Ori posts the embed with an Enter button immediately.
What it looks like
Section titled “What it looks like”In the dashboard
Section titled “In the dashboard”What your members see
Section titled “What your members see”How does provably fair selection work?
Section titled “How does provably fair selection work?”When a giveaway is created, Ori generates a random seed — a string of random characters. A fingerprint (hash) of that seed is published on the giveaway page before any entries are accepted. This fingerprint is a one-way function: you can verify a seed produces a given fingerprint, but you cannot work backward from the fingerprint to the seed.
When the timer ends, Ori reveals the original seed. Anyone can then verify two things:
- The fingerprint matches the revealed seed. This proves the seed was not changed after entries opened.
- The winner is calculated from the seed and the entry list. The formula always gives the same result for the same inputs. Anyone can re-run it.
Because the seed was locked before entries opened, the admin cannot influence the outcome. The draw is determined entirely by a value that was committed before anyone entered.
For a deeper explanation, see the Provably Fair Explained guide.
Configuration
Section titled “Configuration”- Prize name (required) — The prize being given away. Displayed on the Discord embed and the public page.
- Duration (required) — How long the giveaway runs. Set in hours or days.
- Description (optional) — Additional details about the prize or entry requirements.
- Channel (required) — Which Discord channel the giveaway embed appears in.
- Winner count — How many winners to draw. Default: 1. Maximum: 25.
- Bot protection (Plus only) — Enables a verification pipeline to prevent bot entries. Members are redirected to the giveaway page to verify before their entry is recorded.
The giveaway page (ori.gives)
Section titled “The giveaway page (ori.gives)”Every giveaway gets a public page at a unique URL like g-abc123.ori.gives. This page shows:
- Prize name and description
- Server name
- Live entry count (updates in real time)
- Countdown timer
- Published seed hash (visible from the start)
- After the draw: revealed seed, winner, and verification link
The page is read-only. Anyone can view it — no login required. After the giveaway ends, the page becomes a permanent receipt showing the winner, the proof, and the full entry record.
Free vs Plus
Section titled “Free vs Plus”| Feature | Free | Plus |
|---|---|---|
| Button entry | ✓ | ✓ |
| Live entry counter | ✓ | ✓ |
| Provably fair selection | ✓ | ✓ |
| ori.gives public page | ✓ | ✓ |
| Scheduling (up to 5) | ✓ | ✓ |
| Dashboard management | ✓ | ✓ |
| Bot protection pipeline | — | ✓ |
Limits
Section titled “Limits”- Maximum winners per giveaway: 25
- Maximum scheduled giveaways: 5
- Maximum giveaway duration: 30 days
- Giveaway data retention: 180 days after the giveaway ends, records are permanently deleted
- One active giveaway per channel at a time
What the giveaway plugin cannot do
Section titled “What the giveaway plugin cannot do”Ori’s giveaway plugin cannot restrict entries to specific Discord roles. All server members can enter any giveaway. There is no role-gating option.
Ori’s giveaway plugin cannot require members to complete external tasks to enter. There are no “follow our Twitter” or “subscribe on YouTube” entry gates. Entry is one click.
Ori’s giveaway plugin cannot allow the admin to influence or re-roll winner selection. The winner is determined by the cryptographic seed committed before entries opened. This is by design — it’s what makes the draw provably fair.
Ori’s giveaway plugin cannot run multiple simultaneous giveaways in the same channel. Use different channels for concurrent giveaways.
Ori’s giveaway plugin cannot integrate with external platforms. There is no Twitch subscriber verification, YouTube membership check, or similar integration for entry requirements.
Ori’s giveaway plugin cannot send DMs to winners. The winner is announced in the giveaway channel and on the public ori.gives page.
Ori’s giveaway plugin cannot run giveaways longer than 30 days.
Troubleshooting
Section titled “Troubleshooting”The giveaway embed isn’t appearing Check that Ori has permission to send messages and embed links in the selected channel. Verify the plugin is enabled in the dashboard.
Entry count isn’t updating on the Discord embed The embed updates periodically, not on every single entry. The ori.gives page shows the live count in real time.
Someone says the giveaway was rigged
Send them the verification page at g-[code].ori.gives/verify. It re-computes the entire draw in their browser using the published seed. They can verify the result themselves.
I want to end a giveaway early Use the “Draw Early” button in the dashboard. The winner is selected immediately. The audit log records the early draw with a timestamp.
I want to cancel a giveaway without picking a winner Use the “Cancel” button in the dashboard. The giveaway is voided, no winner is selected, and the embed updates to show the cancellation.
Frequently asked questions
Section titled “Frequently asked questions”Is Ori’s giveaway plugin free? Yes. The core giveaway system — button entry, provably fair selection, public verification page, scheduling, and dashboard management — is completely free. Bot protection is a Plus feature.
How do members enter a giveaway? They click the “Enter” button on the giveaway embed in Discord. One click, they’re in. No commands to type.
Can someone enter a giveaway twice? No. Each Discord account can enter once per giveaway. Duplicate entries are automatically rejected.
What happens when the giveaway ends? Ori draws the winner(s) using the pre-committed seed, announces the result in the Discord channel, and updates the ori.gives page with the winner and full verification proof.
How long are giveaway records kept? 180 days after the giveaway ends. After that, all records including entries, seeds, and winner data are permanently deleted.