Lona Docs DOCS Dashboard Support Add Lona
Docs / Levels and Profile

Levels & Profiles

XP system tracking text messages and voice time, customizable rank cards, and leaderboards.

11 commands1 PRO2 guides
How to configure it from the dashboard

The leveling system has an often-overlooked feature: you can split text tracks from voice tracks — meaning a member can be level 10 in text and 4 in voice at the same time. Read step two before deciding.

Enable the system

Dashboard ← Levels and Roles ← Enable and Control

The main toggle enables point tracking (text + voice) and reveals commands to members.

Levels and Roles System
Enable the entire systemPoint tracking (text + voice) and show commands

Choose: single level or two separate levels?

Same page ← Leveling Mode

An important decision that affects the card design and leaderboard:

Single level — Text and voice merge into a single number. Simpler and clearer for members.
Two separate levels — Independent text and voice tracks. Ideal if your server has two distinct groups (chatters vs voice dwellers).

When dual mode is enabled: the card displays both tracks, and the leaderboard splits into a separate list for each track.

Leveling Mode
Single levelCurrent system — one number combines text and voice
Two separate levelsE.g. text 10 and voice 4
Do not count points if member is Mute/DeafenPrevents AFK voice campers from earning points without interacting

Set role rewards

Same page ← Role Rewards

Link each level to an automatically assigned role.

A tip that makes a difference: give the role actual utility — access to a private channel, image upload permissions, or giveaway priority. A role that only changes name color won't motivate anyone past the first week.

Role Rewards
At level 5@Active
At level 15@Engaged
At level 30@Legend
The role must be below Lona's role, otherwise it cannot assign it

Design the rank card

Same page ← Rank Card Design

Custom background (PNG/JPG) and a color applied to the font, XP bar, and avatar ring.

There is a live preview — the bar fills up gradually just like it appears to the member.

Rank Card Design
Custom backgroundClick to upload an image (PNG/JPG)
Card colorFont, XP bar, and avatar ring#ffb7c5
Live preview updates with every change

Configure the level-up message

Same page ← Level-up Channel

Choose where it posts and what it says. Variables keep it personalized.

Tip: If your server is large, don't keep it in the main chat — it will flood the channel with level-up messages. Dedicate a channel for it.

Level-up Message
Level-up channelOr a dedicated channel💬 Same channel
Level-up message typeEmbed card
Variables: {user} · {level} · {server}

Set allowed command channels

Same page ← Allowed Command Channels

If you don't select any channel, the command works in all channels.

You'll usually want !rank and !top restricted to a bot channel so they don't disrupt chat.

Rank and Top Commands
Allowed command channels#🤖│bot-commands
Clear all (= all channels)

How the system works

The leveling system turns activity into a competition. Lona tracks two types of activity:

Message XP — Points per message, with a cooldown to prevent spamming from boosting levels.

Voice XP — Points per minute in a voice channel. This sets your server apart, as most bots only track text messages.

When a member reaches a specific level, they automatically get a level-up role configured in the dashboard. The rank card is generated as an image displaying their avatar, color, and progress.

The formula is progressive: each level requires more XP than the last—keeping high levels valuable.

Practical recipes

Want to boost activity on a specific day?

A temporary boost gets everyone chatting:
1!xpboost 2x 3h — 2x XP multiplier for 3 hours
2Announce it an hour beforehand so they get ready
3!top — then check the new leaderboard

A member says their level isn't increasing

Lona has a built-in diagnostic tool:
1!setlevel diagnose @member — gives you the exact reason
2Common causes: ignored channel, exempt role, or cooldown period
Tips and warnings
Exclude spam and bot channels from XP calculation in the dashboard—it keeps rankings fair.
Level-up roles are more impactful when they offer actual perks (access to private channels, image upload perms) rather than just a colored name.
!بطاقتي displays a full profile card, while !rank shows the level card—they are two different things.
If you change the XP rate, existing members keep their levels—the change only affects future gains.
Commands · 11
Copied ✓
!rankPrefix
%p%rank → Your rank card
Copied ✓
/setlevelSlashAdmin
⚙️ Manage a member's level and XP — view/set/add/reset
عضو The target memberمستوى Number = direct set | +2 add | -1 subtract | empty = view onlyاكس_بي Same as level but for XPتصفير True completely resets the member's level and XP
Copied ✓
/streakSlash
🔥 View your streak in the server
member View another member's streak
Copied ✓
/streak-resetSlashAdmin
♻️ Reset a member's streak or the entire server (Admin)
member Target member — leave empty to reset the entire serverfull Wipe everything: best streak and total days as well (default: no)
Copied ✓
/streaksSlash
🏆 Top 10 streaks in the server
Copied ✓
!topprefix
%p%top [daily/weekly/monthly] [text/voice]
Copied ✓
!xpadminPrefixAdmin
%p%xpadmin give @user 100 | remove @user 50 | reset @user
Copied ✓
!xpboostPrefixPROAdmin
%p%xpboost 2 30 → 2x XP for 30 minutes
Copied ✓
!الافضلPrefix
Top members points leaderboard.
Copied ✓
!نقاطيPrefix
View your points balance.
Copied ✓
!profilePrefix
—
No commands match the filter