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 Release 6 (0.6).** Download 0.3.1 Always back up your mods/ folder and your worlds before a big Hytale update. Be careful with other mods: Hytale changed a lot of APIs for Release 6. Outdated mods can fail to load or crash the server. Only keep mods that are confirmed for 0.6, or disable the rest until their authors update.

🔧 0.3.11 - Class progress HUD, lock class change per world, harvest XP fixes. Hytale Release 6 (0.6) only. Install this file before 27 August.

🔧 0.3.10 - Harvest XP hotfixes (duplicate crop XP, dry soil blocks). Targets Hytale 0.5.6.

🆕 0.3.9 - The Harvest Moon Update - Crop harvest XP, new Harvest stat (double/triple yield), tame XP, optional Alec's Tamework companion XP bridge, built on Hytale 0.5.5.

📖 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.11).

🤝 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

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. BlacklistedXPBlocks in RPGLevelingConfig.json excludes specific block type IDs (default: Animal Husbandry feed troughs).
• 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). Block XP blacklist - BlacklistedXPBlocks for modded blocks that should not grant break XP.

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

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

RPG Leveling v0.3.11 · Zuxaw

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

| | |