# Importing

Everything comes in through the **Import** button above the item list. The main button imports `.ydd` and `.ytd` files; the arrow beside it opens every other way in. You can also drag files or folders onto the window.

| Import menu entry | What it takes |
| --- | --- |
| **Import — auto-detect gender** | Loose `.ydd` / `.ytd` files. The gender is read from the file names. |
| **Import folder (all .ydd / .ytd)…** | Every model and texture in a folder |
| **Import a FiveM resource** → **Resource folder…** / **Downloaded .zip…** | A whole FiveM clothing resource, reviewed before anything is added |
| **Import a FiveM resource** → **Escrowed FiveM resource (kept as-is)…** | An escrowed resource you bought, kept exactly as downloaded |
| **New garment from a 3D model (.glb / .obj)…** | A garment modelled in Blender or elsewhere (Premium) |
| **Other formats** | Any pack or project, a Koja package (`.kct`), a Durty project (`.dctproj`) or package (`.dctpackage`), a GTA V add-on pack (`dlc.rpf`) |
| **Import as Male** / **Import as Female** | Loose files, with the gender you choose |
| **Makeup / face overlays…** | Face overlays for the Makeup / Overlays section |

## Loose `.ydd` / `.ytd` files

Select an item and click **Import**, or right-click an item and import onto it. The model fills the item and each texture becomes a variant. Files are copied into the project's `assets/` folder.

- The gender is detected from the file name. Use **Import as Male** or **Import as Female** when the names do not say.
- Texture letters are kept when they run in order (a, b, c…). Gaps are re-lettered, and the import tells you which.
- A cloth file next to a model is picked up with it, whether it is a compiled `.yld` or a CodeWalker / Sollumz `.yld.xml`. YLD XML is converted to `.yld` for you. See [Cloth simulation](/cloth-tool/about-the-tool/cloth-simulation).
- Loose `.png` and `.dds` textures are accepted and converted to real `.ytd` files when you build. See [Items and Textures](/cloth-tool/about-the-tool/items-and-textures).

:::hint{type="warning" title="Escrowed files are refused"}
A `.ydd` or `.ytd` protected by FiveM asset escrow is encrypted and locked to the buyer's server. Dropped in as a garment, it is refused with that reason rather than a "parse failed" error. To keep an escrowed resource in your project, import it as a whole resource instead — see [Escrowed resources](/cloth-tool/about-the-tool/escrowed-resources).
:::

## Import a FiveM resource

