/giveaway¶

Tip

This command requires the administrator permission by default. To learn how to change this, please check the faq command.

/giveaway create¶

Creates a giveaway in your server.

Users can sign up for this giveaway by clicking the button below the posted embed.

Parameters:

Name	Type	Description	Default
`winners`	`int`	The amount of possible winners.	required
`title`	`str`	A title for your giveaway - will also be the title of the embed.	required
`days_hours_minutes`	`Transform[str, FutureRelativeDHMTransformer] \| None`	For example `10d5h2m` would end the giveawayh in 10 Days, 5 Hours, 2 Minutes.	`None`
`specific_date`	`Transform[str, DateHoursMinutesTransformer] \| None`	A specific date for the giveaway to end on, in the format of YYYY-MM-DD HH:MM. This will assume UTC time.	`None`
`description`	`str`	An optional description for your giveaway. Defaults to None.	`None`

Cancels an existing giveaway.

Parameters:

Name	Type	Description	Default
`message`	`Transform[str, MessageTransformer]`	A link or ID of a message with a giveaway attached to it.	required

Changes the date of a provided giveaway.

Parameters:

Name	Type	Description	Default
`message`	`Transform[str, MessageTransformer]`	A link or ID of a message with a giveaway attached to it.	required
`date`	`Transform[str, DateHoursMinutesTransformer]`	The new date for the giveaway in the format of `YYYY-MM-DD HH:MM` - assumes UTC time	required

Changes the amount of winners for a provided giveaway.

Parameters:

Name	Type	Description	Default
`message`	`Transform[str, MessageTransformer]`	A link or ID of a message with a giveaway	required
`winners`	`Range[int, 1, None]`	The new amount of winners this giveaway should get.	required

Changes the title of a provided giveaway.

Parameters:

Name	Type	Description	Default
`message`	`Transform[str, MessageTransformer]`	A link or ID of a message with a giveaway.	required
`title`	`str`	The new title the giveaway should get.	required

Shows you the amount of users currently signed up for a giveaway

Parameters:

Name	Type	Description	Default
`message`	`Transform[str, MessageTransformer]`	A link or ID of a message with a giveaway.	required

Rerolls a specified amount of winners for a giveaway

Parameters:

Name	Type	Description	Default
`message`	`Transform[str, MessageTransformer]`	A link or ID of a message with a giveaway.	required
`winners`	`int`	The amount of winners you'd like to reroll.	required