FAQ

Common questions and fixes for Nexus Multicharacter.

The default character spawns in front of my main character on QBCore

This happens because of the basic-gamemode script that ships with FiveM. It auto-spawns a default character before the multichar takes control.

Open [cfx-default]/[gamemodes]/basic-gamemode/basic_client.lua and replace the entire file with:

basic_client.lua


AddEventHandler('onClientMapStart', function()
  exports.spawnmanager:setAutoSpawn(false)
  exports.spawnmanager:forceRespawn()
end)

Restart the server and the ghost character should be gone.

Framework auto-detection isn’t picking up my framework

Config.Framework = 'auto' works for most setups, but if your framework is loaded oddly or you’re running a fork, it can miss. Force it explicitly:

shared/config.lua


Config.Framework = 'qbx' -- auto | qb | qbx | esx

How do I add more character slots?

Bump Config.Freeslots and add matching entries to Config.Animations so each new slot has a scene to use.

shared/config.lua


Config.Freeslots = 5
 
Config.Animations = {
    [1] = { ... },
    [2] = { ... },
    [3] = { ... },
    [4] = { ... }, -- add
    [5] = { ... }, -- add
}

If you forget the extra animation entries, the new slots still work but won’t have a per-slot scene.

You can wire up any menu by editing client/cl_customize.lua and server/sv_customize.lua. Both files contain the integration logic for the built-in menus. Copy one of the existing handlers as a starting point.

How do I change the UI color theme?

Open shared/theme.lua:

shared/theme.lua


Theme = {
    Primary = '#2389FD',
    Danger  = '#FD2327',
    Bg      = '#0E0E0E',
    Text    = '#FFFFFF',
}

Hex values only. The accent color drives selected slots, the Play button, focus rings, and gradient highlights.

Can I translate it to another language?

Yes. Open shared/locales.lua, copy the Locales.en = { ... } block, rename it (for example Locales.de), and translate the values. Then in shared/config.lua set Config.Locale = 'de'.

My Discord role-based slots aren’t working

Check the following in Config.Discord:

BotToken is a valid bot token (not an OAuth token).
The bot is a member of the guild whose ID is set in GuildId.
The role IDs in the Roles table are correct (right-click a role in Developer Mode to copy its ID).
The player has actually been assigned the role in Discord.

If everything looks right, lower CacheSeconds temporarily to force a fresh lookup.

The bot doesn’t need any special intents. It uses the standard /members/{user} endpoint, which only requires the bot to be in the server.

How do I add or change nationalities?

Edit shared/nationalities.lua. Each entry has a value (stored in the database, lowercase, no spaces) and a label (shown in the UI):

shared/nationalities.lua


Nationalities = {
    { value = 'american', label = 'American' },
    { value = 'british',  label = 'British' },
    -- add or remove as needed
}

Can I rename the resource folder?

Yes. Rename the folder to whatever you want, then update the ensure line in your server.cfg to match.

Need help with something else?

Hop into our Discord and we’ll help you out.

FAQ