Server configuration
Levels
Reward activity with XP, ranks, and automatic role rewards.
Slash commands for this page
Set this up in Discord with /configure feature:Leveling, /configure feature:Live leaderboards, or on the dashboard under Roles › Leveling.
Use the slash version of each command below. Prefix commands keep working until March 5, 2027. What is changing
,level→/level rank,level text→/level text,level voice→/level voice,level channel→/level channel,level message→/level message,level leaderboard→/level leaderboard
,level add→/level add,level remove→/level remove,level roles→/level roles,level setxp→/level setxp,level removexp→/level removexp,level setlevel→/level setlevel,level dm→/level dm,level stackroles→/level stackroles,level sync→/level sync,level setrate→/level setrate,level reset user→/level reset user,level reset all→/level reset all,level antiafk→/configure feature:Leveling,level card→/configure feature:Leveling,level coins→/configure feature:Leveling,level event→/configure feature:Leveling,level decay→/configure feature:Leveling,custom list→/configure feature:Custom scripts,level cardbranding→/configure feature:Leveling,level milestone add→/configure feature:Leveling,level milestone remove→/configure feature:Leveling,rankcard→@greed rankcard,rc→@greed rc,level monthly→@greed level monthly,level weekly→@greed level weekly,level graph→@greed level graph,level hide→@greed level hide,rankcard color→@greed rankcard color
Overview
greed features a robust, dual-track leveling system that rewards both text and voice activity. With real-time stats, dynamic rank cards, and automated role rewards, it's designed to keep your community engaged.
Getting Started
The leveling system is enabled by default. You can configure it using the following commands:
,level text: Toggle text-based XP earning.,level voice: Toggle voice-based XP earning.,level channel [channel]: Set the channel for level-up announcements, or leave it blank to stop posting them in a channel.,level message [script]: Customize the level-up message (ordisableto turn off messages).
Earning XP
Members earn XP passively by participating in the server.
Text XP
- Earned by sending messages in text channels.
- Includes anti-spam protection to ensure fair leveling.
Voice XP
- Earned by staying in voice channels.
- Requires members to be unmuted and not alone in a channel to prevent farming (turn it on with
,level antiafk on, or with the Anti-AFK switch on the dashboard).
Commands for Members
These commands allow users to track their own progress and see how they compare to the rest of the community.
See your current level, total XP, and progress to the next level.
,level [@user]Aliases: ,lvl
View the top members in the server.
,level leaderboard [sort]Aliases: ,level lb, ,level top
Additional leaderboards:
,level monthly: This month's rankings.,level weekly: This week's rankings.,level graph: View the server's level distribution.
Post a leaderboard that keeps itself up to date. greed edits the message every 5 minutes with the current top 10, the medal badges for the first three places, and a "last updated" stamp. One text board and one voice board per server; posting again moves it to the new channel.
,live text [#channel]
,live voice [#channel]
,live remove (text|voice)
,live listWithout a channel the board is posted where you run the command. Requires Manage Server. If the message is deleted the board is removed automatically.
See all the roles currently configured as rewards for reaching specific levels.
,level rolesLeave yourself off every server's public leaderboard page on the website. It applies in every server at once, and you can also switch it in your account settings on the dashboard, under Privacy.
,level hide
,level unhideYour XP and level keep counting, and ,level leaderboard in Discord still shows you.
Leaderboard Page
A server can publish its leaderboard on the greed website, ranked from the same XP as ,level leaderboard. Turn it on from the dashboard under Levels → Leaderboard page. It is off until you enable it.
- Link: every page lives at
greed.best/leaderboard/<server id>, and that link always works. With Server Premium you can also set a custom link such asgreed.best/leaderboard/your-server: 3 to 32 lowercase letters, numbers and dashes, not only numbers, and not a reserved word. If premium ends, the custom link is released and the page goes back to the server id link. Renewing lets you set one again. - Who can see it: anyone with the link, or server members only. Members-only pages ask the visitor to log in with Discord.
- Boards: choose which of Total, Text and Voice, and which of All time, This month and This week, the page shows. At least one of each stays on.
- Columns: messages, voice time and the level-progress ring can each be hidden.
- Display: a minimum level, how many members are listed (top 50, 100 or 250), an accent colour, an animated or still podium, and the server banner.
Members who ran ,level hide never appear on any page. Settings changes and opt-outs apply right away, and turning the page off takes it down immediately. XP itself is refreshed on the page about once a minute.
Rank Card
Members can recolour their own rank card: no permissions needed.
,rankcard: Show your rank card options (alias:,rc).,rankcard color [hex]: Set your accent colour, or passresetto go back to the default (aliases:colour,accent).
Administrative Commands
Manage the leveling system and adjust user progress when necessary.
Reward specific roles or channels with extra XP.
,level multiplier add (target) (multiplier)
,level multiplier remove (target)
,level multiplierList all configured multipliers or set a channel/role to earn bonus XP.
Configure roles that are automatically awarded at certain levels.
,level add (role) (level): Award a role at a specific level.,level remove (level): Remove a role reward.,level roles: List all configured role rewards.,level milestone add (level) [coins] [role]: Add a milestone with optional rewards. Milestone coins are capped at 5,000 because greed coins are shared across every server.,level milestone remove (level): Remove a milestone.
Modify a user's XP and level directly.
,level setxp (user) (amount): Set a user's total XP.,level removexp (user) (amount): Remove XP from a user.,level setlevel (user) (level): Set a user's level directly.
Resetting is permanent and cannot be undone.
,level reset user (user): Reset a single member's XP.,level reset all: Wipe all leveling data for the server.
Prevent XP gain in specific channels or from specific roles.
,level ignore [target]Run without arguments to see the list of ignored channels/roles.
See the Level-Up Messages section below for complete templating documentation.
,level message [script]: Customize the level-up message (ordisable).,level card [state]: Send a rank-up card instead of a text message.,level dm: Toggle sending level-up messages via DM.
,level channel [channel]: Set the level-up announcement channel. Run it with no channel to stop posting level-ups in a channel.,level coins (amount): Set coins awarded per level-up (at most 250, since coins are one global balance).,level event [multiplier] [duration]: Start a temporary server-wide XP multiplier.,level decay [days] [percent]: Reduce inactive members' XP over time.,level stackroles [on|off]: Choose whether multiple role rewards stack. Run it bare to see the current setting.,level sync: Apply role rewards to all members based on their level.,level antiafk [state]: Require voice members to be active (unmuted, not alone).,level setrate (multiplier): Set the text XP multiplier (default 1x).
Level-Up Messages
Customize the message greed sends when a member reaches a new level. This feature gives you full control over congratulations announcements, achievements, and level-up feedback.
Quick Setup
Set the announcement channel
Messages post to your designated level-up channel:
,level channel #level-upsRequires
Send Messagespermission. Messages only send if both channel and message are configured.Write your message template
Use variables and embeds to customize the announcement:
,level message {embed}{title: Level Up!}{description: {user.mention} reached level {level}!}Test the message
Preview how it renders:
,level message [script]Run without arguments to view the current template.
Enable or disable messages
Turn off announcements entirely if preferred:
,level message disableRun the same command again with a template to re-enable.
Send to DM instead
Optionally send level-ups privately:
,level dmToggle to switch between channel announcements and DMs.
Available Variables
Level-up messages are rendered when a member levels up and have access to:
{level.*}: Level progression context (shown below){user.*}: The member who leveled up{guild.*}: Your server's properties
Level Variables
| Variable | Description | Example |
|---|---|---|
{level} | New level reached | 5 |
{level.current} | Current level (same as {level}) | 5 |
{level.next} | Next level to reach | 6 |
{level.rank} | Member's position on leaderboard | 3 or N/A |
{level.xp} | Total XP accumulated | 1234 |
{level.next_xp} | XP required to reach next level | 567 |
User Variables
| Variable | Description | Example |
|---|---|---|
{user} | Username | moonpie |
{user.mention} | Mention tag | <@123456789> |
{user.name} | Username only | moonpie |
{user.id} | Discord ID | 123456789 |
{user.avatar} | Avatar URL | https://cdn.discordapp.com/avatars/... |
{user.display_name} | Display name or nickname | moonpie |
{user.top_role} | Highest role name | Member |
{user.color} | Hex color of highest role | #FF0000 |
Guild Variables
| Variable | Description | Example |
|---|---|---|
{guild} | Server name | My Awesome Server |
{guild.name} | Server name | My Awesome Server |
{guild.id} | Server ID | 987654321 |
{guild.member_count} | Member count (formatted) | 1,234 |
{guild.icon} | Server icon URL | https://cdn.discordapp.com/icons/... |
{guild.boost_count} | Number of boosts | 5 |
{guild.boost_tier} | Boost level | 1, 2, 3, or No Level |
Template Examples
Simple Announcement
Copy and paste to try:
,level message {user.mention} reached level {level}! Congratulations!Rich Embed with Progress
,level message {embed}{color: 5814783}{title: Level Up!}{description: {user.mention} just reached level {level}!}{field: Rank|{level.rank}}{field: Total XP|{level.xp}}{field: To Next Level|{level.next_xp} XP needed}{thumbnail: {user.avatar}}Milestone Callout
,level message {embed}{color: 16711680}{title: New Level: {level}}{description: Congratulations {user.mention}! You've reached level {level} in {guild.name}.}{field: Server Member|Rank {level.rank} out of {guild.member_count}}{footer: Keep grinding!}Customization
Using Embeds
Leverage embed syntax for rich formatting:
,level message {embed}{color: 5814783}{title: Level {level}}{description: {user.mention} is now level {level}!}{field: Progress to {level.next}|{level.next_xp} XP needed}{thumbnail: {user.avatar}}{footer: {user.id}}Using Custom Scripts
Save a reusable level-up template:
,custom save levelup-announce {embed}{color: 5814783}{title: Level {level}}{description: {user.mention} leveled up!}{thumbnail: {user.avatar}}Then apply it:
,level message {cscript:levelup-announce}Custom script names must start with a letter or number and contain only lowercase letters, numbers, hyphens, and underscores (max 32 characters). You can save up to 100 custom scripts per server.
Management
View the Current Template
See what message is configured:
,level messageIf disabled, it will display "Disabled". If default, it shows the default template.
Review Your Template
There is no dedicated preview command for level-up messages. Run the message command with no script to print the stored template back:
,level messageTo see it rendered for real, cross a level boundary yourself: temporarily lower the requirement so the next message fires in your configured channel.
Disable Level-Up Messages
Turn off announcements completely:
,level message disableRe-enable with a New Template
Set a fresh template to re-enable:
,level message {embed}{title: Level {level}}{description: {user.mention} is now level {level}}Toggle DM vs. Channel
Switch between announcing in the level-up channel or sending messages privately:
,level dmRun again to toggle back to channel announcements.
Troubleshooting
Messages Aren't Sending
- Channel Not Configured: Run
,level channel #channelto set the announcement channel. - Message Disabled: Verify with
,level message. If it says "Disabled", run the command again with a template. - No Permission: Confirm greed has
Send Messagesin the configured channel. - Member Left Before Message Sent: If a member levels up and immediately leaves, the message may fail. This is expected behavior.
- User Has DMs Closed: If using
,level dm, members with closed DMs will not receive the message.
Template Renders Empty or Broken
- Check variable spelling:
{level}not{lvl},{user.mention}not{user.tag}. - Verify embed syntax matches the embed resource guide.
- Run
,level messagewith no arguments to print the stored template back and inspect it. - Check that custom script names exist:
,custom listshows all saved scripts.
Embeds Not Displaying
- Ensure color values are valid (decimal or hex format).
- Check field names and descriptions are not empty.
- Review the embed syntax reference for proper structure.
- Run
,level messagewith no arguments to confirm what is currently stored.
Level-up messages are sent in the configured announcement channel or as DMs, depending on your settings. If the channel is deleted or greed loses permission, messages silently fail. Verify permissions and channel configuration when troubleshooting.
On the dashboard
Every ,level setting can also be changed on the dashboard, under Levels. Both change the same settings, so a change made in one shows up in the other.
Text and voice XP, the XP rate (decimals such as 0.5 work), coins per level, Anti-AFK, ignored channels and roles, XP decay, and voice rates (XP per minute, the cap per session and the minimum time in a channel).
Start or end an XP event here too: pick a multiplier and how many hours it runs for.
Add and remove level roles. Sync roles re-applies every reward to every member in the background, the same as ,level sync.
XP multipliers for roles and channels, and milestones that award coins or a role at a given level.
Showing the server icon on rank cards (,level cardbranding) needs Server Premium on both surfaces.
Rank card styling
The rank card that ,rank sends: and that a level-up posts when the image card is enabled: can be restyled per member.
This needs User Premium, or a vote for greed. Everyone else gets the default card, which already tints itself from the member's avatar.
The live editor
The dashboard is the easiest way in: Levels → Rank card. Every control re-renders the real card through the same renderer that sends it in Discord, so the preview is the artefact rather than an approximation of it.
- Accent: the level number, the progress bar and the stat values. Leave it empty and it follows the dominant colour of your avatar, which is the default behaviour.
- Card background, Panel, Text and Muted text: the surfaces and the two text tones.
- Avatar border: leave empty to reuse the accent.
Four bundled families: Satoshi, Inter, PolySans and Dela Gothic One. Weight runs 400 to 900 and applies to the headings.
A direct https link. Dim darkens the image behind the text: raise it if
a busy image is making the card hard to read.
0 to 12 pixels. 0 keeps the thin default outline.
From Discord
,rankcard color (hex)
,rankcard color reset,rankcard color #ff8800
,rc accent resetThe command covers the accent only: the rest of the card is edited on the dashboard.
Anything you leave alone keeps its default, so a card you have only set an accent on looks exactly as it did before.