> For the complete documentation index, see [llms.txt](https://corem.gitbook.io/corem/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://corem.gitbook.io/corem/crm-appearance/migration.md).

# Migration

CoreM provides a **Migration System** to safely migrate player clothing and appearance data from **illenium-appearance** to **crm-appearance**.\
This allows you to switch without wiping or resetting player outfits.

{% hint style="warning" %}
Read this documentation carefully before migrating!
{% endhint %}

The migration system is configured in: `crm-appearance/crm-config/crm-config.lua`

```lua
-- Migration System (Read documentation first!)
crm_config.crm_migration = {
    crm_enable = false,                 -- Enable migration mode
    crm_old_resource = 'illenium-appearance', -- Resource to migrate from
}
```

### Migration Steps

***

### 1. Enable Migration

Set the resource you want to migrate from and enable migration:\
Currently, **only `illenium-appearance`** is supported as the old resource.

```lua
-- Migration System (Read documentation first!)
crm_config.crm_migration = {
    crm_enable = true,                 -- Enable migration mode
    crm_old_resource = 'illenium-appearance', -- Resource to migrate from
}
```

### 2. Restart the Script

Restart the **crm-appearance** resource

{% hint style="warning" %}
Make sure **no players are connected** to the server during migration.
{% endhint %}

### 3. Wait for Migration

The system will automatically copy all player clothing and appearance data from the old resource.

* Wait until the migration process is fully completed.
* Do **not** stop the server while migrating.

### 4. Disable Migration

Once the migration is finished, **disable migration mode**:

{% hint style="danger" %}
**Do not run the migration twice on the same data!**

Running the migration a second time can duplicate or corrupt player appearance data.
{% endhint %}

```lua
-- Migration System (Read documentation first!)
crm_config.crm_migration = {
    crm_enable = false,                 -- Enable migration mode
    crm_old_resource = 'illenium-appearance', -- Resource to migrate from
}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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://corem.gitbook.io/corem/crm-appearance/migration.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.