Skip to end of metadata
Go to start of metadata

THIS IS A BETA FEATURE

Overview

The Asset Browser provides you with an overview of your project's content. You can browse your project in its entirety, search for particular assets, as well as import new assets from FBX but in the future all the asset management functionality will be added to the Asset Browser.

In short, the entire workflow will eventually revolve around the Asset Browser, and the regular file explorer should not be necessary anymore when working on a CRYENGINE project. In fact, the goal of this feature is for users of CRYENGINE to ignore what lies on the disk completely and only interact with their project through the Editor. This gives us the freedom of changing how things appear on disk without changing anything in the user experience.

For now though, functionality is limited and it is to be considered an experimental (Beta) feature.

Icon

In this release, we're focusing on upgrading old projects to Asset Browser-compatible projects. Please try it out and give us any feedback you can.

For more information about the system that's behind the Asset Browser, click here.

Pic1: Asset Browser

Opening the Asset Browser

Icon

Before using the Asset Browser on an existing project, you'll need to generate *.cryasset files to be able to see your assets in the Asset Browser.

See here how to do this.

The Asset Browser can be opened in two ways:

  • by going to Tools -> Asset Browser
  • by pressing F2. This toggles the Quick Asset Browser, letting you quickly open and close it whenever you need it. Since in the future the workflow within CRYENGINE will use the Asset Browser extensively, using F2 is the recommended way of opening it.

1. Menu Bar

File

OptionDescription
ImportImport assets. This will automatically open the relevant importer tool for the selected asset.

Edit

OptionDescription
FindMoves the cursor to the Search Assets bar so assets can be searched for.

View

OptionDescription
Show Folder TreeShows/hides the Folder Tree pane.
Show PreviewShows/hides the Preview pane.
Recursive ViewActivates/deactivates Recursive View in the Search Results pane. This means that all assets in the selected folder in the Folder Tree AND its subfolders are shown in the Search Results pane instead of just the ones in the selected folder.
Recursive SearchTurns the search in the Search Assets bar into a recursive search; the results from the search in the Search Assets bar will show all the results in the selected folder and its subfolders.
Icon

When Recursive View and/or Recursive Search are active, you can also select multiple folders. The Search Results will then show any assets in those folders.

2. Navigation Bar

Lets you go to the previous/next folder you selected and shows you the path of the currently selected folder.

3. Folder View

Shows the folders within your project and lets you navigate through them. The Search Folders bar lets you type in part of the name of a folder and filters out any folders that correspond to the search.

Right Click Menu

Right clicking anywhere in this pane will let you add a new folder.

4. Search Results

This is where the assets and results of your searches and filters are displayed. 

Right Click Menu

Right clicking on the headers in this pane (Name, Type, etc) will let you add new columns with other information (which can also be filtered by).

5. Preview

This pane shows a preview of the selected asset (when possible).

Functionality

The Asset Browser in this release is a proof of concept with some very basic functionality.

Favorites

You can add individual assets to your Favorites list by clicking the open star in front of them in the Search Results pane:

The icon will change into a filled in star and the assets will be added to your Favorites list. This list can be accessed by clicking the star button in front of the Search Assets bar:

Icon

The Favorites list will only show your favorite assets in the selected folder in the Folder View on the left and its sub-folders.

 

Smart Search Bar & Advanced Search Bar

Smart Search Bar

The Search bar at the top of the Search Results is capable of searching for much more than just the name of an object or asset. It will search in all the columns that can be displayed in the Search Results below, so for example, if you want to search for textures with "leaf" in their names, you could simply type in "leaf texture" and it will only show these textures.

Icon
In future releases, more columns will be added to the Search Results, allowing you to make more and more complex queries.

Advanced Search Bar

The Search Assets bar at the top is a Smart Search bar and the filters are part of the Advanced Search Bar. More information about these can be found here.

Drag & Drop into Viewport

(i would rename this section "create objects in level" and explain that it will supersede and eventually replace the create objects tool, at least for placing assets)

If an asset is an object or mesh, it is possible to drag it from the Asset Browser and drop it directly into the main viewport. 

Importing Assets

Either click File -> Import or drag & drop the asset into your preferred folder in the Asset Browser and the appropriate Importer tool will open.

When using File -> Import, the following dialog will open, letting you choose which parts of the asset(s) you want to import:

When dragging & dropping, all of these will be imported by default.

Icon

It is possible to call up this dialog when dragging & dropping; simply hold Ctrl while doing this and when you drop the asset into a folder, the dialog will appear.

Icon

You can import multiple assets at a time by holding Shift or Ctrl and selecting more than one file.

Future Functionality

Examples of functionality that will be added to the Asset Browser in the future: 

  • Thumbnail view instead of preview pane
  • Create assets of any type
  • Edit assets of any type
  • Delete/Move/Rename assets
  • Source control integration
  • Dependency tracking

CVars

CVarValuesDescription

ed_enableAssetPickers

0 - Off

>0 - On

When clicking the Browse button in Asset Pickers, will open an Asset Browser window instead of the default Open File window, letting you pick assets instead of separate files.
  • No labels