Jump to content

* * * * *
In this tutorial we are going to have a look at the asset browser. The asset browser lets you view all assets in a project directory.  Assets are files the game loads media from. Assets include textures, shaders, materials, models, sounds, scripts and fonts.

Let’s select the Assets tab in the side panel.

Attached Image: asset tab.JPG

The asset browser is divided into two parts.  On top the project's directory structure is shown.  You can use this to navigate around a project's folder hierarchy. Below this the files in the current directory are displayed as thumbnails or icons, depending on the file type.  If the Recursive checkbox is checked, files in all subfolders will be displayed as well, otherwise only files in the currently selected folder will be shown.

Attached Image: different icons per asset type.JPG

Directory Structure

Let’s open the root project folder of the project by right-clicking on the "TutorialProject" folder at the top of the directory tree, and selecting the Open Folder popup menu.  A folder now opens on your computer that contains the entire game project.

Attached Image: open folder.jpg

By default all new projects will have the following folders created:
  • Fonts
  • Maps
  • Materials
  • Models
  • Prefabs
  • Projects
  • Scripts
  • Shaders
  • Sound

Attached Image: folder structure project.jpg

The shaders, scripts, textures, and materials folders should always be in a project. Without those folders your project may not work properly. Other folders are not necessarily required, but it's a good idea to use the defaults Leadwerks provides. In all Leadwerks tutorials we will make use of the default folder layout.

Creating and Deleting Folders

If you want a new folder to store a certain type of asset, you can simply create is in the project folder on your computer. Leadwerks automatically detects the change in your project and displays it to the asset browser. Create a new folder called ‘Test’ in the opened folder and switch back to the editor to see that it appeared automatically.  This makes it very easy to work with files in Leadwerks.

Attached Image: new folder.JPG

You can also right-click on any folder in the assets tab and select the  Create Folder popup menu to make a new subfolder. Try creating a subfolder called "Subtest" inside the "Test" folder by right-clicking on the "Test" folder and selecting the Create Folder menu.

Attached Image: new folder option.jpg

Attached Image: create sub folder name.JPG

You can remove a folder from your project by right-clicking on it and selecting the Remove popup menu.  The folder and all its files and subfolders will be deleted from your project.  Fortunately, a warning dialog will appear to make sure you really meant to do that.

Attached Image: delete folder quickmenu.jpg


The search bar can be used to filter files with a search term.  As soon as you type your search term in here, the editor will search for assets with the search term in it.  A list of recent search terms is available in the drop down items of the search bar.

Attached Image: search bar.JPG

Select the ‘Models’ folder and uncheck the Recursive checkbox that sits to the right of the search box. We are going to look for assets that have something to do with crates. Click in the search panel and type the word ‘Crate’. Notice how we are not getting any results back. This is because we are only looking in the ‘Models’ folder and not in any subfolders residing in the Models folder.

Attached Image: empty search result.JPG

Now check the ‘Recursive’ checkbox to the right of the search box. Notice how are now we are getting lots of results appearing. The recursive checkbox makes it so the editor also looks in the subfolders of the  ‘Models’ folder so all files will be found.

Attached Image: recursive search.JPG


Pretty easy, huh?  Since you now know the basics of navigating a project and finding files, we will talk about the different kinds of assets in later tutorials.