Skip to main content

​
Changelog

All notable changes to the RPG Leveling plugin. Format based on Keep a Changelog.

​
[0.1.9] — 2026-01-24

​
📖 Documentation

  • Full documentation live — We now have docs to help with config issues and give you maximum detail on the mod. Before asking a question (in comments or on Discord): please read the docs first. 90% of the time the answer is already there. I’m alone answering everyone, and it’s tough when people don’t take the time to read the basics — so check the docs, it’ll save us both time. 💙

​
🐛 Fixed

  • 🧩 /lvl gui crash — Fixed the /lvl gui command crash caused by Hytale’s latest update. This should also fix the /lvl gui crash for some of you who had it even before the Hytale update.

​
🔜 What’s next

  • v0.2.0 in progress — A massive rework of the mod is on the way. I’ve been working on it for several days and hope you’ll like it. Should arrive soon.

​
[0.1.8] — 2026-01-21

​
🐛 Fixed

  • 🧩 HUD/GUI compatibility — Opening /lvl gui no longer hides then re-shows the Level HUD. Toggling the HUD caused full HUD re-renders (including other HUD mods) and could crash/disconnect some users.

​
⚡ Performance

  • 🐲 Monster kills / combat — Reduced lag when mobs die by simplifying the kill-handling flow and removing heavy/spammy debug output during fights.
  • 🏆 Leaderboard — Opening the leaderboard is much smoother thanks to caching + background refresh; also updates instantly after admin /lvl setlevel.
  • 🪓 Mining & woodcutting — Improved block-hit performance by avoiding repeated expensive lookups on every hit.
  • 🧩 HUD — Reduced unnecessary HUD work with smart updating + throttling to keep things stable on busy servers.
  • 📝 Logging — Removed non-essential / laggy logs and enforced using DebugLogger everywhere.

​
[0.1.7] — 2026-01-20

​
🔄 Changed

  • 🎯 Complete HUD Management Rework — Completely redesigned HUD system architecture for maximum compatibility.
  • ⚔️ Damage stat balance (low-damage weapons) — Rebalanced Damage stat scaling to be fairer for low base-damage weapons (e.g. daggers) while keeping high-damage weapons in check (hybrid scaling instead of pure % scaling).

​
✨ Added

  • 🧭 Wayfinder Compatibility — Full compatibility with Wayfinder mod by Alexr03.
    • ⚠️ Important: Wayfinder and EyeSpy are NOT compatible with each other.

​
⚠️ Other

  • ⚠️ Performance Warning — EyeSpy can cause performance issues on servers with multiple HUD mods installed. EyeSpy forces all HUD mods/plugins to re-render, which can lead to significant lag on busy servers. They are working on it.

​
⚡ Performance

  • 🖥️ Server-side performance improvements — Massive optimizations to reduce lag spikes during combat and on busy servers.
  • 🚀 HUD Performance Improvements — Massive performance optimizations for HUD system (credit to Alexr03, creator of Wayfinder).

​
💡 Developer Notes

  • Thanks to Alexr03 (creator of Wayfinder) for the inspiration and insights that led to the HUD performance improvements.

​
[0.1.6] — 2026-01-20

​
🔄 Changed

  • 📊 BaseXP default — Changed default from 10.0 to 3 for more balanced XP gain from mob kills.
  • ⚔️ Damage stat — Replaced flat damage bonus with a multiplicative formula to be less cheated.
  • 🛡️ Defense stat — Replaced flat reduction with percentage-based, diminishing returns (e.g. 50 pts, 1.0 → ~40% reduction; always at least 20% of damage gets through).
  • 📈 StatPointsPerLevel default — Changed default from 5 to 3 stat points per level up.

​
🐛 Fixed

  • 🏆 Leaderboard — Leaderboard was showing and sorting by XP on the current level only (e.g. 200/450). It now shows and sorts by total XP earned since the beginning (cumulative).
  • 📜 AddXP command — /lvl addxp <player> <xp> was crashing with Assert not in thread!.

