Installation

Environ cinq minutes, et un redémarrage complet du serveur à la fin. L’erreur la plus fréquente concerne l’ordre des lignes dans server.cfg — lisez l’étape 3 deux fois.

Avant de commencer

Vous avez besoin de	Pourquoi
oxmysql, démarré	Les designs, items et tenues sont stockés dans la base de données
ox_lib	Les callbacks et les notifications de l’atelier
ESX, QBCore ou QBox (optionnel)	Uniquement pour les items portables. Sans aucun d’eux, l’atelier fonctionne en standalone
ox_inventory (optionnel)	Privilégié pour les items lorsqu’il est actif
Une clé d’API Gemini (optionnel)	Uniquement pour le générateur IA — gratuit sur aistudio.google.com/apikey
Un token Fivemanage (optionnel)	Héberge les photos des designs et des items — gratuit sur fivemanage.com

1. Mettez les deux dossiers en place

Le package contient deux ressources. Déposez les deux côte à côte dans votre dossier resources — par exemple dans resources/[mic]/mic_cloth_designer et resources/[mic]/mic_cloth_addons.

2. La base de données — rien à faire

Les tables sont créées automatiquement au premier démarrage : mic_cloth_designs et mic_cloth_imported pour les designs, mic_cloth_items pour les items et tenues.

mic_cloth_designs.sql est fourni à la racine de mic_cloth_designer pour quiconque souhaite créer les deux premières tables à la main. Vous n’en avez pas besoin.

3. server.cfg — l’ordre est primordial

Deux blocs de lignes distincts, à deux endroits.

Vers le haut de server.cfg, au-dessus de tout ensure :

accordez à la ressource mic_cloth_designer les ACEs command.refresh, command.ensure, command.start et command.stop (quatre lignes add_ace resource.mic_cloth_designer … allow) — l’atelier redémarre lui-même mic_cloth_addons après l’exportation d’un vêtement ;
ajoutez la permission de système de fichiers autorisant mic_cloth_designer à écrire dans mic_cloth_addons (add_filesystem_permission mic_cloth_designer write mic_cloth_addons) ;
donnez l’ACE mic_clothdesigner aux personnes autorisées à utiliser l’atelier — par exemple à group.admin, ou à un identifier.discord:… précis.

Plus bas, avec vos autres ressources : ensure oxmysql, puis ox_lib, puis mic_cloth_addons, puis mic_cloth_designer. Un ensure [mic] englobant les deux fonctionne également, tant qu’il arrive après le bloc de permissions ci-dessus.

Vous souhaitez seulement tester ? Définissez Config.OpenPermission = false dans shared/config.lua et tout le monde pourra ouvrir l’atelier — la permission d’écriture reste toutefois indispensable.

4. Vos clés d’API

Ouvrez mic_cloth_designer/shared/keys.lua. Il s’agit d’un fichier exclusivement serveur : aucun de ses éléments n’est jamais transmis à un joueur. Renseignez ce que vous utilisez et laissez les autres sous forme de guillemets vides.

Clé	Ce qu’elle fait	Nécessaire
`GeminiAPIKey`	Générateur de textures par IA	Uniquement pour l’IA. Vide = l’outil d’IA est désactivé
`FivemanageToken`	Héberge les photos des designs et des items	Recommandé. Vide = photos stockées dans la base de données
`DiscordWebhook`	Enregistre chaque génération IA avec son coût estimé	Optionnel
`ClothNetworkKey`	Laissez vide. Le Cloth Network fonctionne sans clé	Non

5. Items

Un seul item générique prend en charge tous les designs : cloth_design (le nom correspond à Config.Items.Name dans shared/config.lua).

Item	Ce qu’il fait
`cloth_design`	Équipe le design associé ; réutilisez-le pour remettre les vêtements que vous portiez

Les définitions sont livrées dans mic_cloth_designer/items/ :

Fichier	Pour
`items/ox.lua`	ox_inventory — va dans `ox_inventory/data/items.lua`
`items/qb.lua`	QBCore — va dans `qb-core/shared/items.lua`

Aucune image n’est fournie : sur ox_inventory, chaque item affiche le rendu propre à son design. Sur QBCore, placez un fichier cloth_design.png dans qb-inventory/html/images/ si vous souhaitez une icône par défaut. Sur ESX sans ox_inventory, ajoutez un item nommé cloth_design à vos items habituels.

Les designs vendus en magasin recevront leur propre nom d’item plus tard — voir 🎒 Items.

6. Framework

Rien à changer. Le bridge d’items détecte qb-core ou es_extended de lui-même et privilégie ox_inventory lorsqu’il tourne. Définissez Config.Framework dans shared/config.lua sur 'qb' ou 'esx' selon votre configuration.

Sur QBox, le bridge le trouve via sa compatibilité QBCore — qbx_core fournit qb-core — et Config.Framework reste sur 'qb' : QBox exécute les ressources QBCore via sa couche de compatibilité.

Le mode Standalone fonctionne également. Sans framework, l’atelier, l’aperçu 3D, le générateur IA et le Cloth Network tournent normalement ; seule la permission ACE est requise pour y accéder. Laissez Config.Framework sur 'qb'. Les items portables sont la seule fonctionnalité nécessitant ESX, QBCore ou QBox.

7. Redémarrage complet, puis premier design

Redémarrez le serveur entier, pas seulement la ressource : GTA charge les métadonnées de vêtements au démarrage du serveur.

En jeu, tapez /clothdesigner.
Choisissez un vêtement dans la Library, peignez un motif et cliquez sur Save.

Cela a fonctionné quand l’atelier s’ouvre avec la Library, l’aperçu 3D et l’éditeur côte à côte, que Save répond Saved, et que votre personnage porte le vêtement orné de votre création.

Pour le réenfiler plus tard, transformez-le en item — voir 🎒 Items.

Avant d’ouvrir votre ville

Désactivez Config.Debug dans shared/config.lua. Il est activé par défaut et affiche chaque étape dans la console.
Faites votre choix pour Config.GlobalContent. Activé (par défaut), tous les créateurs autorisés voient et éditent l’ensemble des designs, items et tenues.
Gardez shared/keys.lua confidentiel. Il contient votre clé Gemini, votre token Fivemanage et votre webhook. Videz-le avant de partager vos fichiers.
Vérifiez qui détient l’ACE mic_clothdesigner. Lorsqu’une clé Gemini est configurée, chaque génération IA vous est facturée.