Spawn Rates

Configurable spawn rates and mob caps for hostile and friendly mobs on Forge 1.20.1, with a fix for the vanilla regional animal cap and a built-in German-language diagnostics tool.

Features

Configurable Spawn Rates & Cap
Separately adjustable percentage rates and caps for hostile and friendly mobs, plus per-category overrides for monsters, land animals, bats, axolotls, underground water creatures, water creatures, and fish.

Regional Animal Cap Fix
Vanilla's global animal limit can silently block all new land-animal spawns once enough animals exist anywhere in loaded chunks — even far from the player. This mod switches land animals (CREATURE category) to a regional cap instead: only animals within a configurable radius around the spawn area count, so distant animals no longer block spawning in empty areas.

World Generation Control
Separate rate control for the animal spawns that happen during initial chunk generation (independent of the natural-spawn-cycle rate).

Built-in Diagnostic
An in-game diagnostic tool that snapshots or observes spawning conditions over time (mod status, game rules, biome, effective rates, regional counts, light levels, ground type) and flags common causes of "why aren't mobs spawning" — without changing any settings itself. Reports are automatically saved as German-language text files on the server.

Commands
All diagnostic commands require OP level 2.

| Command | Function |

| `/spawnraten diagnose` | Instant snapshot of settings, environment, and warnings |
| `/spawnraten diagnose 60` | Observe for a given number of seconds (1–600) |
| `/spawnraten diagnose abbrechen` | Cancel early and save a partial report |
| `/spawnraten bericht` | Export the current progress, last completed report, or a snapshot |

Configuration
All settings live in `config/spawnrates-common.toml` and are hot-loaded on server start (missing new settings are added automatically on update):

-Global rates**: hostile/friendly spawn-attempt percentage (0–2000%)
-Caps**: hostile/friendly population cap percentage
-Regional animal cap**: on/off, count radius (32–128 blocks, default 64), spawn interval (default 400 ticks / ~20s)
-Land animals on surface**: spawn at surface height instead of a random height
-World generation rate**: separate percentage for animals placed during initial chunk generation (-1 = inherit the land-animal rate)
-Per-category overrides: monsters, land animals, bats, axolotls, underground water creatures, water creatures, fish — each with its own rate and cap percentage (negative = inherit the group value)

A global `aktiviert = false` switch disables all interventions without affecting existing mobs.

Requirements
- Minecraft 1.20.1
- Forge 47.4.0+ (up to but not including 48)
- Java 17
- **Server-side only** — singleplayer installs it in the same instance; dedicated server clients don't need it

Scope & Limitations
Does not affect breeding, spawner blocks, commands, spawn eggs, or other mods' custom spawners. No guaranteed compatibility with every other spawn-related mod. Very high rates, caps, or very short intervals can affect server performance.

Validation
8 passing JUnit tests plus 2 separate Forge GameTest runs, covering real animal spawns across 5 biomes, percentage/cap behavior, diagnostic counters, an intentionally denied Forge spawn event, and the automatic timed report.