Kivo Multichar
Kivo Multichar is the character selection screen of the Kivo Character Suite. When a player connects, they are moved into a separate routing bucket and shown a cinematic scene with a ped for each character slot. They can select, create and delete characters. After they pick a character, Multichar logs them in through your framework and hands them to your spawn system.
Documented version: 1.5.0.
What the player sees
Section titled “What the player sees”- A cinematic backdrop (a “scene”) with one animated ped per slot, each wearing that character’s saved appearance, with the camera moving from slot to slot.
- A panel with the selected character’s name, gender, cash, bank, job and location.
- Empty slots offer Create. Slots beyond the player’s allowance appear locked.
- Play logs the character in and moves on to the spawn step.
- Delete removes a character (can be switched off). The selection then moves to the next remaining character.
A player with no characters goes straight into character creation.
Features
Section titled “Features”- Automatic detection of QBX, QBCore and ESX Legacy, including when the framework starts after Multichar.
- Characters are created and loaded by the framework itself, so it works across framework versions. New QBX and QBCore characters get the framework’s starter items.
- Character previews for illenium-appearance, fivem-appearance, qb-clothing, bl_appearance and esx_skin, based on the saved skin’s format.
- Startup check that reports conflicting resources and settings, and a
kivosetupconsole command that fixes them. - Protection against duplicate logins (double clicks, resource restarts while players are in game).
- Routing bucket isolation during character selection (
Config.bucket). - Configurable scenes with per slot ped, animation and camera, plus optional camera waypoints. Three scenes ship with the resource.
- Per player slot allowance: default slots, a hard maximum, and
addslotandremoveslotconsole commands. - Works with Kivo Identity Creator for creation, or a built-in dialog.
- Works with Kivo Spawn, your framework’s spawn selector, or your own spawn script through a bridge file.
- Demo mode and demo server mode for testing without a live framework.
- Open framework and appearance layers (
server/framework.lua,client/framework.lua) you can adjust for your server.
Requirements
Section titled “Requirements”| Requirement | Notes |
|---|---|
ox_lib |
Declared as a dependency in fxmanifest.lua. |
oxmysql |
Declared as a dependency in fxmanifest.lua. |
| A framework | qbx_core, qb-core or es_extended. |
| Kivo Identity Creator, Kivo Spawn | Optional. Switched on and off from config.lua. |
The database table Multichar needs is created automatically on the first start.
Kivo Multichar tells ESX Legacy that a multicharacter resource is present (it provides esx_multicharacter). Do not run the original esx_multicharacter next to it.
Start order
Section titled “Start order”ensure oxmysqlensure ox_libensure qbx_core # or qb-core, or es_extendedensure kivo-multi-charensure kivo-identity-creator # optionalensure kivo-spawn # optionalESX also needs mapmanager and spawnmanager started before es_extended. See the suite installation page for the full blocks.
- Installation
- Configuration: every option, scenes, slots, demo mode and console commands.
- Exports and integration: the spawn bridge, the framework and appearance layers, and adapting to other scripts.
- Examples: scenes, slots, demo mode, edge cases and troubleshooting.
- Back to the Kivo Character Suite.
