RPG Leveling — Stats, Classes & Progression for Hytale

Turn Hytale into a real RPG. Experience and levels, monster scaling, zones, difficulty presets, and deep stat progression — plus 6 classes, 18 custom passives, and fully customizable classes so you can match any theme: fantasy, Star Wars, or your own RP server.

⚠️ Hytale Update 5 will bring breaking API changes. RPG Leveling below 0.3.6 is not compatible with that build — your game can crash. Upgrade to 0.3.6-pre.9.1 (current pre-release build targeting Hytale 0.5.0-pre.9.1), or wait for the stable release 0.3.6 when Update 5 is out. Mod developers: Update 5 brings a lot of server-side API changes — always back up your mods/ folder and your worlds before switching versions.

🆕 0.3.6 — Per-range XP-earned multipliers via the new XPCurveOverridesConfig.json (e.g. double XP at levels 50–79), built on Hytale 0.5.0-pre.9.1 (pre-release), level HUD migrated to Hytale's native HudManager (random kick / HUD layer collision bug is now definitively fixed; MultipleHUD no longer required), max-level HUD and Stats GUI now show total earned XP so the leaderboard at the cap ranks by what players actually grind, and lighter per-tick checks for 100+ players servers.

📖 Full documentation — Classes & passives, config, commands, instance/dungeon setup, API, translation. Check the docs first.

The server has built the new version of the mod (0.3.6).

🤝 Partner servers

Public Partner Hytale servers running RPG Leveling try the mod live in a real community before installing it on your own server.

IP: play.hylterium.fr

⚔️ Classes & full customization

6 classes (default set) — Heavy, Blunt, Edge, Fang, Archery, Arcane. Each has unique weapons, innate stat bonuses per tier, and passives that trigger on damage dealt, damage taken, or on kill.
18 custom passives — HighGuard, ThickSkin, Overkill, Impact, LastStand, DuelFocus, Riposte, LifeSteal, Backstab, and more. Add, remove, or swap passives per class; tune every value and percentage in JSON.
Fully customizable classes — Classes are templates. Override any class file: change name, icon, weapons, passives, and tier bonuses. No code required — edit JSON. Perfect for RP servers (medieval, Star Wars, cyberpunk, etc.).
Modded weapons — Register weapons from other mods in ClassesGlobalConfig.json (e.g. lightsaber, plasma rifle). Give a class damage bonuses for those weapons and rename the class in MessagesLanguageMapping — instant Jedi, bounty hunter, or custom archetype.
Tier system (T0 → T4) — Play a class to tier it up; each tier unlocks stronger innate bonuses and new passives. Bonuses scale with your player level, so switching class doesn’t waste progress.
New stats — Movement Speed and Mana Regen (allocatable). Arcane class makes mana matter for magical weapons in Hytale.

🎮 Core RPG: monster & player leveling

