Forest TSStatic Mover

The Forest TSStatic Mover moves instances between the Forest system and TSStatic objects. It is useful when repeated props should be converted to lightweight forest items, or when selected forest items need to become normal scene objects for manual editing.

Use it when you need to change the representation of already placed objects without manually recreating every transform.

Open it from the World Editor window menu as Forest TSStatic Mover.

Requirements

The tool depends on the current edit mode:

  • Use Forest Tools mode to move selected forest items to TSStatic.
  • Use Object Select mode to move selected TSStatic objects to forest items.
  • The level must contain forest data before TSStatic objects can be converted to forest items.

The window displays the current edit mode and the selected shape. If the selected shape is shown as -none-, switch to the correct edit mode and select a valid forest item or TSStatic.

When To Use Each Object Type

Use ForestItems for large amounts of repeated, mostly static scatter content such as vegetation, rocks, small props, and other repeated meshes. Forest items are managed by the Forest system and are usually more efficient for dense repeated placement.

Use TSStatic for individually managed scene objects, especially when the object needs normal Scenetree organization, custom object fields, per-object editing, special grouping, or workflows that depend on standard scene object selection.

Converting between the two is useful during optimization. For example, early blockout work may use TSStatic objects for precise editing, then repeated meshes can be moved to forest items once placement is final.

Options

  • Select Moved: selects the newly created objects or forest items after the move.
  • Move all instances of selected shape: expands the current selection to all matching instances that use the same shape.
  • Put created TSStatics into new folder (SimGroup): when converting forest items to TSStatic, places the created objects inside a new SimGroup.

Move all instances of selected shape uses the selected object’s mesh as the reference. For TSStatic, matching is based on the shapeName field. For forest items, matching is based on the selected forest item’s ForestItemData.

Disable this option when you only want to convert a small hand-picked selection.

Move Forest Items To TSStatic

  1. Switch to Forest Tools mode.
  2. Select one or more forest items.
  3. Choose whether to move only the selection or all instances of the selected shape.
  4. Click Move selected ForestItems -> TSStatic.

The tool creates TSStatic objects with matching shape, transform, and scale data, then removes the source forest items.

If Put created TSStatics into new folder (SimGroup) is enabled, the created objects are placed under a new group named from MovedForestToTSStatic. This makes it easier to review, rename, move, or delete the converted objects before saving the level.

Move TSStatic To Forest Items

  1. Switch to Object Select mode.
  2. Select one or more TSStatic objects.
  3. Choose whether to move only the selection or all instances of the selected shape.
  4. Click Move selected TSStatic -> ForestItems.

If no matching ForestItemData exists for the selected shape, the tool creates one in the level forest data and then creates forest items at the original transforms.

The new forest item data is saved under the level’s forest data path, using the selected mesh’s shape file. After conversion, the Forest Editor list may refresh so the new mesh entry is visible.

What Is Preserved

The conversion keeps the placement data that both systems share:

  • Mesh or shape file.
  • World transform.
  • Position and rotation.
  • Scale, within the limits of the target object type.

Object-specific data is not equivalent between the two systems. Custom TSStatic fields, Scenetree group organization, object names, and per-object metadata do not become forest item metadata. Forest brush settings also do not become TSStatic fields.

Recommended Workflow

  1. Save the level or make a backup before doing large conversions.
  2. Convert a small representative selection first.
  3. Inspect the created objects or forest items.
  4. Undo and adjust options if the result is not correct.
  5. Convert the full set with Move all instances of selected shape if needed.
  6. Save the level after confirming the result.

Notes

  • Moving TSStatic objects to forest items converts scale to a single forest scale value.
  • The operation supports undo and redo through the editor undo stack.
  • Save the level after confirming the converted objects are correct.
  • Avoid converting objects that rely on unique TSStatic fields or names unless you no longer need that object-specific data.

Related Tools

Last modified: July 23, 2026

Any further questions?

Join our discord
Our documentation is currently incomplete and undergoing active development. If you have any questions or feedback, please visit this forum thread.