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

# Stats Level Config

> StatsLevelConfig.json - Stat-related configuration options.

# Stats Level Config

**File:** `mods/Zuxaw_RPGLeveling/StatsLevelConfig.json`

All stat-related configuration options. Controls stat points per level, stat values, max allocations, and stat-specific mechanics.

***

## Configuration Options

| Option                                | Type    | Default | Description                                                               |
| ------------------------------------- | ------- | ------- | ------------------------------------------------------------------------- |
| `StatPointsPerLevel`                  | Integer | 3       | Stat points earned per level up                                           |
| `StatValuePerPoint`                   | Double  | 1.0     | Stat value increase per allocated point (base stats)                      |
| `DamageStatValuePerPoint`             | Double  | 1       | Multiplicative damage bonus per Damage point                              |
| `MiningStatValuePerPoint`             | Double  | 0.5     | Block damage multiplier per Mining point                                  |
| `WoodcuttingStatValuePerPoint`        | Double  | 0.5     | Block damage multiplier per Woodcutting point                             |
| `DefenseStatValuePerPoint`            | Double  | 1       | % damage reduction per Defense point; diminishing, max 80%                |
| `DefenseMaxReductionRatio`            | Double  | 0.8     | Maximum damage reduction ratio for Defense stat (80% = 80% max reduction) |
| `BlockDamageScalingDivisor`           | Double  | 25.0    | Divisor for Mining/Woodcutting block damage multiplier                    |
| `MiningPerTickDivisor`                | Double  | 100.0   | Divisor for per-tick block damage bonus                                   |
| `StaminaConsumptionReductionPerPoint` | Double  | 0.01    | Stamina consumption reduction per point (1% per point)                    |
| `StaminaRegenSpeedMultiplierPerPoint` | Double  | 0.18    | Stamina regen speed multiplier per point (18% per point)                  |
| `MaxStatPointsHealth`                 | Integer | 50      | Max allocatable to Health                                                 |
| `MaxStatPointsStamina`                | Integer | 50      | Max allocatable to Stamina                                                |
| `MaxStatPointsMana`                   | Integer | 50      | Max allocatable to Mana                                                   |
| `MaxStatPointsAmmo`                   | Integer | 4       | Max allocatable to Ammo                                                   |
| `MaxStatPointsOxygen`                 | Integer | 50      | Max allocatable to Oxygen                                                 |
| `MaxStatPointsStaminaRegenSpeed`      | Integer | 50      | Max allocatable to StaminaRegenSpeed                                      |
| `MaxStatPointsStaminaConsumption`     | Integer | 50      | Max allocatable to StaminaConsumption                                     |
| `MaxStatPointsDamage`                 | Integer | 50      | Max allocatable to Damage                                                 |
| `MaxStatPointsMining`                 | Integer | 50      | Max allocatable to Mining                                                 |
| `MaxStatPointsWoodcutting`            | Integer | 50      | Max allocatable to Woodcutting                                            |
| `MaxStatPointsDefense`                | Integer | 50      | Max allocatable to Defense                                                |
| `BlacklistedStats`                    | String  | `""`    | Comma-separated stat names to disable/hide                                |

***

## Stat Points

### Points Per Level

* `StatPointsPerLevel` - How many stat points you earn on each level up (default: 3)

**Total stat points at max level:**

```
Total = (MaxLevel - 1) × StatPointsPerLevel
```

**Example:** Max level 100, 3 points per level:

* Total: (100 - 1) × 3 = **297 stat points**

***

## Base Stats

Stats that directly increase resource pools use `StatValuePerPoint`:

* **Health** - Increases maximum health
* **Stamina** - Increases maximum stamina
* **Mana** - Increases maximum mana
* **Ammo** - Increases ammo capacity
* **Oxygen** - Increases oxygen (underwater)

**Value per point:** `StatValuePerPoint` (default: 1.0)

***

## Combat Stats

### Damage

Multiplicative damage bonus to NPCs:

