Levels

Every mob NMEntities spawns carries a level. It defaults to 1 and is recorded on the entity, so it survives restarts and unloaded chunks.

Levels are recorded and readable, but nothing scales stats by them yet. Per-level health and damage formulas are their own feature. Configs written against levels keep working, and an addon can do its own scaling from the value today.

Where a level comes from

Source	How
Spawners	`spawn.level` (also `level`, `moblevel`) on the spawner.
Natural spawn rules	`level` on the rule.
Anything else	`1` — `/nme spawn`, the menu, eggs, the `summon` mechanic, the API.

Scaling by distance

A spawner with world-scaling: true sets the level from how far out it is instead of a fixed number — the further from world spawn, the higher the level.

  spawn:
    world-scaling: true

Tuned server-wide in config.yml:

spawner:
  world-scaling:
    blocks-per-level: 250   # blocks from world spawn worth one extra level
    max-level: 20           # ceiling, however far out the spawner is

A spawner 1,400 blocks out with the defaults spawns level 6 mobs.

Reading a level

In any effect text — messages, titles, setname, command:

- actionbar{message=&7Level <caster.level> <caster.name>} +onSpawn @playersRadius[16]
- message{m=&cYou were killed by a level <caster.level>!} +onAttack @target

Placeholder	Resolves to
`<caster.level>`	the mob’s own level
`<target.level>`	the level of the entity the line is acting on

Both read 1 for anything that was not spawned with a level. From code, NMEntitiesAPI.spawners().levelOf(entity) returns the same value — see Spawners in the API section.

Getting Started

Mobs

Spawning

Commands

Effects

Models

Compatibility

NPCs

Configuration

API

Where a level comes from

Scaling by distance

Reading a level

​Where a level comes from

​Scaling by distance

​Reading a level

Where a level comes from

Scaling by distance

Reading a level