Personnalisation
Deux fichiers regroupent l’intégralité de vos réglages, et leur séparation répond à une règle simple : cela poserait-il problème si un joueur pouvait le lire ? shared/config.lua est envoyé à chaque client. shared/keys.lua est chargé exclusivement côté serveur et ne quitte jamais la machine hôte.
Quel fichier gère quoi
Section intitulée « Quel fichier gère quoi »Tous les chemins sont relatifs à mic_cloth_designer, sauf mention contraire.
| Emplacement | Ce qu’il détermine | Modifiable |
|---|---|---|
shared/config.lua | Commande, touche, permission, langue, bibliothèque partagée ou individuelle, résolution, l’item, debug | Oui |
shared/keys.lua | Vos clés et tokens, réglages IA, hébergement d’images, liste des composants personnalisables — serveur uniquement | Oui |
locales/*.lua | Tous les textes de l’atelier et ses notifications ; locales/locale.lua est le chargeur | Oui |
items/ox.lua, items/qb.lua | Définition de l’item cloth_design pour ox_inventory et QBCore | Oui |
html/ | Interface de l’atelier ; html/patterns/ stocke les motifs, html/previews/ les miniatures de vêtements en cache | Non escrowed, mais scripts livrés obfusqués |
base/addon_templates/ | Modèles utilisés par l’atelier pour bâtir de nouveaux vêtements. Ne pas modifier | Oui |
client/, server/, bridge/ | La logique interne, le générateur de fichiers, les bridges | Escrowed |
mic_cloth_addons/import/ | Dossier de dépôt de vos propres vêtements .ydd | Oui |
mic_cloth_addons/stream/, metas/, fxmanifest.lua | Les vêtements générés. Réécrits par l’atelier — ne pas modifier manuellement | Fichiers générés |
Les fichiers ouverts correspondent à ceux listés dans escrow_ignore dans fxmanifest.lua.
shared/config.lua
Section intitulée « shared/config.lua »| Option | Ce qu’elle fait | Valeur par défaut |
|---|---|---|
Config.Framework | 'esx' ou 'qb'. Réglez-le selon votre serveur ; le bridge d’items détecte également le framework seul. Utilisez 'qb' sur QBCore, sur QBox (via sa compatibilité QBCore) et sur un serveur standalone | 'qb' |
Config.Locale | Langue de l’atelier et des notifications | 'en' |
Config.Command | Commande qui ouvre l’atelier | clothdesigner |
Config.Keybind | Touche d’ouverture, comme 'F7'. false pour aucune. Les joueurs peuvent la réassigner dans leurs options FiveM | false |
Config.OpenPermission | L’ACE nécessaire pour ouvrir l’atelier. false donne l’accès à tous | mic_clothdesigner |
Config.GlobalContent | true : tous les utilisateurs autorisés partagent une seule bibliothèque de designs, items et tenues. false : chaque designer ne voit que les siens | true |
Config.TextureResolution | Résolution de texture par défaut : 256, 512 ou 1024. Le menu déroulant de l’éditeur permet de l’ajuster par design, et l’IA s’y adapte | 512 |
Config.MaxDesignsPerPlayer | Plafond de designs enregistrés. Présent dans le fichier mais non appliqué dans la version actuelle | 50 |
Config.Items.Enabled | Active ou désactive les items portables, tenues et items de magasin | true |
Config.Items.Name | Nom de l’item générique qui transporte un design | cloth_design |
Config.Items.Label | Conservé pour référence. Chaque item s’affiche avec le nom propre de son design | Clothing Design |
Config.Debug | Affiche les détails des opérations de l’atelier dans la console. Activé par défaut — désactivez-le sur un serveur en production | true |
shared/keys.lua
Section intitulée « shared/keys.lua »Vos clés d’API
Section intitulée « Vos clés d’API »| Clé | Ce qu’elle fait |
|---|---|
GeminiAPIKey | Active le générateur par IA. Vide = aucune IA |
FivemanageToken | Téléverse les photos des designs et items sur Fivemanage et ne stocke que l’URL. Vide = photos gardées dans la base de données, qui grossit |
DiscordWebhook | Envoie un log sur Discord à chaque génération IA avec le prompt et le coût estimé. Vide = désactivé |
ClothNetworkKey | Laissez vide. Le partage sur le Cloth Network fonctionne directement sans clé |
Le générateur par IA — Config.AI
Section intitulée « Le générateur par IA — Config.AI »Préréglé de base. L’option principale à connaître est Model, qui permet d’ajuster le compromis entre coût et qualité.
| Option | Ce qu’elle fait | Valeur par défaut |
|---|---|---|
Enabled | IA activée ou désactivée, quelle que soit la clé présente | true |
Provider | 'gemini', ou 'openai' pour DALL·E (la clé renseignée dans GeminiAPIKey est alors utilisée pour OpenAI) | 'gemini' |
Model | gemini-3.1-flash-lite-image est le plus économique, gemini-3.1-flash-image le plus équilibré, gemini-3-pro-image le plus cher | gemini-3.1-flash-image |
GeminiImageSize | Taille d’image de secours. Généralement ignorée : la résolution choisie dans l’éditeur prend le relais | 512px |
ImageSize | Taille de sortie pour OpenAI uniquement | 1024x1024 |
AspectRatio | Les textures sont carrées | 1:1 |
Pricing | Coût en USD par million de tokens d’entrée et de sortie, utilisé uniquement pour le calcul estimatif dans le webhook Discord | 0.50 / 60.00 |
Une seule génération s’exécute à la fois par joueur, avec un court temps d’attente entre chaque requête.
Hébergement d’images — Config.Fivemanage
Section intitulée « Hébergement d’images — Config.Fivemanage »Enabled et le token mentionné plus haut. Les images correspondent au rendu 3D de chaque design, utilisé dans la bibliothèque, sur les items (ox_inventory l’affiche comme icône d’item) et sur les cartes du réseau.
Composants personnalisables — Config.Components
Section intitulée « Composants personnalisables — Config.Components »Les douze emplacements vestimentaires GTA pris en charge par l’atelier — tête, masque, cheveux, bras, jambes, gants, chaussures, accessoires, sacs, gilet, décalcomanies et hauts — chacun avec le préfixe de fichier associé à ses vêtements. Déclaré côté serveur pour empêcher toute altération client. Laissez tel quel.
Permissions
Section intitulée « Permissions »| Permission | Emplacement | Ce qu’elle permet |
|---|---|---|
L’ACE dans Config.OpenPermission (mic_clothdesigner) | server.cfg — à un groupe ou un identifiant unique | Ouvrir l’atelier et exécuter chaque action interne. Contrôlé sur le serveur à chaque fois |
command.refresh, command.ensure, command.start, command.stop pour resource.mic_cloth_designer | Début de server.cfg | Permet à l’atelier de recharger mic_cloth_addons après un export |
Écriture système de mic_cloth_designer vers mic_cloth_addons | Début de server.cfg | Autorise tout simplement l’enregistrement des vêtements |
importaddons | Console du serveur | Commande restreinte : exécutable par la console ou un admin ayant l’ACE nécessaire |
Commandes
Section intitulée « Commandes »| Commande | Qui | Ce qu’elle fait |
|---|---|---|
/clothdesigner | Joueurs avec l’ACE | Ouvre l’atelier. Le nom correspond à Config.Command |
importaddons | Console du serveur | Convertit les fichiers .ydd placés dans mic_cloth_addons/import/ en vêtements personnalisables. Voir 👕 Vêtements |
Onze langues sont disponibles dans locales/ : en, es, fr, de, it, pt, pl, ru, tr, nl, cs. Définissez Config.Locale et redémarrez. Une chaîne manquante dans une langue sera affichée en anglais.
Pour en ajouter une nouvelle :
- Copiez
locales/en.luaverslocales/<code>.luaet remplacezLocales['en']par votre code. - Traduisez uniquement les valeurs, jamais les clés, et conservez chaque
%s. - Ajoutez le fichier à
shared_scriptsdansfxmanifest.luaavantlocales/locale.lua— le chargeur doit impérativement s’exécuter après toutes les langues. Faites ensuiterefresh. - Attribuez le nouveau code à
Config.Locale.
L’interface se traduit en substituant son texte anglais par le vôtre ; les valeurs anglaises d’origine dans en.lua doivent donc rester intactes.
Le bridge
Section intitulée « Le bridge »Les deux fichiers de bridge sont escrowed ; voici leur fonctionnement détaillé :
| Fichier | Rôle |
|---|---|
bridge/server_bridge.lua | Détecte qb-core ou es_extended, enregistre les items utilisables (ESX RegisterUsableItem / QBCore CreateUseableItem, pris en compte par ox_inventory), et délivre les items avec leur design lié — via ox_inventory lorsqu’il tourne, sinon via le framework |
client/bridge.lua | Notifications. À l’intérieur de l’atelier, ce sont ses propres toasts ; en dehors, les notifications ox_lib si disponible, puis ESX ou QBCore, puis le flux GTA de base |
Les joueurs sont identifiés via leur identifiant license:, quel que soit le framework utilisé.