Skip to content

Movement & Avoidance

SimpleRiggedFishAgent provides built-in wandering, target steering and procedural animation.

Swim volume

All built-in fish share a FishSwimVolume. The volume collider and Edge Padding define the safe movement area. Padding keeps bodies away from the terrain, surface and boundaries.

Locomotion

  • Cruise speed and turn speed are randomized from config ranges.
  • Travel and glide durations create speed variation.
  • Vertical steering is reduced to avoid unnatural pitching.
  • Ecology may set an external target for feeding, fleeing or hunting.

Obstacle avoidance

The built-in controller uses staggered non-allocating sphere casts. Main settings include:

  • Obstacle Layers
  • Obstacle Look Ahead
  • Obstacle Probe Radius
  • Obstacle Avoidance Strength
  • Obstacle Check Interval

Environment rocks and corals receive colliders from the builder. Plant and small-decoration colliders are triggers so fish can reach food and do not avoid tiny props.

Procedural animation

Tail angle, frequency, body influence, wave delay, banking and vertical bob can be tuned. Procedural bone animation is automatically disabled when Animator animation is selected.