Getting Started

Prerequisites

You’ll need:

The Lumistra invite link (get it from the bot’s listing page)
Manage Server permission on the Discord server you’re adding it to

Step 1: Add the bot

Use the invite link to authorize Lumistra. During authorization, grant these permissions:

Permission	Required for
View Channels	Tracking messages and activity
Send Messages	Level-up announcements and responses
Embed Links	Level cards, leaderboards, embeds
Read Message History	Harvest and replay commands
Use External Emojis	Level cards with custom emoji
Add Reactions	Quality reaction features
Manage Roles	Assigning role rewards on level-up

Before continuing: Go to Server Settings → Roles and drag the Lumistra bot role above any roles it will be assigning. If the bot’s role sits below a reward role, it can’t assign it - level-ups will succeed but no role will be granted.

Step 2: Run `/setup`

Type /setup in any channel the bot can read. You’ll see two options:

Analyze - Lumistra scans your server’s recent message activity and recommends one of three presets:

Relaxed - slower XP gain, longer cooldowns, suits low-traffic servers
Moderate - balanced defaults, good starting point for most communities
Fast - higher XP per message, shorter cooldowns, suits high-traffic servers

Configure Manually - step through each category with dropdowns and modals:

XP & Leveling - XP per message, cooldown, max level, level curve
Reactions - quality reaction emojis and their XP weights
Threads - XP for creating and contributing to threads
Channels & Roles - channels and roles to exclude from XP
Announcements - level-up message template and destination channel

Permission note: /setup requires Manage Server. The /config command, role rewards, and ignore lists all require Administrator.

Step 3: Add a role reward

Run /add-role-reward and pick a level and an existing server role. When a member reaches that level, Lumistra automatically assigns the role.

You can add as many role rewards as you want at different levels. View them any time with /list-role-rewards.

Step 4: Test it

Send a few messages in a tracked channel (not one you’ve excluded), then run /level. You should see your XP and rank card. If XP isn’t moving, check:

The channel isn’t on the ignore list (/ignore-channel list)
Your role isn’t on the ignore list (/ignore-role list)
You’re not still on cooldown (default: 60 seconds between earning messages)

What’s next?

Setup Guide - detailed configuration for every option, including thread XP, multiple leveling tracks, and announcement templates
Welcome Messages - configure personalized welcome embeds for new members with /welcome enable