Leveling Formula | MMO Skill Tree Docs

Available Formulas

Hybrid (Default)

Combines OSRS-style exponential scaling with a quadratic floor:

XP = OSRS_component + (base × level × (level-1) / 2)

OSRS component uses 2^(level/7) - each level requires ~10% more XP
Quadratic floor ensures early/mid levels aren't too easy
Level 100 = ~10 million XP

Legacy

Simple quadratic formula:

XP = base × level × (level-1) / 2

Easier endgame (~1.5M XP at level 100)
Good for casual servers

Switching Formulas

/mmoconfig formula --args=hybrid    # OSRS-style (default)
/mmoconfig formula --args=legacy    # Easier quadratic

Parameters

Parameter	Default	Effect
`baseXpPerLevel`	300	Controls early game difficulty
`levelScaleMultiplier`	200	Controls endgame curve steepness

Adjusting Parameters

/mmoconfig basexp --args=400    # Harder early game
/mmoconfig basexp --args=200    # Easier early game
/mmoconfig scale --args=150     # Easier endgame
/mmoconfig scale --args=250     # Harder endgame

Max Levels

By default, all skills cap at level 100. You can change the default max level and set per-skill overrides via the admin dashboard (/mmoadmin → Max Levels section).

How It Works

Default Max Level — applies to every skill unless overridden (default: 100)
Per-Skill Overrides — set individual skills higher or lower than the default. Leave a field blank to use the default
XP Stops at Cap — once a skill reaches its max level, no further XP is awarded for that skill
Persisted — settings are saved to mods/mmoskilltree/skill-config.json under defaultMaxLevel and skillMaxLevels

Example: JSON Config

{
  "defaultMaxLevel": 50,
  "skillMaxLevels": {
    "MINING": 75,
    "SWORDS": 100
  }
}

In this example, most skills cap at 50, but Mining caps at 75 and Swords at 100.

Tips

Lowering the max level does not remove existing XP — players keep their XP but their displayed level is capped
Skill tree rewards tied to levels above the new cap remain claimed if they were already earned
Use the "Save All" button in the admin dashboard to update the default and all per-skill overrides at once

XP Requirements (Default Settings)

Level	XP Required	Difficulty
10	~14,270	Early game
25	~95,573	Early-mid
50	~446,222	Mid game
80	~2,274,045	Late game
100	~10,000,000	Endgame mastery

Milestone Preview

When changing formula or parameters, the command shows milestone XP:

XP required: Lv10=14.3k | Lv25=95.6k | Lv50=446.2k | Lv80=2.3M | Lv100=10.0M

Player Impact

Warning: Changing the formula affects existing players! Players may have lower levels than before if XP requirements increase.

Skill tree rewards are automatically validated
Rewards may be revoked if player no longer meets level requirements
Stat bonuses are recalculated

Validation Triggers

These commands trigger player validation:

/mmoconfig formula
/mmoconfig basexp
/mmoconfig scale
/mmoconfig reload
/mmoconfig reloaddefaults