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

# Spawn Rule Commands

> The full /nme spawnrule reference: list, info, test, trigger, enable, disable, reset.

Natural spawn rules are the `type: spawn` entries of `Effects/` — mobs appearing where the world suits them, rather than at a placed [spawner](spawner-commands). These commands inspect them, test them and switch them on and off.

**Aliases:** `/nme spawnrules`, `/nme naturalspawn` **Permission:** `nmentities.spawnrule`

## Inspecting

| Command                      | What it does                                                                                               |
| :--------------------------- | :--------------------------------------------------------------------------------------------------------- |
| `/nme spawnrule list`        | Every loaded rule and what it currently has alive.                                                         |
| `/nme spawnrule info <rule>` | One rule in full: what it spawns, where it may, and its caps.                                              |
| `/nme spawnrule test [rule]` | Whether each rule would spawn where you're standing, and why not. `[rule]` narrows it to one. Player-only. |

`test` is the important one. A compiled condition can't be taken apart to name the clause that failed, so the report gives the verdict per rule plus the caps — which is what separates *"your condition is wrong"* from *"you're at the cap"*.

## Driving

| Command                                | What it does                                                                                                   |
| :------------------------------------- | :------------------------------------------------------------------------------------------------------------- |
| `/nme spawnrule trigger <rule>`        | Spawns a rule's pack where you're standing, ignoring its `rate`. Conditions and caps still apply. Player-only. |
| `/nme spawnrule enable <target>`       | Switches a rule, or all of them, back on.                                                                      |
| `/nme spawnrule disable <target>`      | Switches it off. Remembered across restarts.                                                                   |
| `/nme spawnrule reset <target> [kill]` | Forgets a rule's tracked mobs. `[kill] true` also removes them.                                                |

`<target>` is a rule id or the literal `all`.

## Examples

```text theme={null}
/nme spawnrule list
/nme spawnrule info taiga_alpha
/nme spawnrule test
/nme spawnrule test taiga_alpha
/nme spawnrule trigger taiga_alpha
/nme spawnrule disable all
/nme spawnrule reset taiga_alpha true
```

## Notes

* A rule whose `cond:` fails to parse **loads disabled** rather than being skipped: a gate that silently disappeared would spawn mobs exactly where the config said not to. `/nme spawnrule info` and [`/nme debug`](debug) both say so.
* Enable/disable decisions are stored in `spawnrule-state.yml` and survive a restart. Live counts do not.
* The same operations are available to addons — see [Natural Spawns](addon-natural-spawns) in the API section, including `explain(location)`, which returns exactly what `test` prints.