RPG Leveling And Stats/Skills

[0.3.1-pre] — 2026-03-25

Mod version: 0.3.1 · Game version: Hytale pre-release 2026.03.25-89796e57b

⚠️ Pre-release Compatibility Notice

This mod is only compatible with Hytale Pre-Release (Release 4 / Update 4).
It will NOT work on Hytale Classic Release.

• The current implementation relies on Release 4 server APIs that are not available in the Classic version.
• Once Hytale Release 4 is officially launched, the exact same codebase will be published as the stable release version of the mod.

🔄 Compatibility

• Hytale Release 4 (server) — Mining and woodcutting block bonuses target the current server APIs (block health module and chunk section resolution). Build against the Release 4 server JAR.

🔄 Changed

• Mining / woodcutting (API migration) — Per-tick block damage while targeting no longer uses removed BlockState / WorldChunk.getState; it now applies via BlockHealthChunk.damageBlock. Chunk refs use ChunkUtil.chunkCoordinate with ChunkStore.getChunkSectionReference so older SDK stubs without getChunkSectionReferenceAtBlock still compile. Swing-time multiplier via DamageBlockEvent is unchanged.

✨ Added

• Command /classes — Opens the RPG Leveling GUI directly on the Classes tab (same UI as /lvl gui). If the class system is disabled, shows a short error instead of opening the GUI.
• Command alias /level — Equivalent to /lvl for the full command tree (e.g. /level gui, /level info, admin subcommands). /lvl info also mentions /classes and /level.
• Life Steal — flat HP plus percent — The Life Steal passive now restores a fixed amount of HP per hit (HealFlat) in addition to a percentage of damage dealt (HealPercent). Bundled PassivesConfig is version 0.3.1; servers on older passives configs get migration 0.3.1 (flat values per tier, max 2 HP flat at higher tiers). Why: percent-only healing barely moved the needle on weak or low-damage weapons because the heal scaled off tiny hit values; adding flat healing keeps Life Steal meaningful on those weapons. The same 0.3.1 migration batch updates MessagesLanguageMapping.json (version bump + Life Steal template text) only when passives.lifesteal.template still equals the old default English line—custom or translated wording is not overwritten. New migration step option whenCurrentEquals documents this pattern in docs/config-migrations.md.
• Admin /lvl resetrewards <player> — Clears claimed level-reward flags for one player (online or offline) so they can reclaim from the Rewards GUI; does not remove items already received. /lvl resetrewardsall does the same for every player. Documented in Commands. Messages: commands.resetrewards.*, commands.resetrewardsall.*, and /lvl info lines cmd_resetrewards / cmd_resetrewardsall.
• EnablePassiveNotifications (RPGLevelingConfig.json) — When EnableNotification is true, set EnablePassiveNotifications to false to disable only class passive proc popups (heal, buff applied, passive damage line, Hunter's Mark proc, on-kill buffs such as Overkill). Level-up, XP, critical hit, entity killed, class tier-up subtitle, zone warnings, death penalty, and other non-passive notifications still follow EnableNotification only. Default: true. Documented in Main Plugin Config.

🐛 Fixed

• Level rewards & full inventory — Claiming from the Stats GUI Rewards tab no longer marks a level as claimed when the configured item stacks cannot fully fit in the player’s storage. A red chat message tells the player to free space and try again (gui.rewards.error_inventory_full in messages). Claim All still claims every reward that fits; if any level is skipped for lack of space, the same message is shown once. Rewards with only reset points and/or commands (no items) are unchanged.