Terrain settings
The final tool on the five-icon toolbarA row of buttons and basic controls at the top of the Unity Editor that allows you to interact with the Editor in various ways (e.g. scaling, translation). More info
See in Glossary is for settings. In the InspectorA Unity window that displays information about the currently selected GameObject, asset or project settings, allowing you to inspect and edit the values. More info
See in Glossary, click the gear icon to reveal the Terrain settings.
Basic Terrain
| Property | Function | |
|---|---|---|
| Grouping ID | The grouping ID for the Auto connect feature. | |
| Auto Connect | Check this box to automatically connect the current TerrainThe landscape in your scene. A Terrain GameObject adds a large flat plane to your scene and you can use the Terrain’s Inspector window to create a detailed landscape. More info See in Glossary tile to to neighboring tiles sharing the same Grouping ID. |
|
| Reconnect | On rare occasions, you might lose connections between Terrain tiles if you change the Grouping ID, or disable Auto connect for one or more tiles. To recreate connections between tiles, click the Reconnect button. Reconnect only connects two adjacent tiles if they have the same Grouping ID and if both tiles have Auto Connect enabled. | |
| Draw | Check this box to enable rendering of the Terrain. | |
| Draw Instanced | Check this box to enable instanced rendering. | |
| Pixel Error | The accuracy of the mapping between Terrain maps (such as heightmaps and Textures) and generated Terrain. Higher values indicate lower accuracy, but with lower rendering overhead. | |
| Minimum Detail Limit | Limits the minimum level of detailThe Level Of Detail (LOD) technique is an optimization that reduces the number of triangles that Unity has to render for a GameObject when its distance from the Camera increases. More info See in Glossary that the terrain can be reduced to. Enter a value of 0 to not limit the level of detail that the terrain can be reduced to. Values higher than 0 force the terrain to keep a minimum level of detail regardless of what the PixelThe smallest unit in a computer image. Pixel size depends on your screen resolution. Pixel lighting is calculated at every screen pixel. More info See in Glossary Error property is set to. |
|
| Maximum Complexity Limit | Limits the maximum resolution the terrain can be rendered at. Enter a value of 0 to not limit the maximum resolution the terrain can be rendered at. Values higher than 0 prevent the terrain from rendering at higher levels of complexity regardless of what the Pixel Error property is set to. | |
| Base Map Dist. | The maximum distance at which Unity displays Terrain Textures at full resolution. Beyond this distance, the system uses a lower resolution composite image for efficiency. | |
| Cast Shadows | Use this to define how the Terrain casts shadows onto other objects in the SceneA Scene contains the environments and menus of your game. Think of each unique Scene file as a unique level. In each Scene, you place your environments, obstacles, and decorations, essentially designing and building your game in pieces. More info See in Glossary. Rendering.ShadowCastingMode controls how the Terrain shadow interacts with Scene objects. |
|
| Off | The Terrain does not cast shadows. | |
| On | The Terrain casts shadows. | |
| Two Sided | Casts two-sided shadows from either side of the Terrain. | |
| Shadows Only | Shadows from the Terrain are visible, but the Terrain itself is not. | |
| Reflection ProbesA rendering component that captures a spherical view of its surroundings in all directions, rather like a camera. The captured image is then stored as a Cubemap that can be used by objects with reflective materials. More info See in Glossary |
Use this to set how Unity uses Reflection Probes on Terrain. This setting only has an effect when MaterialAn asset that defines how a surface should be rendered. More info See in Glossary is set to Built In Standard, or if you use a custom Material (with Material set to Custom) that supports rendering with reflection. |
|
| Off | Disables Reflection Probes, and uses a skyboxA special type of Material used to represent skies. Usually six-sided. More info See in Glossary for reflection. |
|
| Blend Probes | Enables Reflection Probes. Blending occurs only between probes. Uses default reflection if there are no Reflection Probes nearby, but no blending between default reflection and probe. | |
| Blend Probes And Skybox | Enables Reflection probes. Blending occurs between probes, or between probes and default reflection. | |
| Simple | Enables Reflection probes, but no blending occurs between probes when there are two overlapping volumes. | |
| Material | Lets you specify the Material to use for rendering Terrain. | |
| Create | The Create button only appears when you select a default Terrain Material. It does not appear when you select a custom Material. When you click Create, Unity creates a copy of the Material in your Project folder, which you can modify, and then automatically selects this new copy. | |
Tree and Detail Objects
| Property | Function | |
|---|---|---|
| Draw | Check this box to draw trees, grass, and details. | |
| Bake Light Probes For Trees | If you check this box, Unity creates internal Light Probes at the position of each tree, and applies them to tree renderers for lighting. These probes are internal, and don’t affect other renderers in the Scene. If you don’t check this box, trees are still affected by Light Probe GroupsA component that enables you to add Light Probes to GameObjects in your scene. More info See in Glossary. This option is only effective for trees with Light Probe enabled on their prototype Prefab. |
|
| Remove Light Probe Ringing | If you check this box, Unity removes visible overshooting, which often appears as ringing on GameObjects that are affected by intense lighting. This setting reduces contrast, and is dependent on Bake Light Probes for Trees. For more information, see Light Probe Groups: Ringing. | |
| Preserve Tree Prototype Layers | Check this box if you want your tree instances to take on the layer values of their prototype PrefabsAn asset type that allows you to store a GameObject complete with components and properties. The prefab acts as a template from which you can create new object instances in the scene. More info See in Glossary, instead of the Terrain GameObjectThe fundamental object in Unity scenes, which can represent characters, props, scenery, cameras, waypoints, and more. A GameObject’s functionality is defined by the Components attached to it. More info See in Glossary’s layer values. |
|
| Tree Motion Vectors | Set whether to use motion vectors for trees painted on the terrain. Motion vectors track each renderer’s per-pixel, screen-space motion from one frame to the next. Note: Not all platforms support motion vectors. See SystemInfo.supportsMotionVectors for more information. This property corresponds to the Terrain.treeMotionVectorModeOverride API. |
|
| CameraA component which creates an image of a particular viewpoint in your scene. The output is either drawn to the screen or captured as a texture. More info See in Glossary Motion Only |
Use only camera movement to track motion. | |
| Per Object Motion | Use a specific pass to track motion. | |
| Force No Motion | Do not track motion. | |
| Inherit From Prototype | Use the Motion Vector property setting of the tree prototype. | |
| Detail Distance | The distance from the camera beyond which details are culled. | |
| Detail Density Scale | Scaling factor applied to the density of all details with the “Affected by Density Scaling” setting enabled. For more information, see Detail Settings. | |
| Tree Distance | The distance from the camera beyond which trees are culled. | |
| Billboard Start | The distance from the camera at which BillboardA textured 2D object that rotates so that it always faces the Camera. More info See in Glossary images replace 3D Tree objects. |
|
| Fade Length | The distance over which Trees transition between 3D objectsA 3D GameObject such as a cube, terrain or ragdoll. More info See in Glossary and Billboards. |
|
| Max Mesh Trees | The maximum number of visible Trees that are represented as solid 3D meshes. Beyond this limit, Billboards replace Trees. | |
| Detail Scatter Mode | The scatter mode type to be used while painting details. Coverage paints areas details should be populated in based on their density setting, Instance Count paints the amount per sample. | |
Wind Settings for Grass
| Property | Function |
|---|---|
| Speed | The speed of the wind as it blows across the grass. |
| Size | The size of ripples on grassy areas as the wind blows over them. |
| Bending | The degree to which the wind bends over grass objects. |
| Grass Tint | The overall color tint applied to grass objects. The final color that appears is the Grass Tint multiplied by the Healthy Color and Dry Color settings of each grass object. |
Wind Settings for Grass have no connection with Wind ZoneA GameObject that adds the effect of wind to your terrain. For instance, Trees within a wind zone will bend in a realistic animated fashion and the wind itself will move in pulses to create natural patterns of movement among the tree. More info
See in Glossary components. The two are unrelated.
Mesh Resolution
| Property | Function |
|---|---|
| Terrain Width | The size of the Terrain GameObject in its X-axis, in world units. |
| Terrain Length | The size of the Terrain GameObject in its Z-axis, in world units. |
| Terrain Height | The difference in Y-coordinate between the lowest possible heightmapA greyscale Texture that stores height data for an object. Each pixel stores the height difference perpendicular to the face that pixel represents. See in Glossary value and the highest one, in world units. |
| Detail Resolution Per Patch | The number of cells in a single patch (mesh). This value is squared to form a grid of cells, and must be a divisor of the detail resolution. |
| Detail Resolution | The number of cells available for placing details onto the Terrain tile. This value is squared to make a grid of cells. |
Holes Settings
| Property | Function | |
|---|---|---|
| Compress Holes Texture | If you check this box, Unity compresses the Terrain Holes Texture to the DXT1 graphics format in the Player during runtime. If you don’t check this box, Unity does not compress the Texture. | |
Texture Resolutions
| Property | Function | |
|---|---|---|
| Heightmap Resolution | The pixel resolution of the Terrain’s heightmap. This value must be a power of two plus one, for example, 513, which is 512 + 1. | |
| Control Texture Resolution | The resolution of the splatmap that controls the blending of the different Terrain Textures. | |
| Base Texture Resolution | The resolution of the composite Texture to use on the Terrain when you view it from a distance greater than the Basemap Distance. | |
Require resampling on change indicates that when you change properties under Texture Resolutions, the Editor resizes the Terrain tile’s content to the new size you specify, which can potentially affect the quality of your content.
Heightmap Import/Export buttons
The Import Raw and Export Raw buttons allow you to set or save the Terrain’s heightmap to an image file in the RAW grayscale format. You can create RAW format files in third-party terrain editing tools (such as Bryce), and you can open, edit, and save them in Photoshop. This allows for sophisticated generation and editing of terrains outside Unity.
Lighting
| Property | Function | |
|---|---|---|
| Contribute Global Illumination | Enable this check box to indicate to Unity that the Terrain influences Global IlluminationA group of techniques that model both direct and indirect lighting to provide realistic lighting results. See in Glossary computations. When you enable this property, Lightmapping properties appear. |
|
| Receive Global Illumination | You can only configure this option if you’ve enabled Contribute Global Illumination above. If you don’t enable Contribute Global Illumination, the Terrain registers as non-static, and receives Global Illumination from Light ProbesLight probes store information about how light passes through space in your scene. A collection of light probes arranged within a given space can improve lighting on moving objects and static LOD scenery within that space. More info See in Glossary. |
|
Lightmapping
| Property | Function | |
|---|---|---|
| Scale in Lightmap | Lets you specify the relative size of an object’s UVs within a lightmapA pre-rendered texture that contains the effects of light sources on static objects in the scene. Lightmaps are overlaid on top of scene geometry to create the effect of lighting. More info See in Glossary. If you set this to zero, the object is not lightmapped, but still contributes lighting to other objects in the Scene. A value greater than 1.0 increases the number of pixels (the lightmap resolution) used for this GameObject, while a value less than 1.0 decreases it. |
|
| Lightmap Parameters | Lets you adjust advanced parameters that affect the process of generating a lightmap for an object using global illumination. See Lightmap Parameters for more information about these settings. | |
| Rendering Layer Mask | Determines which rendering layer this Terrain lives on. When you use a scriptable render pipeline, you can specify an additional rendering-specific layer maskA value defining which layers to include or exclude from an operation, such as rendering, collision or your own code. More info See in Glossary. This filters the renderers based on the mask the renderer has and the mask passed to the DrawRenderers command. |
|
Quality Settings
| Property | Function | |
|---|---|---|
| Ignore Quality Settings | If you check this box, this Terrain ignores the Terrain Override Settings set in the Quality settings. | |
Terrain Collider
The Terrain ColliderAn invisible shape that is used to handle physical collisions for an object. A collider doesn’t need to be exactly the same shape as the object’s mesh - a rough approximation is often more efficient and indistinguishable in gameplay. More info
See in Glossary component manages collisionsA collision occurs when the physics engine detects that the colliders of two GameObjects make contact or overlap, when at least one has a Rigidbody component and is in motion. More info
See in Glossary on the terrain. For details about the Terrain ColliderA terrain-shaped collider component that handles collisions for collision surface with the same shape as the Terrain object it is attached to. More info
See in Glossary component properties, see the Terrain Collider component reference.
2022–07–20 Page amended
Updated content to reflect new quality change settings and updated UI