Oceanology Legacy

Oceanology Legacy is a production-ready water simulation system for Unreal Engine, optimized for broad hardware compatibility and consistent frame rates. Whether you're building action games, exploration experiences, or multiplayer projects that need to run smoothly on mid-range PCs, Oceanology Legacy delivers reliable water rendering without sacrificing visual quality.
Who It's For​
Oceanology Legacy is designed for teams who need water that performs consistently:
| Target | Use Case |
|---|---|
| Game Studios | Targeting 60-120 FPS on mid-range hardware while maintaining visual quality |
| Indie Developers | Accessible setup with clear controls and predictable behavior |
| Multiplayer Projects | Foundational replication support for synchronized water states |
| Large World Projects | Quadtree tessellation and World Partition compatibility |
Core Features​
🌊 Wave Simulation​
- Gerstner Wave System - Four customizable wave layers (Σ1-Σ4) for complex, organic wave patterns
- Customizable Wave Profiles - Full control over amplitude, speed, wavelength, and direction
- Deterministic Calculations - Synchronized wave states for multiplayer and buoyancy systems
⚡ Performance & Scalability​
- Optimized Rendering - Smooth frame rates on mid-range GPUs without sacrificing quality
- Quadtree Tessellation - Dynamic mesh density based on camera distance
- World Partition Support - Native streaming for large open worlds
🎨 Visual Effects​
- Underwater Volumetrics - Light scattering, caustics, and post-process effects
- Surface Rendering - Reflections, refractions, and depth-based coloring
- RVT Landscape Integration - Runtime Virtual Texture support for seamless shoreline blending
🎮 Gameplay Systems​
- Pontoon Buoyancy - Physics-accurate floating with configurable density and damping
- Swimming System - Complete character swimming with bubbles, transitions, and surface detection
- Navigation - Water-aware AI navigation support
🔧 Workflow & Flexibility​
- Presets System - Save and load complete water configurations
- Multiple Water Bodies - Infinite oceans and local water bodies with independent settings
- Dynamic Audio - Audio analyzer for wave-driven soundscapes
Technical Requirements​
| Requirement | Specification |
|---|---|
| Engine | UE5.x (latest release) |
| Platform | Windows, Mac, Linux |
| Graphics API | DirectX 12 (Shader Model 6 recommended) |
| Hardware | Mid-range GPU (GTX 1080 / RTX 3060+) or better |
Documentation Structure​
This documentation is organized to get you productive quickly:
| Section | Description |
|---|---|
| Setup | Installation, project configuration, and first scene verification |
| Waves | Gerstner wave parameters, presets, and wave layer customization |
| Buoyancy | Pontoon-based floating physics for vessels and objects |
| Swimming | Character swimming component setup, bubbles, and transitions |
| Underwater | Volumetric effects, post-processing, and caustics |
| Surface | Water surface rendering, reflections, and refractions |
| QuadTreeCPU | CPU-based quadtree tessellation and LOD configuration |
| Navigation | Water-aware AI navigation setup |
| Presets | Saving, loading, and managing water presets |
| RVTHeightmap | Runtime Virtual Texture and landscape integration |
Quick Start​
- Install the Plugin - Enable Oceanology Legacy in your project's Plugins menu
- Add Water to Your Level - Use Quick Add (+) and search for BP_OceanologyInfiniteOcean
- Add the Manager - Place an Oceanology Manager actor to initialize the system
- Configure Water Volume - Add an Oceanology Water Volume for buoyancy and swimming
- Play - Enter Play mode to see your ocean in action
For detailed instructions, see the Setup Guide.
Legacy vs NextGen​
| Feature | Legacy | NextGen |
|---|---|---|
| Target Hardware | Mid-range GPUs (GTX 1080 / RTX 3060+) | High-end GPUs (RTX 3080 / RTX 4070+) |
| Wave System | Gerstner (4 layers) | Spectral Gerstner + FFT |
| Performance Focus | 60-120 FPS on broad hardware | Maximum visual quality |
| Shore Waves | Basic coastal effects | Math-based breaking waves |
| Best For | Games, multiplayer, compatibility | Cinematics, AAA visuals |
Choose Legacy for reliable performance across diverse hardware. Choose NextGen for cutting-edge visuals on high-end systems.
Support & Community​
Additional Resources:
- Discord - Real-time community support
- FAB Store - Purchase and updates
- Issue Reports - Include engine version, plugin version, logs, and screenshots
Ready to dive in? Start with the Setup Guide →