Documentation Index

Fetch the complete documentation index at: https://docs.rpg-leveling.zuxaw.com/llms.txt

Use this file to discover all available pages before exploring further.

​

Overview

Turn Hytale into a real RPG. RPG Leveling adds experience, levels, zones, difficulty scaling, and stat-based progression so every fight and every zone feels meaningful. 0.3.4 is the current Release 4 build (per-player level HUD hide, notification toggles, rpgleveling.command.*, timed XP boost end title, Placeholder API for chat formats). 0.3.3 added modder APIs, chat tokens, /lvl xprateboost, class cooldown, and HUD/stability fixes; 0.3.2 fixed mining/woodcutting world issues. A class system (from 0.3.1 onward) adds 6 classes, 18 passives, and full customization. One mod, full RPG feel.

---

​

Everything you can do

​

Classes & passives (0.3.4)

• 6 classes — Heavy, Blunt, Edge, Fang, Archery, Arcane. Each has its own weapons, innate stat bonuses per tier, and passives that trigger in combat (damage dealt, damage taken, on kill).
• 18 passives — HighGuard, ThickSkin, Overkill, LastStand, LifeSteal, Backstab, Riposte, ManaShield, and more. Unlock by tier (T0→T4); values scale with your class tier.
• Tier system — Play a class to tier it up; each tier unlocks stronger innate bonuses and new passives. Bonuses scale with your player level.
• Fully customizable — Classes are templates: override names, weapons, passives, and tier bonuses in JSON; add modded weapons (e.g. lightsabers); rename everything in MessagesLanguageMapping. See Classes configuration, Passives configuration, and Custom class guide.

​

Leveling & XP

• Monster-level XP — XP from mob kills is based on monster level (not max health). Higher-level monsters give more base XP.
• Level-difference multipliers — Monsters near your level = best XP; much easier or much harder = heavy penalties so the best strategy is content that matches you.
• 6 Zones — Emerald Grove, Howling Sands, Borea, Devastated Lands, Skylands, Poisonlands with different level ranges (default: Emerald Grove 1–15, Howling Sands 15–50, then higher zones).
• HUD zone display — Zone name + color: green = good match (±25 levels), white = too easy (−26+), orange/red/purple = too hard (+26+). You always know if you’re in the right place.
• Monster level variation — ±5 levels per monster in a zone for variety.

​

Difficulty & combat

• Difficulty scaling — Monster damage and HP scale with level. When you’re underleveled, level-gap penalties apply: monsters hit harder, you deal less. Gap defense uses EASY/NORMAL/HARD/EXTREME caps. See Difficulty Scaling.
• Difficulty presets — Easy, Normal, Hard, Extreme. One setting in mods/Zuxaw_RPGLeveling/RPGLevelingConfig.json shapes how punishing gaps are and how tough high-level mobs feel. Balanced progression out of the box.
• Config toggles — EnableGapLevelDefense, EnableGapLevelDamageToPlayer, EnableMonsterLevelScale, EnableGapLevelXpReducer to turn gap scaling or all monster scaling off. Full control without editing formulas.

​

Content & config

• ZoneLevelConfig entity overrides — Pin bosses or NPCs to a fixed level (e.g. 150), set exact XP per kill, or disable scaling per entity. See Override entity xp and level.
• Instance Level Config — Works with dungeon mods (e.g. Yung’s HyDungeons). Set level ranges per instance/dungeon so mobs and XP fit your server. See Instance & Dungeon mod setup.
• Config files — Main configs in mods/Zuxaw_RPGLeveling/: RPGLevelingConfig, StatsLevelConfig, ZoneLevelConfig, InstanceLevelConfig, LevelRewardsConfig, MessagesLanguageMapping. Class and passive configs in mods/Zuxaw_RPGLeveling/Classes/ (Class*.json, PassivesConfig.json, ClassesGlobalConfig.json). See Configuration, Classes config, Passives config.

​

Social & admin

• Nameplate level display — See “Username [Lvl. X]” on players and “Lvl. X” on monsters when you look at them. Disable with EnableNameplateLevelDisplay: false in the main config (see Main Plugin Config).
• PvP XP toggle — EnablePVPXp to enable or disable XP from player kills.
• Entity blacklist — BlacklistedEntities (no XP, no level display) and BlacklistedStats (hidden in GUI, no allocation, no effect in-game). Fully disable stats or mob types you don’t want.
• Offline admin commands — /lvl setlevel, /lvl setpoints, /lvl setreset, /lvl resetstats work for offline players (by name; data in universe/players/). /lvl resetrewards / /lvl resetrewardsall clear only claimed level reward flags so players can reclaim (items already received stay in inventory). /lvl resetall resets all (online + offline). See Commands.
• Reset points — Players can earn reset points from level rewards; the RESET ALL button in the Stats GUI refunds all allocated stat points, clears claimed rewards, and sets reset points to 0 (requires at least one reset point). Admins can set reset points with /lvl setreset <player> <amount>.

​

Modders & compatibility

• Public API — Other mods can add XP (e.g. quest rewards), listen for level-ups, get player level. Perfect for quest mods, custom bosses, or any mod that needs level/XP. See API.
• PartyPro — PartyPro shares XP in a party (configurable multipliers, max distance). See Share XP with teammates.
• Translation — Full localization via MessagesLanguageMapping.json. Class and passive names are configurable there too. See Translation.

---

​

All stats you can upgrade

You earn stat points every level up and spend them in /lvl gui. Each stat has a real effect in-game. You can specialize in combat, farming, or survival — or spread points for a hybrid build. Classes (0.3.4) add more identity via innate bonuses and passives.

​

Combat stats

​

Farming & gathering stats

​

Survival & resources

​

Movement & mana (0.3.4)

​

Stamina tuning

All stats have configurable max points and effect per point. You can blacklist stats you don’t want. See Configuration and Features.

---

​

Why progression feels good

The plugin keeps you in a level band that fits your character: Difficulty presets (Easy / Normal / Hard / Extreme) control how strong these effects are. You get balanced game progression without tuning every number yourself. You can disable underleveled XP reduction, gap defense, or gap damage in config if you want a different pace.

---

​

Core loop

1. Pick a class (0.3.4) — Choose Heavy, Blunt, Edge, Fang, Archery, or Arcane (or use a server-customized class). Play it to tier up and unlock passives.
2. Kill mobs — Gain XP (monster level + level difference).
3. Use the HUD — Green zone = best XP; white = too easy; orange/red = too hard.
4. Level up — Earn stat points.
5. Spend points — Improve Damage, Mining, Defense, Health, Movement Speed, Mana Regen, or any stat you want.
6. Open /lvl gui — Manage stats, switch class, check leaderboard.

See Features, Commands, Classes config, Passives config, Progression, and Formulas for more.