Skip to Content
MulticharacterCommon Issues

Common Issues

A collection of common problems and their solutions to help you troubleshoot crm-multicharacter quickly.

CreatePed error on join

CreatePed native failing

Because crm-multicharacter loads early when a player joins, a CreatePed error can look like it comes from the script. In almost every case, it doesn’t.

CreatePed native error

The error happens when the game tries to create a ped (character model) and the native fails.

This is not a crm-multicharacter problem. The script only loads the ped your server provides — if that ped can’t be created, the cause is in your server files, not the script.

Common causes

  • Wrong or unstable server artifacts — outdated, broken or experimental artifacts can break ped creation.
  • Broken or incompatible clothing packs — addon clothing, DLC packs or custom models with missing textures, wrong structure, or corrupted YDD/YMT files will crash ped creation.
  • Conflicting or corrupted streamed ped files — two resources streaming the same file, or a corrupted outfit, can make CreatePed fail.
  • YMT limit reached — exceeding GTA’s native YMT component limit stops peds from loading correctly.

How to fix it

  1. Update your server artifacts to a recent, stable build.
  2. Test your clothing packs one at a time to find the culprit.
  3. Remove or repair any corrupted clothing packs.

ID card / driver license not working

ID card / driver license not working with crm-multicharacter + qbx_idcard

Open the server file:

        • crm-main.lua

Replace the crm_starter_items function with the following:

crm-multicharacter/crm-open/crm-server/crm-main.lua
function crm_starter_items(crm_framework, crm_source, crm_identifier, crm_data)
    Citizen.Wait(1000)
    local crm_starting = crm_config.crm_items
    if crm_starting.crm_enable then
        if crm_framework == "crm_esx" then
            for _, crm_item in pairs(crm_starting.crm_items) do
                local crm_metadata = {}
                crm_inv.crm_add(crm_source, crm_item.crm_item, crm_item.crm_amount, false, crm_metadata, "Starting Items")
            end
        else
            local crm_citizenid = crm_lib.crm_getplayerid(crm_source)
            local crm_info = crm_data.charinfo
            for _, crm_item in pairs(crm_starting.crm_items) do
                local crm_metadata = {}
                if crm_item.crm_item == "id_card" then
                    crm_metadata = exports.qbx_idcard:GetMetaLicense(crm_source, {'id_card'})
                elseif crm_item.crm_item == "driver_license" then
                    crm_metadata = exports.qbx_idcard:GetMetaLicense(crm_source, {'driver_license'})
                end
                crm_inv.crm_add(crm_source, crm_item.crm_item, crm_item.crm_amount, false, crm_metadata, "Starting Items")
            end
        end
    end
end

This creates ID cards and driver licenses with the correct metadata, so qbx_idcard can display and use them properly.

Extra SlotsInstallation