Legacy Documentation: Version 5.0
Textures
Grass and Other Details

Trees

Suggest a change

Success!

Thank you for helping us improve the quality of Unity Documentation. Although we cannot accept all submissions, we do read each suggested change from our users and will make updates where applicable.

Close

Sumbission failed

For some reason your suggested change could not be submitted. Please try again in a few minutes. And thank you for taking the time to help us improve the quality of Unity Documentation.

Close

Cancel

Unity terrains can be furnished with trees. Patches of trees can be painted onto a terrain in much the same way that heightmaps and textures are painted but the trees are solid 3D objects that grow from the surface. Unity uses optimisations (eg, billboarding for distant trees) to maintain good rendering performance, so you can have dense forests with thousands of trees and still keep an acceptable framerate.

Terrain with trees
Terrain with trees

Enabling Trees

The tree button on the toolbar enables tree painting.

Initially, the terrain will have no trees available but if you click the Edit Trees button and select Add Tree you will see a window to select a tree asset from your project.

The Add Tree window
The Add Tree window

Unity comes with several sample SpeedTree tree objects in the Standard Assets packages for prototyping purposes Assets > Import Package > Terrain Assets) but you can also create suitable objects with SpeedTree Modeler app, Unity Tree Creator tools or other 3D modelling apps.

If the selected tree object is created by the Tree Creator, the window will show Bend factor for adjusting the wind responsiveness. See the section on Making trees bend in the wind below.

Painting Trees

With a tree selected, you can paint onto the landscape in the same way you paint textures or heightmaps. You can remove trees from an area by holding the shift key while you paint and remove just the currently selected tree type by holding down the control key. The familiar Brush Size option is available for tree painting but the Opacity property is replaced by Tree Density, which controls the average number of trees painted into a given unit of area.

There is a ranged slider for you to control the tree’s minimal height and maximal height. If you disable Random, you can specify a value for all tree’s height. By default a tree’s width is locked to height so that trees are always scaled uniformly. However you can disable Lock Width to Height option and specify the width separately.

There is also a control for Color Variation and Random Tree Rotation. The variation options help to create the impression of a random, natural-looking forest rather than an artificial plantation of identical trees.

The Mass Place Trees button is a very useful way to create an overall covering of trees without painting over the whole landscape. Following a mass placement, you can still use painting to add or remove trees to create denser or sparser areas.

SpeedTree/LOD Trees

From Unity 5, you can use SpeedTree Modeler from IDV, Inc. to create trees with advanced visual effects such as smooth LOD transition, fast billboarding and natural wind animation. Please refer to their site for detailed information. You can also freely import SpeedTree assets into your project folder from asset store packages or other third party sources.

SpeedTree assets (.SPM files saved by Unity version of SpeedTree Modeler) are recognized and imported by Unity 5 just like other assets. Make sure the textures are reachable in the project folder and materials for each LOD will be generated automatically. There are import settings when you select .SPM assets for you to tweak the generated game object and materials. Materials will not be generated again on reimporting, unless you hit the Generate Materials or Apply & Generate Materials button, therefore any customisations to the materials can be preserved.

SpeedTree importer in the end generates a prefab with LODGroup component configured. The prefab can both be instantiated in a scene as a common prefab instance or be selected as a tree prototype on the terrain and paint massively. Additionally, terrain accepts any game object with an LODGroup component as a tree prototype, and put no limitation on the mesh size or number of materials being used (on contrast to the Tree Creator trees, described below). But be aware that SpeedTree trees usually use 3–4 different materials, results in a number of draw-calls being issued every frame. So try avoid heavy use of LOD trees on platforms that are sensible to draw-call numbers.

Tree Creator trees

Unity has its own Tree creator that you can use to produce new tree assets but you can also use a standard 3D modelling app for the task. The tree mesh should have fewer than 2000 triangles (for performance reasons) and the anchor point should be right at the base of the tree where it emerges from the ground. The mesh should always have exactly two materials, one for the tree body and the other for the leaves.

Trees must use the Nature/Soft Occlusion Leaves and Nature/Soft Occlusion Bark shader. In order to use those shaders you also have to place the tree in a special folder that contains the name “Ambient-Occlusion”. When you place a model in such a folder and reimport it, Unity will calculate soft ambient occlusion in a way that is specifically designed for trees. The “Nature/Soft Occlusion” shaders rely on the folder naming convention and the tree won’t render correctly if you don’t follow it.

When you save a tree asset from the modelling app, you will need to click the Refresh button (shown in the inspector when the tree painting tool is selected) in order to see the updated trees on your terrain.

Using Colliders with Trees

You can add a Capsule Collider to a new tree asset by instantiating it in the scene, adding the collider (menu: Component > Physics > Capsule Collider) and creating a new prefab for the modified tree object. When you add the tree to the terrain for painting, make sure you select the prefab with the collider rather than the original object. You should also enable Create Tree Colliders in the terrain’s Terrain Collider component inspector.

Making trees bend in the wind

The first thing you will need to do is create a wind zone. You can do this by selecting from the menu: Game Object > Create General > Wind Zone.

At this point, you will need to make sure that your trees are set to bend. Select your tree types, then select Edit Trees… -> Edit tree. Setting the bend value to 1 will cause the trees to adjust if you have not already done this.

You may notice that your trees are moving about quite violently. To fix this, you can change your bend value, but it is probably easier to set the values on the “Wind zone” directly, keeping your tree bend value set to 1. To keep the trees from fluttering around too much, adjust the wind turbulence down to around 0.1 to 0.3 and everything will become much smoother. If you don’t want the trees blowing all the way to one side, set the Wind Main value down to the same value as your turbulence.

Textures
Grass and Other Details