Configuration¶

Better Ecology uses data-driven configuration files that can be hot-reloaded without restarting the game.

Overview¶

All animal behaviors are configurable through:

• Mob profile files: Per-entity configuration
• Archetype files: Reusable behavior templates
• Template files: Base configuration defaults

File Locations¶

Categories¶

• passive/ - Non-hostile animals (sheep, cow, pig, chicken)
• predator/ - Predatory animals (wolf, fox)
• ambient/ - Ambient creatures (bat)

Hot-Reloading¶

Configuration changes take effect after running /reload:

1. Modify configuration files
2. Run /reload command in-game
3. New behaviors apply immediately
4. Existing entities update gracefully

Basic Configuration¶

Hunger System¶

{
  "hunger": {
    "enabled": true,
    "max": 100,
    "starting": 75,
    "decay_rate": 0.01,
    "starvation_threshold": 10,
    "starvation_damage": 1
  }
}

Behavior Weights¶

{
  "behaviors": {
    "cohesion": 1.5,
    "separation": 1.8,
    "alignment": 1.0,
    "flee": 2.0
  }
}

Fleeing Configuration¶

{
  "fleeing": {
    "enabled": true,
    "flight_initiation_distance": 16.0,
    "escape_strategy": "ZIGZAG",
    "zigzag_intensity": 0.5
  }
}

Using Archetypes¶

Archetypes provide reusable behavior templates:

{
  "archetypes": [
    "better-ecology:passive/grazer",
    "better-ecology:herd/diurnal"
  ]
}

Values from archetypes are merged with the mob profile, with profile values taking precedence.

Common Parameters¶

Distance Parameters¶

Behavior Weights¶

Debugging¶

Inspect Entity Data¶

/data get entity @e[type=sheep,limit=1] better-ecology

Check Applied Weights¶

/data get entity @e[type=sheep,limit=1] better-ecology.behavior

Advanced Configuration¶

For detailed configuration options, see the Configuration System documentation.