​
✨ Added

  • 💀 Death Penalty System — New configurable feature that resets player level to 1 upon death.
    • Disabled by default — Set ResetLevelOnDeath: true in config to enable.
    • When enabled, players who die will: level reset to 1, lose all XP, have all stat allocations cleared, available stat points reset to 0.
    • Prominent death notification shown when reset occurs.
    • Configuration: "ResetLevelOnDeath": false is added automatically to RPGLevelingConfig.json on next plugin load.

​
💬 How to Enable Death Penalty

  1. Open mods/RPGLeveling/RPGLevelingConfig.json
  2. Find "ResetLevelOnDeath" (added automatically if missing)
  3. Change false to true
  4. Restart the server or reload the plugin

​
[0.1.5] — 2026-01-19

​
✨ Added

  • 🌍 Translation Support — The plugin now supports multiple languages! Server messages, notifications, and GUI elements can be translated.
    • Fully customizable via messages.json at mods/RPGLeveling/messages.json
    • Easy to create and share community translations
    • English included by default
    • Translation file is automatically generated on first server start
    • See Translation for the full guide

​
💬 Community Note

Don’t worry if you’re one of those people who break into a cold sweat at the mere thought of speaking English — now you can panic in your native language instead! 😅

​
[0.1.4] — 2026-01-19

​
✨ Added

  • 🏆 Leaderboard System — New leaderboard page in the GUI showing all players (including offline) ranked by level and XP.
    • Top 100 players with rank, username, level, and XP
    • Highlights your own position
    • Special colors for top 3 (Gold, Silver, Bronze)
  • 🎨 Navigation System — Completely redesigned GUI with modern sidebar navigation.
    • Sidebar with “Stats Management” and “Leaderboard” tabs
    • Active tab highlighting, smooth tab switching
  • 🐛 Debug Configuration — New Debug config option.
    • Debug: false (default) — clean console, no GUI/leaderboard spam
    • Debug: true — detailed debug logging for troubleshooting
    • Automatically added to existing config on server restart

​
🐛 Fixed

  • 📝 Console Spam — Fixed excessive logging from GUI and leaderboard. All debug logs now respect the Debug config.
  • 👁️ HUD Visibility — Level progress HUD no longer stays visible when opening Stats GUI; HUD hides/shows correctly with improved state management.

​
[0.1.3] — 2026-01-18

​
🐛 Fixed

  • 🛡️ Defense stat — Defense could reduce damage to 0 at high points. Now caps at 80% reduction; at least 20% of damage always gets through.
  • ⚔️ Damage stat — DamageStatValuePerPoint and DefenseStatValuePerPoint now load correctly from config at startup (workaround for Hytale Config). Default for both: 1.

​
🔄 Changed

  • 📋 BlacklistedStats default — No stats blacklisted by default. Default is "" instead of "StaminaRegenDelay".
  • 🛡️ DefenseStatValuePerPoint default — Raised from 0.5 to 1.
  • ⚙️ Default config — Full default RPGLevelingConfig.json documented in MODINFO (Configuration section).

​
[0.1.2] — 2026-01-17

​
🐛 Fixed

  • ⚙️ MaxStatPoints Params — Max stat point configuration now works correctly. All limits are properly applied and enforced.
  • 🔫 Ammo Stat — Fixed ammo stat functionality; players can properly allocate points to increase ammo capacity.

​
🔄 Changed

  • ⚡ Stamina System Rework — Replaced StaminaRegenDelay with two stats:
    • StaminaRegenSpeed — How fast stamina regenerates
    • StaminaConsumption — How much stamina is consumed during activities
  • 🌍 Exploration Balance — New stamina stats make exploration more engaging and balanced.
  • 📝 BlacklistedStats Configuration — Fully modifiable in config; admins can customize which stats are hidden.
  • ⚙️ Default Configuration Values — Updated: MaxStatPointsAmmo 50→4, new MaxStatPointsStaminaRegenSpeed 50, MaxStatPointsStaminaConsumption 50, BlacklistedStats → “StaminaRegenDelay” only.

