> ## Documentation Index > Fetch the complete documentation index at: https://docs.nmentities.net/llms.txt > Use this file to discover all available pages before exploring further. # Config Reference > Every option in config.yml, grouped, with its default. `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](resource-pack-compat). | | `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. | See [Factions & Threat](factions-threat). ## Spawners | Option | Default | What it does | | :--------------------------------------- | :------ | :----------------------------------------------------------- | | `spawner.enabled` | `true` | Turn every [spawner](spawners) off at once. | | `spawner.check-interval` | `20` | Ticks between passes. `20` = once a second. | | `spawner.world-scaling.blocks-per-level` | `250` | Blocks from world spawn worth one extra [level](mob-levels). | | `spawner.world-scaling.max-level` | `20` | Ceiling for a scaled level. | ## Natural spawning | Option | Default | What it does | | :---------------------------------- | :------ | :------------------------------------------------------------------- | | `natural-spawn.enabled` | `true` | Turn every [spawn rule](natural-spawns) 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. | See [Performance](npc-performance) for what to tune first. ## Menu overlay `gui-overlay.*` has [its own page](menu-overlay). ## 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. | For config *problems* rather than config options, see [`/nme debug`](debug).