Installation

Follow the steps below to get crm-multicharacter running on your server.

Download the resource

Log in to the Cfx.re portal and open the Asset Grants section. There you’ll find crm-multicharacter, along with every other resource you’ve purchased from our store , ready to download.

Install the dependency

crm-multicharacter runs on top of the CoreM core, so make sure it’s installed first:

crm-core — the foundation shared by every CoreM script. View installation guide →

Add the files to your server

Drop the crm-multicharacter folder into your [crm-scripts] directory, next to crm-core:

Start it in your server.cfg

Start crm-core first, then start the whole [crm-scripts] folder:

server.cfg


# CoreM
ensure crm-core
ensure [crm-scripts]

Always place CoreM scripts after your framework (qb-core / qbx_core / es_extended) in server.cfg, otherwise they won’t detect it correctly.

Import the database

Run any .sql files found in the crm-sql folder against your database. If that folder is missing or empty, you can safely skip this step.

Remove conflicting scripts

crm-multicharacter replaces your old multicharacter, identity and spawn systems. Remove any of the following before continuing:

esx_multicharacter, esx_identity
qb-multicharacter, qb-spawn
any other multicharacter, identity or spawn resource

Leaving an old multicharacter, identity or spawn script enabled will conflict with crm-multicharacter.

Configure your framework

Apply the change that matches your framework so it hands character selection over to crm-multicharacter.

ESX

Open es_extended/shared/config/main.lua and find this line:

es_extended/shared/config/main.lua


Config.Multichar = GetResourceState("esx_multicharacter") ~= "missing"

Replace it with: