GhiaccioScripts

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:

cfg
ensure oxmysql
ensure es_extended        # or qb-core / qbx_core
ensure ghiaccio_multichar

Then 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_multicharacter and stop esx_identity. If server.cfg starts a category folder (ensure [core]), dropping a line is not enough: move both folders out of resources/ (keep a copy), otherwise they start anyway.
  • Keep skinchanger + esx_skin (or another appearance script) for the creator.
  • fxmanifest.lua declares provide 'esx_multicharacter': es_extended reads it to enter multicharacter mode.
  • Put ensure ghiaccio_multichar after ensure [core] (or after es_extended, esx_skin and skinchanger).
  • Maximum character load time: Config.ESX.joinTimeoutMs (config_server.lua).

#QBCore

  • Stop and remove qb-multicharacter from server.cfg (and from other scripts' dependencies). If you start the category (ensure [qb]), move the folder out of resources/.
  • Also stop qb-spawn: the spawn selector is part of this resource (Config.Spawn).
  • qb-apartments and qb-houses may stay: the apartment choice simply does not appear (with Config.Spawn.newCharacter = 'spawns', the default, it is not needed).
  • Put ensure ghiaccio_multichar after qb-core and qb-clothing (at the bottom, after ensure [qb]).

#Qbox

  1. qbx_core/config/client.lua: characters.useExternalCharacters = true.
  2. qbx_core/config/server.lua: defaultNumberOfCharacters = 0 and playersNumberOfCharacters = {} (this resource manages slots).
  3. 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 the RegisterNetEvent('qbx_core:server:deleteCharacter', ...) block.
    • qbx_core/server/player.lua: remove or comment out the lib.callback.register('qbx_core:server:deleteCharacter', DeleteCharacter) line.
  4. qbx_spawn may stay started: with useExternalCharacters = true the core no longer calls it. Put ensure ghiaccio_multichar after qbx_core and illenium-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

cfg
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.admin

Without 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).