# Farm Doctor

> A free Minecraft mod (Fabric, Forge, NeoForge) that checks a mob farm or iron farm against the vanilla spawning rules and explains in plain words why it isn't working.

- Page: https://spicesfire.com/farmdoctor/
- Author: SpicesFire (https://spicesfire.com/)
- Version: 1.0.0 (beta). Fabric 26.3 / 26.1.2 / 1.21.10 / 1.20.1 (needs Fabric API), NeoForge 26.3 / 1.21.1, Forge 26.3 / 1.20.1.
- Languages: English, Turkish, German, Spanish, French, Russian, Brazilian Portuguese, Simplified Chinese.
- No account, no internet connection, no AI service. Spawning rules are not changed.

## How it works
Craft the Farm Scanner (iron nugget; stick, paper, stick; redstone) or type /farmdoctor, then right-click the farm's spawning floor or a block near the villagers. A chat report marks each finding as fine, risky or blocking.

## Mob farm checks
- Lit spots (hostile mobs need block light 0 since 1.18), marked with flames.
- Unspawnable floors (slabs, glass, leaves, buttons, rails, pressure plates, water).
- Spawnable spots open to the sky (roof, surroundings) that use up the mob cap at night.
- Mobs piling up inside the farm.
- The hostile mob cap (70) around the player, and where the mobs filling it are (direction, distance, coordinates, cave or surface); they glow for 30 seconds.
- A live action-bar read-out of the distance to the spawning spots (no spawns within 24 blocks, instant despawn beyond 128).
- Peaceful difficulty and the mob spawning game rule.

## Farm types
Mob, iron, raid (totems/emeralds), gold (zombified piglins), enderman, slime, witch, guardian, spawner, crops and plants, animals, villager breeder. Shift + right-click with the scanner (or /farmdoctor menu) opens a clickable chat menu sorted by product; by default the type is detected from the clicked place.

## Other farm checks
- Raid: village present, raids game rule, Bad Omen / Raid Omen, current wave and raiders alive.
- Slime: slime chunk test with the nearest slime chunk's coordinates, Y below 40.
- Witch / guardian: inside the swamp hut or ocean monument structure area.
- Spawner: room in the 9×3×9 area, light 11 or less, 6+ mobs crowding, player within 16 blocks (live action bar).
- Crops and plants: dark crops (need light 9+), dry farmland, stems without room for fruit, kelp at max age, cane/cactus height, randomTickSpeed, growth distance.
- Animals: ready to breed / cooldown / babies, entity cramming.
- Villager breeder: adults, free beds, food.

## Iron farm checks
- At least 3 villagers, at least 3 within 10 blocks of each other.
- Claimed beds, sleep in the last 20 minutes, fear of a visible zombie.
- Living iron golems nearby that block new ones (they glow), and the normal ~30 s cooldown.