Ecosystem Config

EcosystemConfig defines the population spawned at runtime.

Global settings

Setting	Description
Random Seed	Produces repeatable initial placement and variation.
Maximum Total Population	Global cap used by initial spawning and reproduction.

Species entry

Setting	Description
Enabled	Includes or excludes the entry.
Species Name	Unique runtime identity shown in UI and used for mating, schooling and per-species counting.
Fish Prefab	Visual prefab instantiated for the species.
Species	Reusable FishSpeciesDefinition behavior profile.
Starting Population	Number created when the simulation starts.

Two entries may share one ecology profile while remaining different species. For example, Shark and Swordfish can both use a carnivore profile without mating or schooling together.

Variation ranges

• Adult Length Range normalizes the visual model to a randomized target length.
• Cruise Speed Range controls normal movement speed.
• Turn Speed Range controls steering responsiveness.
• Swim Frequency Range controls procedural wave frequency.
• Tail Angle Range controls procedural tail amplitude. Values around 5–10 degrees are a restrained starting point.

Controller modes

Movement supports built-in procedural control or a prefab controller. Animation supports built-in procedural animation, Animator integration or a prefab controller. Invalid combinations are reported in the config Inspector.