# NPC animations

## Summary

Created: Jan 02 2025 by [nutboy](https://app.gitbook.com/u/y772Qw4Ul9cmqXiuTKkTpLxDVzQ2 "mention")\
Last documented update: Jan 02 2025 by [nutboy](https://app.gitbook.com/u/y772Qw4Ul9cmqXiuTKkTpLxDVzQ2 "mention")

This page will explain how NPC animations are selected and connected within the files.

### Wait, this is not what I want!

* For a guide on creating a custom NPC, check [amm-custom-npcs](https://wiki.redmodding.org/cyberpunk-2077-modding/modding-guides/npcs/amm-custom-npcs "mention")
* For a guide on creating an even more custom NPC, check [npv-v-as-custom-npc](https://wiki.redmodding.org/cyberpunk-2077-modding/modding-guides/npcs/npv-v-as-custom-npc "mention")

## entAnimatedComponent

The very base for any animations is the entAnimatedComponent with the name of `root`.\
You can usually find it insde the [root entity's](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) `components` array:

<figure><img src="https://1427525421-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4gzcGtLrr90pVjAWVdTc%2Fuploads%2Fgit-blob-188f6ef77a159699fda562297ee87842a8836371%2FentAnim_root.png?alt=media" alt=""><figcaption></figcaption></figure>

`animations.gameplay` animations does...

(we needed to put those, or no photo mode animations. Where are they read? Why aren't they overwritten by SetupExtensionComponents?)

### entAnimatedSetupExtensionComponent

One or more extensions to the [#entanimatedcomponent](#entanimatedcomponent "mention") for different contexts.\
You can usually find them insde the [root entity's](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) `components` array:

<figure><img src="https://1427525421-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4gzcGtLrr90pVjAWVdTc%2Fuploads%2Fgit-blob-d03b0596298181245abd4ffa44cc92efba51777a%2FentAnimExtension.png?alt=media" alt=""><figcaption></figcaption></figure>

As of January 2025, we don't exactly know what they do and where they are read. Maybe ask psi at some point.