Skip to content
Lumistra Docs

Multiple Leveling Tracks

A leveler is a completely independent leveling track within one server. Each leveler has its own XP pool, levels, configuration, role rewards, ignored channels and roles, and quality reactions.

By default, your server has one unnamed leveler that’s active when you don’t specify one.

When multiple levelers make sense

Section titled “When multiple levelers make sense”
  • An art community tracking creative work separately from general chat
  • A gaming server with per-game-channel leveling
  • Event-based temporary tracks - a month-long competition with its own XP that doesn’t mix with the main leaderboard

Creating a leveler

Section titled “Creating a leveler”

Levelers are created implicitly. Pass a leveler name to any config command and the leveler is created on the spot:

/config set first_level_xp:20 leveler:art
/add-role-reward level:5 role:@Art Novice leveler:art
/ignore-channel add #general leveler:art

Names can contain letters, numbers, hyphens, and underscores. Maximum 50 characters.

How members earn XP per leveler

Section titled “How members earn XP per leveler”

When a leveler is active, messages earn XP for that leveler according to its own settings. If a channel is ignored in one leveler but not another, messages there count only in the leveler that doesn’t ignore it.

Members use the leveler parameter to view their progress on a specific track:

/level leveler:art
/leaderboard leveler:art
/list-role-rewards leveler:art

Omitting the parameter falls back to the server’s default leveler.

Common patterns

Section titled “Common patterns”

Two-track leveling - One leveler for creative channels (art, music, writing), another for everything else. Ignore the creative channels in the default leveler, and ignore non-creative channels in the creative leveler. Each track stays clean.

Event leveler - Stand up a temporary leveler with aggressive XP settings for a limited-time event. Configure unique role rewards. When the event ends, the levels remain as a permanent record without polluting the main leaderboard.

Game-specific tracks - Route each game’s channels into their own leveler. Members who focus on one game climb that leaderboard without being disadvantaged on the main one.

Limitations

Section titled “Limitations”

Each leveler needs its own complete configuration. There’s no inheritance or “copy defaults from another leveler” - ignore lists, role rewards, and quality reactions are all configured independently per leveler.