🦑Kivo Identity Creator

Character identity creation NUI for FiveM. Collects name, date of birth, gender, height, and nationality from the player when a new character is created. Triggered by kivo-multi-char or used standalone by any script.

1

Place the resource

resources/
  [kivo]/
    kivo-identity-creator/

2

Configure

Open config.lua. The critical value is Config.callbackResource — it must match the exact folder name of kivo-multi-char on your server:

Config.callbackResource = 'kivo-multi-char-DEMO'  -- change to your actual folder name
Config.selfHandle       = false                    -- true = standalone mode

Field visibility per framework — set any field to false to hide it:

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

3

Add to server.cfg

QBX

ensure oxmysql
ensure ox_lib
ensure qbx_core
ensure kivo-multi-char
ensure kivo-identity-creator

QBCore

ESX

Features

• Per-framework field visibility (show only what your framework uses)

• Fires kivo-multichar:identityCreated on confirm, kivo-multichar:identityBack on Back

• Standalone mode: writes to DB directly without kivo-multi-char

• Custom camera and ped position for standalone mode

Config Reference

Key	Default	Description
Config.selfHandle	false	true = standalone mode, resource writes to DB itself
Config.callbackEvent	'kivo-multichar:identityCreated'	Client event fired when player confirms the form
Config.callbackResource	'kivo-multi-char-DEMO'	Exact folder name of kivo-multi-char — must match
Config.backEvent	'kivo-multichar:identityBack'	Client event fired on Back button
Config.defaultCam.coords	—	Standalone: camera world position
Config.defaultCam.rot	—	Standalone: camera rotation
Config.defaultCam.fov	50.0	Standalone: field of view
Config.defaultPedCoords	—	Standalone: ped world position + heading
Config.blankPedModel	'mp_m_freemode_01'	Standalone: ped model displayed during creation

Kivo Suite Integration

In kivo-multi-char's config.lua:

Config.useIdentityCreator = true

Creation flow:

1. Player clicks "Create Character" → kivo-multi-char opens kivo-identity-creator

2. Player fills the form → confirms → kivo-multichar:identityCreated fires

3. kivo-multi-char writes character to DB → triggers spawn

4. Player presses Back → kivo-multichar:identityBack fires → returns to character select

To skip this resource entirely set Config.useIdentityCreator = false in kivo-multi-char — it will use lib.inputDialog instead.

Standalone Mode

Set Config.selfHandle = true. The resource will:

1. Place a blank ped at Config.defaultPedCoords using Config.blankPedModel

2. Open the identity form with the camera at Config.defaultCam

3. Write identity data to the DB

4. Fire Config.callbackEvent when complete

Troubleshooting

1. Form submits but character never creates

   • Config.callbackResource does not match the kivo-multi-char folder name exactly — check spelling and casing

2. Wrong fields shown for my framework

   • Confirm shared/framework.lua is detecting the correct framework

   • Check Config.fields for the matching key (qbx, qb, or esx)

3. Camera is wrong in standalone mode

   • Adjust Config.defaultCam.coords and Config.defaultPedCoords to a clear spot on your map