Installation

How to properly install Multicharacter resource

ESX

Changing es_extended config

Firstly, we need to apply the changes to the config file. If you're on ESX Legacy 1.12 and above find es_extended/shared/config/main.lua Any other version, go to es_extended/config.lua Find this variable:

Config.Multichar = GetResourceState("esx_multicharacter") ~= "missing"

And change it to:

Config.Multichar = true

Now you applied the core changes to the framework! 🎉

Installing the resource

Drag resource into your /resources folder. Voila! 🎉

QBCore

Installing the resource

Drag resource into your /resources folder. Voila! 🎉

QBOX

Installing the resource

Drag resource into your /resources folder. Head over to the Multicharacter/server/functions/characters.lua directory and find function Characters.GetIdentifier and replace the content with:

Characters.GetIdentifier = function(src, noCut)
    local identifier = GetPlayerIdentifierByType(src, 'license2') or GetPlayerIdentifierByType(src, 'license')
    assert(identifier ~= nil, '^5Invalid identifier type for config value Config.Characters.IdentifierType!\n^2Please refer to the docs: https://zsx-development.gitbook.io/docs/multicharacter/common-issues/other\n\n')
    local convertedIdentifier
    if FrameworkSelected == 'ESX' then
        if not noCut then
            local colonIndex = string.find(identifier, ":")
            convertedIdentifier = string.sub(identifier, colonIndex + 1)
        elseif noCut then
            convertedIdentifier = identifier
        end
    elseif FrameworkSelected == 'QBCore' then
        convertedIdentifier = identifier
    end

    return convertedIdentifier
end

Voila! 🎉 Why those changes are crucial? QBOX prioritize identifiers starting from the license2, that way we can't just set the identifier for license2 since some percentage of the users does not have that identifier.