Aller au contenu

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.


Tous les chemins sont relatifs à mic_cloth_designer, sauf mention contraire.

EmplacementCe qu’il détermineModifiable
shared/config.luaCommande, touche, permission, langue, bibliothèque partagée ou individuelle, résolution, l’item, debugOui
shared/keys.luaVos clés et tokens, réglages IA, hébergement d’images, liste des composants personnalisables — serveur uniquementOui
locales/*.luaTous les textes de l’atelier et ses notifications ; locales/locale.lua est le chargeurOui
items/ox.lua, items/qb.luaDéfinition de l’item cloth_design pour ox_inventory et QBCoreOui
html/Interface de l’atelier ; html/patterns/ stocke les motifs, html/previews/ les miniatures de vêtements en cacheNon 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 modifierOui
client/, server/, bridge/La logique interne, le générateur de fichiers, les bridgesEscrowed
mic_cloth_addons/import/Dossier de dépôt de vos propres vêtements .yddOui
mic_cloth_addons/stream/, metas/, fxmanifest.luaLes vêtements générés. Réécrits par l’atelier — ne pas modifier manuellementFichiers générés

Les fichiers ouverts correspondent à ceux listés dans escrow_ignore dans fxmanifest.lua.


OptionCe qu’elle faitValeur 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.LocaleLangue de l’atelier et des notifications'en'
Config.CommandCommande qui ouvre l’atelierclothdesigner
Config.KeybindTouche d’ouverture, comme 'F7'. false pour aucune. Les joueurs peuvent la réassigner dans leurs options FiveMfalse
Config.OpenPermissionL’ACE nécessaire pour ouvrir l’atelier. false donne l’accès à tousmic_clothdesigner
Config.GlobalContenttrue : tous les utilisateurs autorisés partagent une seule bibliothèque de designs, items et tenues. false : chaque designer ne voit que les sienstrue
Config.TextureResolutionRé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 adapte512
Config.MaxDesignsPerPlayerPlafond de designs enregistrés. Présent dans le fichier mais non appliqué dans la version actuelle50
Config.Items.EnabledActive ou désactive les items portables, tenues et items de magasintrue
Config.Items.NameNom de l’item générique qui transporte un designcloth_design
Config.Items.LabelConservé pour référence. Chaque item s’affiche avec le nom propre de son designClothing Design
Config.DebugAffiche les détails des opérations de l’atelier dans la console. Activé par défaut — désactivez-le sur un serveur en productiontrue

CléCe qu’elle fait
GeminiAPIKeyActive le générateur par IA. Vide = aucune IA
FivemanageTokenTé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
DiscordWebhookEnvoie un log sur Discord à chaque génération IA avec le prompt et le coût estimé. Vide = désactivé
ClothNetworkKeyLaissez vide. Le partage sur le Cloth Network fonctionne directement sans clé

Préréglé de base. L’option principale à connaître est Model, qui permet d’ajuster le compromis entre coût et qualité.

OptionCe qu’elle faitValeur par défaut
EnabledIA activée ou désactivée, quelle que soit la clé présentetrue
Provider'gemini', ou 'openai' pour DALL·E (la clé renseignée dans GeminiAPIKey est alors utilisée pour OpenAI)'gemini'
Modelgemini-3.1-flash-lite-image est le plus économique, gemini-3.1-flash-image le plus équilibré, gemini-3-pro-image le plus chergemini-3.1-flash-image
GeminiImageSizeTaille d’image de secours. Généralement ignorée : la résolution choisie dans l’éditeur prend le relais512px
ImageSizeTaille de sortie pour OpenAI uniquement1024x1024
AspectRatioLes textures sont carrées1:1
PricingCoût en USD par million de tokens d’entrée et de sortie, utilisé uniquement pour le calcul estimatif dans le webhook Discord0.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.

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.

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.


PermissionEmplacementCe qu’elle permet
L’ACE dans Config.OpenPermission (mic_clothdesigner)server.cfg — à un groupe ou un identifiant uniqueOuvrir 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_designerDébut de server.cfgPermet à l’atelier de recharger mic_cloth_addons après un export
Écriture système de mic_cloth_designer vers mic_cloth_addonsDébut de server.cfgAutorise tout simplement l’enregistrement des vêtements
importaddonsConsole du serveurCommande restreinte : exécutable par la console ou un admin ayant l’ACE nécessaire

CommandeQuiCe qu’elle fait
/clothdesignerJoueurs avec l’ACEOuvre l’atelier. Le nom correspond à Config.Command
importaddonsConsole du serveurConvertit 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 :

  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.


Les deux fichiers de bridge sont escrowed ; voici leur fonctionnement détaillé :

FichierRôle
bridge/server_bridge.luaDé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.luaNotifications. À 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é.