Skip to Content

QBCore Character Builder

Compose a test persona and generate a qb-clothing appearance table you can paste into default-character or test-player scripts.

Model

qb-clothing appearance table

local appearance = {
    model = 'mp_m_freemode_01',
    tattoos = {},
    faceFeatures = {},
    hair = { style = 0, color = 0, highlight = 0, texture = 0 },
    components = {
        { component_id = 11, drawable = 0, texture = 0 },
        { component_id = 8, drawable = 0, texture = 0 },
        { component_id = 4, drawable = 0, texture = 0 },
        { component_id = 6, drawable = 0, texture = 0 },
    },
    props = {},
}

Drawable IDs differ per server resource pack. Test in-game with a scratch character before shipping defaults.

Profile fields worth capturing alongside appearance

  • Identity: first/last name, birthdate, gender, nationality
  • Jobs & gangs: job name/grade, gang name/grade
  • Wallets: cash, bank, crypto; starting inventory slots
  • Licenses/flags: driver, weapon, medical, custom role tags

Suggested defaults for testing

  • Cash 500, Bank 5,000, Crypto 0
  • Job: unemployed grade 0; Gang: none
  • Starter inventory: phone, ID card, water, sandwich, bandage
  • Licenses: driver = true, weapon = false (flip per scenario)

Export tips

  • Keep JSON/Lua exports versioned with your resource configs.
  • Include a short note for each test persona (purpose, expected behaviour).
  • When load-testing, vary jobs/grades to hit permission checks and salary timers.