Aller au contenu

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.


FichierCe qu’il gèreModifiable
config.luaFramework, langue, qui peut peindre, items, noms des commandes, marqueurs d’atelierOui
locales/*.luaChaque notification et suggestion de chat, un fichier par langueOui
locales/main.luaLa fonction qui sélectionne les textes selon Config.LocaleOui
bridge/server.luaDétection du framework, notifications, vérification admin, métiers, items utilisables, retrait d’itemsOui
bridge/client.luaDétection du framework et notifications côté joueurOui
items/ox.lua, items/qb.lua, items/sql.sqlDéfinitions d’items prêtes à copier dans votre inventaireOui
permissions.jsonLes Steam ID autorisés à ouvrir le menu. Rempli par les commandes give et removeOui
vehicle_original_colors.jsonCouleur d’origine de chaque véhicule avant sa première peinture, par modèle et plaqueOui
html/ui.html, html/style.css, html/script.jsLe menu : son titre, ses échantillons et son apparence—
data/, stream/Définitions des peintures et textures de rampe pour les couleurs 223 à 242Laisser tel quel
client/main.lua, server/main.luaLa logiqueSous escrow

OptionCe qu’elle faitValeur 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.LocaleLangue de tous les messages. Voir Langues ci-dessous"es"
Config.PermissionFileNom du fichier JSON stockant la liste des permissions"permissions.json"

OptionCe qu’elle faitValeur par défaut
Config.PermissionsUtiliser la liste de permissions dans permissions.jsontrue
Config.UseJobsPermettre également aux métiers de Config.AuthorizedJobs d’ouvrir le menutrue
Config.AuthorizedJobsNoms des métiers autorisés quand UseJobs est activémechanic, police

Les deux options se combinent ainsi :

PermissionsUseJobsQui 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.


OptionCe qu’elle faitValeur par défaut
Config.UseItemsEnregistrer les 82 items de peinture et l’item reset comme utilisablestrue
Config.ItemsRequirePermissionSoumettre les items de peinture aux mêmes règles que le menu. Désactivé, quiconque en possède un peut l’utiliserfalse

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


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

OptionValeur par défautQuiCe qu’elle fait
Config.Chameleon/chameleonQuiconque y est autorisé selon les règles ci-dessusOuvre le menu. Vous devez être dans un véhicule
Config.ChameleonReset/chameleonresetTout le mondeRestaure la couleur d’origine du véhicule dans lequel vous êtes
Config.ChameleonGive/chameleongive [ID]AdministrateursAjoute le Steam ID de ce joueur à la liste des permissions
Config.ChameleonRemove/chameleonremove [ID]AdministrateursLe 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.


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

ChampCe qu’il faitValeur d’origine
coordsEmplacement du marqueurDeux emplacements d’exemple près de Burton
radiusDistance en mètres nécessaire pour voir l’invite3.0
markerTypeLe marqueur FiveM dessiné1 (un cercle au sol)
markerColorRouge, vert, bleu et opacité (alpha)Rouge pour l’un, vert pour l’autre, alpha 100
markerScaleSa taille2.0 × 2.0 × 1.0
notificationLe texte d’aide affiché dans le rayonPress ~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 :

  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.


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

FichierCe qu’il fait
bridge/server.luaDé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.luaDé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.