KS-Multicharacter

Installation

1. Unzip the delivered archive into your resources/ folder, under the name ks-multicharacter.
2. Import the provided install.sql file into your database.
3. Add ensure ks-multicharacter to your server.cfg, after oxmysql and qb-core.
4. Restart your server.

Configuration

Config.MaxSlots = 3
Config.UnlockExtraSlot = { afterHoursPlayed = 20 } -- déblocage d'un slot supplémentaire

Leave UnlockExtraSlot as nil for a fixed number of slots, identical for every player from their first connection.

Granting a player an extra slot

Useful as a reward for an event or a purchase:

exports['ks-multicharacter']:GrantSlot(source)
-- ajoute immédiatement un slot de personnage supplémentaire au joueur

The granted slot is permanent and persists across sessions, with no further action needed.

Common issues

The 3D character preview stays black. Check that the NUI render has enough time to load the model before displaying it — on a heavily loaded server, increase Config.PreviewLoadDelay (in milliseconds).

A deleted character reappears after a restart. Check that deletion properly updates the players table (the deleted_at column or equivalent), and that no other save script recreates the entry automatically.