Personnalisation

Note

💬 Besoin d’aide ? Le support, les mises à jour et les changelogs sont sur le Discord de Mic Scripts. Ouvrez un ticket avec votre ID de transaction Tebex et l’erreur console.

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

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

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

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

Note

FiveM n’applique la valeur par défaut d’une assignation de touche que la première fois qu’un joueur la rencontre. Modifier Config.CancelKey plus tard ne changera pas la touche des joueurs qui l’ont déjà enregistrée — ils doivent la modifier eux-mêmes dans Paramètres › Configuration des touches › FiveM.

---

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.

---

Langues

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 :

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.

---

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

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.