---
updatedAt: 2025-10-14T20:59:38.000Z
agentTools:
  projectIndex: https://developer.didimo.co/llms.txt
---

# Adding Deformables, Shapes, and Animations

Once your project is initialized and you’ve added your first Base Character (Template), you can begin importing your assets, such as:

* deformable 3D models (e.g., clothing, hair)
* textures (.png, .jpg and .tga - type1, 2 and 10)
* alternative character variants (Shapes)
* animations

**Popul8 Express** recognizes different asset types, but each asset must be manually assigned to its correct category (Template, Shape, Deformable, Animation) in order to function properly.

🎬 Check our Tutorial Video:

<iframe src="https://drive.google.com/file/d/1cuQeDD9PzhvHjSb8-PHB-mBhOP-iZfQ2/preview" width="640" height="480" allow="autoplay" />

# 1. Converting Assets to the Correct Type

In order for **Popul8 Express** to use an asset correctly, you need to assign it a type (see [Base Concepts](https://developer.didimo.co/docs/base-concepts)):

* Deformable
* Shape
* Animation

> 📘 These options become available after importing your Base Character (Template), and are only applicable to models located under the **Imported Assets** folder.
>
> Follow [Before You Start](https://developer.didimo.co/docs/before-you-start-prepare-your-assets#/) page about how to import your assets and [Importing Your Own Base Character](https://developer.didimo.co/update/docs/how-to-add-your-first-character-to-the-scene#/) page for more information about how to import your Base Character.

## 1.1. Converting an Asset into a Deformable

* Navigate to the **Imported Assets** folder and select your Model to be converted into a Deformable:
  (e.g., *Imported Assets → Male → Categories → Deformables → Legs → Sport\_Shorts*)

1. <Image align="center" border={false} width="600px" src="https://files.readme.io/e709f80a1324e5aea148d1e88dd1ba5ec7f2d0f2b1cf6a689b378ecdef2208fc-Screenshot_2025-08-01_at_15.41.15.png" />

   <br />

* Right-click the asset *→ Convert To → Deformable Of → \[Template name]*
  *(eg., → Convert To → Deformable Of → Male)*

1. <Image align="center" border={false} width="600px" src="https://files.readme.io/56387609c4a51288997d8dec79b8ee7f1a341490da16fa6205dc7ddf2a4771d8-Screenshot_2025-08-01_at_15.41.50.png" />

   <br />

* After a moment, a new Deformable object (e.g., *Sport\_Shorts\_LOD1*) will appear under the selected Template in the tree view.

<Image align="center" border={false} width="400px" src="https://files.readme.io/916e30cafb960a2d60016fb710aeb2447ab1794740f0eb8a855c6bdf4f7ffef5-Screenshot_2025-08-01_at_15.42.40.png" />

## 1.2. Converting an Asset into a Shape

* Navigate to the **Imported Assets** folder and select your Model to be converted into a Shape:
* Right-click the asset *→ Convert To → Shape Of → \[Template]*
  (eg., *→ Convert To → Shape Of → Male*)

<Image align="center" border={false} width="600px" src="https://files.readme.io/cb3c62780097ba38287f9f8b53914313e075179a9d4ba41a5bc1b75e0dd9087b-Screenshot_2025-08-01_at_15.44.03.png" />

<br />

* Drag and Drop the Shape into the Outliner to preview the character; you can also drag in any Deformables assigned to the Template.

<Image align="center" border={false} width="600px" src="https://files.readme.io/a124f4cecb08cfc059bb9d9db315a6f8a565b4ebb1e2e49146ffb42ab7df48bb-Screen_Recording_2025-08-01_at_15.46.34.gif" />

> 📘 All Deformables previously assigned to the Template (e.g., clothing) will automatically be fitted to the new Shape!

## 1.3. Convert Model into Animation

* Navigate to the **Imported Assets** folder and select your Model to be converted into a Animation
* Right-click the file → Convert To → Animation Of → \[Template]
  (eg., *→ Convert To → Animation Of → Male*)

<Image align="center" border={false} width="300px" src="https://files.readme.io/9b2f66e4be15bf80ae046ce70d0a4546a6cb639e2b36d3d09ea6d5a553760889-Screenshot_2025-08-01_at_15.48.52.png" />

* The animation will automatically be linked to the Template and all its Shapes.

<Image align="center" border={false} width="400px" src="https://files.readme.io/fe2ea3a80c0c9a95fe765eb6d1db20f995e9be7be2fccb7933c70a59402b9ea8-Screenshot_2025-08-01_at_15.49.59.png" />

* Drag and Drop your Template or Shape into the outliner and select an option in the Animation panel (e.g., None or Walk) to see your character animated.

<Image align="center" border={false} width="400px" src="https://files.readme.io/836c61d5365ef40928145f9ebddff6f708093ffe6719c8959a987e5a87c8de04-Screen_Recording_2025-08-01_at_16.04.17-3.gif" />

# 2. Setup Materials

Once the model is imported or even after conversion, you can assign textures to enhance and complete its visual appearance.

* Select the material expanding your model (eg., *Male → Sport\_Shorts\_LOD1 → Model* and select *ddmo\_shorts\_MAT*). All the inputs related with the material will be displayed in the Inspector View

<Image align="center" border={false} width="600px" src="https://files.readme.io/ccffaa02f8e21342a74bb6b31c10e509cc7c55283bc6014fbfbfd968e6d71003-Screenshot_2025-08-01_at_15.51.28.png" />

* Drag and drop the corresponding textures previously imported into the Inputs section under the Outliner (Albedo, Normal Map or Mask Map)
* Click **Apply Changes**. If your model is already placed in the Outliner, any texture or configuration updates will be applied automatically in real time.

<Image align="center" border={false} width="600px" src="https://files.readme.io/a627562536d3f29e9a581e9be17ea4bb47eef20ff778c481efb01a82b4f957e1-Screenshot_2025-08-01_at_15.52.54.png" />

# 3. Previewing Deformables on the Character

**Popul8 Express** supports dragging  multiple assets into the outliner, enabling you to preview how different assets fit together within your scene.

> 📘 In the outliner, only Deformables assigned to a Template can be combined and previewed together. For character shapes, only the Deformables associated with the selected shape can be combined.

* Drag your Template or Shape and next drag a Deformable into the Outliner

<Image align="center" border={false} width="500px" src="https://files.readme.io/a58a736bc87ccb24865e54e42fbb10ffe9bf84c5ef83d959030c086952df6fa6-Screenshot_2025-08-01_at_15.58.33.png" />

<Image align="center" border={false} width="500px" src="https://files.readme.io/9e115d0b06860211f8517de2c64cb1633445638e49c67dbe69c2a575e5b42334-Screenshot_2025-08-01_at_16.01.02.png" />

**Popul8 Express Magic:** Once assigned, a Deformable automatically works with all Shapes linked to that Template!