Adding a New YDD or YTD

Full step-by-step guide for adding template YDD files, optional slot YTD files, and preview images to 0r-clothing_designer

This is the practical file-placement guide.

Use it when you want to:

add a new clothing template
add optional default slot textures
add your own preview image

1. Know the Difference#

YDD#

Add a new .ydd when you want a new clothing template to appear in the designer.

Example:

jbib_015_u.ydd

YTD#

Add a .ytd only if you want that template to open with one or more default slot texture options.

The .ytd is optional.

A template can work with only a .ydd.

2. Add a New YDD Template#

Follow these steps in order.

Step 1: choose the gender folder#

Choose one:

templates/cloth_templates/male/
templates/cloth_templates/female/

Step 2: choose the component folder#

Supported component folders:

accs
berd
decl
feet
hair
hand
head
jbib
lowr
task
teef
uppr

Common rule:

if the piece is a jacket/top-style clothing template, it usually belongs in jbib

Step 3: place the YDD in the matching folder#

Example:

templates/cloth_templates/male/jbib/jbib_015_u.ydd

Another example:

templates/cloth_templates/female/feet/feet_022_u.ydd

Step 4: make sure the file prefix matches the folder#

The file prefix should match the component folder.

Examples:

jbib folder -> file should start with jbib_
feet folder -> file should start with feet_
accs folder -> file should start with accs_

Good:

templates/cloth_templates/male/jbib/jbib_015_u.ydd

Bad:

templates/cloth_templates/male/jbib/feet_015_u.ydd

Step 5: refresh and restart the resource#

If the server is already running, use:

refresh
restart 0r-clothing_designer

Do not skip this step after adding template files.

Step 6: test in game#

Check:

the template appears in the Templates tab
the preview is visible
the template opens in the editor

3. Add an Optional Default YTD Slot#

Use this only if the template should ship with one or more default slot textures.

Step 1: build the template key folder name#

Folder format:

<gender>_<component>_<drawable_name_without_suffix>

Examples:

male_jbib_jbib_015
female_feet_feet_022
male_accs_accs_004

Example folder:

templates/template_slots/male_jbib_jbib_015/

Step 2: place the YTD file inside that folder#

Example:

templates/template_slots/male_jbib_jbib_015/jbib_diff_015_a_uni.ytd

You can place more than one .ytd in the same folder if you want multiple default slot choices.

Step 3: restart the resource#

Use:

refresh
restart 0r-clothing_designer

Step 4: test the template again#

Open the same template in the editor and confirm the default slot textures are available.

4. Add an Optional Preview Image#

If you want to ship your own preview image instead of relying on auto-generated previews, place it under:

templates/template_previews/<gender>/<component>/

Example:

templates/template_previews/male/jbib/jbib_015_u.png

Supported formats:

.png
.webp
.jpg
.jpeg

If you add or replace preview files while the server is already running, use:

refresh
restart 0r-clothing_designer

5. Full Example#

Example: add a new male jacket template with one default slot texture.

Step 1: copy the template YDD#

templates/cloth_templates/male/jbib/jbib_015_u.ydd

Step 2: create the slot folder#

templates/template_slots/male_jbib_jbib_015/

Step 3: place the slot texture#

templates/template_slots/male_jbib_jbib_015/jbib_diff_015_a_uni.ytd

Step 4: optionally add a preview image#

templates/template_previews/male/jbib/jbib_015_u.png

Step 5: refresh and restart#

refresh
restart 0r-clothing_designer

Step 6: verify in game#

Check:

the template appears
the preview looks correct
the template opens
the default slot texture is available

6. Common Mistakes#

Avoid these:

putting the .ydd directly inside cloth_templates/ without gender and component folders
using a file prefix that does not match the component folder
forgetting to restart after adding templates
creating the template_slots folder with the wrong template key
expecting a .ytd alone to create a template without a matching .ydd