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

# Progression System

> XP gain, leveling, zones, stat points, and death penalty (0.2.0).

# Progression System

## Experience Points (XP)

In **0.2.0**, XP is based on:

1. **Monster level** - Higher-level monsters give more base XP
2. **Level difference** - How close the monster’s level is to yours. Same-level or ±5 gives the best XP; much easier or much harder content is penalized

**Best strategy:** Fight monsters within **±25 levels** of you, ideally **±5**. Stay in **green** zones on the HUD. See [Formulas](formulas) for the full math and [Overview](overview) for zones.

### Other XP sources (0.3.9)

| Source                      | How                                            | Config                                                                                           |
| --------------------------- | ---------------------------------------------- | ------------------------------------------------------------------------------------------------ |
| **Mining / woodcutting**    | Break eligible ore, stone, log, or wood blocks | `EnableBlockXP`, `BlockXPBaseMining`, `BlockXPBaseWood` in [RPGLevelingConfig.json](config-main) |
| **Crop harvest**            | Harvest mature crops (F key / sickle)          | [HarvestingConfig.json](config-harvesting)                                                       |
| **Tame**                    | Successfully tame a creature                   | `EnableTameXP`, `TameXpMultiplier` in [RPGLevelingConfig.json](config-main#tame-xp)              |
| **Commands / API / quests** | Admin or mod-granted XP                        | `/lvl addxp`, [Public API](api)                                                                  |

The **Harvest** stat does not change XP; it adds a chance for **double or triple crop yield** on harvest. See [Stats Level Config](config-stats).

## Leveling Up

When you have enough XP, you **level up**. Each level up:

* Awards **stat points** (configurable, default 5 per level)
* Resets XP to 0 (excess carries over)
* Updates the HUD
* Sends a level-up notification

## Zones and HUD Colors

The HUD shows your **current zone** and its **color**:

| Color                     | Meaning                 | XP       | Action                |
| ------------------------- | ----------------------- | -------- | --------------------- |
| **White**                 | Too easy (−26+ levels)  | 10%      | Move to a harder zone |
| **Green**                 | Good match (±25 levels) | 100–150% | **Stay here**         |
| **Orange / Red / Purple** | Too hard (+26+ levels)  | 1–5%     | Come back when higher |

**Pro tip:** If the zone name is **green**, you’re in the right place for the best XP.

***

## XP Reducer (Underleveled Penalty)

When the **monster is higher level than you** (you are underleveled), the plugin can **reduce the XP** you get - so fighting far above your level does not reward full XP. This is controlled by **`EnableGapLevelXpReducer`** in config.

**How it works:**

* **`EnableGapLevelXpReducer: true`** (default) - XP is reduced when you are underleveled. The bigger the level gap (monster above you), the harsher the penalty (see table below).
* **`EnableGapLevelXpReducer: false`** - No XP reduction for being underleveled. You always get **full base XP (1.0×)** from higher-level monsters, regardless of gap.

**Level difference** (monster level − your level) only affects XP when the monster is **above** your level. When the monster is at or below your level, the multiplier is unchanged (same-level bonus, slight reduction for trivial content, etc.). See [Formulas](formulas) for the full level-difference table.

### XP multiplier when underleveled (monster above you)

| Level gap (monster − you) | `EnableGapLevelXpReducer: true` | `EnableGapLevelXpReducer: false` |
| ------------------------- | ------------------------------- | -------------------------------- |
| **+1 to +5**              | 1.1× – 1.5× (challenge bonus)   | 1.0×                             |
| **+6 to +25**             | 1.0× (normal)                   | 1.0×                             |
| **+26 to +30**            | 0.5× (50% penalty)              | 1.0×                             |
| **+31 to +40**            | 0.4× (60% penalty)              | 1.0×                             |
| **+41 to +50**            | 0.3× (70% penalty)              | 1.0×                             |
| **+51+**                  | 0.2× (80% penalty)              | 1.0×                             |

**Example:** You are level 30, monster is level 60 (gap +30). With reducer **on**: you get 50% XP (0.5×). With reducer **off**: you get full XP (1.0×).

**Config:** `EnableGapLevelXpReducer` in `mods/Zuxaw_RPGLeveling/RPGLevelingConfig.json`. Default: `true`. See [Configuration](configuration) or [Difficulty Scaling](difficulty-scaling).

***

## Death Penalty (Optional)

Optional **death penalty** (same as 0.1.9):

* **Disabled by default** - Enable in config
* When enabled (`ResetLevelOnDeath: true`): level reset to **1**, lose all XP, clear stat allocations, reset available points
* Creates a **hardcore** experience

**To enable:** Set `"ResetLevelOnDeath": true` in `mods/Zuxaw_RPGLeveling/RPGLevelingConfig.json`, then restart the server.

## Stat Points

Stat points are earned on each level up. Allocate them via the GUI (`/lvl gui`) to any of the [available stats](features#available-stats). Allocated stats apply as **permanent modifiers**.

**Available points:** `(Current Level - 1) × StatPointsPerLevel`

**Example:** Level 10, 5 stat points per level → **(10 − 1) × 5 = 45** points

See [Formulas](formulas) for progression speed and stat totals at max level.