Main Plugin Config

File: mods/Zuxaw_RPGLeveling/RPGLevelingConfig.json The main configuration file for the RPG Leveling plugin. Controls XP rates, max level, difficulty preset, and core gameplay toggles.

Configuration Options

Option	Type	Default	Description
`MaxLevel`	Integer	100	Maximum level players can reach
`RateExp`	Double	3.0	Global XP multiplier (1.0 = normal, 2.0 = double XP)
`BaseXP`	Double	1.0	Base XP multiplier for mob kills (used in XP formula)
`LevelBaseXP`	Double	150.0	Base value for level XP requirement formula
`LevelOffset`	Double	0.0	Offset for level XP requirement formula
`EnableHUD`	Boolean	true	Enable or disable HUD (fix HUD crashes)
`Debug`	Boolean	false	Enable debug logging
`ResetLevelOnDeath`	Boolean	false	Reset player level to 1 on death (hardcore mode)
`BlacklistedEntities`	String	`""`	Comma-separated entity type IDs (e.g. `Bear_Grizzly`) that give no XP and no level display when killed or looked at
`EnablePVPXp`	Boolean	false	If `true`, killing a player awards XP. If `false`, no XP from PvP kills
`DifficultyPreset`	String	”normal”	`"easy"`, `"normal"`, `"hard"`, or `"extreme"`
`EnableMonsterLevelScale`	Boolean	true	If `true` (default), monster level scaling is enabled (damage/HP per level, gap damage/defense, level-based XP). HP scaling is the primary toughness mechanic, so your damage stays consistent while higher-level mobs simply have bigger HP pools. If `false`, all monster level scaling is disabled and XP reverts to the old HP-based system (only mob max HP), while level display still works. See Difficulty Scaling.
`EnableGapLevelDefense`	Boolean	true	If `true`, level-gap defense applies (you deal less damage when underleveled). If `false`, gap defense is disabled - your damage to monsters is not reduced by level gap, letting HP scaling alone handle the toughness while your stat upgrades feel more impactful. See Difficulty Scaling.
`EnableGapLevelDamageToPlayer`	Boolean	true	If `true`, level-gap damage applies (monsters deal extra damage when above your level). If `false`, gap damage to player is disabled - monsters do not get bonus damage from level gap. See Difficulty Scaling.
`EnableGapLevelXpReducer`	Boolean	true	If `true`, XP is reduced when you are underleveled (monster level above yours). If `false`, no XP reduction for being underleveled - you get full XP from higher-level monsters. See Formulas level-difference table and Difficulty Scaling.
`EnablePlayerLevelNameplate`	Boolean	true	If `true` (default), player nameplates show level (e.g. “Username [Lvl. X]”). If `false`, player nameplates are not modified and show the default name only.
`EnableNotification`	Boolean	true	If `true` (default), all notifications are sent (XP gain, level up, stat points earned, death penalty, zone warnings, entity killed). If `false`, no notifications are sent.
`EnableCurrentZoneHudDisplay`	Boolean	true	If `true` (default), HUD shows level plus current zone/biome (e.g. “Lvl 5	Zone 1 Emerald Grove”). If `false`, HUD shows only level and XP progress bar.
`EnableBlockXP`	Boolean	true	If `true` (default), XP is awarded for breaking mining blocks (ore/mineral) and woodcutting blocks (log/tree). If `false`, no XP is awarded for block breaking.
`BlockXPBaseMining`	Double	5.0	Base XP awarded per mining block (ore/mineral). Final XP = base × playerScale × zoneMultiplier × RateExp.
`BlockXPBaseWood`	Double	3.0	Base XP awarded per woodcutting block (log/tree). Final XP = base × playerScale × zoneMultiplier × RateExp.
`BlockXPPlayerLevelFactor`	Double	0.1	Player level factor for block XP scaling. PlayerScale = 1.0 + (playerLevel - 1) × this value (no cap). Higher = more XP per block at high levels.

XP and Leveling

0.2.0 note: XP from mobs is based on monster level and level difference. RateExp and BaseXP still apply as multipliers. See Formulas for the complete math.

XP Rate Multiplier

RateExp - Global XP multiplier applied to all XP gains
- 1.0 = normal XP
- 2.0 = double XP
- 3.0 = triple XP (default)

Level Requirements

Level XP requirements use this formula:

XP_required = LevelBaseXP × level^2.5 + LevelOffset   (level ≥ 2)
XP_required(1) = 0

LevelBaseXP - Base multiplier for the level curve (exponent 2.5; default: 150.0)
LevelOffset - Added to total XP per level.

