RPG Leveling And Stats/Skills

[0.2.0-beta-5] - 2026-01-30

✨ Added

• ⚙️ EnableGapLevelXpReducer — New config option in RPGLevelingConfig.json. When true (default), XP is reduced when you are underleveled (monster level above yours). When false, no XP reduction for being underleveled — you get full XP from higher-level monsters.

🔄 Changed

• 🔌 API: getPlayerLevelInfo(playerRef, store) — store now required — The overload getPlayerLevelInfo(PlayerRef) (no store) was removed. Level/XP resolution without a store can return wrong data when Holder is null (e.g. in HUD/system ticks). Call getPlayerLevelInfo(playerRef, store) from the world thread with your entity Store for correct data. The UUID overload getPlayerLevelInfo(playerUuid) remains for contexts where you only have a UUID (Holder-only; use the two-arg overload when you have a Store). Docs and API reference updated accordingly.
• 📊 Underleveled XP penalties — Reduced underleveled XP penalties when fighting monsters far above your level. Penalties are now 50% (26–30 levels higher), 60% (31–40), 70% (41–50), and 80% (51+), instead of the previous 95–99%. Fighting in zones above your level is still discouraged but less punishing. You can disable the underleveled XP reduction entirely via EnableGapLevelXpReducer: false in config.

🐛 Fixed

• 📌 Config version in RPGLevelingConfig and StatsLevelConfig — Fixed Version in RPGLevelingConfig.json and StatsLevelConfig.json staying outdated (e.g. 0.2.0-beta-2) while ZoneLevelConfig.json and MessagesLanguageMapping.json showed the correct plugin version. The Version encoder for both Hytale Config codecs now always writes the current plugin version on save, so the version in these config files stays up to date with the plugin (e.g. 0.2.0-beta-5).
• 🌍 Monster level when crossing zones — Fixed issue where luring a monster from a higher zone into a lower one (e.g. from zone 2 toward zone 1) caused its level and XP reward to drop to the new zone’s level. The monster’s level is now locked when it first appears, so you always get the correct XP and difficulty no matter where the fight ends.
• 👁️ Monster nameplate (level above monster) — Nameplate works now on pre-release without white screen or crash. It is displayed only when looking at a monster to improve performance on big servers.