# Converting

This page covers conversions from "Server Cosmetics" & "Shadow Cosmetics" 

## Import Folder

Put the source files in:

```
config/dawncosmetics/convert/ServerCosmetics
or
config/dawncosmetics/convert/ShadowCosmetics
```

## Turn It On

In `config/dawncosmetics/config.json`:

```json
{
  "converters": {
    "servercosmetics_converter": true,
    "servercosmetics_overwrite": false
  }
}
```

```json
{
  "converters": {
    "shadow_converter": true
  }
}
```

`servercosmetics_overwrite` decides what happens when an id already exists:

* `false` keeps the current local entry
* `true` lets the import replace it

## What Gets Created

The converter can write to:

* `cosmetics/hats.json`
* `cosmetics/backpacks.json`
* `cosmetics/armor_skins.json`
* `cosmetics/armor_items.json`
* `cosmetics/assets/items.json`
* `cmd-map.json`

It also copies models and textures into your DawnCosmetics asset folders.

## Armor Sets

Armor imports are split into two files:

* `armor_items.json` for the piece defs
* `armor_skins.json` for the full set defs

That split is normal.

## After Import

1. run `/cosmetics reload`
2. run `/cosmetics reload pack`
3. test the imported cosmetics in game

## Quick Checks

* if a cosmetic is missing, look for id conflicts first
* if armor imports but one set looks wrong, check the texture folder names
* if assets copy over but do not render, check your pack layout and model paths


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://dawnshade.gitbook.io/dawnshade-docs/docs/dawn-cosmetics/summary/converting.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.