Installation

Welcome to the bablo-multicharacter installation guide. Follow each step carefully to ensure a smooth setup.

1. Download the asset

To find the asset in the portal you must have purchased it using your own CFX account. If the purchase was made on a different account, use the transfer system first.

After purchasing from our official website (opens in a new tab), the asset is delivered directly to your CFX Portal (opens in a new tab). Download it from there and extract it into your resources folder.

2. Install dependencies

bablo-multicharacter requires the following resources to be present and started before bablo-multicharacter:

3. Framework setup

🚫

You must disable your framework's built-in multicharacter resource first, otherwise both will fight over the spawn flow. Pick the tab that matches your framework.

Step 1 — Remove the legacy multicharacter

Delete (or stop) qb-multicharacter from your /resources/[qb]/ folder. Do not ensure it anywhere in your server.cfg.

Step 2 — Add the resource

Place bablo-multicharacter into your /resources folder.

Step 3 — Set the framework (optional)

In bablo-multicharacter/config.lua:

Config.Framework = "auto"  -- or "qbcore"

4. Configure your server.cfg

🚫

Your framework core (qbx_core, qb-core, es_extended) must be started before bablo-multicharacter. Incorrect start order is the most common cause of issues.

Add the following to your server.cfg:

# Dependencies
ensure oxmysql
ensure ox_lib
 
# Start your framework first
ensure qb-core      # or qbx_core / es_extended
 
# bablo-multicharacter
ensure bablo-multicharacter

5. Database

No manual SQL import is required. On first start the resource automatically creates the bablo_multicharacter_unlockedslots table (used for premium slot unlocks).

You should see a line like this in your server console on the first boot:

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

If you prefer to create it manually, run:

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 and set at minimum:

Config.Framework  = "auto"   -- auto | qbcore | esx | qbox
Config.Appearance = "auto"   -- the clothing/skin script you run
Config.Housing    = "none"   -- none | auto | qb-houses | qbx-apartments

See the Configuration page for a full breakdown of every option.

7. First start

Start the resource and check your server console. Connect to the server — you should land on the character selector with the cinematic camera and live character peds.

⚠️

If players get stuck on the loading screen, double-check that your framework core is started before bablo-multicharacter in server.cfg.

General Information Configuration