Interface ILevelConfig

A custom JS expression string evaluated when formula = "custom". Available variables: level, base, exponent Example: "base * level * (level + 1) / 2"

Whether the leveling system is enabled for this guild. Default: true

XP formula to use for computing required XP per level. Default: "quadratic"

Maximum level a member can reach. 0 = no cap. Default: 0

Message/custom rewards that fire the levelReward event

Role/channel-specific XP multipliers. All matching multipliers are stacked (multiplied together).

Roles that grant zero XP but are not the same as ignore. Members with these roles can still appear on the leaderboard.

Role rewards granted at specific levels

If true, all earned role rewards are kept as the member levels up. If false, only the highest reward role is kept. Default: true

Base XP value used in the formula. linear: xpRequired = base * level quadratic: xpRequired = base * level^2 exponential: xpRequired = base * exponent^level Default: 100

Cooldown between XP gains in milliseconds. Default: 60000 (60 seconds)

Exponent used only for the "exponential" formula. xpRequired = xpBase * xpExponent^level Default: 1.5

Maximum XP awarded per message. Default: 25

Minimum XP awarded per message. Default: 15

Global XP multiplier applied on top of any role/channel multipliers. Default: 1