Aller au contenu

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.


Vous avez besoin dePourquoi
oxmysql, démarréLes designs, items et tenues sont stockés dans la base de données
ox_libLes 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

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.


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.


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.


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 faitNécessaire
GeminiAPIKeyGénérateur de textures par IAUniquement pour l’IA. Vide = l’outil d’IA est désactivé
FivemanageTokenHéberge les photos des designs et des itemsRecommandé. Vide = photos stockées dans la base de données
DiscordWebhookEnregistre chaque génération IA avec son coût estiméOptionnel
ClothNetworkKeyLaissez vide. Le Cloth Network fonctionne sans cléNon

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

ItemCe 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/ :

FichierPour
items/ox.luaox_inventory — va dans ox_inventory/data/items.lua
items/qb.luaQBCore — 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.


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.


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

  1. En jeu, tapez /clothdesigner.
  2. 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.


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