* **Value per point:** `DamageStatValuePerPoint` (default: 1.0)
* Each point adds a flat damage bonus (e.g., +1 damage per point)

### Defense

Percentage damage reduction with diminishing returns:

* **Value per point:** `DefenseStatValuePerPoint` (default: 1.0)
* **Max reduction:** `DefenseMaxReductionRatio` (default: 0.8 = 80%)
* Uses diminishing returns formula to prevent overpowered defense

**Example:** With default settings, you can reach up to 80% damage reduction, but each additional point becomes less effective as you approach the cap.

***

## Gathering Stats

### Mining

Damage bonus to stone/ore blocks:

* **Value per point:** `MiningStatValuePerPoint` (default: 0.5)
* **Scaling divisor:** `BlockDamageScalingDivisor` (default: 25.0)
* **Per-tick divisor:** `MiningPerTickDivisor` (default: 100.0)

Higher Mining stat = faster stone/ore breaking.

### Woodcutting

Damage bonus to wood blocks:

* **Value per point:** `WoodcuttingStatValuePerPoint` (default: 0.5)
* Uses same scaling as Mining

Higher Woodcutting stat = faster tree/wood breaking.

***

## Stamina Stats

### Stamina Regen Speed

Increases how fast stamina regenerates:

* **Value per point:** `StaminaRegenSpeedMultiplierPerPoint` (default: 0.18 = 18% per point)

**Example:** 10 points = 180% faster stamina regen (2.8× normal speed)

### Stamina Consumption

Reduces stamina consumption when performing actions:

* **Value per point:** `StaminaConsumptionReductionPerPoint` (default: 0.01 = 1% per point)

**Example:** 25 points = 25% less stamina consumption

***

## Max Stat Allocations

Each stat has a maximum number of points you can allocate:

| Stat               | Default Max |
| ------------------ | ----------- |
| Health             | 50          |
| Stamina            | 50          |
| Mana               | 50          |
| Ammo               | 4           |
| Oxygen             | 50          |
| StaminaRegenSpeed  | 50          |
| StaminaConsumption | 50          |
| Damage             | 50          |
| Mining             | 50          |
| Woodcutting        | 50          |
| Defense            | 50          |

Set to `0` to effectively disable a stat, or increase for more specialization.

***

## Blacklisted Stats

Hide or disable specific stats from the GUI:

```json theme={null}
{
  "BlacklistedStats": "Ammo,Oxygen"
}
```

Blacklisted stats:

* Do **not** appear in the stats GUI
* Cannot be allocated
* Are comma-separated stat names

***

## Example Config (Default Values)

```json theme={null}
{
  "StatPointsPerLevel": 3,
  "StatValuePerPoint": 1.0,
  "DamageStatValuePerPoint": 1.0,
  "MiningStatValuePerPoint": 0.5,
  "WoodcuttingStatValuePerPoint": 0.5,
  "DefenseStatValuePerPoint": 1.0,
  "DefenseMaxReductionRatio": 0.8,
  "BlockDamageScalingDivisor": 25.0,
  "MiningPerTickDivisor": 100.0,
  "StaminaConsumptionReductionPerPoint": 0.01,
  "StaminaRegenSpeedMultiplierPerPoint": 0.18,
  "MaxStatPointsHealth": 50,
  "MaxStatPointsStamina": 50,
  "MaxStatPointsMana": 50,
  "MaxStatPointsAmmo": 4,
  "MaxStatPointsOxygen": 50,
  "MaxStatPointsStaminaRegenSpeed": 50,
  "MaxStatPointsStaminaConsumption": 50,
  "MaxStatPointsDamage": 50,
  "MaxStatPointsMining": 50,
  "MaxStatPointsWoodcutting": 50,
  "MaxStatPointsDefense": 50,
  "BlacklistedStats": ""
}
```

***

## See Also

* [Configuration Overview](config-overview) - All config files
* [Main Config](config-main) - Main plugin settings
* [Features](features) - Available stats and their effects