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.
Quel fichier décide de quoi
Section intitulée « Quel fichier décide de quoi »| Fichier | Ce qu’il décide | Ouvert ? |
|---|---|---|
config.lua | Langue, commande, touche d’annulation, interaction avec prop posé, chemin d’images, barre de progression | Oui |
bridge/client_bridge.lua | Notifications, santé, armure, stress, faim et soif, décompte d’items, jobs, target, barre de progression | Oui |
bridge/server_bridge.lua | Détection du framework, items utilisables, ajout et retrait d’items, jobs, notifications, liste d’items | Oui |
locales/*.lua | L’ensemble des textes, en jeu et dans le menu | Oui |
data/*.lua | Les listes alimentant les sélecteurs du menu | Oui |
html/ | Le menu (HTML, CSS, JS) | Lisible |
client/, server/ | Logique des items | Sous escrow |
config.lua
Section intitulée « config.lua »| Option | Ce qu’elle fait | Par défaut |
|---|---|---|
Config.Locale | Langue du menu et des messages. Voir Langues | 'en' |
Config.Command | La commande qui ouvre et ferme le menu | 'itemcreator' |
Config.CommandDescription | Le 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.CancelKey | Touche par défaut pour annuler ce qu’un item a déclenché. Voir ci-dessous | 'X' |
Config.Interaction | Faç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.ImageInventoryPath | Emplacement 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/.
Touches et commandes
Section intitulée « Touches et commandes »| Commande | Touche par défaut | Ce qu’elle fait |
|---|---|---|
/itemcreator | aucune | Ouvre ou ferme le menu. Nécessite l’ACE mic_itemcreator.open |
/cancelitemanim | Config.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 :
| Touche | Action |
|---|---|
| ← → ↑ ↓ | Déplacer le prop à gauche, droite, avant, arrière |
| Page Haut / Page Bas | Monter ou descendre |
| Pavé num. 4 / 6 | Lacet (Yaw) |
| Pavé num. 8 / 5 | Tangage (Pitch) |
| Pavé num. 7 / 9 | Roulis (Roll) |
| X | Prévisualiser l’animation |
| E | Confirmer |
| Retour arrière | Annuler |
Les listes de données
Section intitulée « Les listes de données »Tout ce que vous pouvez choisir dans une liste déroulante du menu provient du dossier data/, et vous pouvez en ajouter dans chacune :
| Fichier | Ce qu’il répertorie |
|---|---|
data/animations.lua | Animations |
data/scenarios.lua | Scénarios |
data/walkingstyles.lua | Styles de marche |
data/bones.lua | Os (bones) auxquels un prop peut être attaché |
data/particles.lua | Effets de particules |
data/screeneffects.lua | Effets d’écran |
data/sounds.lua | Sons |
data/cars.lua | Véhicules, par libellé et modèle |
data/peds.lua | Modèles de ped |
data/clothing.lua | Animations 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.Locale | Langue |
|---|---|
en | Anglais |
es | Espagnol |
de | Allemand |
fr | Français |
it | Italien |
pt | Portugais |
ru | Russe |
ch-zn | Chinois |
jp | Japonais |
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 :
- Copiez
locales/en.luavers un nouveau fichier, par exemplelocales/pl.lua. - À l’intérieur, changez
Locales['en']par votre code, et traduisez le texte à droite de chaque ligne. Conservez les clés et les%s. - Ajoutez le fichier à
shared_scriptsdansfxmanifest.lua, au-dessus delocales/lib.lua. - Définissez
Config.Localesur votre code, faitesrefresh, puis redémarrez.
Une clé manquante affichera Translation key "…" not found dans la console et la clé elle-même à l’écran.
Le bridge
Section intitulée « Le bridge »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.RegisterUsableItem | Enregistre chaque item configuré comme utilisable auprès de votre framework |
Bridge.AddItem, Bridge.RemoveItem, Bridge.GetItemCount | Items : bundles, ramassages, items requis, Remove on Use |
Bridge.GetPlayerJob, Bridge.GetPlayerJobGrade | Restriction de job |
Bridge.Notify | Notifications côté serveur |
Bridge.GetAllItems | Liste 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.Notify | Chaque notification. Bascule sur le feed GTA en l’absence de framework |
Bridge.AddHealth, Bridge.AddArmor | Santé/Armure |
Bridge.AddFoodThirst | Faim/Soif : esx_status sur ESX ; sur QBCore les événements consumables:server:addHunger et addThirst |
Bridge.AddStress | Stress : esx_status sur ESX ; consumables:server:addStress sur QBCore |
Bridge.GetItemCount | Always Attached Prop : décompte d’ox_inventory si actif, sinon données du joueur |
Bridge.AddTargetEntity | Option de ramassage sur un prop posé, pour ox_target ou qb-target |
Bridge.ProgressBar | Barres 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.
Réseau communautaire
Section intitulée « Réseau communautaire »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.