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.

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

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

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

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

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

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

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

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

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

---

Langues

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 :

1. Copiez locales/en.lua vers locales/<code>.lua et remplacez Locales['en'] par votre code.
2. Traduisez uniquement les valeurs, jamais les clés, et conservez chaque %s.
3. Ajoutez le fichier à shared_scripts dans fxmanifest.lua avant locales/locale.lua — le chargeur doit impérativement s’exécuter après toutes les langues. Faites ensuite refresh.
4. 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

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