Aller au contenu

Personnalisation

Ce que fait chaque item est configuré dans le menu et stocké en base de données. Les fichiers définissent le reste : la commande, les touches, la manière dont les éléments s’affichent et la communication avec votre framework.


FichierCe qu’il décideOuvert ?
config.luaLangue, commande, touche d’annulation, interaction avec prop posé, chemin d’images, barre de progressionOui
bridge/client_bridge.luaNotifications, santé, armure, stress, faim et soif, décompte d’items, jobs, target, barre de progressionOui
bridge/server_bridge.luaDétection du framework, items utilisables, ajout et retrait d’items, jobs, notifications, liste d’itemsOui
locales/*.luaL’ensemble des textes, en jeu et dans le menuOui
data/*.luaLes listes alimentant les sélecteurs du menuOui
html/Le menu (HTML, CSS, JS)Lisible
client/, server/Logique des itemsSous escrow

OptionCe qu’elle faitPar défaut
Config.LocaleLangue du menu et des messages. Voir Langues'en'
Config.CommandLa commande qui ouvre et ferme le menu'itemcreator'
Config.CommandDescriptionLe nom de cette commande dans les assignations de touches FiveM, où une touche peut lui être attribuée. Aucune par défaut'Open Item Creator Menu'
Config.CancelKeyTouche par défaut pour annuler ce qu’un item a déclenché. Voir ci-dessous'X'
Config.InteractionFaçon de ramasser un prop posé : 'drawtext', 'ox_target' ou 'qb-target'. Avec l’une ou l’autre valeur de target, le bridge utilise celui qui est actif'drawtext'
Config.ImageInventoryPathEmplacement où le menu trouve les images d’items, sous la forme <path><item name>.png'nui://ox_inventory/web/images/'
Config.ProgressBar'custom' pour la barre intégrée, 'ox_lib' pour celle d’ox_lib. Si ox_lib n’est pas actif, la barre intégrée est utilisée'custom'

Vous n’utilisez pas ox_inventory ? Définissez Config.ImageInventoryPath vers le dossier d’images de votre inventaire, par exemple nui://qb-inventory/html/images/.


CommandeTouche par défautCe qu’elle fait
/itemcreatoraucuneOuvre ou ferme le menu. Nécessite l’ACE mic_itemcreator.open
/cancelitemanimConfig.CancelKey (X)Arrête l’animation, le scénario ou le style de marche lancé par un item, réinitialise la vitesse, met fin aux super-pouvoirs et retire un prop attaché

Lors du positionnement d’un Attach Prop, ces touches s’appliquent. Chacune est répertoriée dans les assignations de touches FiveM sous un libellé « Placement: », afin que les joueurs puissent les modifier :

ToucheAction
← → ↑ ↓Déplacer le prop à gauche, droite, avant, arrière
Page Haut / Page BasMonter ou descendre
Pavé num. 4 / 6Lacet (Yaw)
Pavé num. 8 / 5Tangage (Pitch)
Pavé num. 7 / 9Roulis (Roll)
XPrévisualiser l’animation
EConfirmer
Retour arrièreAnnuler

Tout ce que vous pouvez choisir dans une liste déroulante du menu provient du dossier data/, et vous pouvez en ajouter dans chacune :

FichierCe qu’il répertorie
data/animations.luaAnimations
data/scenarios.luaScénarios
data/walkingstyles.luaStyles de marche
data/bones.luaOs (bones) auxquels un prop peut être attaché
data/particles.luaEffets de particules
data/screeneffects.luaEffets d’écran
data/sounds.luaSons
data/cars.luaVéhicules, par libellé et modèle
data/peds.luaModèles de ped
data/clothing.luaAnimations jouées lorsqu’un vêtement ou un prop est enfilé

Conservez chaque entrée sous le même format que les autres. Le menu lit ces fichiers à son ouverture ; après modification, redémarrez la ressource.


Neuf fichiers sont fournis dans locales/ :

Config.LocaleLangue
enAnglais
esEspagnol
deAllemand
frFrançais
itItalien
ptPortugais
ruRusse
ch-znChinois
jpJaponais

Le commentaire dans config.lua mentionne également tr et ch ; aucun des deux n’existe. Utilisez les codes ci-dessus.

Le même fichier traduit à la fois les messages en jeu et le menu, il n’y a donc qu’un seul endroit à modifier.

Ajouter une langue :

  1. Copiez locales/en.lua vers un nouveau fichier, par exemple locales/pl.lua.
  2. À l’intérieur, changez Locales['en'] par votre code, et traduisez le texte à droite de chaque ligne. Conservez les clés et les %s.
  3. Ajoutez le fichier à shared_scripts dans fxmanifest.lua, au-dessus de locales/lib.lua.
  4. Définissez Config.Locale sur votre code, faites refresh, puis redémarrez.

Une clé manquante affichera Translation key "…" not found dans la console et la clé elle-même à l’écran.


Deux fichiers ouverts se trouvent dans bridge/. Conservez les noms de fonctions — le reste de la ressource les appelle directement par leur nom.

bridge/server_bridge.lua

FonctionÀ quoi elle sert
(détection)Utilise ESX si es_extended est démarré, sinon QBCore si qb-core est démarré. QBox est reconnu comme qb-core, via sa compatibilité QBCore
Bridge.RegisterUsableItemEnregistre chaque item configuré comme utilisable auprès de votre framework
Bridge.AddItem, Bridge.RemoveItem, Bridge.GetItemCountItems : bundles, ramassages, items requis, Remove on Use
Bridge.GetPlayerJob, Bridge.GetPlayerJobGradeRestriction de job
Bridge.NotifyNotifications côté serveur
Bridge.GetAllItemsListe des items dans le menu : depuis ox_inventory, puis items enregistrés d’ESX, puis shared items de QBCore

bridge/client_bridge.lua

FonctionÀ quoi elle sert
Bridge.NotifyChaque notification. Bascule sur le feed GTA en l’absence de framework
Bridge.AddHealth, Bridge.AddArmorSanté/Armure
Bridge.AddFoodThirstFaim/Soif : esx_status sur ESX ; sur QBCore les événements consumables:server:addHunger et addThirst
Bridge.AddStressStress : esx_status sur ESX ; consumables:server:addStress sur QBCore
Bridge.GetItemCountAlways Attached Prop : décompte d’ox_inventory si actif, sinon données du joueur
Bridge.AddTargetEntityOption de ramassage sur un prop posé, pour ox_target ou qb-target
Bridge.ProgressBarBarres de progression : ox_lib ou intégrée. Un emplacement repéré avec exemple commenté permet d’ajouter une autre ressource

Votre HUD utilise des événements différents pour la faim, la soif ou le stress ? Modifiez-les dans Bridge.AddFoodThirst et Bridge.AddStress. Une autre ressource de notification ? Remplacez le corps de Bridge.Notify. Un autre framework ou inventaire ? Remplissez ces mêmes fonctions pour celui-ci dans les deux fichiers.


Network dans le menu liste les configurations d’items partagées par d’autres serveurs. Import vous demande lequel de vos propres items doit recevoir cette configuration, puis vous l’ouvre pour ajustement et sauvegarde. Pour partager l’une des vôtres, exportez-la depuis votre liste d’items avec un nom public, une description et un nom d’auteur — elle devient visible pour chaque serveur utilisant le réseau.

La liste est téléchargée depuis GitHub ; votre serveur doit donc disposer d’un accès internet sortant pour l’alimenter.