// undine docs
Fluid
Undine aims to reproduce liquid motion that feels physically plausible rather than relying solely on artistic approximations.
The Sim Params tab exposes both artist-facing presets and technical controls for material response, particle distribution, and density behavior.
Material presets
The top of the Sim Params tab exposes quick material families such as Water, Oil, Honey, Chocolate, and Slime.
These presets are starting points. They set groups of simulation values at once so the user can begin from a coherent material behavior instead of tuning every control manually.
| Preset family | Typical intent | Tuning direction |
|---|---|---|
| Water | Low-viscosity, responsive liquid behavior. | Use as the default baseline for most clean fluid tests. |
| Oil | Heavier and smoother motion than water. | Increase damping or viscosity-related controls if motion should feel thicker. |
| Honey | Slow, cohesive, high-viscosity behavior. | Expect to trade speed for stability and use more conservative time stepping. |
| Chocolate | Dense viscous material with a heavier visual feel. | Tune surface, viscosity, and density response for the shot scale. |
| Slime | Highly cohesive or stylized material behavior. | Use restraint with surface and vorticity settings to avoid over-energized motion. |
Preset library and custom presets
The Preset Library section applies built-in or custom presets to the current scene.
Built-in presets are locked, so they act as stable reference points. Custom presets can be saved, updated, or deleted depending on the selected preset state.
| Control | Purpose | Notes |
|---|---|---|
| Presets | Chooses a preset from the library. | The screenshots show Water selected. |
| Apply Selected | Applies the selected preset to the visible Sim Params values. | Use this after choosing a preset from the dropdown. |
| Name | Names a custom preset. | Use a clear shot or material name. |
| Save New | Creates a new custom preset from current values. | Useful after tuning a reusable material. |
| Update Selected | Writes current values back into the selected custom preset. | Disabled for locked built-in presets. |
| Delete Selected | Removes the selected custom preset. | Disabled for locked built-in presets. |
Forces
Forces shape the global motion of the liquid before more specialized material effects are considered.
| Control | Purpose | Practical effect |
|---|---|---|
| Gravity Z | Controls vertical gravitational acceleration. | The visible default is 9.81, matching a common real-world gravity scale. |
| Drag | Adds global velocity damping. | Raise when the entire simulation should lose energy faster. |
| Weight Scale | Scales how strongly weight-like effects influence the liquid. | Useful for art direction when the scene scale or visual weight needs adjustment. |
Physically coherent liquid behavior
Parameters such as viscosity, surface tension, and pressure response are implemented with physically motivated models whenever possible.
The goal is not only visual appeal, but liquid motion that remains believable across a range of use cases.
Viscosity and rheology
The visible Numerics panel includes viscosity controls and a Rheology section. In the screenshots, viscosity and rheology are disabled, but the current settings are preserved and bypassed.
This means a user can keep a material setup ready without paying for those effects until they are enabled.
| Control | Purpose | Notes |
|---|---|---|
| Viscosity | Controls internal resistance to flow. | Higher values make the fluid move more slowly and resist deformation. |
| Friction | Adds resistance related to contact or material motion. | Useful for thicker fluids or contact-heavy shots. |
| Viscosity Mode | Chooses the implementation style. | Simple is visible in the screenshots. |
| Fast / Balanced / Quality | Chooses the speed/quality tradeoff. | Fast is useful while searching for the look; Quality is better for final runs. |
| Rheology enable | Enables non-Newtonian or advanced material response when available. | Disabled rheology settings are preserved but bypassed. |
Supported behavior range
Undine is intended to simulate a wide range of liquid behavior, from low-viscosity fluids such as water to highly viscous materials like syrup, oil, chocolate, slime, or molten substances.
Why this matters
A broad behavior range makes the fluid chapter a bridge between artistic direction and solver design.
Particle distribution and reseeding
Particle Distribution controls how Undine maintains particle coverage. The Conservative distribution mode is designed to preserve mass-aware behavior while reducing visual gaps and clustering.
In the visible panel this section can be disabled, but its settings still document how reseeding will behave when enabled.
| Control group | Visible controls | Purpose |
|---|---|---|
| General | Mode, Particles Per Cell | Sets the target distribution strategy and baseline particle density. |
| Reseeding | Reseed Strength, Birth Threshold, Death Threshold | Controls how aggressively particles are added or removed to maintain coverage. |
| Particle count limits | Min PPC, Max PPC | Bounds the number of particles per cell. |
| Separation override | PR Override: Iters, Radius, Rate | Overrides separation behavior for particle redistribution when needed. |
| Contact Enhancement | Contact Band Cells, Contact Oversampling, Contact Min PPC, Contact Mass Bias, Contact No Reseed Cells | Adds refill behavior near colliders when contact bands are enabled. |
Adaptive PPV and advanced particle controls
Adaptive PPV adjusts particle-per-voxel behavior over time. It is useful when particle density needs to react gradually instead of jumping between states.
The advanced particle controls are best treated as stability and diagnostics tools rather than primary art-direction sliders.
| Control | Purpose | Guidance |
|---|---|---|
| Enable Adaptive PPV | Turns adaptive particle-per-voxel behavior on or off. | Leave enabled when density changes should be smoothed over time. |
| Tau Frames | Controls the response time in frames. | Higher values react more slowly and smoothly. |
| Rate Up | Limits how quickly particle density can increase. | Raise carefully to avoid sudden particle growth. |
| Rate Down | Limits how quickly particle density can decrease. | Raise carefully to avoid visible thinning. |
| Deadband | Ignores small density changes. | Useful for avoiding constant small corrections. |
| Rest Density | Reference density for the solver. | The visible value uses a water-like 1000 baseline. |
| Mass Epsilon | Small mass threshold for numerical safety. | Keep near default unless diagnosing mass-related artifacts. |
| Narrow Band / Age-Weighted Kills / TDW Birth Interpolation | Advanced particle lifecycle controls. | Use for specific density or reseeding artifacts after simpler controls are exhausted. |
Balancing Physical Accuracy and Artistic Control
Fluid simulation tools must balance two sometimes conflicting goals: physical realism and artistic controllability.
Undine aims to provide a solver that behaves in a physically coherent manner while still allowing artists to guide the behavior of the simulation through intuitive parameters.
Practical presentation of physical concepts
Many solver parameters correspond to real physical concepts such as viscosity, surface tension, or boundary friction.
Those concepts are presented in a way that allows artists to shape the simulation without requiring deep knowledge of fluid dynamics.