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
Section intitulée « 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
Section intitulée « 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
Section intitulée « 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
Section intitulée « 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_designerles ACEscommand.refresh,command.ensure,command.startetcommand.stop(quatre lignesadd_ace resource.mic_cloth_designer … allow) — l’atelier redémarre lui-mêmemic_cloth_addonsaprès l’exportation d’un vêtement ; - ajoutez la permission de système de fichiers autorisant
mic_cloth_designerà écrire dansmic_cloth_addons(add_filesystem_permission mic_cloth_designer write mic_cloth_addons) ; - donnez l’ACE
mic_clothdesigneraux personnes autorisées à utiliser l’atelier — par exemple àgroup.admin, ou à unidentifier.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
Section intitulée « 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
Section intitulée « 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
Section intitulée « 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
Section intitulée « 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
Section intitulée « Avant d’ouvrir votre ville »- Désactivez
Config.Debugdansshared/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.luaconfidentiel. 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.