Migration

CoreM includes a migration system that copies player clothing and appearance data from illenium-appearance into crm-appearance — so you can switch without wiping or resetting anyone’s outfits.

Read this page from start to finish before you begin migrating.

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

crm-appearance/crm-config/crm-config.lua


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

Enable migration

Set the resource to migrate from and turn migration on. Currently only illenium-appearance is supported as the source:

crm-appearance/crm-config/crm-config.lua


crm_config.crm_migration = {
    crm_enable = true,                         -- Enable migration mode
    crm_old_resource = 'illenium-appearance',  -- Resource to migrate from
}

Restart the script

Restart the crm-appearance resource to apply the change.

Make sure no players are connected to the server while migrating.

Wait for it to finish

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

Wait until the process has fully completed.
Do not stop the server while it’s running.

Disable migration

Once it’s done, turn migration mode back off:

crm-appearance/crm-config/crm-config.lua


crm_config.crm_migration = {
    crm_enable = false,                        -- Disable migration mode
    crm_old_resource = 'illenium-appearance',
}

Never run the migration twice on the same data. Doing so can duplicate or corrupt player appearance records.