> For the complete documentation index, see [llms.txt](https://docs-nightbeam.gitbook.io/rpg-mob-leveling/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs-nightbeam.gitbook.io/rpg-mob-leveling/rpg-mob-leveling-system-2.0.1.md).

# RPG Mob Leveling System 2.0.1

Official technical documentation for NightBeam Studio's RPG Mob Leveling System.

## What it does

Assigns levels to hostile (and optionally other) mobs from spawn distance, world age, dimension clamps, nearby RPG Attribute System players, structures, and boss locks. Attributes use **named modifiers** (not permanent base-value corruption).

## Level formula

```
raw = baseLevel + (spawnDifference + playerContribution) * scaleFactor
raw = max(raw, structureMin)
level = min(round(raw), dimensionMax)
```

Full option tables: [Usage & Configuration](/rpg-mob-leveling/rpg-mob-leveling-system-usage-and-configuration.md).

## Quick links

* [Usage & Configuration](/rpg-mob-leveling/rpg-mob-leveling-system-usage-and-configuration.md) — every JSON key, default, and example
* [Commands](/rpg-mob-leveling/commands.md)
* [Public API](/rpg-mob-leveling/public-api.md)
* [Changelog](/rpg-mob-leveling/changelog.md)

## Platforms

| MC     | Loaders          |
| ------ | ---------------- |
| 1.21.1 | Fabric, NeoForge |
| 1.20.1 | Fabric, Forge    |

## Links

* Modrinth: [rpg-mob-leveling-system](https://modrinth.com/mod/rpg-mob-leveling-system)
* GitHub: [Ascendant-Mobs](https://github.com/MeherBenSalem/Ascendant-Mobs)