Stellar’s XP and level system turns everyday conversation into friendly competition. Every message a member sends earns them points, and those points accumulate into levels that reflect how active they are in your community. As an admin, you control how quickly members progress, where level-up announcements appear, and whether members get pinged when they rank up — giving you a lightweight but meaningful engagement tool without any external integrations.Documentation Index
Fetch the complete documentation index at: https://docs.stellarbot.dev/llms.txt
Use this file to discover all available pages before exploring further.
How XP works
Members earn points passively by sending messages in your server. Stellar calculates a member’s current level from their total accumulated points. The more points they have, the higher their level. You can speed up or slow down progression for everyone at once by adjusting the XP multiplier.Setup guide
Optionally adjust the XP multiplier
By default the multiplier is A multiplier of
1. Set it higher to make leveling faster, or lower to slow progression down.1.5 gives members 50% more XP per message. A value of 0.5 halves the rate.Configure level-up notifications
Choose one of two approaches:Dedicated channel — Send all level-up messages to a single channel:In-channel replies — Have Stellar reply directly in the channel where the member leveled up:Running
/xp replies again toggles the feature off. If a dedicated channel is already set, Stellar will fall back to that channel when replies are disabled.Commands
/xp enable
Enables the XP and level system for your server. Members begin earning points from their next message onward.
Required permission: Manage Guild
/xp disable
Disables the XP and level system. Existing points are preserved — re-enabling the system resumes from where members left off.
Required permission: Manage Guild
/xp config
Displays the current XP system configuration, including whether the system is enabled, the active multiplier, and where level-up notifications are sent.
Required permission: Manage Guild
/xp get
Shows your current level and total XP points in this server. If the XP system is disabled, the bot will prompt you to ask staff to enable it.
/xp leaderboard
Shows the top 10 members by XP points. The embed also displays the server’s combined total points and overall server level.
/xp setmodifier [multiplier]
Sets the XP gain multiplier for the entire server. The value is a decimal number.
| Example value | Effect |
|---|---|
0.5 | Half the default XP rate |
1 | Default rate |
1.5 | 50% more XP per message |
2 | Double the default XP rate |
/xp setchannel [channel]
Sets the channel where level-up notifications are posted. This is ignored while /xp replies is active.
Required permission: Manage Guild
/xp replies
Toggles in-channel level-up replies. When enabled, Stellar replies directly to the message that triggered a level-up, rather than posting in a dedicated channel. Run the command again to turn it off.
Required permission: Manage Guild
/xp mention
Toggles whether you receive a ping when you level up. This is a personal preference — each member controls their own setting independently.
This command does not require Manage Guild. Any member can run it to opt in or out of level-up pings.