FAQ
Why isn’t my XP going up?
Section titled “Why isn’t my XP going up?”A few things to check:
- You’re posting in an ignored channel - run
/ignore-channel listto see which ones are excluded - You have an ignored role - run
/ignore-role listto check - You’re on cooldown - by default there’s a 60-second window between XP-earning messages
- You’re posting bot commands, which don’t earn XP
Run /level to see your current stats. If everything looks fine, ask a server admin to verify the config.
Why didn’t I get my role reward when I leveled up?
Section titled “Why didn’t I get my role reward when I leveled up?”The bot’s role must sit above the reward role in Server Settings → Roles. Discord won’t let a bot assign roles that outrank it in the hierarchy. Ask your server admin to drag the Lumistra bot role above any roles it’s supposed to assign.
Also confirm the bot has Manage Roles permission - without it, role assignment fails silently.
My streak reset even though I was active yesterday - why?
Section titled “My streak reset even though I was active yesterday - why?”Streaks run on UTC midnight, not your local timezone. If you were active late at night but it was already the next UTC day, there may be a gap in your streak. A streak breaks when you miss a single UTC day - you need activity on consecutive UTC days to keep it going. Compare your timezone offset against UTC to see if that explains the reset.
How do I stop certain channels from giving XP?
Section titled “How do I stop certain channels from giving XP?”Run /ignore-channel add #channel-name. The channel will stop counting toward XP immediately. Members can see the current ignore list with /ignore-channel list.
Can I have different leveling tracks for different parts of my server?
Section titled “Can I have different leveling tracks for different parts of my server?”Yes. Lumistra supports multiple levelers - independent tracks with separate XP totals, levels, and role rewards. Pass the leveler parameter on commands like /config set, /add-role-reward, and /ignore-channel add to target a specific track. Leveler names can use letters, numbers, hyphens, and underscores, up to 50 characters.
What’s the difference between /member-stage and /lifecycle-analyze?
Section titled “What’s the difference between /member-stage and /lifecycle-analyze?”/member-stage shows one member’s current lifecycle stage and their engagement details. /lifecycle-analyze gives you the full server picture: stage distribution across all members, at-risk members (no XP activity in 30+ days), and an engagement summary.
Someone is farming XP by spamming - how do I stop it?
Section titled “Someone is farming XP by spamming - how do I stop it?”The built-in cooldown already limits how fast anyone can earn XP. The default is 60 seconds between earning messages. You can raise it with /config set cooldown_seconds:120 (or a higher value). You can also exclude specific channels with /ignore-channel add if the farming is concentrated somewhere.
Can I import my levels from MEE6?
Section titled “Can I import my levels from MEE6?”Yes. Export your MEE6 leaderboard as CSV or JSON, then run /import-levels and upload the file. Max file size is 5 MB, max 10,000 users per import. The import maps MEE6 levels to equivalent XP amounts in Lumistra’s system.
How do I see who’s about to leave my community?
Section titled “How do I see who’s about to leave my community?”Run /lifecycle-analyze. It lists at-risk members (no XP activity in the past 30 days) alongside the server’s full stage distribution. For a single member, use /member-stage @user.
What permissions does Lumistra need?
Section titled “What permissions does Lumistra need?”Core permissions: View Channels, Send Messages, Embed Links, Read Message History, Use External Emojis, Add Reactions. For role rewards to work: Manage Roles. For full admin configuration access, granting Administrator is the cleanest approach - though individual permissions will work if you prefer finer control.
Can I customize the level-up message?
Section titled “Can I customize the level-up message?”The announcement template and destination channel are both configurable through /config set. The default message is 🎉 {user} reached **Level {level}**! - you can replace the template text and point announcements to any channel the bot can post in.
How do I reset everything and start fresh?
Section titled “How do I reset everything and start fresh?”/replay-reset removes XP and levels for the server. Adding full:True also wipes messages, reactions, threads, membership, lifecycle, and streaks. Both options require a confirmation step.
Warning: A full reset cannot be undone. There’s no recovery path once confirmed.
What are quality reactions and should I use them?
Section titled “What are quality reactions and should I use them?”Quality reactions are emojis you designate as signals of good content. When a member reacts to a message with a quality emoji, the message author earns bonus XP - multiplied by that emoji’s weight (default 2.0x). You can optionally give the reactor XP too.
They’re useful for communities that want to reward thoughtful posts rather than volume alone. Set them up with /quality-reaction add.
Why does Lumistra need Manage Roles permission?
Section titled “Why does Lumistra need Manage Roles permission?”To assign role rewards automatically when members hit the required level. Without it, leveling still tracks XP and levels normally, but role assignment fails silently - members won’t receive their rewards.
How does the XP curve work - how much XP per level?
Section titled “How does the XP curve work - how much XP per level?”The default curve is linear. Level 1 requires 10 XP, and Level 2 requires 35 XP total (10 + 25). Each subsequent level adds 15 more XP than the previous gap.
Admins can adjust the starting values with /config set first_level_xp: and /config set second_level_xp: - the difference between the two determines how steeply the curve rises. An exponential mode matching MEE6’s curve is also available if you’re migrating from that system.