Fish Controller | Physics based Fish/Eel/Flat Fish movement System

Fish Controller - Arcade-Style Underwater Movement System

The Fish Controller is a complete, arcade-style underwater movement system for Unity, designed for swimming games, underwater exploration, fishing experiences, and ambient ocean scenes. Built on Rigidbody physics, it delivers smooth, responsive 3D swimming with depth control, boost bursts, natural banking, idle bobbing, and extensible event hooks.

This asset includes not only a fully playable fish controller, but also a cinematic underwater camera, automatic audio controller, and an ambient boid system for creating lively fish swarms with minimal setup.

Key Features

Core Fish Movement

Full 3D underwater swimming (forward, turn, rise, dive)
Rigidbody-based physics for smooth, organic motion
Acceleration, drag, buoyancy, and depth control
Natural pitch, roll (banking), and auto-leveling
Idle bobbing when stationary
Configurable maximum depth and water surface level

Boost System

Instant boost bursts with cooldown
Adjustable boost strength, duration, and recovery
UnityEvent hooks for VFX, audio, and gameplay logic

Fish Camera

Smooth third-person underwater camera
Speed-based dynamic FOV
Boost FOV kick for cinematic motion
Depth-based color tinting (shallow to deep water)
Tilt-follow and look-ahead targeting
Snap-to-target support for cutscenes or respawns

Fish Audio Controller

Automatic looping swim audio
Speed-based pitch and volume modulation
One-shot boost, surface, and dive sounds
Optional underwater ambience loop
Event-driven design for easy customization

Ambient Boid System (Fish Swarms)

Lightweight classic flocking behavior
No Rigidbody required for boids
Configurable cohesion, alignment, separation, and wander
Bounded swim areas with force-based containment
Runtime spawning and clearing
Optional batched updates for performance

Perfect for background life, reefs, aquariums, or open ocean scenes.