# Finding files: AMM NPCs

## Summary

**Published**: Dec 31 2024 by [mana vortex](https://app.gitbook.com/u/NfZBoxGegfUqB33J9HXuCs6PVaC3 "mention")\
**Last documented update**: Dec 31 2024 by [mana vortex](https://app.gitbook.com/u/NfZBoxGegfUqB33J9HXuCs6PVaC3 "mention")

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 [appearances-change-the-looks](https://wiki.redmodding.org/cyberpunk-2077-modding/modding-guides/npcs/appearances-change-the-looks "mention")
* To create custom NPCs, see [amm-custom-npcs](https://wiki.redmodding.org/cyberpunk-2077-modding/modding-guides/npcs/amm-custom-npcs "mention")
* To create V as an NPC, see [npv-v-as-custom-npc](https://wiki.redmodding.org/cyberpunk-2077-modding/modding-guides/npcs/npv-v-as-custom-npc "mention")

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](https://wiki.redmodding.org/cyberpunk-2077-modding/for-mod-users/users-modding-cyberpunk-2077/the-cyberpunk-2077-game-directory "mention")
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="https://1427525421-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4gzcGtLrr90pVjAWVdTc%2Fuploads%2Fgit-blob-1cb85327666bf8684530273257eb72778cbed4d6%2Ffinding_amm_npcs_sqliteviewer_1.png?alt=media" 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="https://1427525421-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4gzcGtLrr90pVjAWVdTc%2Fuploads%2Fgit-blob-90b55cd94202765e8d4bddc5213aeb8a8107dcbd%2Ffinding_amm_NPCs_copy_ID.png?alt=media" 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="https://1427525421-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4gzcGtLrr90pVjAWVdTc%2Fuploads%2Fgit-blob-13d0f40118b9501c813a4e9328fc00d80d9743d8%2Ffinding_amm_npcs_finding_current_appearance.png?alt=media" 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="https://1427525421-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4gzcGtLrr90pVjAWVdTc%2Fuploads%2Fgit-blob-b661d0d4fd804f1023b7292dfa03b7f440a69fbc%2Ffinding_amm_npcs_finding_ID_database.png?alt=media" 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="https://1427525421-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4gzcGtLrr90pVjAWVdTc%2Fuploads%2Fgit-blob-5191d9d334afb91e5ecacae23ccd41e1f813232d%2Ffinding_amm_npcs_finding_entity_path.png?alt=media" 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://app.gitbook.com/s/-MP_ozZVx2gRZUPXkd4r/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="https://1427525421-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4gzcGtLrr90pVjAWVdTc%2Fuploads%2Fgit-blob-b26431f1fb7611d6e90bb0d2b7bd2c47b02354a8%2Ftweak_browser_ent_file_from_tweak.png?alt=media" 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://app.gitbook.com/s/-MP_ozZVx2gRZUPXkd4r/wolvenkit-app/editor/asset-browser#mod-browser) first
{% endhint %}

1. Use [WolvenKit's search](https://app.gitbook.com/s/-MP_ozZVx2gRZUPXkd4r/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="https://1427525421-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4gzcGtLrr90pVjAWVdTc%2Fuploads%2Fgit-blob-573bdd999ebaee310043144ad05635823c65b9e0%2Ffinding_amm_npc_root_entity.png?alt=media" 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="https://1427525421-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4gzcGtLrr90pVjAWVdTc%2Fuploads%2Fgit-blob-7a0a6fcb501a2e576135b571755c604874e502fc%2F7.png?alt=media" 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!