LCK Multicharacter

Installation

Install lck-multicharacter as the only character selector on the server. The resource uses the active framework's existing character tables, so no SQL import or database migration is required.

• Copy the resource with the exact folder name lck-multicharacter.
• Install oxmysql, dpemotes, and hn_cigarroom using those exact folder names.
• Stop the stock selector: esx_multicharacter, qb-multicharacter, or ox_charselect.
• Complete the framework-specific setup in the next guide.
• Start lck-multicharacter after its framework and all selected integrations.

Requirements

• Current FiveM artifact with Lua 5.4
• oxmysql
• dpemotes — download from GitHub ↗
• Hane Studios Free Cigar Room — download from Cfx.re ↗
  Install it as hn_cigarroom.
• es_extended, qb-core, or ox_core
• Cigar Room interior at -1003.55, -484.95, 50.10

ensure oxmysql
ensure qb-core          # or es_extended / ox_core
ensure dpemotes
ensure hn_cigarroom
ensure lck-multicharacter

Framework setup

Config.Framework = 'auto' detects es_extended, then qb-core, then ox_core. If more than one framework resource is present, set esx, qb, or ox explicitly.

ESX startup

ensure oxmysql
ensure es_extended
ensure esx_identity
ensure dpemotes
ensure hn_cigarroom
ensure lck-multicharacter

OX Core convars

setr ox:characterSelect false
setr ox:characterSlots 3

ensure ox_lib
ensure oxmysql
ensure ox_core
ensure dpemotes
ensure hn_cigarroom
ensure lck-multicharacter

Slots, identity, and themes

All public settings are in config.lua. Restart the resource after changing them. This release supports a maximum of three slots because each slot has its own position, animation, and camera.

Identity validation

Config.Identity = {
    MinNameLength = 2,
    MaxNameLength = 24,
    MinAge = 18,
    MaxAge = 90,
    DefaultHeight = 180,
    DefaultNationality = 'San Andreas'
}

Names, birth date, gender, nationality, selected slot, ownership, and capacity are validated again on the server. ESX and QBCore accept male or female identities; OX Core also accepts the non-binary form value. DefaultHeight is passed to ESX identity creation but is not exposed in the UI.

Themes

Config.Theme = 'yellow_black'

Config.Themes.custom = {
    label = 'Custom',
    primary = '#D8A7FF',
    secondary = '#08040D'
}

The interface derives readable control colors from the selected theme's primary and secondary values. Translate every selector string in Config.Locale; missing keys fall back to the interface's English defaults.

Character placements and cameras

Config.Scene.PreviewPlacements contains one entry per slot. Each entry controls the preview ped position, dpEmotes pose, native animation fallback, optional prop, and camera.

{
    coords = vector4(x, y, z, heading),
    emote = 'sitchair3',
    animDict = 'timetable@reunited@ig_10',
    animName = 'base_amanda',
    animFlag = 1,
    camera = {
        side = 0.0,
        distance = 2.35,
        height = 1.4,
        lookSide = 0.0,
        lookForward = 0.0,
        lookHeight = 1.0,
        fov = 40.0
    }
}

Global scene values provide fallback camera coordinates and control CameraBlendSpeed, EnterFadeOut, and EnterFadeIn. Each list slot maps to the same index in PreviewPlacements, so keep all three entries in order.

Spawn locations

Config.DefaultSpawn is used only when there is no valid configured spawn point. Add or reorder visible locations in Config.SpawnPoints.

Config.SpawnPoints = {
    {
        name = 'Legion Square',
        description = 'Central hub near shops and services',
        coords = vector4(215.6, -809.9, 30.7, 340.0),
        icon = 'city'
    }
}

• name is the visible location title.
• description provides supporting list text.
• coords stores world position and heading.
• icon accepts city, mountain, water, star, or plane.

Existing characters receive Last Location first when the framework returns valid saved coordinates. New characters do not. The map uses web/map-clean.png at 1280 × 1920; do not resize or crop it independently because marker positions are calculated from its geometry.

Appearance integrations

Start the selected appearance integration before lck-multicharacter. Without compatible saved data, the preview uses the base freemode model for the character's gender.

Saved preview priority

New-character customization priority

The first spawn opens illenium-appearance, then qb-clothing on QBCore, or esx_skin with skinchanger on ESX. fivem-appearance can supply preview data, but this version does not open its creator automatically.

Relog and post-spawn logic

Use the client event after the selected character is visible and placed at the final coordinates:

AddEventHandler('lck-multicharacter:client:characterSpawned', function(framework, isNew)
    -- framework: 'esx', 'qb', or 'ox'
    -- isNew: true only for a newly created character
end)

This is the intended hook for a HUD, tutorial, onboarding flow, or other post-selection logic. Normal framework loaded and spawned events continue to run.

Common problems

First confirm the documented resource order, make sure only one selector is running, verify the exact dependency folder names, then set Config.Debug = true, restart, reconnect, and inspect the server and F8 consoles.

Identity registration failures

Names must meet the configured length and character rules, the birth date must produce an allowed age, the selected slot must remain empty, and the database must be healthy. The form passing browser validation never overrides the server's ownership, capacity, age, or database checks.

Missing Last Location

Last Location is hidden for new characters. For existing characters, inspect the saved QBCore position, ESX loaded coordinates, or OX character coordinates and heading.