🎉 GiveawayBot

A reliable and professional giveaway management bot built for Root communities.

GiveawayBot handles the complete giveaway lifecycle - from creation and participant entry to automatic winner selection, rerolls, reminders, statistics, history, and recovery after downtime.

Test Community: https://rootapp.gg/santos updates: https://rootapp.gg/ADGVEjhejgqveEt2UCUF9g

---

✨ Features

• 🎁 Custom Prizes - Give away anything using free-form prize text.
• ⏱️ Flexible Durations - From 1 second to 1 year.
• 🏆 Multiple Winners - Select between 1 and 100 winners.
• 🎲 Random Winner Selection - Winners are selected randomly from eligible participants.
• 🎉 Reaction-Based Entries - Users join by reacting to the giveaway.
• 🔄 Smart Rerolls - Previous winners are automatically excluded.
• 🚫 Manual Ending - Administrators can end an active giveaway early.
• ❌ Cancellation - Administrators can cancel giveaways without selecting winners.
• 🔔 Ending Soon Reminder - Automatic 5-minute reminder for longer giveaways.
• 💾 Persistence & Recovery - Active giveaways can continue after the bot goes offline and comes back online.
• 🏘️ Multi-Community Support - Each Root community has its own independent giveaway state.
• 📊 Statistics - Track giveaway activity and results.
• 📜 Giveaway History - View recently completed and cancelled giveaways.
• 📢 Announcements - Support for @all and @here.
• 🔒 Permission Protection - Administrative commands are restricted.
• 💬 Command Replies - Responses are linked to the original command where supported.
• 📝 Clean Markdown UI - Professional and readable giveaway messages.
• 🛡️ Input Validation - Invalid giveaway parameters are rejected safely.

---

📋 Commands

/giveaway <prize> <duration> <winners> <@all|@here>

Create a new giveaway.

Examples

/giveaway Steam Gift Card 1h 5 @all
/giveaway Steam Gift Card 30min 3 @here
/giveaway 100 Robux 7d 10 @all

Options

Prize

Free-form text. You can use any prize description.

Examples:

100 Robux
Steam Gift Card
Discord Nitro
Mystery Prize
VIP Role

Duration

From:

1 second

up to:

1 year

Winners

From:

1 → 100

Announcement

Choose:

@all
@here

Permissions: Administrators only.

---

📋 /glist

View the currently active giveaway.

Displays information such as:

• 🎁 Prize
• ⏳ Remaining time
• 🏆 Number of winners
• 👥 Number of participants
• 📢 Announcement type

Available to everyone.

---

🏁 /gend

Immediately end the active giveaway.

GiveawayBot will:

1. Stop the giveaway.
2. Collect eligible participants.
3. Randomly select the configured number of winners.
4. Announce the winners.
5. Save the completed giveaway information.

Permissions: Administrators only.

---

❌ /gcancel

Cancel the active giveaway.

Unlike /gend, cancellation does not select winners.

The giveaway is marked as cancelled and its information can remain available through giveaway history.

Permissions: Administrators only.

---

🔄 /greroll [amount]

Reroll winners from the most recently finished giveaway.

Examples

/greroll
/greroll 3

Rerolls support multiple winners.

Previous-Winner Protection

Previous winners are automatically excluded from future rerolls.

For example:

Original winners:
UserA
UserB

Reroll:
UserC
UserD

UserA and UserB cannot be selected again during the reroll process.

If there are no eligible participants remaining, GiveawayBot will not select another winner.

Permissions: Administrators only.

---

📊 /gstats

View giveaway statistics for the current community.

Statistics include information such as:

• 🎉 Total giveaways
• ✅ Completed giveaways
• ❌ Cancelled giveaways
• 👥 Participants
• 🏆 Winners
• 🔄 Rerolls
• 🎯 Reroll winners
• 🎁 Active giveaway status

Available to everyone.

---

📜 /ghistory

View recent giveaway history for the current community.

History can contain information such as:

• 🎁 Prize
• 📅 Giveaway date
• 👥 Participant count
• 🏆 Winners
• 🔄 Rerolls
• ❌ Cancellation status

Giveaway history is community-specific.

Available to everyone.

---

💾 Persistence & Recovery

GiveawayBot is designed to handle bot downtime safely.

If the bot goes offline while a giveaway is active and later comes back online, the active giveaway can be recovered and its process can continue.

This means a temporary bot restart does not necessarily destroy an ongoing giveaway.

Example

Giveaway starts
      ↓
