🎁 Giveaway System
Advanced giveaway system with multiple types, customizable requirements, analytics, and automation.
🎯 Giveaway Types
Standard
Classic reaction giveaway 🎉. Ideal for general giveaways.
Premium 👑
Giveaway with Bonus Entries by role. Certain roles get more chances to win.
Flash ⚡
Short duration (15-30 min) for high excitement and immediate participation.
Mega 🎊
Multiple prizes in a single giveaway. Perfect for special events.
📋 Web Panel
The web panel offers complete control over giveaways:
Available Tabs
📊 Dashboard
- General statistics (total, active, participants, winners)
- Quick view of active giveaways
- Quick access to create giveaway
🎁 Active Giveaways
- List of ongoing giveaways
- Actions: Pause, Resume, End, Delete
- Filters and search
📈 Analytics (Premium)
- Participation Rate: Average participants per giveaway
- Completion Rate: % of completed giveaways
- Total Winners: Counter of all winners
- Participation Chart: Top 10 giveaways by participation
- Type Distribution: Visual breakdown by giveaway type
- Recent Winners Table: Last 10 winners with details
- CSV Export: Download all statistics
- PDF Export: (Coming Soon)
📄 Templates
- System templates (Nitro, Flash, VIP, Mega)
- Custom templates (up to 3 free, unlimited with Premium)
- Quick creation from templates
⚙️ Settings
- Default channel
- Default winners count
- End message
- Notification settings
✨ Advanced Features
🔄 Recurring Giveaways
Giveaways that automatically recreate themselves when they end.
Configuration:
- Frequency: Hourly, Daily, Weekly, Monthly
- Max Repetitions: 0 = unlimited
- Inherited Configuration: Keeps prize, duration, and requirements
Use cases:
- Weekly Nitro giveaway every Friday
- Daily Yumes giveaway at 8:00 PM
- Monthly big prize giveaway
📅 Scheduled Giveaways
Schedule the exact start and end time of a giveaway.
Configuration:
- Start Date/Time: Giveaway publishes automatically
- End Date/Time: Giveaway ends automatically
- Timezone: Respects your local timezone
Use cases:
- Anniversary giveaway at 00:00 on the exact day
- Event giveaway that starts and ends at specific times
⭐ Bonus Entries
Grant additional entries to users with certain roles.
Example:
- VIP Role: +5 entries
- Booster Role: +3 entries
- Member Role: +1 entry
A user with VIP role will have 6 total entries (1 base + 5 bonus).
🔒 Advanced Requirements
Role-Based Access Control
- Allowed Roles: Only these roles can participate
- Blocked Roles: These roles CANNOT participate
- VIP Roles: Bypass all other requirements
Seniority and Level Requirements
- Minimum Level: Server leveling system
- Account Age: Days since Discord account creation
- Server Seniority: Days since joining the server
Visual Summary: The panel shows a clear summary: "Open to all" or "3 role(s) required, Level 5+, Account 30d+"
🎮 Commands
/giveaway create
Create a giveaway
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
prize | String | ✅ Yes | Giveaway prize |
duration | String | ✅ Yes | Duration (5m, 15m, 30m, 1h, 3h, 6h, 12h, 1d, 3d, 7d, 14d, 30d) |
winners | Number | ❌ No | Number of winners (1-20, default: 1) |
type | String | ❌ No | Type: standard, premium, flash, mega |
requirement | Role | ❌ No | Required role to participate |
channel | Channel | ❌ No | Channel where it will be published |
Example:
/giveaway create prize:Nitro Classic duration:24h winners:3 type:premium
/giveaway end
End a giveaway early
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
message_id | String | ✅ Yes | Giveaway message ID |
Example:
/giveaway end message_id:123456789
/giveaway reroll
Choose new winners
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
message_id | String | ✅ Yes | Message ID |
winners | Number | ❌ No | Number of new winners |
Example:
/giveaway reroll message_id:123456789 winners:2
/giveaway pause
Pause an active giveaway
Example:
/giveaway pause message_id:123456789
/giveaway resume
Resume a paused giveaway
Example:
/giveaway resume message_id:123456789
/giveaway list
List active giveaways
Example:
/giveaway list
🎨 Customization
Embed Colors
Customize the giveaway embed color:
- Discord Blue:
#5865F2 - Gold:
#FFD700 - Green:
#57F287 - Purple:
#9B59B6 - Red:
#ED4245
Custom Messages
- End Message: Customizable from panel
- Giveaway Description: Add additional context
- Custom Emojis: Use server emojis
👑 Premium Features
Server Premium Starter
- 10 custom templates (vs 3 free)
- Basic Bonus Entries
- 5 simultaneous active giveaways (vs 3 free)
Server Premium Pro
- Unlimited templates
- Advanced Bonus Entries
- Prize Tiers (multiple prizes in one giveaway)
- Drop Giveaways (surprise giveaways)
- Advanced Analytics with charts
- CSV/PDF Export
- Scheduled & Recurring Giveaways
- 10 active giveaways simultaneously
- Giveaway transcripts
Server Premium Ultra
- Everything from Pro +
- 20 active giveaways simultaneously
- Priority support
- Custom branding
📊 Analytics and Reports
Available Metrics (Premium)
-
Participation Rate
- Average participants per giveaway
- Bar chart with top 10 giveaways
-
Completion Rate
- % of completed vs cancelled giveaways
- System health indicator
-
Total Winners
- Historical winner counter
- Recent winners table
-
Distribution by Type
- Visual cards for each giveaway type
- % of total for each type
Data Export
CSV Export includes:
- Prize
- Type
- Status (Active/Paused/Ended)
- Winners
- Participants
- Creation Date
- End Date
- Channel
PDF Export (Coming Soon)
📝 Best Practices
Recommended Duration
- Flash (⚡): 15-30 minutes for high excitement
- Standard: 24-72 hours for maximum participation
- Mega Events: 7-14 days for special events
Requirements
- Don't overuse requirements: Too restrictive = less participation
- Use VIP Roles: To reward valuable members without excluding others
- Balance Bonus Entries: +5 is generous, +10 is excessive
Templates
- Create templates for your recurring giveaways
- Name templates descriptively: "Weekly Nitro", "Flash 15min", etc.
- Use system templates as starting point
🔧 Troubleshooting
Giveaway doesn't end automatically
- Verify bot has permissions in the channel
- Check that bot is online
- Giveaways are saved and end on bot restart
Can't create more giveaways
- Free limit: 3 simultaneous giveaways
- Upgrade to Premium for more giveaways
Analytics shows no data
- Analytics requires Server Premium Pro or higher
- Data accumulates over time
CSV export is empty
- There must be at least one giveaway created
- Check browser permissions for downloads
🎯 Use Cases
Weekly Nitro Giveaway
Type: Premium
Duration: 7 days
Winners: 1
Bonus Entries: Boosters +3
Recurring: Weekly
Flash Yumes Giveaway
Type: Flash
Duration: 15 minutes
Winners: 5
Prize: 1000 Yumes each
No requirements
Mega Anniversary Giveaway
Type: Mega
Duration: 14 days
Winners: 10
Multiple prizes:
- 1x Nitro Yearly
- 3x Nitro Classic
- 6x 5000 Yumes
Scheduled: Anniversary day at 00:00
Exclusive VIP Giveaway
Type: Standard
Requirements: VIP role required
Duration: 48h
Winners: 3
🔗 Useful Links
- Web Panel: panel.yumechanbot.com/giveaways
- Premium: exchange.yumechanbot.com/premium
- Support: discord.gg/yumechan
Need help?
Use /ticket create to contact the support team or visit our Discord server.