ConfigMobs

Version 1.0 · Minecraft 26.1

---

Ever wished creepers only spawned at night in deserts? Or that sheep fought back? Or that zombies just... left you alone? ConfigMobs gives you full control over how every vanilla mob spawns and behaves through easy to understand config files.

How It Works

On first launch, ConfigMobs generates a JSON5 config file for every mob in the game under config/configmobs/vanilla/. Each file is pre-filled with that mob's actual vanilla defaults, so nothing changes until you say so.

To start tweaking a mob, open its config and flip the master switch:

modConfigEnabled: true

That's it. Now every setting in that file overrides vanilla behavior for that mob.

There's also a global kill switch in config/configmobs/configMobsGeneral.json5:

Set modEnabled: false and the entire mod steps aside.

What You Can Configure

Spawning

• spawn_weight — How common this mob is relative to others. Higher = more frequent.
• min/max_group_size — How many spawn together in a pack.
• max_concurrent_spawns — The mob cap contribution for this entity type.

Where They Spawn

• biome_whitelist / biome_blacklist — Control exactly which biomes a mob can (or can't) appear in. Supports biome tags like #minecraft:is_forest.
• dimensions — Restrict spawning to specific dimensions.
• structures / structure_only_mode — Lock mobs to specific structures (or just prefer them).
• block_filtering — Whitelist which blocks the mob can spawn on.
• min/max_y_level — Vertical spawn range.

When They Spawn

• day_night_cycle — "day_only", "night_only", or "both".
• min/max_light — Light level requirements.
• min/max_player_distance — How close (or far) a player needs to be.

Spawn Rules

• spawn_type_whitelist — Filter by spawn trigger: "natural", "spawner", "structure", "reinforcement".
• check_collision — Whether to verify the mob fits before spawning.
• ignore_mob_cap — Let this mob bypass the global cap.
• despawn_on_peaceful — Whether switching to Peaceful removes this mob.

Behavior

• burns_in_daylight — Make any mob burn in sunlight, or stop undead from burning. Want sunburn cows? Go for it.

• hostile_to_players — Three modes:

  • "hostile" — Actively hunts players on sight.
  • "neutral" — Minds its own business until you hit it. Then it's personal.
  • "passive" — Won't target players, ever. Peaceful zombies? Sure, why not.

• attack_damage — Override how hard a mob hits. Set to -1 for vanilla default.

  If you make a naturally passive mob hostile or neutral, set this to a positive number (like 2.0). Leaving it at -1 for mobs like sheep or cows will ⚠️ crash ⚠️ the game — they don't have an attack stat by default, and the mod needs a value to give them one.

• aggressive_towards — A list of entity IDs this mob will actively hunt. Want wolves that chase creepers? Cows that hunt chickens? An army of skeletons targeting zombies? Just list the targets:

  aggressive_towards: ["minecraft:chicken", "minecraft:creeper"]
  

Global Mob Caps

In the general config (configMobsGeneral.json5), you can adjust the global mob caps per category — monster, creature, ambient, water, axolotls, etc. Note that passive mob caps only limit new spawns; existing animals don't despawn when you lower the cap.

Quick Tips

• Delete a mob's config file to regenerate it with fresh vanilla defaults on next launch.
• Enable debug_spawning: true on any mob to see detailed spawn-check logs in your game log.
• Old configs with boolean hostile_to_players: true/false still work — they map to "hostile" and "passive" automatically.
• All config files use JSON5, so comments and trailing commas are fine.
• Changes take effect after restarting the game (or using /configmobs reload).

---

ConfigMobs only supports vanilla entities. Modded mobs are not configurable.