:::frame{caption="Import a FiveM resource from the Import menu."}
![The Import menu with Import a FiveM resource open, offering Resource folder, Downloaded .zip and Escrowed FiveM resource](https://pub-57d6558d0e204696b4cdeee5d172e561.r2.dev/cloth-tool/features/resource-import.e288d2e83b.webp)
:::

:::hint{type="info" title="New in 2.0.8"}
A whole FiveM clothing resource can be imported from a folder, a `[category]` folder or a downloaded `.zip`, with a review before anything is added. Free.
:::

Use **Import → Import a FiveM resource** to add it to the open project, or **Import a FiveM resource (folder / .zip)…** on Home to make a new project from it.

:::steps
### Pick the resource
Choose a resource folder, a `[category]` folder holding several resources, or the `.zip` you downloaded (or its `fxmanifest.lua`). The tool reads the manifests, the variation files (`.ymt`) and the stream file names.

### Review it
The review lists every resource, collection and garment: item name, slot, gender, drawable number and textures. The header sums it up — resources, collections, garments and textures.

### Untick what you do not want
Everything starts ticked. Untick a whole resource, a collection, a slot or single garments.

### Import
Click **Import**. Nothing is copied before this point.
:::

What the review tells you:

| Mark | Meaning |
| --- | --- |
| **Add-on** / **Replaces …** | Whether the resource adds new clothing or replaces a Rockstar DLC collection |
| **N renumbered** | Drawable numbers that had to move to fit the project |
| **not in .ymt** | Texture files the variation file does not register |
| **name guessed** | A loose file whose slot or number was worked out from its name |
| **Bulky**, **Heels**, **Cloth**, **Alt hair**, **Hides hair** | Settings read from the `.ymt` that the garment keeps |
| **name already used** | An item with that name is already in the project |

Under **Item names** choose **Original file names** or **Short names (jbib_000)**.

### What is kept

- Each garment keeps its bulky, high-heel, audio, cloth, hair alternate and hair-hiding settings.
- A hair alternate (the cut-down hair masks switch to) attaches to its hairstyle instead of importing as a second hair.
- Packs in ped folders (`mp_m_freemode_01`, `mp_f_freemode_01`) take the gender from the folder.
- Several collections import into one project, and each garment remembers where it came from.
- Escrowed resources found in the pick are listed separately and kept as-is. See [Escrowed resources](/cloth-tool/about-the-tool/escrowed-resources).

### Replace resources

A resource that replaces a Rockstar collection is recognised. Imported from Home as a new project, it keeps building as a replace of that collection — **Keep building it as a replace of …** — so the drawable ids your server stored for those garments do not move.

:::hint{type="warning" title="Replace resources added to an open project"}
Added to an open project, the garments build the way that project does. To keep the replace, import the resource from Home as a new project.
:::

## New garment from a 3D model

:::hint{type="info" title="Premium"}
This uses the Model Studio and needs Premium. New in 2.0.8.
:::

**Import → New garment from a 3D model (.glb / .obj)…** turns a `.glb`, `.gltf` or `.obj` modelled on the freemode ped into a rigged item.

:::steps
### The model
Choose the file. It is shown on the ped straight away. If it stands beside the ped, lies on its back or is giant, change the axis (**Y-up file**, Blender's export default) or the units (**Metres** / **Centimetres**).

### The item
Give it a **Name**, a **Slot** and the gender.

### Rig it
**Auto-rig the garment** weights it from the ped's skin where it lies on the body, and from the garment itself where it hangs away. Adjust **Trust the skin within**, **Fade out over**, **Smoothness** and **Mirror left and right**, then **Rig again** if needed. Click **Create the item**.
:::

The model's base-colour texture becomes texture variant A. A model without one is created without a texture; add it in Textures. Fine-tune the weights later in the [Model Studio](/cloth-tool/about-the-tool/model-studio).

## Durty Cloth Tool projects (`.dctproj`)

Already have projects in Durty Cloth Tool? Import them directly and keep working — no rebuild from scratch.

:::frame{caption="Durty projects and dlc.rpf packs under Other formats."}
![The Import menu's Other formats list with Koja package, Durty project, Durty package and GTA V add-on pack](https://pub-57d6558d0e204696b4cdeee5d172e561.r2.dev/cloth-tool/features/durty-and-dlc-import.11a24e8271.webp)
:::

**How to import:**

1. Choose **Import → Other formats → Durty project (.dctproj)…** (or the Durty import on Home).
2. Point it at the Durty project — either the `.dctproj` manifest or the project folder.
3. The tool reads the manifest, maps every clothing item to the right slot, gender and drawable number, and copies the referenced models and textures into your KOJA project.

**What comes across:**

* All clothing items with their slot, gender, drawable number and name.
* Every model and texture variant, de‑duplicated by content — so a big EUP pack often shrinks dramatically on import (duplicate files are stored once).
* Component vs. prop typing is preserved.

:::hint{type="info"}
Durty stores its assets as GUID‑named files in a `data/` folder. The import resolves the friendly names and rebuilds a clean, self‑contained KOJA project — you don't need to keep the original Durty folder afterwards.
:::

:::hint{type="warning"}
Dummy / placeholder entries in the Durty project are skipped (they have no real files). If an item looks empty after import, it was a dummy on the Durty side.
:::

## GTA V add-on packs (`dlc.rpf`)

**Import → Other formats → GTA V add-on pack (dlc.rpf)…**, or drop the `.rpf` on the window. The archive becomes loose garments, shown in the import preview with every drawable number and name clash before they are added.

## Sharing items between projects (`.kct`)

To move a handful of items between Cloth Tool projects — or share them with a teammate — export them as a **`.kct` package** rather than importing a whole project. See [Sharing Packages (.kct)](/cloth-tool/about-the-tool/sharing-packages).

## Windows right-click menu

Turn on **Explorer context menu** in **Settings → General** to add these to the right-click menu of `.ydd` and `.ytd` files in Windows Explorer (on Windows 11 they sit under **Show more options**). Nothing else about those file types changes; they keep opening in whatever program you already use.

:::frame{caption="The Explorer context menu switch in Settings."}
![Settings, General page, with the Explorer context menu switch for Quick Preview, Quick Optimize Textures and Quick Add to Project](https://pub-57d6558d0e204696b4cdeee5d172e561.r2.dev/cloth-tool/features/windows-context-menu.05a6197ce5.webp)
:::

- **Quick Preview** — look at a model or texture without opening a project. Opens the [Inspect window](/cloth-tool/about-the-tool/inspect-window).
- **Quick Add to Project** — add the file to the project open in the tool. The tool must be running with a project open; if not, a message says what to do.
- **Quick Optimize Textures** (`.ytd`, Premium) — see [Texture Optimization](/cloth-tool/about-the-tool/texture-optimization).

## Portability

Every import copies assets into the project and stores paths **relative** to the project folder. That means you can move or rename the whole project folder freely — the tool re‑resolves everything (and auto‑heals older projects that still held absolute paths) on open.

## Related pages

- [Escrowed resources](/cloth-tool/about-the-tool/escrowed-resources) — keep bought, escrowed resources in a project
- [Items and Textures](/cloth-tool/about-the-tool/items-and-textures) — what an item is and how texture variants work
- [Model Studio](/cloth-tool/about-the-tool/model-studio) — edit and rig garments made from 3D models
- [Cloth simulation](/cloth-tool/about-the-tool/cloth-simulation) — `.yld` and YLD XML cloth
- [Inspect window](/cloth-tool/about-the-tool/inspect-window) — look inside a `.ydd` or `.ytd`
- [Building](/cloth-tool/about-the-tool/building) — When your project is ready, hit Build and choose the FiveM target.
- [About the Tool](/cloth-tool/about-the-tool) — back to the section overview