Kivo Identity Creator Examples
Example: full form on QBX
Section titled “Example: full form on QBX”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 = falseExample: short form on QBCore or ESX
Section titled “Example: short form on QBCore or ESX”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.
Example: ask for height on ESX
Section titled “Example: ask for height on ESX”ESX saves height, so showing it has an effect.
Config.fields.esx.height = trueNationality is not stored on ESX, so leave it hidden.
Example: renamed folders
Section titled “Example: renamed folders”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
Section titled “Standalone mode”Standalone mode is for servers that want the identity form without Kivo Multichar.
Config.selfHandle = trueConfig.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.
Common mistakes
Section titled “Common mistakes”| 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. |
Troubleshooting
Section titled “Troubleshooting”-
Form submits but the character is never created.
- Confirm
kivo-multi-charis started andConfig.useIdentityCreator = true. - Confirm
Config.callbackEventandConfig.backEventare unchanged. - Set
Config.debug = trueand read the client console (F8) and the server console while you submit the form.
- Confirm
-
A white screen, or black, hard to read text.
- Fixed in 1.5.0. Update Kivo Identity Creator to the current version.
-
Wrong fields shown for my framework.
- Check that your framework is started before Kivo Identity Creator.
- Check the matching table in
Config.fields(qbx,qboresx). With no framework detected,Config.fields.defaultis used.
-
The camera or ped is in the wrong place in standalone mode.
- Adjust
Config.defaultCamandConfig.defaultPedCoordsto a clear spot. See the caution above.
- Adjust
-
Back does not return to the selection screen.
Config.backEventmust be'kivo-multichar:identityBack'.
-
Character creation fails on the framework side.
- Read the messages in Suite examples, troubleshooting. Creation itself is done by Kivo Multichar.
