Multicharacter

Koja Multicharacter: character selection, creator and spawn selector for ESX, QBCore and QBX with cutscenes, slot tiers, relog and a developer API built on koja-lib.

Koja Multicharacter

Koja Multicharacter replaces the character selection, identity form and spawn screen of your framework with one resource. It runs on ESX, QBCore and QBX, is built on koja-lib and shares its design with Koja Appearance.

This section covers version 1.1.1 of the resource.

What you get

Area	What is in it
Selection scene	Configurable locations, time and weather, idle scenarios, a single preview or a line-up of all characters, drag to rotate and scroll to zoom
Cutscenes	An opening shot that glides in, and on every switch the old character walks out while the new one walks in, gestures and settles in
Character cards	Headshot, job and grade, gang, cash and bank, playtime, last played, created date, nationality, height and backstory
Slots	Default count, ACE tiers (VIP, staff), per-player overrides, locked slots with a store link, import of old `esx_multicharacter` slots
Creator	Identity form checked on the server (name rules, blacklist, unique names, age, height, nationality, backstory), then the appearance editor
Presets	Save a look and start new characters from it, or copy another character's look
Spawn selector	Last location, public, job and gang spots with minimum grade, cooldowns, spawns from other resources and a sky camera. Uses the koja-spawnselector map when it is on the server
Spawn protection	Ghosting, invincibility, no shooting and transparency for a few seconds
Relog	`/relog` without reconnecting, with cooldown, dead, vehicle and combat checks and blockers from other resources
Safety	Private routing bucket while choosing, duplicate login guard, stale session cleanup
Admin	Commands to list, lock, unlock and delete characters, set slots and force a relog. Discord logs
Developer API	Server and client exports, hooks that can cancel actions, events and state bags
Languages	English and Polish, add your own in `locales/`

Quick facts

Frameworks: ESX Legacy, QBCore and QBX, detected automatically.
Requires: koja-lib and oxmysql.
Appearance: Koja Appearance or illenium-appearance recommended. fivem-appearance, qb-clothing and esx_skin also work.
Replaces: esx_multicharacter and esx_identity on ESX, qb-multicharacter on QBCore. It stops them if they start next to it.
Database: three koja_multicharacter_* tables, created on start.
UI: shipped prebuilt. You only need Node and pnpm to change it.

Start here

Install it
Installation: dependencies, framework settings, server.cfg order and admin access.
Configure it
Configuration: every option in shared/config.lua.
Learn what it does
Features: selection, cutscenes, creator, spawn selector and relog.
Use it from your own code
Developer API: exports, hooks, events and state bags.