Library Browser

The Library Browser is used to browse and create assets in the current project. With the Library Browser, you can select, view, edit, move, rename, and delete project assets. You can drag some asset types from the Library Browser directly into the 3D Edit Window to place them in the current scene.

The Library Browser is divided into two panels. The panel on the left displays the directory structure within the Assets folder, enabling you to quickly navigate in the folder hierarchy. The panel on the right displays the contents of the currently selected folder.

Only files recognized by RoadRunner as assets are displayed. Other system files and auxiliary files in the directory are not shown.

View an Asset

To view an asset, select the asset in the Library Browser. Attributes for the selected asset display in the Attributes Panel, and a preview of the asset displays in the Asset Viewer.

Changes made to the attributes of individual assets are saved when either the current scene or project are saved.

Rename an Asset

  1. Right-click the asset in the Library Browser and select Rename (or press F2).

  2. Enter a new name and press Enter.

Move Assets or Folders

  1. Select the assets or folders in the Library Browser.

  2. Click and drag the assets or folders to a different folder in either the left or right panel.

Moving an asset automatically updates asset references in the current scene, but other saved scenes might still reference the old asset location. Refer to Find Moved Assets.

Create a New Folder

  1. Right-click in the Library Browser and select New > Folder. Alternatively, select the Assets > New > Folder menu option.

  2. Enter a name and press Enter.

Create a New Asset

Create an Asset from Within RoadRunner

You can create some assets from directly within the Library Browser, such as materials and road styles. Follow these steps:

  1. Navigate to the folder in the Library Browser where you want to create the new asset.

  2. Right-click in the Library Browser and select New > (Asset Type). Alternatively, select the Assets > New > (Asset Type) menu option.

  3. Enter a name and press Enter.

Create an Asset from a File Created Outside Runner

Some assets depend on files created outside of RoadRunner, such as a texture image saved as a PNG file or a 3D tree saved as an FBX® file. To create such assets for use in RoadRunner, drag the dependent file into the Library Browser. Follow these steps:

  1. Navigate to the folder in the Library Browser where you want to add the new asset.

  2. In the File Explorer window for your operating system, navigate to the location of the dependent file (for example, the texture image or the 3D model).

  3. Select the file (and any associated files or folders) in the File Explorer.

  4. Drag the files (and any associated files or folders) into the Library Browser.

This operation copies (rather than moves) the selected files into the directory of the current project.

Alternatively, you can perform these steps by using the File Explorer window. Copy and move the files somewhere under the "Assets" directory of your project. This option can be useful if you want to move (rather than copy) the files or if you want to use an external script.

Modify an Asset

The steps to modify an asset differ depending on the specific type of asset (refer to the documentation for the specific asset type).

In most cases, you can modify an asset by following these steps:

  1. Select the asset in the Library Browser.

  2. View and modify the asset attributes displayed in the Attributes Panel.

Some assets (such as Sign Assets) are modified using the 2D Edit Window.

Modifications made to an asset are saved only when the project is next saved.

Duplicate an Asset

  1. Right-click the asset in the Library Browser and select Duplicate.

  2. Enter a name for the new asset and press Enter.

You can use these steps only for assets created within RoadRunner (for example, a material or road style asset). If you want to duplicate an asset that depends on another file (for example, a texture image or 3D model), duplicate the dependent file only (not the rrmeta file) by using the File Explorer for your operating system.

Delete an Asset or Folder

  1. Select the assets or folders in the Library Browser.

  2. Right-click and select Delete. Alternatively, select the Edit > Delete menu option or press Delete.

Add an Asset to a Scene

The steps to add an asset to a scene differ depending on the specific tool and type of asset. Refer to Digitizing (Creating) Objects.

Most assets can be added to a scene by dragging them into that scene. Click and drag an asset from the Library Browser into the 3D Edit Window. RoadRunner automatically switches the current editing tool to the appropriate tool for that asset.

Reload Modified Assets

If you change an asset by using an external application (for example, if you modified a texture file using an image editor), you can force RoadRunner to reload the asset. Right-click in the Library Browser and select Update Assets. Alternatively, select the Assets > Update Assets menu option.

Find Moved Assets

If an asset or asset folder has been moved or renamed, then existing scene files might still refer to the old location. If a scene cannot find an asset, RoadRunner replaces references to that asset with a visually distinct fallback asset (for example, props display as pink barrels, and textures display as striped red and blue images).

If you encounter this situation, RoadRunner can search for the missing references and attempt to relink them. Follow these steps:

  1. Open the scene file containing missing asset references.

  2. Right-click in the Library Browser and select Update Assets. Alternatively, select the Assets > Update Assets menu option.

This search finds moved assets only if the corresponding rrmeta file was also moved or renamed and was left intact.