Quick Start

URP Setup (Required)

If you are using the Universal Rendering Pipeline, complete these steps before adding any liquid volumes.

1. Ensure a URP Asset is assigned in Project Settings > Graphics and/or Project Settings > Quality for each active quality level.
2. Add the Liquid Volume Depth PrePass Render Feature to your URP Forward Renderer. This is required for refraction and irregular topology. A ready-to-use URP asset is included in the Demos folder.
3. In the URP Asset, enable Depth Texture. If you use the refraction effect, also enable Opaque Texture.

Adding Liquid Volumes to 3D Scenes

1. Create or select a Sphere, Cylinder, Cube, or custom mesh GameObject.
2. Click Add Component and search for LiquidVolume.
3. Set the Topology to match your mesh shape. For non-primitive shapes, choose Irregular.
4. Adjust the Level slider to set the fill amount.

Ready-to-use prefabs are available in LiquidVolume/Resources/Prefabs. Drag and drop them into your scene.

Adding Liquid Volumes to 2D UI

Liquid Volume can display as health bars, mana indicators, or other UI elements.

1. Locate the CameraLife or CameraMagic prefabs in LiquidVolume/Resources/Prefabs and add them to your scene.
2. These prefabs create a sphere flask with a dedicated camera that renders to a RenderTexture (LifeRT or MagicRT in Resources/Textures).
3. Assign the RenderTexture to a RawImage UI component in your game interface.

Exploring Demo Scenes

We strongly recommend exploring the included demo scenes before integrating into your project. They showcase different topologies, multi-layer liquids, 2D UI usage, and physics interaction. See Demo Scenes for details.

Next Steps

• Settings Reference — Full parameter documentation.
• Scripting Support (C#) — Runtime control.
• Troubleshooting — Common issues and solutions.