> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rpgmobs.frotty27.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Welcome

> Introduction to RPGMobs for Hytale.

**RPGMobs** transforms the Hytale PvE experience by introducing a tiered elite system to standard NPCs. It bridges the gap between casual exploration and hardcore RPG progression, offering configurable challenges, rewards, and visual variety.

## Features

* **Tiered Difficulty:** 5 distinct power tiers (Common to Legendary) with scaling health and damage.
* **Dynamic Spawning:** Elites spawn naturally in the world based on zone difficulty or distance from spawn.
* **9 Combat Abilities:** Charge Leap, Heal Leap, Summon, Dodge Roll, Multi Slash (Short/Medium/Long), Enrage, and Volley  -  each with weapon-specific animations and per-mob-rule gating.
* **CAE Combat AI:** 4 combat styles (Disciplined, Berserker, Tactical, Chaotic) assignable per mob rule, with per-tier behavior escalation  -  shield guard, BackOff, health retreat, group observe, and flanking. Per-weapon attack chains with correct animations and sounds. Code-side reactive parry system.
* **RPG Itemization:** Category-based equipment system with rarity-weighted loot and loot templates linked to specific mob rules.
* **Visual Flair:** Rank-specific nameplates, size scaling, and entity effects.
* **In-Game Admin UI:** Full configuration panel accessible via `/rpgmobs config` with tree explorers, presets, and visual editors for every setting.
* **Per-World Overlays:** Customize RPGMobs behavior per world or instance template with the overlay system.
* **Developer API:** Event-driven API with 12 event types, a read-only query interface, and cancellable hooks for other mods to integrate with.

## Getting Started

1. **Install:** Place the mod JAR in your server's `mods` folder.
2. **Run:** Start the server once to generate the default configuration files in `%APPDATA%\Hytale\UserData\Saves\<save>\mods\RPGMobs`.
3. **Configure:** Adjust `spawning.yml` to set your preferred progression style, or use `/rpgmobs config` to open the in-game Admin UI.
4. **Play:** Explore the world. You will encounter Elite enemies distinguished by their nameplates and size.

## Navigation Guide

* **[General Mechanics](/general/mechanics):** Understand how tiers, scaling, combat AI, and progression work.
* **[Admin UI](/config/admin-ui):** Visual guide to the in-game configuration interface.
* **[File Configuration](/config/core):** Detailed YAML reference for server admins who prefer editing config files directly.
* **[API Overview](/api/overview):** Integration guide for mod developers who want to hook into RPGMobs events and data.
* **[Reference](/reference/commands):** Commands, permissions, and compatibility info.