Troubleshooting
intermediate troubleshootingLiquid Volume Pro 2 · Troubleshooting & FAQ
Solutions for common issues with Liquid Volume Pro 2.
Liquid Not Visible
| Symptom | Solution |
|---|---|
| Liquid disappears at certain rotations | Increase Rotation Level Bias in Advanced Settings (try values up to 1.0). Most common with low fill levels. |
| Liquid not rendering in URP | Ensure the Liquid Volume Depth PrePass Render Feature is added to your URP Forward Renderer. Check that Depth Texture is enabled in the URP Asset. |
| Nothing visible at all | Verify the Level slider is above 0. Check that Global Alpha is not set to 0. |
Irregular Topology Issues
| Symptom | Solution |
|---|---|
| Liquid does not fill the container properly | Click Center Pivot in Advanced Settings to recenter the mesh. If the pivot is at the bottom instead of the center, the level calculation will be incorrect. |
| Clipping at the top of open containers | Use a Cylinder topology with Default No Flask detail inside your open container mesh. See the NonCapped demo scene. |
| Overdraw or artifacts with open flasks | Adjust the Double Sided Bias parameter in Advanced Settings until only one face layer renders. |
Rendering Issues
| Symptom | Solution |
|---|---|
| Liquid does not render on WebGL | In the Unity Editor, set Edit > Graphics Emulation > WebGL 2.0. The built app supports WebGL 1.0, but the Editor requires 2.0 emulation. |
| Liquid not lit by additional lights | Edit the shader for your detail level and remove the noforwardadd keyword. |
| Overlapping liquid volumes render incorrectly (URP) | Enable Interleaved Rendering in the Liquid Volume Render Feature settings. |
| Rendering issues on older devices | Enable Legacy Rendering in Advanced Settings. If issues persist, disable Floating Point Buffers in Shader Features. |
Performance Issues
| Symptom | Solution |
|---|---|
| Shader compilation takes too long | Delete unused shader files from Resources/Shaders. Disable unused Shader Features. See Performance Tips. |
| "Tiled GPU Perf..." warnings on mobile | This is a known Unity issue related to CommandBuffers on mobile GPUs. It does not affect rendering and can be safely ignored. |
| Low frame rate on mobile | Use Simple detail, disable refraction, reduce ray steps. See Performance Tips. |
Import & Setup Issues
| Symptom | Solution |
|---|---|
| Imported model has wrong orientation | Use Bake Current Transform in Advanced Settings to bake the rotation/scale into mesh vertices. |
| Mesh pivot is off-center | Use Center Pivot in Advanced Settings to move the pivot to the geometric center. |
| Liquid renders with visual glitches on custom or re-exported meshes | The liquid shader relies on correct mesh normals for flask thickness and lighting. If your mesh was re-exported through Blender or another 3D tool, the normals in the resulting file may differ from the original. Set Normals to Calculate in Unity's model import settings to let Unity recompute them. Also ensure the mesh has a valid UV unwrap, as Unity uses UVs to calculate tangent space. |
Still Need Help?
Visit our Kronnect Support to post your question. Our team responds promptly.
Was this page helpful?
Suggest an improvement
Help us improve this documentation page.