Standard Configuration
LevelingCore’s configuration file is stored in the following location: /mods/com.azuredoom_levelingcore/levelingcore.json
Default: false
When enabled, players will lose a portion of their XP when they die.
Notes
- Works together with
XPLossPercentageto determine how much XP is removed. - If disabled,
XPLossPercentageis effectively ignored.
Default: 0.1
The percentage of XP to remove on death when EnableXPLossOnDeath is enabled.
Examples
-
0.1= lose 10% XP on death -
0.25= lose 25% XP on death
Default: true
Toggles the “default XP gain” behavior. When enabled, the system applies the DefaultXPGainPercentage to whatever base XP gain logic you use.
Notes
- If disabled,
DefaultXPGainPercentageis effectively ignored and XP gain should be handled elsewhere (custom logic, events, etc.).
Default: 0.5
Controls the default percentage multiplier/portion used by the XP gain system when EnableDefaultXPGainSystem is enabled.
Examples
-
0.5= apply 50% of the default XP gain amount -
1.0= apply 100% of the default XP gain amount
Default: false
When enabled, death can trigger a level decrease (level down).
Notes
- You can restrict when level down applies using
MinLevelForLevelDown. - If disabled,
MinLevelForLevelDownis effectively ignored.
Default: false
When enabled, death causes the player to lose all levels.
Important
- This is an aggressive option. In most setups, you’ll want to ensure your death-handling logic clearly defines precedence between:
- losing XP (
EnableXPLossOnDeath) - losing a level (
EnableLevelDownOnDeath) - losing all levels (
EnableAllLevelsLostOnDeath)
- losing XP (
A common rule is:
- If
EnableAllLevelsLostOnDeathis true → wipe levels - else if
EnableLevelDownOnDeathis true → level down (respecting min level) - XP loss runs independently (if enabled)
(Adjust to match your actual implementation.)
Default: 65
Sets the minimum level required for level-down to occur when EnableLevelDownOnDeath is enabled.
Example
- If set to
65, players below level 65 will not level down on death.
Default: false
When enabled, players will receive chat messages when they gain or lose levels.
Default: true
When enabled, title popups are shown for level and XP changes.
Default: true
When enabled, the current XP amount is displayed in the player HUD.
Default: true
When enabled, player stats scale with level.
⚠️ Disabling this prevents multiplier below from being used.
Default: 1.2
Multiplier applied to health increases on level-up.
Example
1.2 = increase health by 20% per level
Default: 0.35
Multiplier applied to stamina increases on level-up. integer Example
0.35 = increase stamina by 35% of the base value per level
Default: 0.6
Multiplier applied to mana increases on level-up.
Example
0.6 = increase mana by 60% of the base value per level
Default: true
When enabled, leveling up will heal affected stats (health, stamina, mana).
Default: "SFX_Divine_Respawn"
Sound event played when a player levels up.
⚠️ Must match a valid sound event ID.⚠️ If invalid or empty, no sound will be played.
Default: "SFX_Divine_Respawn"
Sound event played when a player levels down.
⚠️ Must match a valid sound event ID.⚠️ If invalid or empty, no sound will be played.
Default: true
When enabled, XP gain is determined entirely by xpmapping.csv, rather than health-based XP defaults.
⚠️ As of January 18, 2026, all default NPCs are included in xpmapping.csv, so health-based XP will not be used unless this is disabled or explicitly configured elsewhere.
Default: false
When enabled, level up rewards will be granted. These are configured by following the Level Reward Mapping
Default: false
When enabled, level up stats will not be granted.
Default: 5
The amount of stat points to grant on level up if not using the UseStatsPerLevelMapping config.
Default: false
Whether to use a custom mapping to determine stat points granted per level instead of a flat value.
Default: 0.1
Multiplier applied to Strength-based effects such as Melee weapon damage.
Default: 0.1
Multiplier applied to Perception-based effects such has Range weapon damage.
Default: 2.0
Multiplier applied to Vitality-based effects, such as health scaling.
Default: 0.25
Multiplier applied to Agility-based effects, such as stamina.
Default: 2.0
Multiplier applied to Intelligence-based effects, such as incrased mana.
Default: true
Enables compatibility with Party Pro plugin for party experience sharing.
Default: true
Enables compatibility with the Party Plugin for party experience sharing.
Default: NEARBY_PLAYERS_MEAN
Possible options:
NEARBY_PLAYERS_MEANBIOMEINSTANCEZONESPAWN_ONLY
Determines how player level is calculated, based on nearby players.
Default: 5
A randomization factor applied to an NPC's base level. This allows for natural level diversity within the same zone or spawn group, ensuring that not every mob of the same type has identical stats.
The variance is calculated uniquely for each NPC using its UUID as a seed, meaning the level remains consistent for that specific entity once spawned.
Formula
The final level is determined by adding a random offset between -LevelVariance and +LevelVariance to the base level:
FinalLevel = BaseLevel + Random(-LevelVariance, +LevelVariance)
This means the NPC's level may spawn below or above the configured base level.
Examples
| Base Level | Level Variance | Possible Final Levels |
|---|---|---|
| 5 | 0 | 5 (No change) |
| 5 | 2 | 3, 4, 5, 6, or 7 |
| 5 | 5 | 0–10 |
⚠️ LevelVariance applies to all LevelModes except SPAWN_ONLY. If the variance is set to 0, NPCs will always spawn exactly at their assigned base level.
Default: 2.1
Multiplier applied to mob health values based on level.
Default: 0.5
Multiplier applied to mob damage output based on level.
Default: 0.0
Base melee damage scaling factor applied when a mob/NPC hits a player. This value is combined with the mob’s level and MobDamageMultiplier to produce a final melee damage multiplier.
When the hit is not detected as projectile/arrow:
finalDamage = incomingDamage
* conDamageMultiplier(playerCon)
* (MobBaseDamage + (MobDamageMultiplier * mobLevel))Default: 0.3
Multiplier applied specifically to ranged mob damage.
Default: 0.0
Base projectile/ranged damage scaling factor applied when a mob/NPC damages a player using a projectile (e.g., arrows or other projectile-based attacks). This value is combined with the mob’s level and MobRangeDamageMultiplier to produce the final ranged damage multiplier.
finalDamage = incomingDamage
* conDamageMultiplier(playerCon)
* (MobBaseRangeDamage + (MobRangeDamageMultiplier * mobLevel))Default: false
When enabled, the Item Level Requirements system is used.
Default: false
When enabled, the XP bar on the HUD is shown.
Default: false
When enabled, player levels are shown in the player nameplate.
Default: false
When enabled, mob levels are shown in the player nameplate. When false, will remove any mob levels in nameplates.
Default: 0.35
Controls how strongly a mob’s level scales the amount of XP it rewards.
When calculating XP, the base XP value (derived either from the mob’s max health or from configured XP mappings) is multiplied by a level-based scaling factor:
levelScale = mobLevel ^ MobLevelMultiplier
xp = baseXP * levelScale
-
Lower values (e.g. 0.1) result in gentle XP scaling per level
-
Higher values (e.g. 1.0) cause XP to scale much more aggressively with mob level
-
A value of 0 effectively disables level-based XP scaling
This allows fine-tuning how rewarding higher-level mobs are without changing base XP values.
Default: [Lvl {level}]
Controls the formatted suffix (or full template) appended to a mob’s name to display its level.
This is a string template that supports placeholders and is applied when a mob has a level greater than 0.
You may use the following placeholders inside the string:
| Placeholder | Description |
|---|---|
{level} |
The mob’s calculated level (integer) |
{name} |
The mob’s original display name |
{
"EnableXPLossOnDeath": false,
"XPLossPercentage": 0.1,
"DefaultXPGainPercentage": 0.5,
"EnableDefaultXPGainSystem": true,
"EnableLevelDownOnDeath": false,
"EnableAllLevelsLostOnDeath": false,
"MinLevelForLevelDown": 65,
"EnableLevelChatMsgs": false,
"DisableXPGainNotification": false,
"EnableLevelAndXPTitles": true,
"ShowXPAmountInHUD": false,
"EnableStatLeveling": true,
"HealthLevelUpMultiplier": 2.200000047683716,
"StaminaLevelUpMultiplier": 1.350000023841858,
"ManaLevelUpMultiplier": 1.600000023841858,
"EnableStatHealing": true,
"LevelUpSound": "SFX_Divine_Respawn",
"LevelDownSound": "SFX_Divine_Respawn",
"UseConfigXPMappingsInsteadOfHealthDefaults": true,
"EnableLevelUpRewardsConfig": false,
"DisableStatPointGainOnLevelUp": false,
"StatsPerLevel": 5,
"UseStatsPerLevelMapping": false,
"StrStatMultiplier": 0.10000000149011612,
"PerStatMultiplier": 0.10000000149011612,
"VitStatMultiplier": 2.0,
"AgiStatMultiplier": 0.25,
"IntStatMultiplier": 2.0,
"ConStatMultiplier": 0.800000011920929,
"EnablePartyProXPShareCompat": true,
"EnablePartyPluginXPShareCompat": true,
"EnablePartyXPSplit": false,
"PartyGroupXPMultiplier": 0.5,
"KillerGetsFullXp": true,
"EnablePartyXPDistanceCheck": false,
"PartyXPDistanceBlocks": -1.0,
"LevelMode": "NEARBY_PLAYERS_MEAN",
"LevelVariance": 0,
"MobHealthMultiplier": 2.0999999046325684,
"MobDamageMultiplier": 0.25,
"MobBaseDamage": 0.0,
"MobRangeDamageMultiplier": 0.30000001192092896,
"MobBaseRangeDamage": 0.0,
"EnableItemLevelRestriction": false,
"EnableXPBarUI": true,
"ShowPlayerLvls": true,
"ShowMobLvls": true,
"MobLevelMultiplier": 0.35,
"MobNameplate": "{name} [Lvl. {level}]"
}