> ## 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.

# Introduction

> RPG Leveling Stats/Skills Plugin for Hytale - XP, leveling, zones, and stat allocation.

<div align="center">
  <img src="https://mintcdn.com/zuxaw/8lkXVNUHfx3f-fkK/RPGLeveling_logo.png?fit=max&auto=format&n=8lkXVNUHfx3f-fkK&q=85&s=3b0695ed24a817f03333490595081d73" alt="RPG Leveling Logo" width="600" data-path="RPGLeveling_logo.png" />
</div>

# RPG Leveling Plugin

**Turn Hytale into a real RPG.** RPG Leveling adds experience, levels, zones, difficulty scaling, and stat-based progression. Monster-level XP and level-gap penalties keep progression balanced; difficulty presets (Easy / Normal / Hard / Extreme) shape how tough it feels. You earn stat points every level and spend them on **Damage**, **Mining**, **Woodcutting**, **Defense**, **Health**, **Stamina**, **Movement Speed**, **Mana Regen**, and more - with a clear HUD, in-game GUI, and leaderboard.

[![Download on CurseForge](https://img.shields.io/badge/Download_on_CurseForge-F16436?style=for-the-badge\&logo=curseforge\&logoColor=white)](https://www.curseforge.com/hytale/mods/rpg-leveling-and-stats)

[![X](https://img.shields.io/badge/X-000000?style=for-the-badge\&logo=x\&logoColor=white)](https://x.com/Zuxaw) [![Wiki/Docs](https://img.shields.io/badge/Wiki%2FDocs-4A90D9?style=for-the-badge\&logo=readthedocs\&logoColor=white)](https://docs.rpg-leveling.zuxaw.com/) [![KOFI](https://img.shields.io/badge/KOFI-FF5E5B?style=for-the-badge\&logo=ko-fi\&logoColor=white)](https://ko-fi.com/zuxaw) [![Discord](https://img.shields.io/badge/Discord-5865F2?style=for-the-badge\&logo=discord\&logoColor=white)](https://discord.gg/nGDQbjMtxY)

> **0.3.9 - The Harvest Moon Update** - Built on **Hytale 0.5.5**. **Crop harvest XP**, new **Harvest** stat (double/triple yield), **tame XP**, optional **Alec's Tamework** companion XP bridge. **0.3.8** added **`BlacklistedXPBlocks`**, faster level progress HUD on busy servers, nameplate console spam fixed, and leaderboard name fixes. **0.3.7** added external database sync and **`LevelCostMultiplier`**. **0.3.6** added per-range XP-earned multipliers and native **`HudManager`** HUD. **0.3.5** added **per-player language**; **0.3.3** modder APIs, chat placeholders, **`/lvl xprateboost`**, NameplateBuilder. **Class system** (**0.3.1**): **6 classes**, **18 passives**, zones, **Monster-level XP**, stats, instances.

## Quick Links

* **[Overview](overview)** - What the plugin adds (XP, levels, zones, stats, classes, passives, HUD, GUI, leaderboards)
* **[Connect docs to AI (MCP)](mcp-info)** - Use Mintlify’s hosted MCP to search these docs from Cursor / Claude / Codex (human-readable guide at **`/mcp-info`**; connector URL still ends with **`/mcp`**)
* **[Troubleshooting: HUD Crash Fix](hud-crash)** - Fix HUD crashes with MultipleHUD or `EnableHUD: false`
* **[Dependencies](dependencies)** - Optional MultipleHUD for HUD mod compatibility
* **[API](api)** - For modders: add XP, listen for events, get player level
* **[Database](database-sync)** - Sync player data to external database (H2, MySQL, MariaDB, PostgreSQL)
* **[Commands](commands)** - `/lvl gui`, `/lvl info`, admin commands
* **[Configuration](config-overview)** - Overview of all config files
  * **[Main Config](config-main)** - `RPGLevelingConfig.json` (XP rates, difficulty, toggles)
  * **[Stats Config](config-stats)** - `StatsLevelConfig.json` (stat points, values, limits)
  * **[Zone Config](config-zones)** - `ZoneLevelConfig.json` (zone levels, entity overrides)
  * **[Instance Config](config-instances)** - `InstanceLevelConfig.json` (dungeon levels, overrides)
  * **[Harvesting Config](config-harvesting)** - `HarvestingConfig.json` (crop harvest XP, tiers, cooldown) *0.3.9*
  * **[Messages Config](config-messages)** - `MessagesLanguageMapping.json` (translations)
* **[Classes configuration](classes-config)** - Class JSON, weapons, tiers, innate bonuses (0.3.6)
* **[Passives configuration](passives-config)** - PassivesConfig.json, triggers, tiered values (0.3.6)
* **[Custom class guide](guide-custom-class)** - Override a class (e.g. Jedi with lightsabers)
* **[Add modded weapons to a class](guide-modded-weapons-class)** - Give a class bonuses for weapons from other mods
* **[Instance & Dungeon mod setup](dungeon-mod-setup)** - Configure the mod to work with instance and dungeon mods (e.g. Skeleton Dungeon)
* **[Override entity xp and level](override-for-mod)** - Override level/XP for a mod’s entities (bosses, custom mobs)
* **[Formulas](formulas)** - Monster-level XP, level-difference multipliers, zones
* **[Difficulty Scaling](difficulty-scaling)** - Monster damage, HP, level-gap penalties
* **[Share XP with teammates](party-xp-share)** - PartyPro: XP share, level display, configurable multipliers and distance
* **[Level display in chat formatting (Essentials Plus)](level-display-chat-formatting)** - Show level and class in Essentials Plus `config.json` `chat.groups` (`%rpglevelling_*%` with `{player}` / `{message}`)

## Screenshots

| Level Up                                                                            | Monster Level                                                                            | Stats GUI                                                                     | Leaderboard                                                                         | Commands                                                                          |
| ----------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- |
| ![level up](https://media.forgecdn.net/attachments/1473/108/screenshot_3-1-png.png) | ![Monster level](https://media.forgecdn.net/attachments/1493/217/screenshot_7-1-png.png) | ![Stats](https://media.forgecdn.net/attachments/1477/59/screenshot_5-png.png) | ![Leaderboard](https://media.forgecdn.net/attachments/1477/60/screenshot_6-png.png) | ![commands](https://media.forgecdn.net/attachments/1470/570/screenshot_1-png.png) |

## Version

**v0.3.9** · Last updated 2026-06-16 · **Zuxaw**

|                                                                                                                                                     |                                                                                                                                                     |
| :-------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------: |
| [![image](https://media.forgecdn.net/attachments/description/1431645/description_7ca8c80c-e560-4fc0-94cf-5096cf99a6c4.png)](https://ns.games/zuxaw) | [![image](https://media.forgecdn.net/attachments/description/1431645/description_eb69bf4e-12da-4641-952c-a4acf589ceb2.png)](https://ns.games/zuxaw) |
