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:

1. the template appears in the Templates tab

2. the preview is visible

3. 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:

1. the template appears

2. the preview looks correct

3. the template opens

4. 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