Personnalisation
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
Section intitulée « 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 |
| 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
Section intitulée « 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 |
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.
| 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
Section intitulée « 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
Section intitulée « 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.
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.
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 :
- Copiez
locales/en.luavers un nouveau fichier, par exemplelocales/nl.lua. - Modifiez le code de langue en haut du nouveau fichier en
nlet traduisez les textes. - Ajoutez
locales/nl.luaaux deux listes,client_scriptsetserver_scripts, dansfxmanifest.lua, à côté des autres fichiers de langue. - Réglez
Config.Locale = "nl", puis faitesrefreshet 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
Section intitulée « 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.