Skip to main content

Giveaway

This page shows the usage of melon's giveaways system.

note

FOR ALL COMMANDS THAT HAVE A MESSAGE ARGUMENT

If you are replying to a giveaway message instead of passing an id or link, you must pass a fake value for the message_id argument.

This fake value can be literally anything you want.

Usage

Cancel a giveaway. This is similar to [p]g end but it doesn't go throuhg the complete ending process. I.E the end message, and dms are not processed. The giveaway message is deleted from the channel and also from bot storage.

Syntax: [p]g cancel [message_id]

Example:
[p]g cancel 12345678901234567890

// or if you want to reply to a message
[p]g cancel x

This asks you different questions one by one to start a giveaway. ( For Beginners )

  • [p]g eligible

A simple command to check if you are eligible for a giveaway or not.

If you aren't eligible the command will reply with the reason why you aren't eligible.

tip

You can also reply to a giveaway message instead of passing it's id

Syntax: [p]g eligible [message_id]

Example:
[p]g eligible 12345678901234567890

// or if you want to reply to a message
[p]g eligible x

End a giveaway prematurely.

Reason is an optional argument to pass why the giveaway was ended.

tip

You can also reply to a giveaway message instead of passing it's id

Pass all to the message parameter to end all active giveaways in your server.

Syntax: [p]g end [message_id] [reason]

Example:
[p]g end 12345678901234567890

[p]g end all

// or if you want to reply to a message
[p]g end x
  • [p]g entrants

Check who has entered the giveaway until now.

tip

You can also reply to a giveaway message instead of passing it's id.

Syntax: [p]g entrants [message_id]

Example:
[p]g entrants 12345678901234567890

// or if you want to reply to a message
[p]g entrants x

Start multiple flash giveaways with a given prize.

note

<amount> is the number of giveaways to flash. Minimum amount is 2.

These giveaways will have 1 winner and will last for 20 seconds each.

Syntax: [p]g flash <amount> <prize>

Example:
[p]g flash 10 Flash giveaways.

List all the active giveaways in a server.

Syntax: [p]g list

Example:
[p]g list

Reroll the winners for an ended giveaway.

You can pass the winners argument to specify how many winners you want to reroll.

The exclude_old_winners argument is a boolean argument (AKA one of 1/2, true/false, yes/no, on/off) which determines whether to exclude the old winners from the reroll.

tip

You can also reply to a giveaway message instead of passing it's id.

Syntax: [p]g reroll [message_id] [winners=1] [exclude_old_winners=False]

Example:
[p]g reroll 12345678901234567890

// or if you want to reply to a message
[p]g reroll x 2 True

Start a giveaway with a prize.

tip

The time argument is optional, you can instead use the --ends-at flag to specify more accurate time span.

Requires either a manager role set with the [p]gset manager @mygiveawaymanagerrole or the bot mod role set with [p]set addmodrole or manage messages permissions.

Use [p]g create instead if you want a step by step process.

Syntax: [p]g start [time] <no_of_winners> [requirements] <prize> [flags]

Example:
[p]g start 30s 1w my life
[p]g start 1h 1w someroleid;;anotherroleid[bypass];;anotheranotherroleid[blacklist] ok boomer
[p]g start 1w this giveaway has no time argument --ends-at 20 august 2022 12am UTC --msg but has the '--ends-at' flag

Show the giveaway that has the given message id.

tip

You can also reply to a giveaway message instead of passing it's id.

Syntax: [p]g show [message_id]

Example:
[p]g show 12345678901234567890

// or if you want to reply to a message
[p]g show x

See the giveaway managers who have performed the most giveaways in the server.

Syntax: [p]g top

Example:
[p]g top