> 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

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="/files/IxbZSKX051n6FnlICSk7" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/G8qrVPkY1ht16lVwjcEd" 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="/files/4x1XCnrLAVFod1V6d55r" 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="/files/CYCrvH3YJHzbcccdh6zT" alt=""><figcaption></figcaption></figure>