Monster leveling — Every mob has a level. XP from kills is based on monster level; higher-level monsters give more XP. Level-gap penalties keep progression balanced: fight at your level for best rewards. Monster damage and HP scale with level; difficulty presets (Easy / Normal / Hard / Extreme) shape how tough it feels.
Player leveling — Earn XP from kills, mining, and woodcutting. Level up to get stat points; spend them on Damage, Defense, Health, Stamina, Mana, Mining, Woodcutting, Movement Speed, Mana Regen, and more. Clear HUD (level, XP bar, zone), in-game stats GUI, and leaderboard.
6 zones — Emerald Grove, Howling Sands, Borea, Devastated Lands, Skylands, Poisonlands with different level ranges. HUD shows zone name and color (green = good match, orange/red = too hard). Instance Level Config for dungeons (e.g. Yung's HyDungeons).
Full control — Zone/entity overrides, boss levels, XP per kill, blacklists, PvP XP toggle. Public API for quest mods; database sync (H2, MySQL, PostgreSQL). Optional PartyPro for XP sharing.

Why use it?

Real progression — Monster-level XP and level-gap penalties keep you in content that matches your level. Difficulty presets and scaling out of the box.
Class identity — 6 classes, 18 passives, tier progression. Play a role; reward specialization.
Your server, your theme — Override classes and passives via JSON; support modded weapons; rename everything in MessagesLanguageMapping. Fantasy, Star Wars, or any RP — one mod, full flexibility.
Mod-friendly — API for XP and level checks; works with dungeon mods, PartyPro, MultipleHUD. No conflicts.

Documentation

📖 docs.rpg-leveling.zuxaw.com — Overview, Classes & passives, Passives config, Custom class guide, Commands, Configuration, Instance & Dungeon setup, Override for mods, Database Sync, API, PartyPro XP share.

Before you ask — Check the docs or Discord. Most answers are there.

Screenshots

level up

Monster level

Stats

Leaderboard

commands

Features

Classes & passives

6 classes — Heavy, Blunt, Edge, Fang, Archery, Arcane. Each with dedicated weapons, innate bonuses (Health, Stamina, Defense, Movement Speed, Mana Regen, etc.) and 3 passives. Tier up (T0→T4) by playing; stronger bonuses and new passives per tier.
18 passives — Damage when high HP, heal when hit (low HP), on-kill speed buff, stun chance, last stand, duel focus, riposte, lifesteal, backstab, and more. Fully configurable per tier (percentages, thresholds, durations, cooldowns).
Full customization — Override class JSON: Id, Icon, Weapons, Tiers (Innate + Dmg per weapon), Passives. Add weapon kinds for modded weapons; rename classes and passives in MessagesLanguageMapping. No new code — JSON only. Suits any RP (Star Wars, medieval, custom).

Leveling & XP

Monster-level XP — XP from kills based on monster level. Same-level or ±5 = best XP; much easier/harder = penalties. 6 zones with level ranges; HUD zone + color.
Mining & woodcutting XP — Break ore/mineral and wood blocks for XP. Scales with level and zone.
Level-difference multipliers — Content at your level rewards the most; trivial or overlevel content is discouraged.

Difficulty & combat

Difficulty scaling — Monster damage and HP scale with level. Level-gap penalties when underleveled (monsters hit harder, you deal less). EASY/NORMAL/HARD/EXTREME presets in config.
Config toggles — Enable/disable gap defense, gap damage to player, monster scale, underleveled XP reduction.

Stats

Combat — Damage, Defense (diminishing, max 80% reduction). Movement Speed, Mana Regen.
Gathering — Mining (ore/stone), Woodcutting (wood). Survival — Health, Stamina, Mana, Ammo, Oxygen. Stamina tuning — StaminaRegenSpeed, StaminaConsumption.
Configurable — Max points and effect per point per stat in StatsLevelConfig.json. Blacklist stats to hide them.

Content & overrides

ZoneLevelConfig — Entity overrides: fixed level, exact XP per kill, disable scaling per entity. Instance Level Config — Level range and overrides per instance/dungeon (dungeon mods).
Entity blacklist — Exclude NPCs/roles from leveling (e.g. Citizen mod).

HUD & GUI

HUD — Level, XP bar, zone name, zone color. GUI — /lvl gui: allocate stats, leaderboard (top 100). Nameplates — Player level, monster level on look.
Optional — Death penalty (reset level), PvP XP toggle. MultipleHUD for HUD compatibility; EnableHUD: false to disable.

Admin & multiplayer

Commands — /lvl setlevel, /lvl setpoints, /lvl addxp, /lvl resetstats (online + offline). /lvl resetrewards / /lvl resetrewardsall to clear claimed level rewards only. /lvl resetall for full reset of all players. Leaderboard — Top 100, includes offline. Permissions — /lvl gui and /lvl info are open to everyone; /classes and admin commands use rpgleveling.command.* nodes (see docs); grant rpgleveling.command.* (or individual nodes) to staff.

Database & modders

Database sync — H2, MySQL, MariaDB, PostgreSQL. One-way: game → DB. Public API — Add XP, listen for level-up, get player level. PartyPro — XP share in party. Translation — MessagesLanguageMapping_<lang>.json files in the mod's languages/ subfolder. Drop a new file (e.g. MessagesLanguageMapping_french.json) to make a language available; players pick it from the Settings tab in the Stats GUI. New keys are auto-merged in English; existing translations are preserved. The legacy single-file mapping (MessagesLanguageMapping.json) is migrated to languages/MessagesLanguageMapping_english.json automatically on first run via the file-migration system.

Dependencies

None required — runs standalone.
MultipleHUD (optional) — other HUD mods alongside level HUD.
PartyPro (optional) — XP sharing in a party.

Commands

Command	Description
`/lvl gui`	Open stats & class GUI
`/lvl info`	Show stats, commands, help
`/lvl setlevel <player> <level>`	(Admin) Set player level (online & offline)
`/lvl setpoints <player> <points>`	(Admin) Set available stat points (online & offline)
`/lvl addxp <player> <xp>`	(Admin) Add XP to a player
`/lvl resetstats <player>`	(Admin) Reset allocated stats (online & offline)
`/lvl resetrewards <player>`	(Admin) Clear claimed level rewards (online & offline)
`/lvl resetrewardsall`	(Admin) Clear claimed level rewards for all players
`/lvl resetall`	(Admin) Reset level and stats for all players

/lvl gui / /lvl info: no permission. /classes and admin commands: rpgleveling.command.* (see full reference). 📖 Full command reference

RPG Leveling v0.3.6 · Zuxaw

If you need a server, you can support me by using my code ZUXAW — click the banners below:

RPG Leveling And Stats/Skills