> For the complete documentation index, see [llms.txt](https://bkortbus.gitbook.io/ue5-simple-asset-library/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://bkortbus.gitbook.io/ue5-simple-asset-library/intro.md).

# Intro

Intro to the Simple Asset Library for UE5.2+

This plugin provides a relatively simple Asset Library system for UE5.2+. It's not meant to replace the Content Browser, but rather to work alongside it to provide a streamlined alternative experience browsing tagged assets

***

## Video Demo Overview

{% embed url="<https://www.youtube.com/watch?v=HyqoMak6gUE>" %}

## Launching the Asset Library

The tool can be launched from the Content Browser by pressing the `Asset Lib` button:

<figure><img src="https://116886798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG6OYD3otqbtR5YAiJNPN%2Fuploads%2FUwJ3HtwxqSyKPtN1FS1x%2Fimage.png?alt=media&amp;token=df07887f-0c92-47bb-af3f-02145480486b" alt=""><figcaption></figcaption></figure>

This is the interface for the Asset Library inside of Unreal:

<figure><img src="https://116886798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG6OYD3otqbtR5YAiJNPN%2Fuploads%2FJaPt8wJTN5TxvG2hNdCh%2Fscreenshot_main.png?alt=media&amp;token=f316b5d8-44b9-409b-88b3-5190fba2bd5e" alt=""><figcaption></figcaption></figure>

The UI displays tile entries for each `registered asset` in the system, giving quick access to desired assets regardless of where they live in the Content Browser.&#x20;

The colored borders around each asset represents their asset type - it's determined arbitrarily based on the declared asset types in the config, but in the above example characters are shown as red, and environment assets are shown as green.&#x20;

## Browse/Search  Features

Along the top menu bar are three methods to browse assets in the Asset Library:

<table data-header-hidden><thead><tr><th width="173"></th><th></th></tr></thead><tbody><tr><td><strong>Type</strong> dropdown</td><td>The <code>type</code> dropdown refers to the asset type within the Asset Library system (not the actual Unreal Class). We can use this to focus on only the <code>character</code> or <code>environment</code> assets. <code>all</code> will show every asset<br><br><em>note</em>: Asset Types are declared in the config file and are assigned an arbitrary color in the UI</td></tr><tr><td><strong>Cat</strong> dropdown</td><td>The <code>Category</code> (<strong>cat</strong> for short in the UI) dropdown allows for further sorting of assets within a given Asset Type, such as there being <code>grass</code>, <code>flowers</code>, and <code>trees</code> categories within the <code>environment</code> asset type<br><br><em>note</em>: users can declare additional Categories when adding assets to the Asset Library</td></tr><tr><td><strong>Filter</strong> input</td><td>The <code>Filter</code> input provides a text match search to the user. This will check for matches in the entry's <code>official asset name</code> as well as the <code>asset library display name</code>. </td></tr></tbody></table>

## Browse/Search Examples

In the example below I selected the `envir` asset type, which is where our `environment assets` are declared, and further focused on the `flowers` category. This allows us to browse assets we know belong to a specific grouping:

<figure><img src="https://116886798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG6OYD3otqbtR5YAiJNPN%2Fuploads%2FE06nRSBncsyoiJt1oUg2%2Fscreenshot_search_fields.png?alt=media&amp;token=6379b42b-17a1-438b-b43a-320f5d6ad376" alt=""><figcaption></figcaption></figure>

Another option is to use the `filter` field to find assets of any type. In the example below it's searching for any asset that has `ca` in its name - either the `Asset Library Display Name` or its official `Unreal Asset Name`:

<figure><img src="https://116886798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG6OYD3otqbtR5YAiJNPN%2Fuploads%2FTlO9FpKUruD7wcLbvYNE%2Fscreenshot_filter_field.png?alt=media&amp;token=3c03848a-3b58-4984-8266-9b4ef579a96a" alt=""><figcaption></figcaption></figure>
