Installation

Bablo Multicharacter runs on QBCore, Qbox and ESX. The steps that are the same on every framework come first; the Framework setup section then covers the one change your framework needs to hand character selection over to Bablo.

1. Download the asset#

After purchasing from our website, the asset is delivered to your CFX Portal. Download it there and extract bablo-multicharacter into your resources folder.

2. Install dependencies#

These must be present and started before bablo-multicharacter:

• ox_lib
• oxmysql

3. Framework setup#

You must disable your framework’s built-in multicharacter, otherwise the two fight over the spawn flow. Find your framework below — each one needs a slightly different change.

QBCore#

1. Remove the default multicharacter

Stop and delete qb-multicharacter from /resources/[qb]/, and make sure it is not ensured anywhere in your server.cfg.

2. Install the resource

Place bablo-multicharacter in your resources folder. No qb-core edit is required — QBCore has no multichar toggle to flip.

Qbox#

1. Disable Qbox’s built-in characters

Open qbx_core/config/client.lua and set:

useExternalCharacters = true,

This tells Qbox to hand the character-selection flow to an external resource instead of its built-in one.

2. Install the resource

Place bablo-multicharacter in your resources folder.

ESX#

1. Remove the default multicharacter

Completely remove esx_multicharacter from /resources/[core]/.

2. Enable multichar in ES Extended

Open your ESX config — the location depends on your version:

• ESX Legacy 1.12+ — es_extended/shared/config/main.lua
• Older versions — es_extended/config.lua

Find:

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

and change it to:

Config.Multichar = true

3. Install the resource

Place bablo-multicharacter in your resources folder.

4. Add it to server.cfg#

bablo-multicharacter waits for your framework, clothing and housing resources to come up (it polls for up to 10s), so start order is not strict. For the fastest cold boot, still start its dependencies first:

ensure ox_lib
ensure oxmysql
ensure qbx_core                # or qb-core / es_extended
ensure illenium-appearance     # or qb-clothing / skinchanger / fivem-appearance ...
# ensure qbx_apartments        # optional — or qb-houses

ensure bablo-multicharacter

5. Database#

On first boot the resource:

• creates the bablo_multicharacter_unlockedslots table (used for premium-slot unlocks), and
• adds the column(s) it needs to your framework’s player table:

You should see this line in the server console on the first start:

[bablo-multicharacter] migration ok — `bablo_multicharacter_unlockedslots` ensured

CREATE TABLE IF NOT EXISTS `bablo_multicharacter_unlockedslots` (
    `identifier`  VARCHAR(64) NOT NULL,
    `slot_id`     INT         NOT NULL,
    `unlocked_at` TIMESTAMP   NOT NULL DEFAULT CURRENT_TIMESTAMP,
    `unlocked_by` VARCHAR(64) DEFAULT NULL,
    PRIMARY KEY (`identifier`, `slot_id`),
    KEY `idx_identifier` (`identifier`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;

6. Configure the resource#

Open bablo-multicharacter/config.lua. Everything works out of the box on a standard install; the options you’re most likely to touch first:

Config.Framework  = "auto"   -- auto | qbcore | esx | qbox
Config.Appearance = "auto"   -- your clothing/skin script (auto-detected)
Config.Housing    = "none"   -- none | auto | qb-houses | qbx-apartments

See the Configuration page for every option — theming, spawn points, premium slots, socials and more.

7. First start#

Start the resource and connect to your server. You should land on the character selector with the cinematic camera and live character peds.