User Tools

Site Tools

Basic Workflow

The SpeedTree Modeler, which runs separately from Lumberyard, offers procedural and hand modeling tools that allow both efficiency and precision.

Note: SpeedTree for Lumberyard is compatible only with Lumberyard 1.9 and later.
Note: Files exported by the SpeedTree for Lumberyard Modeler (.CGF) will not work in CryEngine.

Activating Your Free License

The SpeedTree 8 for Lumberyard Modeler is available with a free license provided by Amazon. In order to use the Modeler, you will need to activate your free license on the SpeedTree Store.

To activate your license:

  1. Navigate to the SpeedTree for Lumberyard Product Page.
  2. Select “Activate License” To add the free product to your account.
  3. Complete the checkout process, creating a SpeedTree Store account if you do not already have one.
  4. You will now be able to login to the SpeedTree Modeler with your SpeedTree Store Credentials.
Note: Only one license can be activated per SpeedTree account, and only one copy of the Modeler can be used at a time. If your team requires multiple seats of the SpeedTree for Lumberyard Modeler, you will need to create multiple SpeedTree accounts.

How Does It Work?

SpeedTree 8 for Lumberyard can open SpeedTree files (.SPM) and export them in a format specific to Amazon Lumberyard (.CGF). It’s important to note that SpeedTree 8 for Lumberyard will not export meshes outside of the “.CGF” file format and is incompatible with other game engines, including CryEngine.

Using the SpeedTree Modeler is a three-step process:

  1. Create or purchase a SpeedTree model: Whether you use models from our library or create them from scratch using the SpeedTree Modeler, you’ll need a model to get started. Models consist of the SpeedTree files (.SPM) and the textures and component meshes (.OBJ, .FBX) associated with it. Click here to learn more about creating models in SpeedTree.
  2. Export the model as a “.CGF” file: SpeedTree models are exported directly into your Lumberyard project. Once they’ve been exported into the project, the asset processor will recognize the “.CGF” file and process it accordingly. SpeedTrees can be exported with up to 3 LODs with vertex painted colors for wind added procedurally. Once you’ve opened the model in your scene, you will need to enable the wind on the tree you’ll need to edit the “Bending” value to a value greater than zero.
  3. Place models in your scene: Once imported, SpeedTree models can be placed or painted like any other static mesh. Click here to learn more about placing vegetation in Lumberyard.
Note: Due to a current bug in the Lumberyard Editor, if the tree is re-exported using a different export method (i.e. a change in what is atlased), Lumberyard will need to be restarted becaseu the “.MTL” file can’t be updated while the Lumberyard Editor is running.

Preparing Your Lumberyard Scene

After exporting your SpeedTree to your project, there are key elements that will help make your scene look great.


By default, new levels in Lumberyard don't have any global illumination enabled resulting in black shadows. To add diffuse to the shadows in your scene you will need to either enable Voxel Global Illumination or add an environment probe.

A Sample Conifer with-out Global Illumination enabled:

To enable voxel global illumination

  1. In the Rollup Bar, on the Terrain tab, choose Environment.
  2. In the Environment panel, under Total Illumination v2, check the parameter “Active” to Activate voxel GI for the level.

A Sample Conifer with Global Illumination enabled:

Enabling Wind

SpeedTree leverages Lumberyard's native wind mechanism for the Lumberyard compatible versions of the Modeler. This wind can be previewed and edited inside of the SpeedTree for Lumberyard Modeler. (Lumberyard Wind)

When you export the tree for Lumberyard, all of these settings except “Bending” will be imported. There is no mechanism for importing the main bending value via the “.CGF” file, so you'll need to enter your “Bending” value manually in Lumberyard.

“Bending” and other vegetation parameters can be accessed in the Terrain, Vegetation panel in Rollup Bar for a previously selected vegetation object. You can adjust the parameters for one or more selected objects.

The “Bending” Value can be

For More Information