VoxelBlockyFluid

Inherits: Resource

Properties of a blocky fluid.

Description:

Common properties of a specific fluid. It may be shared between multiple blocky models, each representing a level/state of the fluid.

Properties:

Type Name Default
bool dip_when_flowing_down false
Material material

Property Descriptions

bool dip_when_flowing_down = false

When enabled, if all following conditions are met for a given fluid voxel:

  • It doesn't have maximum level

  • It isn't covered by another voxel of the same fluid type

  • It can flow downwards (below is air or fluid of the same type)

Then the shape of the voxel will change to be "pushed" downwards, creating steeper slopes. Note, this also means the voxel will look as if it has minimum level in some situations. However, in practice these cases don't occur often. You may decide whether to use this option depending on how your fluid simulates.

Material material

Material used by all states of the fluid. Note that UVs of a fluid are different than a regular model, so you may need a ShaderMaterial to handle flowing animation. See https://voxel-tools.readthedocs.io/en/latest/blocky_terrain/#fluids

Generated on Jan 26, 2026