Prérequis
Requis
qbx_core 1.24 ou plus récent, qb-core ou es_extendedomerta_bridge (dans le téléchargement)ox_liboxmysqlillenium-appearance
Optionnel
- ox_inventory, qb-inventory ou l’inventaire d’ESX (uniquement pour les objets de départ)
- screenshot-basic (uniquement pour l’outil de capture des vignettes)
- bob74_ipl (uniquement pour la salle de sélection par défaut)
Installation
Placez le dossier omerta_multichar dans vos ressources, et le dossier omerta_bridge du téléchargement à côté. Une seule copie d’omerta_bridge sert à tous les scripts Omerta : gardez la plus récente.
Sur Qbox, dans qbx_core/config/client.lua, désactivez le menu de personnages de qbx_core et son appartement de départ (sur QBCore ou ESX, suivez plutôt install/qbcore.md ou install/esx.md du téléchargement) :
qbx_core/config/client.luacharacters = { useExternalCharacters = true, startingApartment = false, -- ...}Laissez startingApartment désactivé. Activé, qbx_properties ouvre son choix d’appartement à chaque chargement d’un citoyen sans logement, puis le menu d’apparence, et masque la minicarte.
Redémarrez tout le serveur, pas seulement la ressource : qbx_core lit ces deux réglages au démarrage.
Dans server.cfg, démarrez omerta_bridge puis omerta_multichar, après oxmysql, ox_lib, votre framework et illenium-appearance :
server.cfgensure qbx_coreensure omerta_bridgeensure omerta_multichar
Ses deux tables, emplacements supplémentaires et kits de départ déjà donnés, sont créées au démarrage. Les personnages restent dans les tables de votre framework. Sur Qbox et QBCore, la table playerskins d’illenium-appearance doit exister. Si vous avez déjà des joueurs, exécutez install/starter-backfill.sql une fois.
Réglages
| Réglage | Ce qu’il fait |
|---|---|
Config.Theme | 'amethyst' (par défaut) ou 'cyan'. |
Config.Locale | nil laisse chaque joueur choisir anglais ou français ; 'en' ou 'fr' en impose une et masque le choix. |
Config.MaxSlots | Le nombre maximum de personnages par joueur, emplacements supplémentaires compris. 5 par défaut. Le nombre de base vient du framework (sur QBCore et ESX, la convar omerta:characterSlots, 3 par défaut). |
Config.MaxExtraSlots | Le maximum d’emplacements supplémentaires attribuables à un joueur depuis la console. 4 par défaut. |
Config.AllowDelete | Affiche ou masque seulement le bouton de suppression ; désactivé par défaut. Le serveur laisse quand même le propriétaire supprimer son personnage : sur Qbox, install/qbx_core.md explique comment le bloquer. |
Config.SlotsCommand | Nom de la commande console des emplacements supplémentaires. 'charslots' par défaut. |
Config.AdminAce | Groupe ACE des commandes admin. 'group.admin' par défaut. |
Commandes
| Commande | Qui peut l’utiliser | Ce qu’il fait |
|---|---|---|
charslots | Console du serveur | Liste les joueurs qui ont des emplacements supplémentaires. |
charslots <who> | Console du serveur | Affiche les emplacements et les personnages d’un joueur. <who> est l’id serveur d’un joueur en ligne ou, en ligne comme hors ligne, un citizenid (sur ESX, l’identifiant du personnage) ou un identifiant license:, license2: ou fivem:. |
charslots add <who> <n> | Console du serveur | Donne n emplacements supplémentaires de plus, par exemple depuis un package Tebex. |
charslots remove <who> <n> | Console du serveur | Retire n emplacements supplémentaires. |
charslots set <who> <n> | Console du serveur | Fixe exactement n emplacements supplémentaires ; 0 les retire tous. |
/mcstage | Admins | Affiche votre position et orientation sous forme de ligne d’ancrage pour la config. |
/mcshots [male | female | both] [category | camera | all] [force] | Admins | Capture les vignettes de vêtements dans web/img/thumbs. /mcshots stop l’arrête. |
Mise à jour
Téléchargez la nouvelle version depuis votre Keymaster, remplacez le dossier et gardez votre config.lua, vos fichiers web/locales et, si vous avez filmé les vôtres, web/img/thumbs.
Obtenir de l’aide
Ouvrez un ticket sur ce site ou sur Discord avec la version de votre artifact, celle du framework et la sortie console.
Nouveau ticket