Levels and Giveaways
DocsCommunity

Levels and Giveaways

Reward activity with configurable XP and run managed giveaways.

Leveling

Text leveling awards random XP for eligible messages after a configurable cooldown. Voice leveling can be enabled separately. Existing XP is preserved when text leveling is disabled.

community

,level enable

Turns text leveling on, so members earn XP for sending messages.

,level enable
User permissionsManage Guild
Open in command browser
community

,level config

Shows the server's leveling configuration: XP rate and cooldown, level-up message settings, and role rewards.

,level config
Open in command browser
community

,level rate

Sets how much XP a message awards, as a random amount between a minimum and maximum. Both must be between 1 and 100 and the maximum cannot be below the minimum.

,level rate <min> <max>
Example,level rate 10 10
Arguments
minRequired
maxRequired
User permissionsManage Guild
Open in command browser
community

,level cooldown

Sets how long a member must wait between XP-earning messages, from 1 to 600 seconds. Stops people farming XP by spamming.

,level cooldown <seconds>
Example,level cooldown 10
Arguments
secondsRequired
User permissionsManage Guild
Open in command browser
community

,level voice

Turns voice leveling on or off, so members also earn XP for time spent in voice channels.

,level voice <state>
Example,level voice enable
Arguments
stateRequired
User permissionsManage Guild
Open in command browser

Role rewards

Level rewards grant configured roles at specific levels. Stack mode keeps every earned reward; otherwise only the highest reward is kept. Sync reapplies missing rewards after configuration changes.

community

,level role add

Sets a role to be granted automatically when a member reaches a given level.

,level role add <input>
Example,level role add text here
Arguments
inputRequired
User permissionsManage Guild
Open in command browser
community

,level roles

Lists the configured level role rewards and which level each is granted at.

,level roles
Open in command browser
community

,level stackroles

Sets whether level role rewards stack. When on, members keep every reward role they have earned; when off, only the highest one is kept.

,level stackroles <state>
Example,level stackroles enable
Arguments
stateRequired
User permissionsManage Guild
Open in command browser
community

,level sync

Re-applies level role rewards across the whole server, giving members any reward roles they have earned but are missing. Useful after adding or changing rewards.

,level sync
User permissionsManage Guild
Open in command browser

Giveaways

Giveaways use a duration, winner count, and prize. Staff with Manage Messages can edit the prize, duration, or displayed host, end or cancel early, and reroll winners.

giveaways

,giveaway start

Start a giveaway.

,giveaway start <time> <winners> <prize>
Example,giveaway start 5m 1 Nitro
Arguments
inputOptional
User permissionsManage Messages
Open in command browser
giveaways

,giveaway list

Lists the giveaways currently running in the server with their prizes and end times.

,giveaway list
Open in command browser
giveaways

,giveaway edit

Edit an active giveaway prize, duration, or host.

,giveaway edit <prize/duration/host> <message id/link> <value>
Example,giveaway edit prize 123456789012345678 Nitro
User permissionsManage Messages
Open in command browser
giveaways

,giveaway end

End an active giveaway.

,giveaway end <message id>
Example,giveaway end 123456789012345678
Arguments
giveawayRefOptional
User permissionsManage Messages
Open in command browser
giveaways

,giveaway reroll

Reroll a giveaway.

,giveaway reroll <message id>
Example,giveaway reroll 123456789012345678
Arguments
giveawayRefOptional
User permissionsManage Messages
Open in command browser
giveaways

,giveaway cancel

Cancel an active giveaway.

,giveaway cancel <message id>
Example,giveaway cancel 123456789012345678
Arguments
giveawayRefOptional
User permissionsManage Messages
Open in command browser