# Tab: Favorites and Prefabs

## Use Case

* Favorites and prefabs let you alias anything you want (Single objects to whole groups)
* Things marked as favorite can be assigned a name, category and tags
* The combination of categories and tags allow for both for browsing through your library, and also highly specifc and organized searching
* The favorites system offer multiple ways of browsing and searching:
  * Simple text based search
  * Tag based filters
  * Grouping a categories contents by tags
* Categories can be easily shared and merged

{% hint style="success" %}
Category files can be found in `Cyberpunk 2077\bin\x64\plugins\cyber_engine_tweaks\mods\entSpawner\data\favorite` (E.g. For sharing)
{% endhint %}

## Terminology

* Favorite: This is a single object
* Prefab: This is an entire group, made to be re-usable just like single objects

{% hint style="success" %}
In the following, "Favorite" and "Prefab" is used interchangeably, since they are treated exactly the same
{% endhint %}

## Creating Categories

* The main favorites view can be found on the "Spawn New" tab, specifically the `Favorites` subtab
* Underneath the `Add Category` header, you can find everything you need to make a new category

<figure><img src="https://1427525421-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4gzcGtLrr90pVjAWVdTc%2Fuploads%2Fgit-blob-874e3bd05d72de02925f5117c17718d1e9b35b6a%2FOSFavoritesCategory?alt=media" alt="" width="375"><figcaption><p>Start by adding a category, give it a name and select an icon from the list of icons (Better search: <a href="https://pictogrammers.com/library/mdi/">MDI</a>)</p></figcaption></figure>

## Creating Favorites / Prefabs

* There are two ways of creating them:

1. Right-Click any item in the "Spawn New" list, and choose `Make Favorite`
2. Right-Click any item (Group or object) in the "Spawned UI" hierarchy, and select `Make Favorite / Prefab`
   1. Tip: You can also simply hit `CTRL-F`, and make the currently selected item a favorite / prefab

* A popup will appear, allowing you to assign a name, tags and category:

<figure><img src="https://1427525421-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4gzcGtLrr90pVjAWVdTc%2Fuploads%2Fgit-blob-8ab0a18c30c0c2a165be8201d5436a7d1c4ad88a%2FOSFavoriteSettings?alt=media" alt="" width="355"><figcaption><p>Choose a name, select tags (And addionally add new ones), and finally select the category</p></figcaption></figure>

{% hint style="success" %}
You can always bring back this menu, by clicking the configuration button for the favorite you like to edit, in the main favorites view
{% endhint %}

## Spawning Favorites / Prefabs

* To spawn a favorite, simply click it in the main favorites view
  * You can also do any of the more advanced things, such as drag and dropping a favorite into the world
  * This works the same as spawning anything from the `All` tab

## Organizing and searching

* Clicking the icon on the right of a category will group its contents by their tags

  * This can be done recursively for each created tag category

  <figure><img src="https://1427525421-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4gzcGtLrr90pVjAWVdTc%2Fuploads%2Fgit-blob-c2bf87b95df9584d473daf236edf21e936c6464f%2FOSFavoritesGroupedByTag?alt=media" alt="" width="290"><figcaption><p>Example of a category, grouped by its tags.</p></figcaption></figure>
* If you already know what to look for, you can also use the search bar, and the `Search Tags` selection
  * Search tags can be set to be either in AND or OR mode

## Merging / Renaming Tags and Categories

### Merging / Renaming Tags

* Often you might end up with multiple tags that indicate the same thing:
  * E.g. "Large", "large", "L", "big"
* To combine these tags, you can use the `Rename Tags` header, where you can select which tags to rename, and what the new name should be

### Merging Categories

* Categories can be merged in two ways:
  * Automatic: If you ever end up having two categories with the same name (E.g. You added someone else's categories), they will be merged
  * Explicitly
* To explicitly merge a category into another, simply use the category configuration menu (Wheel button)

<figure><img src="https://1427525421-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4gzcGtLrr90pVjAWVdTc%2Fuploads%2Fgit-blob-7e5d83c1bb51dd8b503e9a2b04525f86fb3ce9ac%2FOSCategoryConfig?alt=media" alt="" width="375"><figcaption><p>The category config menu, where you can change the icon, name and manually merge into another category</p></figcaption></figure>

{% hint style="success" %}
When merging categories, any favorites which contain the same data (E.g. the same mesh) will be merged as well (Tags will be combined).

Additonally, a pre-merge copy of both categories will be placed in the `preMerge` subfolder of the favorites folder
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wiki.redmodding.org/cyberpunk-2077-modding/modding-guides/world-editing/object-spawner/ui-tabs-explained/tab-favorites-and-prefabs.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.