Skip to content

Kivo Identity Creator Examples

This is the shipped QBX setup. Every field is shown.

Config.fields.qbx = {
firstname = true,
lastname = true,
dob = true,
gender = true,
height = true,
nationality = true,
}

QBX does not store height. If you do not want players typing a value that is dropped, hide it:

Config.fields.qbx.height = false

The shipped QBCore and ESX tables already show only the four core fields. Use the same shape for a server that wants nothing else.

Config.fields.qb = {
firstname = true,
lastname = true,
dob = true,
gender = true,
height = false,
nationality = false,
}

With height hidden, ESX saves the default of 180. With nationality hidden, QBCore and QBX save Los Santos.

ESX saves height, so showing it has an effect.

Config.fields.esx.height = true

Nationality is not stored on ESX, so leave it hidden.

Nothing to change. Kivo Multichar tells the creator it is in charge when it opens the form, and finds the creator by itself, whatever either folder is called.

Standalone mode is for servers that want the identity form without Kivo Multichar.

Config.selfHandle = true
Config.defaultCam = {
coords = vector3(-1850.8547, -1230.2957, 13.0172),
rot = vector3(-8.0, 0.0, -119.0),
fov = 50.0,
}
Config.defaultPedCoords = vector4(-1075.34, -248.12, 43.14, 60.0)
Config.blankPedModel = 'mp_m_freemode_01'

Things to know:

  • The creator writes the character to the database itself, then fires Config.callbackEvent. Your own script handles the spawn.
  • Camera and ped coordinates must point to a clear spot on your map, with the ped inside the camera’s view.
Mistake Result Fix
Config.callbackEvent or Config.backEvent renamed Multichar never gets the confirm or Back action, so nothing is created or Back does nothing. Restore the defaults.
firstname or lastname hidden Multichar refuses to create the character. Show both.
gender hidden Every new character is saved as male. Show it.
useIdentityCreator = true in Multichar but the resource is not started Multichar uses its built-in dialog instead. Start kivo-identity-creator if you want the form.
Started before the framework The wrong or no field set may be used. Put it after the framework in server.cfg.
  1. Form submits but the character is never created.

    • Confirm kivo-multi-char is started and Config.useIdentityCreator = true.
    • Confirm Config.callbackEvent and Config.backEvent are unchanged.
    • Set Config.debug = true and read the client console (F8) and the server console while you submit the form.
  2. A white screen, or black, hard to read text.

    • Fixed in 1.5.0. Update Kivo Identity Creator to the current version.
  3. Wrong fields shown for my framework.

    • Check that your framework is started before Kivo Identity Creator.
    • Check the matching table in Config.fields (qbx, qb or esx). With no framework detected, Config.fields.default is used.
  4. The camera or ped is in the wrong place in standalone mode.

    • Adjust Config.defaultCam and Config.defaultPedCoords to a clear spot. See the caution above.
  5. Back does not return to the selection screen.

    • Config.backEvent must be 'kivo-multichar:identityBack'.
  6. Character creation fails on the framework side.