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.

La quasi-totalité des réglages se trouve dans config.lua. Le reste concerne les textes, les données et la fine couche qui communique avec votre framework.

---

Quel fichier décide de quoi

Fichier	Ce qu’il gère	Modifiable
config.lua	Framework, langue, qui peut peindre, items, noms des commandes, marqueurs d’atelier	Oui
locales/*.lua	Chaque notification et suggestion de chat, un fichier par langue	Oui
locales/main.lua	La fonction qui sélectionne les textes selon Config.Locale	Oui
bridge/server.lua	Détection du framework, notifications, vérification admin, métiers, items utilisables, retrait d’items	Oui
bridge/client.lua	Détection du framework et notifications côté joueur	Oui
items/ox.lua, items/qb.lua, items/sql.sql	Définitions d’items prêtes à copier dans votre inventaire	Oui
permissions.json	Les Steam ID autorisés à ouvrir le menu. Rempli par les commandes give et remove	Oui
vehicle_original_colors.json	Couleur d’origine de chaque véhicule avant sa première peinture, par modèle et plaque	Oui
html/ui.html, html/style.css, html/script.js	Le menu : son titre, ses échantillons et son apparence	—
data/, stream/	Définitions des peintures et textures de rampe pour les couleurs 223 à 242	Laisser tel quel
client/main.lua, server/main.lua	La logique	Sous escrow

---

Général

Option	Ce qu’elle fait	Valeur par défaut
Config.Framework	"auto", "esx" ou "qbcore". Auto utilise celui qui tourne entre es_extended et qb-core ; QBox compte comme qb-core via sa compatibilité QBCore. Pour le forcer, QBox utilise "qbcore"	"auto"
Config.Locale	Langue de tous les messages. Voir Langues ci-dessous	"es"
Config.PermissionFile	Nom du fichier JSON stockant la liste des permissions	"permissions.json"

---

Qui peut ouvrir le menu

Option	Ce qu’elle fait	Valeur par défaut
Config.Permissions	Utiliser la liste de permissions dans permissions.json	true
Config.UseJobs	Permettre également aux métiers de Config.AuthorizedJobs d’ouvrir le menu	true
Config.AuthorizedJobs	Noms des métiers autorisés quand UseJobs est activé	mechanic, police

Les deux options se combinent ainsi :

Permissions	UseJobs	Qui peut ouvrir le menu
activé	activé	Les joueurs sur la liste et toute personne exerçant un métier dans AuthorizedJobs
activé	désactivé	Uniquement les joueurs sur la liste
désactivé	activé ou désactivé	Tout le monde

Note

Il n’existe pas d’option “métiers uniquement”. Pour réserver le menu aux seuls métiers, laissez les deux réglages activés et gardez la liste de permissions vide.

La liste est indexée par identifiant Steam. Un joueur qui ne lance pas Steam ne peut pas être ajouté ; la commande pour donner la permission indiquera qu’elle n’a pas pu récupérer son identifiant Steam.

---

Items

Option	Ce qu’elle fait	Valeur par défaut
Config.UseItems	Enregistrer les 82 items de peinture et l’item reset comme utilisables	true
Config.ItemsRequirePermission	Soumettre les items de peinture aux mêmes règles que le menu. Désactivé, quiconque en possède un peut l’utiliser	false

L’item reset ne demande jamais de permission. Le nom des items et l’emplacement de leurs définitions se trouvent dans Installation.

---

Commandes

Chaque nom est défini dans config.lua, sans le slash.

Option	Valeur par défaut	Qui	Ce qu’elle fait
Config.Chameleon	/chameleon	Quiconque y est autorisé selon les règles ci-dessus	Ouvre le menu. Vous devez être dans un véhicule
Config.ChameleonReset	/chameleonreset	Tout le monde	Restaure la couleur d’origine du véhicule dans lequel vous êtes
Config.ChameleonGive	/chameleongive [ID]	Administrateurs	Ajoute le Steam ID de ce joueur à la liste des permissions
Config.ChameleonRemove	/chameleonremove [ID]	Administrateurs	Le retire de la liste

“Administrateur” désigne le groupe admin ou superadmin sur ESX, et la permission admin ou god sur QBCore. Ces deux vérifications résident dans bridge/server.lua si vos groupes portent d’autres noms.

---

Marqueurs d’atelier de peinture

Config.Locations est une liste ; ajoutez-y autant d’entrées que vous le souhaitez. Chacune contient :

Champ	Ce qu’il fait	Valeur d’origine
coords	Emplacement du marqueur	Deux emplacements d’exemple près de Burton
radius	Distance en mètres nécessaire pour voir l’invite	3.0
markerType	Le marqueur FiveM dessiné	1 (un cercle au sol)
markerColor	Rouge, vert, bleu et opacité (alpha)	Rouge pour l’un, vert pour l’autre, alpha 100
markerScale	Sa taille	2.0 × 2.0 × 1.0
notification	Le texte d’aide affiché dans le rayon	Press ~INPUT_CONTEXT~ to open the Chameleon menu

Le marqueur est visible dès 10 mètres de distance. L’invite n’apparaît qu’à l’intérieur du rayon radius et à bord d’un véhicule ; E ouvre alors le menu, avec les mêmes vérifications de permissions que la commande.

Le texte de notification se trouve directement dans config.lua, pas dans les fichiers de langue, traduisez-le donc à cet endroit.

---

Le menu

html/ui.html contient les échantillons — un pour chaque ID de couleur de 161 à 242 — ainsi que le titre du menu, “Chameleon Paintings”, qui est écrit en dur dans la page au lieu d’être extrait des locales. html/style.css définit la couleur d’aperçu de chaque échantillon.

---

Langues

Neuf langues sont fournies dans locales/ : en, es, fr, de, it, pt, pl, ru et tr. Définissez Config.Locale sur l’un de ces codes.

Pour en ajouter une :

1. Copiez locales/en.lua vers un nouveau fichier, par exemple locales/nl.lua.
2. Modifiez le code de langue en haut du nouveau fichier en nl et traduisez les textes.
3. Ajoutez locales/nl.lua aux deux listes, client_scripts et server_scripts, dans fxmanifest.lua, à côté des autres fichiers de langue.
4. Réglez Config.Locale = "nl", puis faites refresh et redémarrez la ressource.

Une clé manquante affiche Translation [key] does not exist sans rien faire planter, ce qui permet de repérer facilement une traduction incomplète.

---

Le bridge

Deux fichiers dans bridge/ constituent les seuls points de contact de la ressource avec votre framework.

Fichier	Ce qu’il fait
bridge/server.lua	Détecte le framework, envoie les notifications (esx:showNotification ou QBCore:Notify), détermine qui est admin, lit le métier d’un joueur, enregistre les items utilisables et retire un item après utilisation
bridge/client.lua	Détecte le framework côté joueur et affiche les notifications (ESX.ShowNotification ou QBCore.Functions.Notify)

Si aucun framework n’est détecté, les notifications basculent sur des messages dans le chat.

L’adapter. Pour utiliser votre propre ressource de notifications, modifiez le corps de Bridge.Notify dans les deux fichiers. Pour un système d’administration personnalisé, modifiez Bridge.IsAdmin. Pour un framework autre qu’ESX, QBCore ou QBox, remplissez chaque fonction Bridge. dans bridge/server.lua — détection du framework, Notify, IsAdmin, GetPlayerJob, RegisterUsableItem et RemoveItem — et la ressource n’aura besoin de rien de plus.