RPG Leveling And Stats/Skills

[0.2.4] - 2026-02-07

✨ Added

• 🎁 Level Rewards — New config LevelRewardsConfig.json and Rewards tab in the Stats GUI (/lvl gui). Define per-level rewards: items (by Hytale ItemId and Quantity, added to player storage when claimed), reset points, and an optional command run when the reward is claimed. Players claim rewards once per level; status shows Unclaim or Claimed. Claim All appears when there is at least one claimable reward and claims every unclaimed reward the player has reached the level for. See Level Rewards Config.
  • ⚠️ Note: When a player uses Claim All, they can claim every reward from level 1 up to their current level in one go. It is recommended to check mods/Zuxaw_RPGLeveling/LevelRewardsConfig.json and ensure the default rewards are suitable for your server. You can edit the JSON to add rewards for specific levels, remove existing reward entries you don’t want, or change items and quantities — see the docs for the full format.
  • 📜 Reward commands — Each reward can have one command: Command (the command string) and optional CommandTitle (label in the Rewards tab); both default to empty and every reward entry includes them in the config. Use the {player} placeholder in Command; it is replaced with the claiming player's username. The plugin runs lvl setlevel {player} <level> directly (no server CommandManager required): level applies immediately, leaderboard is updated, and the server stays responsive. Other commands are run via the game's CommandManager when available. See Running a command when a reward is claimed in the Level Rewards Config docs.
• 🔄 Reset points system — Players can earn reset points from level rewards (LevelRewardsConfig.json: ResetPoints per reward). Reset points are displayed on the Stats page (e.g. x5 next to the RESET ALL button). The RESET ALL button (Stats GUI, bottom left) consumes 1 reset point and refunds all allocated stat points; Health/Stamina etc. are clamped to base. Button is disabled when the player has 0 reset points. Data is persisted (store, holder, and external database if enabled).
• 📜 /lvl setreset <player> <amount> — Admin command to set a player's reset points (e.g. /lvl setreset PlayerName 5). Works for online and offline players. OP only.
• 🔄 /lvl reload — Admin command to reload config files from disk without restarting the server. Reloads ZoneLevelConfig.json, InstanceLevelConfig.json, LevelRewardsConfig.json, and MessagesLanguageMapping.json. Hytale-managed configs (RPGLevelingConfig, StatsLevelConfig, DatabaseConfig) still require a server restart. OP only.
• 🌍 Disable plugin per world/instance — In InstanceLevelConfig.json, each instance can have DisableRPGLeveling (default: false). When true, the plugin has no effect in that world: no HUD, no level scaling, no XP, no stat modifiers (damage/defense/mining/stamina), no death reset. Use for minigame worlds or dungeons where you want vanilla gameplay. See How to disable the mod for a specific world/instance.

🔄 Changed

• ⚙️ Nameplate options — EnableNameplateLevelDisplay (default: true): when true, nameplates can show level; when false, no nameplate is modified (players or monsters). EnablePlayerLevelNameplate (default: true): when false, only player nameplates are left unchanged (monster level still shows when you look at them). Both options are in RPGLevelingConfig.json and are written on config save.
• 📜 /lvl setlevel — When setting a player's level, claimed rewards for levels above the new level are removed (so the player can reclaim those rewards when they reach the level again). Available stat points are set to (level - 1) × StatPointsPerLevel (correct total for the new level). Applies to both online and offline targets.
• 📜 /lvl resetall — Now also clears claimed reward levels and sets reset points to 0 for every affected player (online and offline). Level and stats reset unchanged (level 1, 0 XP, 0 stat points, no allocations).

🐛 Fixed

• ⛏️ Mining XP on cracked ore — Fixed: mining cracked ore (e.g. cracked ore variants) no longer grants XP. You will earn no more XP when mining cracked ore; only full ore/mineral/gem blocks award mining XP.
• 👁️ Nameplate level display — console warnings when entities or players disappear while the level nameplate is being updated (e.g. player disconnects or target despawns).
• 🗄️ Database connection / plugin startup — Fixed error on start when using external database sync (SLF4J).
• 🗄️ Database sync — External database now stays in sync with player data: sync runs on mod start and again after 10 seconds (so universe/players is available if the server loads it later). Offline admin commands (/lvl setlevel, /lvl setpoints, /lvl setreset) now push the updated player from disk to the DB. /lvl resetall triggers a full sync from disk so offline resets are reflected in the database.

💬 Developer note

Do not hesitate to reach out on my Discord server — especially if you have better ideas for default reward items in LevelRewardsConfig.json. The current defaults are placeholders; suggestions for more fitting or balanced items per level are welcome.