VoxelEntity

public GeometryInstance3D.ShadowCastingSetting CastShadow { get; set; }

Sets the shadow casting mode that meshes of the terrain will use.

public VoxelFormat Format { get; set; }

Overrides the default format of voxels. WARNING: changing this will reload the terrain. If it has a stream attached with data saved with a different format, it might load improperly.

public GeometryInstance3D.GIModeEnum GIMode { get; set; }

Sets the Global Illumination mode meshes of the terrain will use.

public VoxelGenerator Generator { get; set; }

Procedural generator used to load voxel blocks when not present in the stream.

public VoxelMesher Mesher { get; set; }

Defines how voxels are transformed into visible meshes.

public int RenderLayersMask { get; set; }

Sets the render layers meshes of the terrain will use.

public VoxelStream Stream { get; set; }

Primary source of persistent voxel data. If left unassigned, the whole volume will use the generator.

public Entity3D ConvertToEntities(VoxelEntity.EntityConversionFlags flags);

Generates a tree representing the terrain at the time of calling, only using Reckfell vanilla nodes. This method can be used as a way to produce a snapshot of the terrain as a vanilla scene that can be opened with standard Reckfell versions without plugins. It could also be used for debug purposes, or as a way to workaround Reckfell features that expect mesh instance nodes (such as some GI baking options, navigation generation or GLTF export). The returned root is not added to the scene tree. It is up to you to decide what to do with it. If you want it to be present in the scene, you should add it as child of an existing node. Otherwise, don't forget to free it. Output structure: every chunk of the terrain will create its own MeshInstance3D, with a unique ArrayMesh resource attached to it. Meshes and/or mesh instances may also have materials attached to them. Depending on how the terrain is configured, these materials can be unique per chunk. If the terrain has LODs, chunks will be stored under a corresponding LOD node. If the terrain has an instancer, multimesh chunks can be included. See VoxelEntity.EntityConversionFlags for options. Resources: unless specified, resources attached to nodes of the tree will be direct references to those actually used by the terrain system. Careful, depending on configuration, it is possible that they get altered when the terrain runs its next process cycle (for example, materials with per-chunk parameters are pooled, so when chunks get unloaded, those referenced in the nodes might drastically change as new chunks re-use them). Performance: this can be an expensive operation. It might slow down your game. Packing to scene file: it is possible to save the output as a PackedEntity, by assigning Entity.Owner (see Reckfell's documentation). It contains a lot of unique meshes so the saved scenes can be very large. Prefer saving as binary .rbin if it's a problem. If the terrain uses a ShaderMaterial with detail rendering, chunks will also have unique textures, further increasing size. GLTF: if your terrain uses ShaderMaterial and you want to convert the terrain to a GltfDocument, these materials won't carry over because GLTF does not support it. That also means if you use VoxelMesherTransvoxel with LOD, meshes in your GLTF document will have unwanted extra geometry and cracks at the seams (which would normally be handled by shader). LOD: if your terrain has LOD, you will only get a snapshot of which LODs are currently active. Detailed meshes will be centered around viewers, and have less and less details further away.

public VoxelTool GetVoxelTool();

Creates an instance of VoxelTool bound to this node, to access voxels and edition methods. You can keep it in a member variable to avoid creating one again, as long as the node still exists.