VoxelGeneratorHeightmap¶
Inherits: VoxelGenerator
Inherited by: VoxelGeneratorImage, VoxelGeneratorNoise2D, VoxelGeneratorWaves
Base class for several basic height-based generators.
Properties:¶
| Type | Name | Default |
|---|---|---|
| ChannelId | channel | CHANNEL_SDF (1) |
| float | height_range | 30.0 |
| float | height_start | -50.0 |
| float | iso_scale | 1.0 |
| Vector2i | offset | Vector2i(0, 0) |
Property Descriptions¶
ChannelId channel = CHANNEL_SDF (1)¶
Channel where voxels will be generated. If set to VoxelBuffer.CHANNEL_SDF, voxels will be a signed distance field usable by smooth meshers. Otherwise, the value 1 will be set below ground, and the value 0 will be set above ground (blocky).
float height_range = 30.0¶
Maximum distance between the lowest and highest surface points that can generate.
NOTE: due to a bug in Godot's documentation tool, the default value shown here is not 30.0, but 200.0. This seems to be because one of the subclasses, VoxelGeneratorWaves, has a different default value, chosen for better practical results. This property also appears in some subclasses now, despite being defined in the base class.
float height_start = -50.0¶
Minimum height where the surface will generate.
float iso_scale = 1.0¶
Scale applied to the signed distance field when using a smooth terrain configuration.
Vector2i offset = Vector2i(0, 0)¶
Offsets height generation along the X and Z axes.
Generated on Jan 26, 2026