The Giveaway system allows you to create, manage, and automate giveaways in your server with features like role requirements, entry limits, and automatic winner selection.

Requirements

  • Bot must have permissions to:
    • Send messages
    • Embed links
    • View channels
    • Add reactions
    • Manage messages

Commands

Start Giveaway

,giveaway start [duration] [winners] [prize] --role [role]

End Giveaway

,giveaway end [message_id]

Reroll Winners

,giveaway reroll [message_id]

Blacklist Role

,giveaway blacklist [role]

Set Entry Limit

,giveaway setmax [max_entries] [role]

Configure Notifications

,giveaway dmcreator [true/false]
,giveaway dmwinners [true/false]

Set Template

,giveaway template [embed_code]

Features

Giveaway Creation

  • Custom duration (minutes, hours, days)
  • Multiple winners support
  • Role requirements
  • Custom prize descriptions
  • Embed templates

Entry Management

  • Role-based entry limits
  • Blacklisted roles
  • Entry tracking
  • Weighted entries
  • Automatic validation

Winner Selection

  • Random winner selection
  • Multiple winner support
  • Reroll capability
  • DM notifications
  • Winner announcements

Customization

  • Custom embed templates
  • Role requirements
  • Entry limits per role
  • DM notifications
  • Blacklist management

Template Variables

  • - The giveaway prize
  • - Time until giveaway ends
  • - Required role mention
  • - Number of winners

Giveaways cannot be edited after creation. Make sure all settings are correct before starting.

The bot will automatically clean up ended giveaways after 5 days to maintain database efficiency.