Documentation

wnt_multicharacter

Multicharacter

Smooth multi-character selection with slots, creation and live previews.

QBCoreESXQbox

Installation

Follow these steps to get wnt_multicharacter running. It works out of the box on QBCore, ESX and Qbox.

1
Download the resource
Grab the latest release from your account dashboard or straight from your CFX keymaster.
2
Drop it into resources
Extract the folder into your server's resources directory.
3
Add it to your server.cfg
Below your framework and oxmysql:
server.cfg
```
ensure oxmysql
ensure wnt_multicharacter
```
4
Import the database
Run the included SQL file once — it creates every table for you:
bash
```
mysql -u root -p yourdatabase < wnt_multicharacter.sql
```
5
Configure & restart
Set Config.Framework in config.lua, restart your server and you're done!

Make sure wnt_multicharacter loads after your framework and oxmysql so its exports register correctly.

Everything lives in config.lua. Just set your framework and you're good to go:

config.lua

Config = {}
Config.Framework    = 'qbox'    -- 'qb' | 'esx' | 'qbox'
Config.Slots        = 5
Config.EnablePreview = true
Config.SpawnLast    = true

Exports and events you can use from your own resources:

exports['wnt_multicharacter']:GetSlots(source)

Returns the number of unlocked character slots.

TriggerEvent('wnt_multicharacter:client:selected', charId)

Fired client-side once a character has been chosen.

If wnt_multicharacterwon't start, check your console for missing dependencies and open a ticket in our Discord with the output.