plugins/NMEntities/config.yml. Everything here is re-read by /nme reload unless the option says otherwise.
Rendering
| Option | Default | What it does |
|---|---|---|
sight-trace | true | Only render a model when there is a clear line of sight to it. With this off, the two sight options below do nothing. |
max-sight | -1 | Blocks beyond which a model is never rendered. 0 or below = the server’s view distance. |
min-sight | 5 | Blocks within which a model is always rendered, skipping the line-of-sight check — so a model right next to you never flickers out. |
follow-mob-invisibility | true | A model on an invisible mob becomes invisible too. |
lerp-frame-time | 3 | Ticks between interpolation keyframes. Lower is smoother and more expensive. |
packet-bundling-size | 16 | Packets bundled before sending. 0 or below disables bundling. |
use-purpur-afk | true | Pause animations for AFK players, using Purpur’s API. |
Modules
| Option | Default | What it does |
|---|---|---|
module.model | true | General entity models. |
module.player-animation | true | Player-specific animations and models (limbs). |
Resource pack
| Option | Default | What it does |
|---|---|---|
pack.generate-modern-model | true | Models for Minecraft 1.21.4 and newer. |
pack.generate-legacy-model | true | Models for 1.21.3 and older. |
pack.use-obfuscation | true | Obfuscate model and texture names in the pack. |
pack-type | zip | zip or folder. |
build-folder-location | NMEntities/build | Where the pack is written, relative to plugins/. |
namespace | nmentities | Asset namespace — assets/nmentities/.... |
item | leather_horse_armor | The base item used for custom model data. |
item-namespace | bm_models | Namespace for custom model items. |
merge-with-external-resources | true | Merge the generated pack with other plugins’ packs. See Nexo & ItemsAdder. |
enable-strict-loading | false | Refuse to load a model with unsupported features, instead of loading it without them. |
indicator.progress_bar | true | Progress bar while the pack generates. |
Do not change
namespace, item-namespace or build-folder-location casually on a live server — they decide generated asset paths. Set them once.Threat and factions
| Option | Default | What it does |
|---|---|---|
threat.enabled | true | Off returns mobs to plain vanilla targeting. |
threat.retarget-interval | 20 | Ticks between retarget passes. Lower reacts faster to a taunt; higher is cheaper. |
threat.decay-per-second | 0.02 | Fraction of threat lost each second. 0 means it never fades. |
threat.forget-range | 32 | Blocks past which a mob forgets someone entirely. |
Spawners
Natural spawning
| Option | Default | What it does |
|---|---|---|
natural-spawn.enabled | true | Turn every spawn rule off at once. |
natural-spawn.check-interval | 100 | Ticks between passes. 100 = every five seconds. |
natural-spawn.min-distance | 24 | Closer than this and mobs would appear in someone’s face. |
natural-spawn.max-distance | 96 | Further and nobody would notice it happened. |
natural-spawn.attempts-per-player | 8 | Candidate points per player per pass — the whole cost of the system. |
natural-spawn.caps.max-per-chunk | 4 | Default cap for rules that do not name one. |
natural-spawn.caps.max-nearby | 0 | Default density cap. 0 = no ceiling. |
natural-spawn.caps.nearby-radius | 32 | Radius max-nearby measures over. |
natural-spawn.caps.max-per-world | 0 | Default world total. |
natural-spawn.caps.max-per-player | 0 | Default per-player total. |
NPCs
| Option | Default | What it does |
|---|---|---|
npc.look-interval | 1 | Ticks between head-turn updates. 2 is usually indistinguishable and halves the work. |
npc.behaviour-interval | 2 | Ticks between pathfinding updates. Can be noticeably higher than look-interval without looking laggy. |
npc.activation-range | 48 | Blocks from an NPC’s home a player must be within for it to tick at all. 0 ticks every NPC. |
Menu overlay
gui-overlay.* has its own page.
Player models
| Option | Default | What it does |
|---|---|---|
cancel-player-model-inventory | false | Block hotbar swaps while a player model or animation is active. |
player-hide-delay | 3 | Ticks before the original player entity is hidden after a model is applied. Minimum 1. |
default-mount-controller | walk | For mountable models: walk, fly, none (mountable, no steering) or invalid (not mountable). Anything else reads as walk. |
Debug and misc
| Option | Default | What it does |
|---|---|---|
debug.hitbox | false | Messages for hitbox creation and interaction. |
debug.exception | false | Full stack traces for handled exceptions. |
debug.pack | false | Messages for pack generation. |
debug.tracker | false | Messages for model tracker lifecycle. |
metrics | true | Anonymous bStats metrics. Leaving it on is what tells us which versions and platforms to keep supporting. |
version-check | true | Check for new versions on startup. |
/nme debug.