Giveaways

Giveaways lets you run prize draws your members enter with a single click. You create, draw, and manage everything from the web dashboard — the bot posts the embed, collects entries, and announces the winners.

🎉 How it works

1. Open the Giveaways page and create a giveaway.
2. Set the prize, an optional description, and pick a Discord channel.
3. Choose how many winners to draw and when the giveaway ends.
4. Optionally add entry requirements (a role, or a minimum level).
5. Click Publish — YAWBDB posts an embed with a live countdown and an Enter button.

Members click Enter to join. When the timer runs out, the winners are drawn automatically, the embed is updated, and the winners are announced in the channel.

🎯 Entry requirements

A giveaway can be open to everyone, or gated:

• Required role — only members holding a specific role can enter.
• Required level — only members at or above a minimum level can enter. This option appears when the Leveling feature is enabled on the server.

Requirements are checked the moment a member clicks Enter. Invalid entries are rejected with a private, ephemeral message explaining exactly why — nobody else sees it.

🏆 How winners are drawn

Winners are drawn on the panel, not inside the bot. This keeps draws fair and reliable:

• The pick is uniform random among all valid entrants.
• A giveaway always ends on time. If the bot restarts mid-giveaway, it catches up and draws the moment it reconnects.
• Fewer entrants than winners? Everyone who entered wins.
• No valid entrants? The giveaway ends cleanly and announces that no winner could be drawn.

🗂️ Managing giveaways

Each giveaway shows its status — Draft, Running, Ended, or Cancelled — along with its entry count and the winners once drawn.

• Publish / Re-publish — post the giveaway to Discord, or refresh the embed after an edit.
• End now — close a running giveaway early and draw the winners immediately.
• Reroll — draw a fresh winner, excluding everyone who already won, when a winner is unreachable. The original result stays on the giveaway message; the reroll is announced below it.
• DM winners — optionally send each winner a direct message. Toggle this in the feature settings.

You can run several giveaways per server at once, each in its own channel.

🎟️ Bonus entries

Give some members better odds with bonus entries. Each rule adds extra entries on top of the base 1, and the draw is weighted accordingly — a member with 3 entries is three times as likely to win.

Rule types:

• Has role — members with a chosen role get extra entries (great for Nitro boosters, supporters, etc.)
• Server booster — members boosting your server get extra entries
• Level ≥, Prestige ≥, Streak ≥, XP ≥ — reward your most active members

The level, prestige, streak and XP rules need the Leveling feature. When Leveling is off they appear locked in the editor with a notice — role and booster rules always work. Members see how many entries they have when they click Enter.

🎯 Eligibility filters

Optionally restrict who can win:

• Exclude sanctioned members — members with an active ban or mute can't enter (needs the Moderation feature)
• Minimum account age — block brand-new accounts to deter alt-farming

🔗 Works with your other features

• Leveling — bonus entries by level/prestige/streak/XP, a required-level condition, and reward-graph triggers (On giveaway win, On giveaway entry) to grant XP or roles to participants.
• Moderation — exclude sanctioned members from winning.
• Server Logs — when the Engagement category is enabled, giveaway start/end/winner events are logged.

Every bridge degrades gracefully: Giveaways works on its own, and feature-specific options are clearly locked when the other feature is off.

✅ Permissions

Giveaways only needs the baseline bot permissions (View Channels, Send Messages, Embed Links). It does not assign roles, so no Manage Roles permission is required. See Feature permissions.

👍 Recommended setup

1. Create a giveaway, set a clear prize and a realistic end date.
2. Pick the channel your community actually watches.
3. Add a required role or level only if you want to limit who can enter.
4. Publish, then check the embed shows the countdown and the Enter button.
5. Let it run — winners are drawn and announced automatically.

💡 Best practices

• Keep the prize in the title short and clear; use the description for rules or details.
• Use a required level to reward active members and discourage throwaway accounts.
• If a winner never claims, use Reroll instead of recreating the giveaway.
• Enable DM winners so people know they won even if they miss the channel announcement.