Skip to main content

Oceanology Legacy

oceanology-legacy

🌊 Water Simulation
âš¡ Optimized Performance
🎮 Game Ready

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:

TargetUse Case
Game StudiosTargeting 60-120 FPS on mid-range hardware while maintaining visual quality
Indie DevelopersAccessible setup with clear controls and predictable behavior
Multiplayer ProjectsFoundational replication support for synchronized water states
Large World ProjectsQuadtree 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​

RequirementSpecification
EngineUE5.x (latest release)
PlatformWindows, Mac, Linux
Graphics APIDirectX 12 (Shader Model 6 recommended)
HardwareMid-range GPU (GTX 1080 / RTX 3060+) or better

Documentation Structure​

This documentation is organized to get you productive quickly:

SectionDescription
SetupInstallation, project configuration, and first scene verification
WavesGerstner wave parameters, presets, and wave layer customization
BuoyancyPontoon-based floating physics for vessels and objects
SwimmingCharacter swimming component setup, bubbles, and transitions
UnderwaterVolumetric effects, post-processing, and caustics
SurfaceWater surface rendering, reflections, and refractions
QuadTreeCPUCPU-based quadtree tessellation and LOD configuration
NavigationWater-aware AI navigation setup
PresetsSaving, loading, and managing water presets
RVTHeightmapRuntime Virtual Texture and landscape integration

Quick Start​

  1. Install the Plugin - Enable Oceanology Legacy in your project's Plugins menu
  2. Add Water to Your Level - Use Quick Add (+) and search for BP_OceanologyInfiniteOcean
  3. Add the Manager - Place an Oceanology Manager actor to initialize the system
  4. Configure Water Volume - Add an Oceanology Water Volume for buoyancy and swimming
  5. Play - Enter Play mode to see your ocean in action

For detailed instructions, see the Setup Guide.


Legacy vs NextGen​

FeatureLegacyNextGen
Target HardwareMid-range GPUs (GTX 1080 / RTX 3060+)High-end GPUs (RTX 3080 / RTX 4070+)
Wave SystemGerstner (4 layers)Spectral Gerstner + FFT
Performance Focus60-120 FPS on broad hardwareMaximum visual quality
Shore WavesBasic coastal effectsMath-based breaking waves
Best ForGames, multiplayer, compatibilityCinematics, AAA visuals
Choosing the Right Version

Choose Legacy for reliable performance across diverse hardware. Choose NextGen for cutting-edge visuals on high-end systems.


Support & Community​

Need Help?

Join our Discord community for real-time support and discussions.

Join Discord

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 →