Lumberyard
User Guide (Version 1.16)

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 the Entity Inspector.

The Asset Browser shows all files inside your watch folders that are specified in the lumberyard_version\dev\AssetProcessorPlatformConfig.ini file. In the Asset Browser, usable files appear white. Non-usable files such as .exe or .zip appear gray.

To open the Asset Browser

  1. From Lumberyard Editor, choose Tools, Asset Browser.

    
                    Search and view assets in your game project with the
                            Asset Browser.
  2. Dock the Asset Browser window in Lumberyard Editor as needed.

The Asset Browser displays source assets along with their products. For example, an .fbx file appears with its meshes and animations. However, if the source and product asset have the same name and extension, then the products are hidden to save space.

Example

The WombearActor.fbx file has two products, an actor and mesh.


                A WombearActor.fbx source file with two
                    products.

Files that are unprocessed or not usable in Lumberyard Editor appear gray.


            Ignored or unprocessed files are grayed out in the
                    Asset Browser.

With the Asset Browser, you can do the following:

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 indicated by the icon next to the asset in the Asset Browser.

  • Assigns the asset for that component's property.

Example

You can drag the brokenrobot05.cgf file to the viewport, which creates a new entity, adds a Mesh component, and assigns the asset into the Mesh asset property.


                    Dragging an asset from the Asset Browser into the
                        viewport automatically creates an entity and assigns a Mesh
                            asset.

Example

You can select multiple entities in the Entity Outliner and then select and drag an asset into the Entity Inspector. This adds the Mesh component and the associated mesh asset to the selected entities.


                    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.

Example

You can drag an asset file (.cfg) into the Material asset field on the Mesh component. The boulder in the viewport displays the new asset.


                    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

In the Asset Browser, right-click an asset to display a context menu. The following menu options appear:

  • Open with associated application – Opens the file with the default application that you specify. For example, if you specified Photoshop to open .tiff files, this opens the file in Photoshop.

  • Open in Explorer – Opens the asset in Windows Explorer.

  • Copy Name To Clipboard – Copies the asset name.

  • Copy Path To Clipboard – Copies the path of the asset.

Note

You can also open some files in their respective Lumberyard tool, such as the Lua Editor for .lua files.


                    Right-click context menu for assets in the
                            Asset Browser

Some files, such as .fbx files, have an additional Edit Settings option, which opens the FBX Settings tool. For more information, see Working with the FBX Settings Tool.


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

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

  • Check Out – Check out the file in source control.

  • Undo Check Out – Undo check out for the file.

  • Get Latest Version – Get the latest version of the file.

  • Add To Source Control – Add the file 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 your assets

  1. In the Asset Browser, choose the filter icon in the upper right.

  2. Select one or more asset types.

    
                        Filter assets by type in the
                            Asset Browser.
  3. To filter by file name, type search terms into the search bar.

    The filtering process is dynamic, which means that search results update as you type.

    
                        Type search terms into the Asset Browser's
                            search bar.
  4. To reset your selection, in the Filter by drop-down menu, click Reset or Clear.

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.