Skip to main content

How to Create a New Builder Asset

Lightship map themes use configurable feature builders for generating and rendering meshes for map tiles features. For more information on how feature builders work, see Feature Builders.

Prerequisites

  1. You will need a new 3D (URP) Unity project with Lightship Maps installed. For instructions, see Installing the Lightship Maps SDK.
  2. You will need an existing theme in the Hierarchy. You can use your own or drag an existing theme into the Hierarchy.

Steps

To create a new builder asset, and add it to a theme:

  1. In the Hierarchy, find and open up the theme where you’d like to add the new builder. Double-click it to make sure that it is the primary object in the Hierarchy.
  2. In the GameObject menu (or the right-click menu) select Create Empty.
  3. Name the object as your new builder name.
  4. Select the object and click Add Component from the Inspector tab.
  5. Use the search bar to find one of the following builders:
  • Standard:
    • Area Feature Builder
    • Ground Builder
    • Linear Feature Builder
    • Structure Feature Builder
  • Performance:
    • Area Feature Builder Async
    • Area Object Builder
    • Ground Builder Async
    • Linear Feature Builder Async
    • Structure Feature Builder Async
    • Map Feature Prefab Spawner
  1. Select the builder to add it to the Inspector tab.
  2. Select the theme in the Hierarchy tab. Double-click it to make sure that it is the primary object in the Hierarchy.
  3. Expand the Builders list (above the Skybox).
  4. Click + to add a builder to the list.
  5. From the Hierarchy, drag and drop your new builder where it says "None (Feature Builder Base)".
note

You may need to click out of the theme before the new builder shows up in the ‘Select A Builder’ drop down.

See Also