# Spawn mechanics

### Flow

As one of our targets was to maintain a natural spawning and not a sudden surprise mob spawning behind you, we came up with a solution that would maintain natural mob spawning but with additional custom mobs included.

We came up with the solution to replace mobs that are spawned by Minecraft with our custom mobs. When a mob is spawning, an extended flow of conditions will execute. Based on the outcome of the condition, we might replace the original mob with a custom mob or keep the mob that was originally spawned.

![](/files/-M-fxgVf6JVEjFaoYCIv)

### Mob registration

Every custom mob that is spawned will be registered on the blood-moon. Whenever the blood-moon ends, all the custom mobs will automatically despawn.

### Custom mob spawning

The custom mob spawning allows the plugin to spawn mobs in a radius around the player with a given minimum and maximum radius. Mob spawning does completely ignore natural spawning and therefore it will also spawn mobs in places that have high light levels.

The server administrator can configure the maximum amount of mobs within a single chunk. By default, this feature is disabled.

```yaml
spawning:
  enabled: false
  min-radius: 20
  max-radius: 80
  mobs-per-chunk: 20
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://bloodmoon.pseudonova.com/mobs/spawn-mechanics.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.