Menu
Lumberyard
User Guide (Version 1.13)

Asset Browser

The Asset Browser displays all project assets in a source folder and file view to enable quick access and interaction. You can use the Asset Browser with other editor components to improve your development workflow, such as the viewport and Entity Inspector. The Asset Browser displays assets that Asset Processor successfully processed and that appear in the cache database.

To open the Asset Browser

  • From Lumberyard Editor, choose Tools, Asset Browser. You can dock the Asset Browser window to Lumberyard Editor.

    
                    Use the Asset Browser to search and view assets in your game project.

The Asset Browser displays source assets along with their products. For example, an .fbx file would appear with its meshes and animations, as shown in the following example. However, if the source and product asset have the same name and extension, then the products are hidden to conserve space.


            A character.fbx source file with two products: character.chr and character.skin.

The Asset Browser also includes the following features:

Drag and Drop

You can drag assets from the Asset Browser into the viewport or the Entity Inspector.

When you drag an asset from the Asset Browser into the viewport, Lumberyard Editor does the following:

  • Creates a new entity at the cursor's location.

  • Adds the associated component, which is denoted by the icon next to the asset in the Asset Browser.

  • Assigns the dragged asset into that component's property.

For example, dragging the brokenrobot05.cgf file creates a new entity, adds a Mesh component, and assigns the dragged asset into the Mesh asset field.


                Dragging brokenrobot05.cgf from the Asset Browser into the viewport automatically creates an entity named brokenrobot05
                    and assigns brokenrobot05 as its Mesh asset.

When you drag an asset into the Entity Inspector, the asset's associated component is added to all entities that are currently selected in the Entity Outliner.


                Animation showing a boulder mesh asset dragged into the Entity Inspector while three empty entities are selected in the
                        Entity Outliner. Three boulders appear in the viewport.

You can also drag the appropriate file type into a component property's field. For example, you can drag a material file (.mtl) into the Material override field on the Mesh component. The boulder in the viewport displays the new material.


                Animation showing a material dragged from the Asset Browser into the Entity Inspector. The material is dropped onto the
                        Mesh component's Material override field.

Context Menu Operations

To display a context menu, right-click an item in the Asset Browser. The following menu options appear:

  • Open

  • Open in Explorer

  • Copy Name To Clipboard

  • Copy Path To Clipboard

Some files, such as .fbx files, have an additional Edit Settings menu option, which opens the FBX Settings.


                Right-click context menu for an .fbx file in the Asset Browser

If source control is enabled, the following additional options appear:

  • Check Out

  • Undo Check Out

  • Get Latest Version

  • Add To Source Control


                Right-click context menu in the Asset Browser with source control enabled

Filtering

You can filter what appears in the Asset Browser by file name, asset type, or both.

To filter by asset type

  1. Choose the filter icon in the upper-right corner of the Asset Browser.

  2. Select one or more asset types.

    
                        Filter assets by type in the Asset Browser.

    To reset your selection, in the Filter by drop-down menu, click Reset or Clear in the main Asset Browser.

To filter by file name

  • Type search terms into the filter search bar.

    
                        Type search terms into the Asset Browser's search bar.

    The filtering process is dynamic, which means that the display updates as you type.

    The search function also has the following features:

    • Recognizes multiple words and performs an and search on assets and directories that contain all of the search terms in any order.

    • Is not case sensitive.

    • Displays product assets that match the search string.

    • Displays source assets that match the search string and contain at least one valid product.

    • Displays directories that match the search string and contain at least one valid product. All products in each displayed directory and its subdirectories are displayed.