See Formulas for examples and progression tables.

Difficulty Scaling

0.2.0 changes: Difficulty scaling settings are now in the main config file. Difficulty scaling is always enabled and controlled via the DifficultyPreset setting.

Difficulty Presets

Preset	Monster→Player Dmg/Lvl	HP%/Lvl	Gap Dmg Mult	Gap Def Mult	Best For
EASY	+0.5%	+2%	×0.75	×0.75	New players
NORMAL	+1%	+3.25%	×1.0	×1.0	Default
HARD	+2%	+4.5%	×1.25	×1.25	Experienced
EXTREME	+4%	+6.5%	×1.5	×1.5	Hardcore

See Difficulty Scaling for complete details on monster damage, HP scaling, and level-gap mechanics.

Scaling Toggles

Fine-tune difficulty with these toggles:

EnableMonsterLevelScale - Master toggle for all level-based scaling (damage, HP, XP)
EnableGapLevelDefense - Toggle level-gap defense penalty (you → monster when underleveled)
EnableGapLevelDamageToPlayer - Toggle level-gap damage bonus (monster → you when underleveled)
EnableGapLevelXpReducer - Toggle XP reduction when fighting higher-level monsters

Death Penalty

Optional hardcore mode that resets progress on death:

ResetLevelOnDeath: true - Reset to level 1, lose all XP, clear stat allocations
ResetLevelOnDeath: false (default) - Keep level and stats on death

Entity Blacklist

Exclude specific entities from giving XP and showing level displays:

{
  "BlacklistedEntities": "Bear_Grizzly,Wolf_Alpha,Sheep"
}

Blacklisted entities:

Give no XP when killed
Show no level display when looked at
Are comma-separated entity type IDs

PvP XP

Control whether player kills award experience:

EnablePVPXp: true - Killing players awards XP
EnablePVPXp: false (default) - No XP from player kills

Block XP (Mining / Woodcutting)

0.2.3+: Earn XP from breaking blocks:

EnableBlockXP: true (default) - XP awarded for mining ore/mineral and woodcutting log/tree blocks
EnableBlockXP: false - No XP from block breaking

Base XP Values

BlockXPBaseMining (default 5.0) - Base XP per mining block (ore, mineral)
BlockXPBaseWood (default 3.0) - Base XP per woodcutting block (log, tree)
BlockXPPlayerLevelFactor (default 0.1) - How much block XP scales with player level. PlayerScale = 1.0 + (level - 1) × factor (no cap).

Which Blocks Give XP

Only specific block types give XP:

Category	Block ID contains	Examples	XP
Mining	`ore` or `mineral`	Iron_Ore, Diamond_Mineral	Yes
Woodcutting	`log` or `tree`	Oak_Log, Birch_Tree	Yes
(No XP)	`stone`, `rock`, `wood`, `plank`	Stone, Cobblestone, Oak_Plank	No

Note: Stone/rock/wood/plank blocks still benefit from Mining/Woodcutting stat speed bonus - they just don’t give XP.

Zone Bonus

Mining/woodcutting in higher-level zones gives more XP. Each zone has its own BlockXPZoneLevelFactor in Zone Config. See Formulas for the complete block XP formula.

Example Config (Default Values)

{
  "MaxLevel": 100,
  "RateExp": 3.0,
  "BaseXP": 1.0,
  "LevelBaseXP": 150.0,
  "LevelOffset": 0.0,
  "EnableHUD": true,
  "Debug": false,
  "ResetLevelOnDeath": false,
  "BlacklistedEntities": "",
  "EnablePVPXp": false,
  "DifficultyPreset": "normal",
  "EnableMonsterLevelScale": true,
  "EnableGapLevelDefense": true,
  "EnableGapLevelDamageToPlayer": true,
  "EnableGapLevelXpReducer": true,
  "EnablePlayerLevelNameplate": true,
  "EnableNotification": true,
  "EnableCurrentZoneHudDisplay": true,
  "EnableBlockXP": true,
  "BlockXPBaseMining": 5.0,
  "BlockXPBaseWood": 3.0,
  "BlockXPPlayerLevelFactor": 0.1
}

​Main Plugin Config

​Configuration Options

​XP and Leveling

​XP Rate Multiplier

​Level Requirements

​Difficulty Scaling

​Difficulty Presets

​Scaling Toggles

​Death Penalty

​Entity Blacklist

​PvP XP

​Block XP (Mining / Woodcutting)

​Base XP Values

​Which Blocks Give XP

​Zone Bonus

​Example Config (Default Values)

​See Also