Skip to content

Adding Fish

Clean visual prefab workflow

A source fish prefab may contain only:

  • Mesh or SkinnedMeshRenderer.
  • Rig and bones when procedural animation is used.
  • Materials and textures.
  • Optional Animator.

The source prefab does not need ecology or movement components. Built-in components are added to runtime instances.

Add a species

  1. Add an element to EcosystemConfig.species.
  2. Enter a unique Species Name such as Swordfish.
  3. Assign the visual prefab.
  4. Assign a reusable ecology profile such as FishSpecies_Carnivore.
  5. Select movement and animation modes.
  6. Set population, length and movement ranges.
  7. Review validation messages at the bottom of the Inspector.

Example:

Species Name: Swordfish
Fish Prefab: Swordfish.prefab
Species: FishSpecies_Carnivore
Starting Population: 3

Swordfish remains a separate species from Shark even when both use the same profile.

Rig expectations

Built-in procedural animation discovers skinned-mesh bones and applies a weighted body-to-tail wave. Forward alignment attempts to infer direction from the root and a bone containing tail in its name. Models with unusual bone naming or axes may require a custom controller.