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

# Folia

> Per-subsystem Folia support: verified, untested, and known limitations.

NMEntities runs on Folia. Because Folia ticks the world in independent regions on separate threads, support is documented honestly, per subsystem, rather than as a blanket claim.

## Verified on a real Folia server

Tested end-to-end on Folia 26.1.2:

* Startup and plugin enable
* Loading `Mobs/`, `Effects/`, `NPCs/` and `Dialogs/`
* `/nme reload` and `/nme debug`
* Resource-pack generation
* Spawning mobs with their configured stats
* Effect triggers, including `delay` and `repeat`/`pulse`
* The [MythicMobs importer](mythicmobs)

## Expected to work, not yet verified

These need a connected game client to drive, and haven't been tested end-to-end on Folia yet:

* Model rendering and animation
* `/nme gui`, `/nme disguise`, `/nme play`
* [Dialogs](dialogs)

They're expected to work; this list exists so you know exactly what has and hasn't been proven.

## Known Folia-only limitations

* **NPC entities aren't cleaned up when the plugin is disabled** on Folia. Harmless across a restart, since NPCs are never saved to disk, but visible if you reload the plugin on a live server.
* **The `@world` targeter is only safe with text mechanics** (messages, titles, sounds) on Folia. Don't use it with mechanics that damage or move players.

## Why the caution

Folia gives each world region its own thread, and a thread may only touch the entities its region owns. NMEntities schedules its work per-region accordingly (NPC ticking follows each NPC as it moves between regions). On Paper, everything behaves exactly as it always has.