Installation

1. Download Resource

Download the purchased resource from CFX Portal - the official site of FiveM with purchased resources.

---

2. Install Required Dependencies

This script needs a few extra resources to work properly. Below you will find a list of things to download - click the link, download and upload to your server just like other resources.

Resource	Download Link	Note
spawnmanager	https://github.com/citizenfx/cfx-server-data/tree/master/resources/%5Bmanagers%5D/spawnmanager	Only for ESX users!

---

3. Import Database Tables

This is a very important step - without it, the script will not work properly. Depending on the framework you are using (ESX or QB-Core), select the appropriate section below and paste the SQL code into your database.

Not sure how to do it?

No worries - we've prepared a short guide that shows you step by step how to import an SQL file into your database: 👉 Click here to view the tutorial.

Database for ESX

CREATE TABLE `multichars_slots` (
    `identifier` VARCHAR(60) NOT NULL,
    `slots` INT(11) NOT NULL,
    PRIMARY KEY (`identifier`) USING BTREE,
    INDEX `slots` (`slots`) USING BTREE
) ENGINE=InnoDB;

You should already have a disabled column in your users, but in case you don't, you need to import it as well.

ALTER TABLE `users` ADD COLUMN `disabled` TINYINT(1) NULL DEFAULT '0';

Database for QB-Core

CREATE TABLE `multichars_slots` (
    `identifier` VARCHAR(60) NOT NULL,
    `slots` INT(11) NOT NULL,
    PRIMARY KEY (`identifier`) USING BTREE,
    INDEX `slots` (`slots`) USING BTREE
) ENGINE=InnoDB;

ALTER TABLE `players` ADD COLUMN `disabled` TINYINT(1) NULL DEFAULT '0';

---

4. Environment Requirements

1

Remove conflict scripts

Remove your previous multicharacter and identity system, e.g. esx_multicharacter, esx_identity, qb-multicharacter, qbx-multicharacter.

2

Make changes to external resources

ESX

If you are using an older ESX like 1.8.X, 1.9.X the configuration file path is es_extended/config.lua

1. Go to your es_extended/shared/config/main.lua file.

2. Find options Config.Multichar and Config.Identity

3. Set both parameters to true:

Config.Multichar = true
Config.Identity = true

These settings enable multi-character functionality and user identity management, ensuring compatibility with the new system architecture.

QBX-Core

1. Go to your qbx_core/config.lua file.

2. Find option Config.Characters.UseExternalCharacters

3. Set parameter to true:

Config.Characters.UseExternalCharacters = true

---

4. Start Resource

To start a resource in your server.cfg, ensure that it begins after your framework has been initiated. For instance, if you are using a framework like es_extended, you should start resource after it, like so:

start [core] # For example, here is your framework (esx/qb-core)

# VMS Resources
start vms_multichars
start vms_identity

Ensure there are no syntax errors or incorrect paths in your server.cfg.