​
🗑️ Removed

  • ✨ MagicCharges Stat — Removed for now due to bugs. May return in a future update.

​
[0.1.1] — 2026-01-17

​
🐛 Fixed

  • 🪵 Woodcutting/Mining Stat Separation — Woodcutting no longer affected mining blocks and vice versa. Mining and woodcutting are now properly separated.
  • ⚖️ Damage Calculation Formula — Reworked from flat addition to percentage-based multiplier: damage = baseDamage * (1.0 + statLevel * statValuePerPoint / 25).
  • 📊 Stat Scaling Balance — Adjusted so blocks don’t break too easily at low levels; level 50 with 50 woodcutting can break trees in 1–2 hits.
  • 🔢 Zero Stats Handling — Zero points in a stat has no negative effect; base performance without penalties.

​
🔄 Changed

  • 📐 Mining/Woodcutting Calculation — Switched to percentage-based multipliers instead of flat damage addition.

​
[0.1.0] — 2026-01-17

​
✨ Added

  • ⚔️ Damage Skill — Increases damage dealt to NPCs.
  • 🛡️ Defense Skill — Reduces damage taken from NPCs/entities.
  • 🪨 Mining Skill — Increases damage to stone and ore blocks; mine faster.
  • 🪵 Woodcutting Skill — Increases damage to wood blocks; chop trees faster.
  • ⚙️ Maximum Stat Points Configuration — Per-stat limits (MaxStatPointsHealth, Stamina, Mana, Ammo, Oxygen, StaminaRegenDelay, MagicCharges, Immunity, Damage, Mining, Woodcutting, Defense). Default: 50 per stat.
  • 🚫 BlacklistedStats Configuration — BlacklistedStats option (comma-separated) to blacklist specific stats. Default: Ammo, Immunity, MagicCharges, StaminaRegenDelay.

​
🔄 Changed

  • ⚡ HUD Performance Optimization — LevelProgress HUD reworked to use Hytale’s native CustomUIHud; better performance and stability.
  • 🎨 UI Assets Rework — All UI assets updated for improved visuals and consistency.

​
🐛 Fixed

  • 📝 Log Error Fix — Fixed spam log errors on server start when players didn’t have levelup data yet; proper initialization for new players.

​
[0.0.3] — 2026-01-16

​
🐛 Fixed

  • 🚨 Critical HUD crash fix — Fixed critical HUD crashes with incremental updates, removed immediate updates, added proper change detection.

​
✨ Added

  • 👁️ EnableHUD configuration option — Admins can disable the HUD display if desired.

​
🔄 Changed

  • ⚡ Optimized HUD updates — HUD updates only when data actually changes; fewer unnecessary updates, better performance.

​
[0.0.2] — 2026-01-16

​
🔄 Changed

  • 🎨 HUD Reorganization — Level progress bar moved to center of screen, just above life and stamina bars for better visibility.
  • ⌨️ Command Prefix Rebranding — Rebranded from rpglvl to lvl for a shorter, cleaner command.

​
🐛 Fixed

  • 🟫 Dirt Block Recipe Bug — Removed unintended dirt block crafting recipe (10 dirt → 1 dirt in pocket crafting).
  • 🧩 CustomUI HUD Crashes — Fixed “CustomUI HUD” crashes during gameplay.
  • 📊 XP Progress Display Bug — Fixed HUD stuck at 0% XP progress; now shows actual XP percentage.

​
📌 Notes

  • 🧩 MultipleHUD Requirement — When using other HUD mods, install MultipleHUD; otherwise the level progress HUD won’t be visible.

​
[0.0.1] — Initial Release

​
✨ Added

  • 🎉 Initial release of the RPG Leveling plugin
  • 📈 Basic leveling system
  • 👁️ HUD display for level and XP progress
  • ⚙️ Configuration system