Common Issues

A collection of common problems and their solutions to help you quickly troubleshoot your scripts

CreatePed Error

CreatePed Native Failing

Some users report an error that looks like it comes from crm-multicharacter, especially because it loads early when joining the server. However, this is a common misunderstanding.

This happens when the server tries to create a ped (character model), and the native function fails.

Important: This Is Not a crm-multicharacter Problem

crm-multicharacter simply loads the ped that your server provides. If that ped cannot be created, the problem comes from your server files, not from the script.

Common Causes

The CreatePed failure is usually caused by one of the following:

1. Wrong or unstable server artifacts

Outdated, broken, or experimental artifacts can break ped creation native.

2. Broken or incompatible clothing packs

Addon clothing, DLC packs, or custom models with:

• missing textures

• wrong model structure

• corrupted YDD/YMT files

These will crash the ped creation process.

3. Conflicting or corrupted streamed ped files

If two resources stream the same file or a corrupted outfit, CreatePed may fail.

4. YMT Limit Reached

If your clothing pack exceeds GTA’s native YMT component limits, peds will stop loading correctly.

✅ How to Fix It

• Change your server artifacts

• Test your clothing packs one-by-one

• Remove or repair corrupted clothing packs

---

ID Card / Driver License Not Working

ID Card / Driver License Not Working with crm-multicharacter + qbx_idcard

🔧 Fix

Go to:

crm-multicharacter/crm-open/crm-server/crm-main.lua

Replace the crm_starter_items function with:

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

✅ Result

This ensures ID cards and driver licenses are created with the correct metadata, allowing qbx_idcard to display and use them properly.