Skip to main content

​
Progression System

​
Experience Points (XP)

Players gain experience points by defeating mobs. The amount of XP gained is calculated based on the mob’s maximum health. See Formulas for the exact math.

​
Leveling Up

When a player accumulates enough XP, they level up. Each level up:
  • Awards stat points (configurable, default: 3 points per level)
  • Resets XP to 0 (excess XP carries over)
  • Updates the HUD display
  • Sends a level up notification

​
Death Penalty (Optional)

The plugin includes an optional death penalty system that can be enabled in the configuration:
  • Disabled by default — Must be manually enabled by server administrators
  • When enabled (ResetLevelOnDeath: true), players who die will:
    • Have their level reset to 1
    • Lose all XP progress
    • Have all allocated stat points cleared
    • Have available stat points reset to 0
    • See a prominent death notification: “YOU DIED! Your level has been reset to 1”
  • Creates a hardcore gameplay experience where death has meaningful consequences
  • Perfect for survival servers or hardcore game modes
To enable death penalty:
  1. Open mods/RPGLeveling/RPGLevelingConfig.json
  2. Set "ResetLevelOnDeath": true
  3. Restart the server

​
Stat Points

Stat points are earned on each level up. Players can allocate these points to any of the available stats through the GUI (/lvl gui). Allocated stats are applied as permanent modifiers to the player’s character.

​
Available Stat Points Calculation

The total available stat points a player has is: 
Available Points = (Current Level - 1) × StatPointsPerLevel
Example: Level 10 with 3 stat points per level → Available = (10 − 1) × 3 = 27 points See Formulas for progression speed analysis and stat point totals at max level.