Users enter
      ↓
Bot goes offline
      ↓
Bot comes back online
      ↓
Giveaway state is recovered
      ↓
Timer continues
      ↓
Giveaway ends normally
      ↓
Winners are selected

---

🏘️ Multi-Community Support

GiveawayBot supports multiple Root communities independently.

Each community maintains its own giveaway state.

For example:

Community A
├── Active Giveaway
├── Statistics
└── History

Community B
├── Active Giveaway
├── Statistics
└── History

Community C
├── Active Giveaway
├── Statistics
└── History

A giveaway running in one community does not interfere with a giveaway running in another community.

---

⏱️ Durations

GiveawayBot supports durations from:

1 second → 1 year

Supported units

sec
min
h
d
w
mo
month
y
year

Examples

10sec
30min
2h
7d
2w
1mo
1year

Limits

Minimum: 1 second Maximum: 1 year

For duration calculations:

• mo / month = 30 days
• y / year = 365 days

---

🏆 Multiple Winners

Every giveaway can have between:

1 → 100 winners

Example:

/giveaway Steam Gift Card 1h 5 @all

GiveawayBot will attempt to select 5 different eligible participants.

If fewer participants entered than the requested number of winners, GiveawayBot selects the available eligible participants.

---

🔔 Ending Soon Reminder

Giveaways lasting more than 5 minutes receive an automatic reminder:

⏰ Giveaway ending soon!
Only 5 minutes remaining.

Giveaways lasting 5 minutes or less do not receive this reminder.

The reminder is handled automatically by GiveawayBot.

---

🎲 Random Winner System

When a giveaway ends, GiveawayBot selects winners randomly from the eligible participants.

The configured winner count is respected whenever enough eligible participants are available.

Each selected winner is a different participant within the same winner selection.

---

📢 Announcements

Giveaways support two announcement modes:

@all
@here

The selected announcement option is included when the giveaway is created.

---

🔐 Permissions

Administrative Commands

/giveaway
/gend
/gcancel
/greroll

These commands require the appropriate administrative permissions.

Public Commands

/glist
/gstats
/ghistory

These commands can be used by regular community members.

---

🛡️ Validation & Safety

GiveawayBot validates command parameters before processing them.

The bot checks things such as:

• Invalid durations
• Durations below the minimum
• Durations above the maximum
• Invalid winner counts
• Winner counts above 100
• Invalid announcement options
• Giveaway state conflicts
• Reroll eligibility
• Missing eligible participants

Invalid commands receive a clear response instead of being processed incorrectly.

---

📊 Current Capability Overview

System	Status
🎉 Giveaway Core	9.5/10
🎲 Random Winner System	9.5/10
🏆 Multiple Winners	9/10
🔄 Reroll System	9/10
💾 Persistence / Recovery	9.5/10
🏘️ Multi-Community	9.5/10
⏰ Timers / Ending Reminder	9/10
📊 Statistics / Information	8.5/10
🛡️ Safety / Permissions	8/10
🧑‍💻 User Experience	8.5/10
📦 Production Readiness	8.5/10

These ratings describe the current implementation areas and are not intended as a formal benchmark.

---

🎯 Complete Giveaway Lifecycle

GiveawayBot handles the complete workflow:

Create
  ↓
Announcement
  ↓
Users Enter
  ↓
Timer
  ↓
Ending Reminder
  ↓
Giveaway Ends
  ↓
Random Winner Selection
  ↓
Winner Announcement
  ↓
History
  ↓
Statistics
  ↓
Optional Reroll

With recovery support:

Giveaway Running
      ↓
Bot Goes Offline
      ↓
Bot Returns
      ↓
Giveaway Recovered
      ↓
Timer Resumes
      ↓
Giveaway Completes

---

🚀 Designed for Root Communities

GiveawayBot is built around three main goals:

Simple

Create and manage giveaways with a small set of commands.

Reliable

Protect active giveaway state and recover from bot downtime.

Organized

Keep giveaways, winners, rerolls, statistics, and history separated by community.

---

📌 Limits

Maximum duration: 1 year Maximum winners: 100 Minimum duration: 1 second Ending reminder: 5 minutes before the end for giveaways longer than 5 minutes

Test Community: https://rootapp.gg/santos updates: https://rootapp.gg/ADGVEjhejgqveEt2UCUF9g

---

🎉 GiveawayBot

Create → Enter → Track → Remind → End → Win → Reroll → History → Statistics

A complete giveaway management system for Root communities.