Leveling & role rewards
Turn XP into levels and automatically reward members with roles as they climb. (Free)
Leveling turns the XP members earn into levels, and it hands out roles automatically at the levels you choose. It's one of the most popular features, because it gives members a reason to stay active. It's also completely free, which is unusual. Most other bots charge for it.
Needs XP first. Make sure Points & XP is on. Levels are worked out from XP.
What it does
- Calculates each member's level from their XP.
- Grants roles automatically at the level breakpoints you set.
- Optionally posts a "level up!" announcement.
Setting it up
In the admin panel, open Leveling and:
- Turn it on.
- Choose how fast levels come with the formula: later. You can tune the curve with a coefficient, and set a maximum level.
- Quadratic (default) makes each level need more XP than the last, a steady climb.
- Linear uses a flat amount of XP per level.
- MEE6-style feels familiar to members coming from that bot: quick early, slower
- Map levels to roles, for example Level 5 to "Bronze" and Level 10 to "Regular."
- Choose whether members keep every role they earn as they climb (stack), or whether each new one replaces the last.
- (Optional) Turn on announcements, then pick a channel and a message.
- Click "Send me a test level-up." It fires a real level-up for your own account so you can see the role grant and the announcement work before any member hits a level.
HoneyGate checks your role order for you. Discord only lets a bot hand out roles that sit below the bot's own role. Get the order wrong and rewards fail silently, a classic headache with other bots. Every time you open the Leveling page, HoneyGate asks the bot which of your reward roles it can actually grant and warns you right on the page. The fix is to drag the HoneyGate role above the marked roles in Server Settings → Roles. It also flags rewards whose role has been deleted.
Bringing your MEE6 XP with you
Switching from MEE6? Your members don't have to start from zero. On the Leveling page, click Import from MEE6 and copy everyone's XP history across in one go.
- In your MEE6 dashboard, turn on Leaderboard → "Make my server's leaderboard public." You can switch it back to private right after.
- Back in HoneyGate, open Leveling → Import from MEE6, confirm your server ID, and click Import XP from MEE6. A progress bar shows it working through your members, at roughly 1 second per 100.
- When it finishes, everyone keeps their place. No one is sent back to Level 1.
You can safely run it more than once to pick up members who joined MEE6 since your last import. It never lowers anyone's XP: if a member has already earned more XP inside HoneyGate, their HoneyGate total wins.
After an import, "Level-ups recorded" reads 0 — that's normal. Those members arrived already holding their levels, so there was no level-up for HoneyGate to watch happen. The cards that matter are Members at level 1+ and Highest level reached, which are worked out from the XP your members actually hold, so they show the truth straight after an import. "Level-ups recorded" starts counting from the first member who crosses a threshold while HoneyGate is watching.
Member experience
Members earn XP by being active. When someone crosses a threshold they level up automatically and get any role you mapped, with no action needed on their part. They check their level with /xp rank, a picture rank card showing their rank, level, and progress to the next level. It also shows on their portal, where the leaderboard lists everyone's level, and /xp top shows levels too.
Tips
- Role rewards must sit below the HoneyGate role (see role hierarchy).
- "Stack" is great for prestige, where members collect every rank. "Replace" keeps the role list tidy, showing only their current rank.
- Level rewards pair naturally with channel permissions. Picture a "Regular" role that unlocks an off-topic channel.