Skip to content

Kivo Multichar Installation

This is the short version. The full install for all three Kivo character scripts is on the suite installation page.

  1. Copy the folder to your server. You can rename it.

    resources/
    [kivo]/
    kivo-multi-char/
  2. Add it to server.cfg after your framework, and remove your old multicharacter (qb-multicharacter, esx_multicharacter or any other). On ESX, also remove esx_identity.

    QBX or QBCore:

    ensure oxmysql
    ensure ox_lib
    ensure qbx_core # or qb-core
    ensure kivo-multi-char
    ensure kivo-identity-creator # optional
    ensure kivo-spawn # optional

    ESX:

    ensure mapmanager
    ensure spawnmanager
    ensure oxmysql
    ensure ox_lib
    ensure es_extended
    ensure kivo-multi-char
    ensure kivo-identity-creator # optional
    ensure kivo-spawn # optional
  3. Start the server and read the console. Multichar prints the framework it detected, then setup OK or a red CONFLICT line. If there is a conflict, type kivosetup in the server console and restart the server once.

    Conflict What kivosetup does
    Another multicharacter resource is running Stops it for the current session. Remove its ensure line so it stays off.
    QBX: useExternalCharacters = false in qbx_core/config/client.lua Sets it to true.
    Older ESX builds: Config.Multichar = false in es_extended Sets it to true.

    Every file it changes gets a .kivo-backup copy next to it. Nothing is changed unless you run the command.

The database table for per player slot counts is created automatically on the first start.

All of these work with their shipped values. See configuration for the full list.

Config.maxChars = 5 -- hard cap per player
Config.defaultSlots = 5 -- slots a player has by default
Config.spawnSelector = 'kivo-spawn' -- 'kivo-spawn' | 'default' | 'custom'
Config.useIdentityCreator = true -- false = built-in dialog
Config.defaultScene = 'scene_2' -- scene shown on connect
Config.defaultMoney = { cash = 500, bank = 5000 }
  • kivo-multi-char starts after your framework
  • Old multicharacter removed from server.cfg (and esx_identity on ESX)
  • Console shows setup OK
  • Config.demo = false
  • Config.debug = false on a live server
  • Tested with a new and a returning character