RPG Leveling And Stats/Skills

[0.2.0] — 2026-01-31

Summary: 0.2.0 is a major update. Everything that changed between 0.1.10 and 0.2.0 is listed below. If you are upgrading from 0.1.10, you must manually migrate config from mods/RPGLeveling/ to mods/Zuxaw_RPGLeveling/ — see Configuration.

✨ Added

• 📌 Instance Level Config (InstanceLevelConfig.json) — Config file in mods/Zuxaw_RPGLeveling/ for instances and dungeons (where zone/biome are unknown). Define level ranges and per-entity overrides per instance. See Configuration → Instance Level Config.
• 🎮 Monster-level XP — XP from mob kills based on monster level (not max health). Higher-level monsters give more base XP.
• 📊 Level-difference multipliers — How close the monster's level is to yours affects XP. Same-level or ±5 = best; much easier or much harder = reduced XP.
• 🌍 Zones — 6 zones (Emerald Grove, Howling Sands, Borea, Devastated Lands, Skylands, Poisonlands) with different monster level ranges.
• 👁️ HUD zone display — HUD shows current zone name and color: green = good match (±25 levels), white = too easy (−26+), orange/red/purple = too hard (+26+).
• 🎲 Monster level variation — ±5 levels per monster in a zone for variety.
• ⚔️ Difficulty scaling — Monster damage and HP scale with level. Level-gap penalties when underleveled. See Difficulty Scaling.
• 🎚️ Difficulty presets — Easy, Normal, Hard, Extreme via difficultyPreset in RPGLevelingConfig.json.
• ⚙️ EnableGapLevelXpReducer — When true (default), XP is reduced when you are underleveled. When false, full XP from higher-level monsters.
• ⚙️ EnableGapLevelDefense — When true (default), level-gap defense applies. When false, gap defense disabled. See Difficulty Scaling.
• ⚙️ EnableGapLevelDamageToPlayer — When true (default), level-gap damage applies. When false, no bonus damage from gap. See Difficulty Scaling.
• ⚙️ EnableMonsterLevelScale — Master toggle. When true (default), damage/HP per level, gap damage/defense, level-based XP. When false, XP falls back to HP-based; level display still works.
• 📌 ZoneLevelConfig entity overrides — EntityOverrides in ZoneLevelConfig.json: force specific NPC type IDs to a fixed level, optional DisableLevelScaling, or precise XP per entity. See Configuration.
• 🔌 Public API for mod developers — Add XP, listen for level ups, get player level. See API.
• 👤 Offline player support for admin commands — /lvl setlevel, /lvl setpoints, /lvl resetstats work for offline players. Success shows (offline). /lvl resetall already supported both.
• 🔄 /lvl resetall — Reset level and stats for all players (online and offline). OP only.
• 👁️ Entity info display (player nameplates) — When you look at another player, nameplate shows "Username [Lvl. X]".
• 📋 BlacklistedEntities — Comma-separated entity type IDs. Blacklisted entities give no XP and no level display.
• ⚔️ EnablePVPXp — When true, killing a player awards XP; when false (default), no XP from PvP.
• ⚙️ Config Management — Configs in mods/Zuxaw_RPGLeveling/. Improved handling, backups on modify.

🔄 Changed

• 📁 Configuration file structure — Now 5 files in mods/Zuxaw_RPGLeveling/: RPGLevelingConfig.json, StatsLevelConfig.json, MessagesLanguageMapping.json, ZoneLevelConfig.json, InstanceLevelConfig.json. Stat-related settings moved to StatsLevelConfig.json. Messages file renamed from messages.json.
• 🔌 API: getPlayerLevelInfo(playerRef, store) — store now required — The overload without store was removed. Use getPlayerLevelInfo(playerRef, store) from the world thread. UUID overload unchanged.
• 📊 Underleveled XP penalties — Reduced. Now 50% (26–30 levels higher), 60% (31–40), 70% (41–50), 80% (51+). Disable via EnableGapLevelXpReducer: false.
• ⚔️ Gap defense (player → monster) — Reworked tiers. See Difficulty Scaling.
• 🔋 HP-based toughness — Monsters scale health with level. Higher-level mobs have more HP.
• 🌍 Early zone ranges — Default zone levels adjusted: Emerald Grove 1–15 (was 1–25), Howling Sands 15–50 (was 25–50).
• ⚠️ Manual migration — When updating from 0.1.9/0.1.10, manually migrate config from mods/RPGLeveling/ to mods/Zuxaw_RPGLeveling/. Plugin generates new defaults on first run.

🐛 Fixed

• 📌 Config version in RPGLevelingConfig and StatsLevelConfig — Version now always written on save so config files stay in sync with the plugin.
• 🌍 Monster level when crossing zones — Monster level is locked when it first appears; no drop when luring into a lower zone.
• 👁️ Monster nameplate — Works on pre-release without white screen/crash; shown only when looking at a monster for performance.
• 👁️ Monster nameplate not showing — Level is now shown using Nameplate component only; custom nameplates from other mods are not overwritten.
• 👁️ Monster nameplate level jump on death — Spawn-level cache cleared when entity is removed, so level stays correct on corpse until despawn.
• 📊 HUD and GUI XP bar sync — LevelingService persists PlayerLevelData to store after XP/level-up so HUD and GUI stay in sync.
• 👥 Nameplate collision with NPC/Pet mods — Level display detects existing nameplates and does not replace them.
• 📊 Level progression in /lvl gui — Progress bar and % now use same data source as HUD (API with store).
• ⚔️ XP rewards and level gap — Player level correctly read from entity store; XP and gap penalties use actual level.
• 🎯 Monster level caching — Monster levels cached on spawn in MobLevelData for consistent XP and display.
• 💰 Trivial XP penalty — Removed harsh 90% penalty for monsters 25+ levels below; low-level mobs now give full base XP (1.0x).
• 👁️ Player level on nameplate — Level read from Store; "Username [Lvl. X]" always shown for online players.
• 📋 Leaderboard player names — Username stripped from nameplate overlay so leaderboard shows real usernames.
• 👁️ Player level above head — Level read from entity Store instead of Holder.
• 📋 BlacklistedStats — Now respected in all systems. Blacklisted = hidden in GUI, no allocation, no effect.
• ⛏️ Mining crash — Fixed critical crash during mining.
• 🌍 Zone config biome remap — MissingZoneIds replaced with MissingBiomeIds in ZoneLevelConfig.json; biome→zone remapping reliable, no world crash.
• 💀 ResetLevelOnDeath — Now correctly detects deaths and resets level, XP, and stat allocations when enabled.

💙 Thank you

A huge thank you to everyone who supported the mod on Ko-fi — Benzitczo, Epickeks, aic — it's really encouraging and means a lot.

Thanks too to everyone who has downloaded the mod, tested the beta, shared feedback, and helped others on Discord. You're all part of this adventure, and that's what gives me the strength to keep going.