Giveaway System

The Giveaway System in OneeChan allows server administrators to create, manage, and remove giveaways using Discord's scheduled events. Users can participate by clicking the event button, ensuring a sm

The system will automatically send a notification in the General Chat Channel (configured in Configuration Keys - Channels) and ping the Giveaway Ping Role if defined.

Features

  • Automated Giveaway Announcements – Posts an announcement with an interactive button.

  • Scheduled Giveaways – Uses Discord scheduled events for structured participation.

  • Custom Winner Selection – Winners can be chosen randomly, by role, or only verified members.

  • Automated Winner Announcement – Announces winners after the giveaway ends.

Giveaway Example
Example of a giveaway announcement

Giveaway System Behavior

Creating a Giveaway

Administrators can create a giveaway using:

/giveaway create title:"Nitro Giveaway" criteria:random expiry:24 winners:3

Once the command is executed:

  1. A Discord Scheduled Event is created.

  2. An announcement is posted in the configured Giveaway Channel.

  3. If a Giveaway Ping Role is set, it is pinged.

  4. Users can participate by clicking the "Interested" button.

If an image attachment is included, it will be embedded in the announcement.

Selecting Winners

At the end of the giveaway, the system automatically selects winners based on the configured criteria:

  1. Random – Any participant can win.

  2. Role-Based – Only users with a specific role are eligible.

  3. Verified-Only – Only verified or cross-verified members can win.

The system ensures that muted members or ineligible users are excluded from the selection.

Example:

🎉 Giveaway Winners: @User1, @User2, @User3

Winners will receive a direct message (if enabled) and a public mention in the giveaway channel.

Removing a Giveaway

Administrators can remove an active giveaway using:

/giveaway remove eventId:123456789012345678

If successful, the bot will confirm:

The giveaway has been removed successfully.

The Discord Scheduled Event will also be deleted.

Slash Commands

/giveaway create – Create a New Giveaway

Required Permission: Administrator Description: Creates a new giveaway with a title, criteria, expiration time, and number of winners.

Argument
Type
Required
Description

title

string

Yes

Title of the giveaway.

criteria

enum

Yes

Winner selection criteria: random, role, or verified only.

expiry

int (hours)

No

Duration before the giveaway expires.

epoch

timestamp

No

Unix timestamp for a specific end time.

winners

int

Yes

Number of winners.

role

@role

No

Required role to participate.

image

attachment

No

Image for the giveaway embed.

sponsored-by

@user

No

The user sponsoring the giveaway.

Example Usage

Random Giveaway (Anyone can join)

/giveaway create title:"Nitro Giveaway" criteria:random expiry:24 winners:3

Role-Exclusive Giveaway (Only members with @VIP role can enter)

/giveaway create title:"VIP Nitro Giveaway" criteria:role expiry:24 winners:3 role:@VIP

Verified-Only Giveaway (Only verified users can enter)

/giveaway create title:"Verified Members Giveaway" criteria:verified expiry:24 winners:3

/giveaway remove – Remove an Existing Giveaway

Required Permission: Administrator Description: Deletes an active giveaway using the event ID.

Argument
Type
Required
Description

eventId

ulong

Yes

The Discord event ID of the giveaway.

Example Usage

/giveaway remove eventId:123456789012345678

How Winners Are Selected

Once a giveaway ends, the bot follows these steps:

  1. Randomly selects winners based on the configured criteria.

  2. Announces the winners in chat, tagging them.

  3. Updates the giveaway embed to display the winners.

  4. Notifies winners in DMs if enabled by the server.

Example Winner Announcement:

🎉 Giveaway Winners: @User1, @User2, @User3

If no eligible participants are found, the bot will notify the administrator.

Setup & Behavior

  • Scheduled Giveaways ensure structured participation and automatic winner selection.

  • Giveaway Ping Role can be set to notify users of new giveaways.

  • Redis-Backed Participant Tracking ensures accurate real-time updates.

  • Automated Announcements keep the giveaway process seamless.

Last updated