Installation — Multicharacter

Installer Multicharacter MrPoulpi Labs : ordre du server.cfg, base de données, réglages ESX Legacy, QBCore et Qbox, et premier essai.

Étapes

Copiez le dossier dans resources sans le renommer : mrpoulpi_multicharacter.
Retirez l’ancienne sélection de personnage de votre framework (voir plus bas). Deux sélections en même temps se gênent.

Ajoutez la ressource à server.cfg, après oxmysql, le framework et le système d’apparence :

ensure oxmysql
ensure es_extended
ensure illenium-appearance
ensure mrpoulpi_multicharacter

Base de données : les tables sont créées au premier démarrage. Si votre utilisateur SQL ne peut pas créer de tables, importez sql/install.sql.
Réglez au moins la langue, les emplacements et la boutique dans config/shared.lua. L’adresse de boutique fournie est un exemple et reste bloquée tant que vous ne la changez pas.
Redémarrez le serveur entièrement après avoir modifié la configuration du framework.

Réglages du framework

Retirez esx_multicharacter et esx_identity du server.cfg.
Dans es_extended/shared/config/main.lua, forcez le mode multipersonnage :

Config.Multichar = true

Dans config/server.lua, ServerConfig.ESX.DateFormat doit correspondre au format des dates de naissance de votre table users (DD/MM/YYYY avec esx_identity).
Si vous veniez d’esx_multicharacter, gardez ServerConfig.ESX.Prefix = 'char' : vos personnages apparaissent directement.
Ajoutez à ServerConfig.ESX.DeleteTables les tables de vos scripts qui stockent des données par personnage (téléphone, maisons, garages…).

Retirez qb-multicharacter et qb-spawn du server.cfg. Le choix du point d’apparition est géré par la ressource.
Rien à changer dans qb-core.
Les objets de QBCore.Shared.StarterItems sont donnés à la création. Pour ne rien donner : ServerConfig.QB.StarterItems = false.

Aucun appartement de départ n’est attribué à la création.

Dans qbx_core/config/client.lua, confiez la sélection à une ressource externe :

characters = {
    useExternalCharacters = true,
    -- vos autres réglages
},

Les objets de départ sont ceux de ServerConfig.QBX.StarterItems (un téléphone par défaut), donnés par ox_inventory.

Premier essai

La console affiche [multicharacter] 1.0.0 · framework: esx (ou qb, qbx) en vert, sans ligne rouge.
À la connexion, la scène s’affiche avec vos personnages existants.
Créez un personnage : il apparaît à l’aéroport et l’éditeur d’apparence s’ouvre.
Tapez /relog : vous revenez à la sélection avec le nouveau personnage.
Jouez avec « Dernière position » : vous réapparaissez où vous étiez.
Supprimez un personnage de test : il disparaît de la liste.

Si ça ne marche pas

Le joueur arrive directement en jeu : Config.Multichar (ESX) ou useExternalCharacters (Qbox) n’est pas activé, ou une autre sélection tourne encore.
Écran noir à la connexion : la ressource démarre avant le framework.
Anciens personnages ESX absents : ServerConfig.ESX.Prefix ne correspond pas à vos identifiants.
Pas d’éditeur d’apparence : le système d’apparence démarre après la ressource.

Plus de cas dans Dépannage.

Mise à jour

Sauvegardez config/, locales/ et bridge/ si vous les avez modifiés. Remplacez le dossier puis reportez vos réglages dans les nouveaux fichiers. Les tables SQL sont conservées.