Multicharacter
Installation
Ensure order and framework-specific steps for ESX, QBCore and Qbox.
#1. Copy and ensure
Copy ghiaccio_multichar into resources/ and add it after oxmysql and the framework:
ensure oxmysql
ensure es_extended # or qb-core / qbx_core
ensure ghiaccio_multicharThen follow the section for your framework, restart the server and run gmc selftest in the console: it tells you what to fix. Existing characters show up with no migration.
#ESX Legacy
- Remove
esx_multicharacterand stopesx_identity. Ifserver.cfgstarts a category folder (ensure [core]), dropping a line is not enough: move both folders out ofresources/(keep a copy), otherwise they start anyway. - Keep
skinchanger+esx_skin(or another appearance script) for the creator. fxmanifest.luadeclaresprovide 'esx_multicharacter':es_extendedreads it to enter multicharacter mode.- Put
ensure ghiaccio_multicharafterensure [core](or afteres_extended,esx_skinandskinchanger). - Maximum character load time:
Config.ESX.joinTimeoutMs(config_server.lua).
#QBCore
- Stop and remove
qb-multicharacterfromserver.cfg(and from other scripts' dependencies). If you start the category (ensure [qb]), move the folder out ofresources/. - Also stop
qb-spawn: the spawn selector is part of this resource (Config.Spawn). qb-apartmentsandqb-housesmay stay: the apartment choice simply does not appear (withConfig.Spawn.newCharacter = 'spawns', the default, it is not needed).- Put
ensure ghiaccio_multicharafterqb-coreandqb-clothing(at the bottom, afterensure [qb]).
#Qbox
qbx_core/config/client.lua:characters.useExternalCharacters = true.qbx_core/config/server.lua:defaultNumberOfCharacters = 0andplayersNumberOfCharacters = {}(this resource manages slots).- Close the two delete doors. Players cannot delete characters; without these two steps a modified client could, with no backup:
qbx_core/server/character.lua: remove or comment out theRegisterNetEvent('qbx_core:server:deleteCharacter', ...)block.qbx_core/server/player.lua: remove or comment out thelib.callback.register('qbx_core:server:deleteCharacter', DeleteCharacter)line.
qbx_spawnmay stay started: withuseExternalCharacters = truethe core no longer calls it. Putensure ghiaccio_multicharafterqbx_coreandillenium-appearance.
gmc selftest reports if either delete door is still open. Anyone who uses them anyway is logged and disconnected.
#Appearance adapters
Config.Appearance.adapter:
'auto'(default) tries illenium-appearance, fivem-appearance, rcore_clothing, qb-clothing, esx_skin and uses the first one running.- or force one:
'illenium','fivem_appearance','rcore','qb_clothing','esx_skin','custom','none'.
For another appearance script set adapter = 'custom' and fill in adapters/appearance/custom.lua (2 functions, instructions in the file). With no adapter the character joins with the outfits in Config.Appearance.defaultOutfits.
#Loadscreen
The resource ships its own loadscreen. FiveM uses one loadscreen per server: stop the others (for example esx_loadingscreen in [core], qb-loading in [qb]: remove the resource or its folder, or drop the loadscreen line from their manifest). gmc selftest reports them. To keep your own loadscreen instead, remove the 3 loadscreen* lines from this resource's fxmanifest.lua.
#Staff permissions
add_ace group.admin ghiaccio_multichar.admin allow # everything
add_ace group.mod ghiaccio_multichar.staff.view allow
add_ace group.mod ghiaccio_multichar.staff.slots allow
add_ace group.mod ghiaccio_multichar.staff.chars allow
add_ace group.sceneeditor ghiaccio_multichar.scene allow # /gmc scene only
add_principal identifier.license:XXXXXXXX group.adminWithout ACE you can use framework groups in Config.Staff.groups. The full command table is in Commands.
#Importing characters from another script
From the server console: gmc import esx|qb|qbox (without --apply it is a dry run).