Setup Guide
Permissions
Section titled “Permissions”The bot needs these Discord permissions to function correctly:
- View Channels - to see messages in channels
- Send Messages - for level-up announcements and responses
- Embed Links - for rich embed responses (level cards, leaderboards)
- Read Message History - for reaction tracking and harvest
- Use External Emojis - for milestone and status display
- Add Reactions - for interactive menus
- Manage Roles - for automatic role reward assignment
The /setup wizard
Section titled “The /setup wizard”/setup requires Manage Server permission. What you see depends on your server’s current state.
New server (no config yet):
- Analyze - scans recent server activity and recommends settings. Offers three presets: Relaxed (low XP, slow progression), Moderate (balanced), Fast (high XP, quick levels). Pick one or adjust values manually after.
- Configure Manually - category-based navigation: XP & Leveling, Reactions, Threads, Channels & Roles, Announcements. Set each parameter directly.
Already configured:
- Re-analyze - re-run analysis with current data
- Configure - modify existing settings
- View Config - see all current values
/analyze (standalone)
Section titled “/analyze (standalone)”/analyze runs the same activity analysis as the setup wizard without changing anything. Useful for reviewing server patterns before adjusting config. Accepts a days parameter (1–365) to control the lookback window. Rate-limited to 2 uses per 30 seconds.
Manual configuration with /config set
Section titled “Manual configuration with /config set”/config set requires Administrator permission. All parameters are optional - include only what you want to change:
| Parameter | Default | Range | What it controls |
|---|---|---|---|
first_level_xp | 10 | 1–10,000 | XP needed for level 1 |
second_level_xp | 25 | 1–10,000 | XP needed for level 2 (defines the step between levels) |
max_level | 300 | 1–1,000 | Level cap |
cooldown_seconds | 60 | 0–3,600 | Seconds between XP-earning messages |
reactor_xp | 1 | 0–1,000 | XP awarded to reactors for quality reactions |
reactor_xp_enabled | false | true/false | Whether reactors earn XP |
The XP curve is linear by default. Each level requires step more XP than the previous, where step = second_level_xp - first_level_xp (default 15).
Thread XP with /config thread-xp
Section titled “Thread XP with /config thread-xp”Thread XP rewards thread creators when others participate. Disabled by default.
| Parameter | Default | What it controls |
|---|---|---|
thread_creator_xp_enabled | false | Master toggle for thread creator XP |
thread_creator_xp | 2 | XP per qualifying message in the creator’s thread |
thread_creator_cooldown_secs | 300 | Seconds between creator XP awards |
thread_creator_daily_cap | 20 | Max creator XP awards per day (0 = unlimited) |
thread_min_age_secs | 0 | Thread must be this old before awards begin |
thread_contributor_bonus_enabled | false | Bonus XP for posting in someone else’s thread |
thread_contributor_bonus_xp | 1 | Bonus XP amount |
Ignored channels and roles
Section titled “Ignored channels and roles”Exclude specific channels or roles from earning XP:
/ignore-channel add #channel//ignore-channel remove #channel/ignore-role add @role//ignore-role remove @role
Common uses: staff-only channels, bot-spam channels, moderator roles that shouldn’t participate in leveling.
Anyone can view the lists with /ignore-channel list and /ignore-role list.
Announcement channel
Section titled “Announcement channel”Level-up announcements go to the same channel where the leveling message was sent by default. To centralize them, set an announcement channel through the setup wizard or /config set.
Viewing current config
Section titled “Viewing current config”Run /setup and select “View Config” to see all current settings in one place.