# RPG Leveling Plugin ## Docs - [API](https://docs.rpg-leveling.zuxaw.com/api.md): RPG Leveling API for external mods — add XP, listen for events, get player level, override config defaults. - [Changelog](https://docs.rpg-leveling.zuxaw.com/changelog.md): All notable changes to the RPG Leveling plugin since the first release. [0.3.4] — 2026-04-01 Mod version: 0.3.4 · Game version: Hytale 2026.03.26-89796e57b - [Chat placeholders (Essentials & more)](https://docs.rpg-leveling.zuxaw.com/chat-placeholders.md): Use %rpglevelling_*% tokens in server chat formats (e.g. Essentials) — level, XP, class. - [Arcane](https://docs.rpg-leveling.zuxaw.com/class-arcane.md): Arcane class — staff and wand, mana and spells. RP lore and gameplay. - [Archery](https://docs.rpg-leveling.zuxaw.com/class-archery.md): Archery class — bow and crossbow, one shot one chance. RP lore and gameplay. - [Blunt](https://docs.rpg-leveling.zuxaw.com/class-blunt.md): Blunt class — mace and club, durable DPS. RP lore and gameplay. - [Edge](https://docs.rpg-leveling.zuxaw.com/class-edge.md): Edge class — sword, longsword, spear; precision and duel focus. RP lore and gameplay. - [Fang](https://docs.rpg-leveling.zuxaw.com/class-fang.md): Fang class — dagger and claw, speed and cruelty. RP lore and gameplay. - [Heavy](https://docs.rpg-leveling.zuxaw.com/class-heavy.md): Heavy class — axe and battleaxe, tank and frontline DPS. RP lore and gameplay. - [Classes Configuration](https://docs.rpg-leveling.zuxaw.com/classes-config.md): How to configure RPG Leveling classes — JSON files, tiers, weapons, innate bonuses, and display names. - [Commands](https://docs.rpg-leveling.zuxaw.com/commands.md): Player and admin commands for the RPG Leveling plugin. - [Instance Level Config](https://docs.rpg-leveling.zuxaw.com/config-instances.md): InstanceLevelConfig.json - Instance/dungeon level mapping and entity overrides. - [Level Rewards Config](https://docs.rpg-leveling.zuxaw.com/config-level-rewards.md): LevelRewardsConfig.json — Level-based rewards (items and reset points). - [Main Plugin Config](https://docs.rpg-leveling.zuxaw.com/config-main.md): RPGLevelingConfig.json - Main plugin configuration options. - [Messages Language Mapping](https://docs.rpg-leveling.zuxaw.com/config-messages.md): MessagesLanguageMapping.json - Translation and localization strings. - [Configuration Overview](https://docs.rpg-leveling.zuxaw.com/config-overview.md): Overview of all configuration files for RPG Leveling plugin — main configs, stats, zones, instances, classes (0.3.4). - [Stats Level Config](https://docs.rpg-leveling.zuxaw.com/config-stats.md): StatsLevelConfig.json - Stat-related configuration options. - [Zone Level Config](https://docs.rpg-leveling.zuxaw.com/config-zones.md): ZoneLevelConfig.json - Zone level mapping and entity overrides. - [Database Sync](https://docs.rpg-leveling.zuxaw.com/database-sync.md): External database synchronization — sync player level, XP, and stats to MySQL, MariaDB, PostgreSQL, or H2. - [Dependencies](https://docs.rpg-leveling.zuxaw.com/dependencies.md): Required and optional dependencies for the RPG Leveling plugin. - [Difficulty Scaling](https://docs.rpg-leveling.zuxaw.com/difficulty-scaling.md): Monster damage, HP scaling, and level-gap penalties (0.2.0). - [Disable Mod for a Specific World/Instance](https://docs.rpg-leveling.zuxaw.com/disable-per-world.md): How to turn off RPG Leveling (HUD, XP, scaling, stats) for specific worlds or instances such as minigame dungeons. - [Instance & Dungeon Mod Setup](https://docs.rpg-leveling.zuxaw.com/dungeon-mod-setup.md): How to configure RPG Leveling to work with instance and dungeon mods — Instance Level Config with Skeleton Dungeon example. - [Features](https://docs.rpg-leveling.zuxaw.com/features.md): Core systems and available stats in the RPG Leveling plugin — leveling, zones, classes, passives (0.3.4). - [Mathematical Formulas](https://docs.rpg-leveling.zuxaw.com/formulas.md): Monster-level XP, level-difference multipliers, zones, and progression. - [How to Create a Custom Class](https://docs.rpg-leveling.zuxaw.com/guide-custom-class.md): Step-by-step guide to overriding an existing class (e.g. Jedi with lightsaber) in RPG Leveling. - [Add Modded Weapons to a Class](https://docs.rpg-leveling.zuxaw.com/guide-modded-weapons-class.md): Step-by-step guide to give a class damage and effect bonuses when using weapons from another mod (e.g. lightsaber, plasma rifle). - [HUD Crash Fix](https://docs.rpg-leveling.zuxaw.com/hud-crash.md): Troubleshooting — Fix HUD crashes in Hytale when using the RPG Leveling level progress bar. - [Introduction](https://docs.rpg-leveling.zuxaw.com/intro.md): RPG Leveling Stats/Skills Plugin for Hytale — XP, leveling, zones, and stat allocation. - [Level display in chat formatting (Essentials Plus)](https://docs.rpg-leveling.zuxaw.com/level-display-chat-formatting.md): Show player level (and class) in Essentials Plus chat — config.json, chat.groups, %rpglevelling_*% with {player} and {message}. - [Connect docs to AI (MCP)](https://docs.rpg-leveling.zuxaw.com/mcp-info.md): Use Mintlify’s hosted MCP server to search this documentation from Cursor, Claude Code, OpenAI Codex, or Claude on the web. - [Override entity xp and level](https://docs.rpg-leveling.zuxaw.com/override-for-mod.md): How to override level and XP for entities from a specific mod — ZoneLevelConfig and InstanceLevelConfig entity overrides. - [Overview](https://docs.rpg-leveling.zuxaw.com/overview.md): Everything the RPG Leveling plugin adds — XP, zones, difficulty scaling, stats, classes, passives (0.3.4), HUD, GUI, leaderboards, instances, API. - [Share XP with Teammates](https://docs.rpg-leveling.zuxaw.com/party-xp-share.md): Share XP among party members with PartyPro — level display, configurable multipliers, max share distance. - [Passives Configuration](https://docs.rpg-leveling.zuxaw.com/passives-config.md): How to configure RPG Leveling passives — PassivesConfig.json, tiers, triggers, and display names. - [Progression System](https://docs.rpg-leveling.zuxaw.com/progression.md): XP gain, leveling, zones, stat points, and death penalty (0.2.0). - [Reset Stats via NPC](https://docs.rpg-leveling.zuxaw.com/reset-stats-npc.md): Let players reset their stat points through an NPC using the NPC Dialog mod — optional item cost (e.g. Essence of Void) with the NPC Quests addon. - [Roadmap](https://docs.rpg-leveling.zuxaw.com/roadmap.md): Planned features and recent updates for the RPG Leveling plugin (0.2.0). - [Translation System](https://docs.rpg-leveling.zuxaw.com/translation.md): How to translate and localize the RPG Leveling plugin. - [Config After an Update](https://docs.rpg-leveling.zuxaw.com/troubleshooting-config.md): What happens to your config when you update the mod, and what to do if something goes wrong. ## OpenAPI Specs - [openapi](https://docs.rpg-leveling.zuxaw.com/api-reference/openapi.json)