Fish School AI – Tropical Aquarium Set

A lightweight fish schooling simulation and aquarium environment for Unity URP, featuring customizable Boids AI, interactive feeding, dynamic caustics, and preconfigured tank prefabs.

Package Features & Specifications

• Unique 3D Models: 6 types (Aquarium, Cabinet, Stone, Sand, Aquatic Plant, Neon Tetra)
• Fish Variations: 2 (Neon Tetra, Black Neon Tetra)
• Vertex Counts:
  Aquarium: 716 triangles
  Cabinet: 76 triangles
  Stone: 209 triangles
  Sand: 588 triangles
  Aquatic Plant: 271 triangles
  Feed: 36 triangles
  Neon Tetra / Black Neon Tetra: 216 triangles each
• LODs: No
• Animation: Animations are not included. Fish swimming motions are driven procedurally by custom vertex shaders. Models include expansion bones and weights.
• Textures: 1024 x 1024 resolution (Color, Normal, Specular, and Iridescence maps depending on the asset)

Requirements & Dependencies

• Target Render Pipeline: Universal Render Pipeline (URP 17.0.4 or higher)
• Recommended Unity Version: Unity 6.0 (6000.0.80f1)
• Dependencies (Unity Registry):
  Universal Render Pipeline (com.unity.render-pipelines.universal): 17.0.4
  Input System (com.unity.inputsystem): 1.19.0
  Cinemachine (com.unity.cinemachine): 3.1.7
  Unity UI (com.unity.ugui): 2.0.0
• Hardware & Project Requirements:
  Shader Target 4.5 support for water surface
  Opaque Texture enabled in URP Asset settings for refraction
  Directional Light with Light Cookies support for caustics
• Supported Platforms: Windows, macOS, Linux, iOS/iPadOS, Android, WebGL 2 (water surface is not supported on WebGL 2)

Fish School AI - Tropical Aquarium Set is a lightweight fish schooling simulation and ready-to-use aquarium environment for Unity Universal Render Pipeline (URP).

Each aquarium operates as an independent unit through AquariumUnit, allowing developers to place multiple tanks within a single scene without scene-wide singletons. The system includes Boids flocking algorithms with burst swimming behaviors tuned for small fish, hunger-driven feeding logic, and collider-based obstacle avoidance. All parameters—such as schooling cohesion, swim speed, reaction distance, hunger thresholds, and food sinking properties—are configurable through ScriptableObjects and inspector fields. The full C# source code is included without precompiled DLLs, enabling direct modification of steering logic, spawning controllers, and interaction events.

This package suits aquarium simulators, idle and management games, ambient background elements in RPGs and adventure titles, architectural visualizations, and interactive VR relaxation experiences. Developers can deploy the preassembled aquarium prefabs directly into a scene or adapt the underlying fish simulation to custom water volumes and larger marine environments.

Key Features

• Natural Boids Schooling AI: Small-fish simulation featuring cohesion, alignment, separation, pitch limits, and burst swimming propulsion.
• Per-Tank Scoping: Isolated simulation contexts via AquariumUnit that manage dedicated fish registries, obstacle queries, and feeding services per aquarium.
• Interactive Feeding System: Mouse click and touch tap food drops with sinking physics, reaction distances, hunger thresholds, consumption events, and cooldown limits.
• GPU Vertex Swimming Animation: Deformation handled via FishShaderMotionDriver without skeletal animation overhead, while retaining bone and weight structures for custom rigging.
• Custom URP Shaders: Includes standard Lit FishBody and specialized FishBody Iridescent shaders for angle-dependent structural color, dynamic caustics projection, and water surface effects.
• Ready-to-Use 3D Environment: Includes Neon Tetra, Black Neon Tetra, a 120×50×55 cm rectangular glass tank, cabinet stand, aquatic plants, stones, sculpted sand, and food pellet prefabs.
• Camera & Viewer Utilities: Orbit and focus camera controllers with focus-target cycling and field-of-view zoom control.
• Runtime Batch Spawning: Programmable spawn tables and API methods for instantiating fish schools dynamically via script.

Included Scenes

• 01_MinimalTank: Fixed-camera baseline setup with white lighting.
• 02_AquariumViewer: Full viewer demo featuring camera switching UI, feeding controls, dual fish species, and blue accent lighting.
• 03_FeedingSample: Fixed-angle scene dedicated to verifying food drop and predator-prey ingestion behaviors.
• 04_RuntimeSpawnSample: Demonstration of programmatic batch spawning from C# scripts.
• FishBodyPreview: Standalone tuning scene for previewing fish swimming deformation and yaw response in Play Mode.