# Finding files: AMM NPCs

## Summary

**Published**: Dec 31 2024 by [mana vortex](mailto:undefined)\
**Last documented update**: Dec 31 2024 by [mana vortex](mailto:undefined)

This page will show you how to find an AMM NPC's files.

**Difficulty**: You know how to read

### Wait, this isn't what I want!

* To change NPC appearances, see [For NPCs - Change Appearances](/cyberpunk-2077-modding/modding-guides/npcs/appearances-change-the-looks.md)
* To create custom NPCs, see [AMM: Custom NPCs](/cyberpunk-2077-modding/modding-guides/npcs/amm-custom-npcs.md)
* To create V as an NPC, see [NPV - V as custom NPC](/cyberpunk-2077-modding/modding-guides/npcs/npv-v-as-custom-npc.md)

In this guide, we'll go looking for `nurse_wa_nurse_wa_01`.

We do that by tracking her through AMM's **database** — an `sqlite3` file. Don't worry, this guide will help you navigate it.

## Step 1: Find and open the database file

1. Open <https://sqliteviewer.app/> in a webbrowser
2. Head to [The Cyberpunk 2077 Game Directory](/cyberpunk-2077-modding/for-mod-users/users-modding-cyberpunk-2077/the-cyberpunk-2077-game-directory.md)
3. Navigate to the subfolder `bin\x64\plugins\cyber_engine_tweaks\mods\AppearanceMenuMod`
4. Find the file `db.sqlite3`
5. Drag and drop it on the [sqliteviewer](https://sqliteviewer.app/) website

You will now see something like this:

<figure><img src="/files/qgMqe4cDkA5oEyeGUJZO" alt=""><figcaption></figcaption></figure>

## Step 2: Find the entity ID

### Variant 1: Copy it from AMM

1. Open AMM's **Scan** tab
2. Find the Target Info section at the bottom
3. Find the **ID** field
4. Click the `Copy` button

<figure><img src="/files/imVHhhjcQ7G5M7gQIu4j" alt=""><figcaption></figcaption></figure>

### Variant 2: Finding it in the database

#### Find the current appearance

1. Open AMM's **Scan** tab
2. Find the **Target Info** section at the bottom
3. Find the **Current Appearance** under the **ID** field and write it down:

<figure><img src="/files/8YMZa4uSQqgzsScauMNn" alt=""><figcaption></figcaption></figure>

#### Find the ID in the database

1. Switch to the [sqliteviewer](https://sqliteviewer.app/) website.
2. In the left column, `Tables`, click on `appearances` to select the table
3. Optional: Resize the `app_name` column
4. Type the name into the search field at the top of the column
5. Find the entity ID in the first column, and write it down (green box in the screenshot below)

<figure><img src="/files/h50lYdzrl1fjy1lpzc08" alt=""><figcaption></figcaption></figure>

## Step 3: Find the .ent file

Complete the following steps on the sqliteviewer website.

1. In the left column, `Tables`, click on `entities` to select the table.
2. Type the entity ID from step 2 into the search field at the top of the first column, `entity_id`. This should give you one (1) row of data.
3. Optional: Resize fields until you can see the entire `entity_path` column
4. Find the entity path, and write it down (green box in the screenshot below)

<figure><img src="/files/LPvWCeJh8qtZhFszvMnc" alt=""><figcaption></figcaption></figure>

## Step 4 (Optional): TweakDBId to entity path

{% hint style="info" %}
If you already have a file name here, skip to [#step-5-read-the-root-entity](#step-5-read-the-root-entity "mention")
{% endhint %}

In the `entity path` column, you will either find a file path (for modded NPCs), or a TweakDB ID (for base game characters).

1. Open Wolvenkit's [Tweak Browser](https://wiki.redmodding.org/wolvenkit/wolvenkit-app/editor/tweak-browser)
2. Pull it wide to make the right panel appear
3. In the search field at the top, search for your TweakDB ID (e.g. `Character.NurseFemale`)
4. In the property panel at the left, find the `entityTemplatePath` (the NPC's [root entity](https://github.com/CDPR-Modding-Documentation/Cyberpunk-Modding-Docs/blob/main/for-mod-creators-theory/files-and-what-they-do/file-formats/entity-.ent-files#root-entity))

<img src="/files/StvrigmbEiFtaBuoN2xe" alt="" data-size="original">

## Step 5: Read the [root entity](https://github.com/CDPR-Modding-Documentation/Cyberpunk-Modding-Docs/blob/main/for-mod-creators-theory/files-and-what-they-do/file-formats/entity-.ent-files#root-entity)

{% hint style="info" %}
If the NPC was added by a mod, you have to switch to [Mod Browser](https://wiki.redmodding.org/wolvenkit/wolvenkit-app/editor/asset-browser#mod-browser) first
{% endhint %}

1. Use [WolvenKit's search](https://wiki.redmodding.org/wolvenkit/wolvenkit-app/usage/wolvenkit-search-finding-files) to find the .ent in the files.
2. Right-click on the file and open it in WolvenKit (you don't need to add it to your project)
3. Find your NPC's appearance in the list:

<figure><img src="/files/ZJjJYitGxGZ0beam6vE9" alt=""><figcaption></figcaption></figure>

4. Note down the `appearanceName` (green box in the screenshot)
5. Open the .app file by clicking the turquoise button

## Reading the [.app file](https://github.com/CDPR-Modding-Documentation/Cyberpunk-Modding-Docs/blob/main/for-mod-creators-theory/files-and-what-they-do/file-formats/appearance-.app-files)

<figure><img src="/files/P8zteHQDsdHFa9TTHUCd" alt=""><figcaption></figcaption></figure>

1. In the `appearances` list at the top of the file, find the entry with the name from the .ent file
2. Expand the appearance's `components` array. These are all of your NPV's parts!
3. Enjoy!


---

# 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/for-mod-creators-theory/references-lists-and-overviews/people/finding-files-amm-npcs.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.