π»Terrain Generator
Here we will break down each public parameter of the TerraForgeTerrainGenerator component
Last updated
Here we will break down each public parameter of the TerraForgeTerrainGenerator component
Last updated
TerraForgeTerrainGenerator
- the main component of terrain generation.
Don't know how to get started with generation? Explore this page.
The TerraForgeTerrainGenerator
component has three parameter windows for generation settings, as well as a separate window for initiating the generation process:
Terrain Settings
Terrain Noise Layers
Hydraulic Erosion Layer
Generation Initiation Window
Let's break down each one individually.
Terrain Settings
Terrain Settings
manages the basic terrain configuration, its terrainData file, and more:
Terrain Resolution
- Controls the resolution of the generated terrain (from 33 to 4097). Values above 513 are considered high, and automatic generation updates will be disabled. These values also take longer to generate. After changing the Terrain Resolution
field, you need to manually apply the resolution change using the "ChangeTerrainResolution
" button, which will regenerate with the new Terrain Resolution
value. If "Auto Update Terrain Generation
" is enabled, the resolution change will happen automatically.
Terrain Material
- Controls the current material of the generated terrain. The default material is Default-Terrain-Standart
. After changing the Terrain Material
field, you need to manually apply the material change using the "ChangeTerrainMaterial
" button. If "Auto Update Terrain Generation
" is enabled, the material change will happen automatically.
Terrain Height
- Changes the overall height of the terrain vertices in relation to the game terrain object.
Save Terrain Data File
- Saves the generation data to a terrainData
file to prevent data loss. It is recommended to keep this enabled.
Current Terrain Data
- The current terrainData
of the terrain. There are three additional actions for TerrainData
represented by buttons:
"Set Terrain Data
" - If you drag another terrainData
file into the "Current Terrain Data
" window, you need to press "Set Terrain Data
" to apply it to the terrain.
"Clone Terrain Data
" - This button creates a clone of the current terrainData
and automatically applies it to the terrain.
"Empty Terrain Data
" - This button creates a default terrainData
and automatically applies it to the terrain.
Terrain Noise Layers
Terrain Noise Layers
handles the noise settings of the terrain:
Terrain Layers
- An array of noise generation layers.
"Refresh Generation All Terrain Layers
" - Forces the regeneration of all noise layers, ignoring cached layers.
Let's break down the settings of one noise layer (an element of the Terrain Layers
array):
Is Enabled
- Indicates whether the terrain noise layer is enabled. When disabled, the layer will not affect generation.
Blur Radius
- The blur radius of the terrain noise layer. Use a zero value to disable blurring.
Noise Type
- The type of noise used for creating the terrain noise layer.
Fractal Type
- The type of fractal used for creating the terrain noise layer.
Depth
- The depth of the terrain noise layer.
Scale
- The scale of the noise layer on the terrain.
Octaves
- The number of octaves used for generating the terrain noise layer.
Lacunarity
- The lacunarity of the noise layer.
Persistence
- The persistence of the terrain noise layer.
Seed
- The seed used for generating the terrain noise layer. Changing the integer values of Seed for layers can create unique variations of a biome.
Inversion
- Indicates whether the height curve should be inverted.
Height Curve
- The height curve used for generating the terrain noise layer.
Use Falloff Map
- Indicates if a falloff map is used for the terrain noise layer. A falloff map is needed to create islands.
Falloff Angle Factor
- Affects the "angle of cut" on faces on the falloff map.
Falloff Range
- The range of falloff for the terrain noise layer.
Hydraulic Erosion Layer
The Hydraulic Erosion Layer
manages the settings for hydraulic erosion:
Is Enabled
- Indicates whether the hydraulic erosion layer is enabled. When disabled, the hydraulic erosion layer will not affect generation.
Strength
- The strength of the erosion effect. Works similarly to opacity.
Iterations
- The number of iterations for the hydraulic erosion process.
Erosion Resolution
- The resolution of the terrain for erosion (from 129 to 1025). It is recommended to use a value lower than "Terrain Resolution
".
Erosion Steps
- The number of erosion steps per iteration.
Erosion Radius
- The radius of the erosion effect.
Inertia
- At zero, water will instantly change direction to flow downhill. At 1, water will never change direction.
Min Sediment Capacity
- The minimum sediment capacity, influencing how much sediment a droplet can carry.
Max Droplet Lifetime
- The maximum lifetime of a droplet.
Initial Water Volume
- The initial volume of water in a droplet.
Use Falloff Map
- Indicates whether to use a falloff map for erosion. A falloff map for erosion is needed to make the seams in a grid of terrains less noticeable.
Falloff Transition Width
- The width of the falloff transition for erosion.
Falloff Range
- The range of the falloff for erosion.
"Hydraulic Erode Generate
" - The button for initiating the hydraulic erosion generation (not required to press if "Auto Update Terrain Generation
" is enabled).
If you have disabled one of the layers in Terrain Layers and the hydraulic erosion did not update, you can try changing the "Iterations
" value and pressing the "Hydraulic Erode Generate
" button.
Generation Initiation Window
This window contains the main generation button and the auto-update generation toggle:
Auto Update Terrain Generation
- Automatically updates the terrain when changes are made. It works for "Terrain Resolution
" values not exceeding 513.
Generate Terrain
- The main button for initiating terrain generation (not required to press if "Auto Update Terrain Generation
" is enabled). Uses caching for layers. Caching assumes using the cached vertices of already generated layers that were not changed after the last generation.