Dépannage

Les problèmes fréquemment rencontrés, plus ou moins dans l’ordre où ils surviennent.

Une modification apportée à la ressource n’a rien changé

restart ne relit pas fxmanifest.lua. Si vous avez ajouté un fichier — une nouvelle langue, par exemple — tapez d’abord refresh dans la console, puis redémarrez. De plus, tout ce qui concerne les vêtements exige un redémarrage complet du serveur, et non un simple redémarrage de ressource : GTA n’enregistre les pièces vestimentaires qu’au démarrage du serveur.

`/clothdesigner` indique que je n’ai pas la permission

Il vous manque l’ACE spécifié dans Config.OpenPermission (mic_clothdesigner). Accordez-le dans server.cfg à votre groupe ou à votre identifiant. Pour écarter tout souci de permission lors des tests, définissez Config.OpenPermission = false.

“mic_cloth_addons no accesible aún” dans la console

L’atelier ne parvient pas à écrire dans mic_cloth_addons. Causes possibles :

la permission d’écriture sur le système de fichiers de mic_cloth_designer vers mic_cloth_addons est absente ;
elle est présente, mais positionnée en dessous des lignes ensure — elle doit impérativement précéder le démarrage des ressources ;
mic_cloth_addons n’est pas démarré, ou démarre après l’atelier ;
un dossier a été renommé, ou la ligne author a été modifiée dans l’un des deux fichiers fxmanifest.lua.

Corrigez le problème, puis redémarrez l’intégralité du serveur. Voir l’étape 3 de 🪛 Installation.

L’atelier s’ouvre mais la Library est vide, ou les miniatures ne chargent pas

La cause est la même dans la grande majorité des cas : mic_cloth_addons n’est pas actif, ou l’atelier ne peut pas y accéder. Vérifiez qu’il démarre bien avant mic_cloth_designer. Lors de la toute première ouverture de la Library, les miniatures sont générées puis mises en cache dans html/previews/, le premier chargement est donc naturellement plus long.

J’ai cliqué sur Replace et mon personnage affiche toujours l’ancien design

Comportement normal. Le jeu conserve la texture du vêtement porté en cache mémoire client ; une modification via Replace s’affiche après une reconnexion. Le bouton Save (nouvelle texture) s’applique immédiatement.

“Slot limit reached for this garment”

Chaque vêtement possède un nombre limité d’emplacements de texture. Redémarrez la ressource pour lui permettre de compacter les emplacements disponibles, supprimez les créations devenues inutiles ou travaillez sur un autre modèle.

Un vêtement importé n’apparaît pas dans la Library

Un redémarrage du serveur est nécessaire après l’importation — parfois deux : le premier démarrage traite l’import, et le suivant finalise l’enregistrement GTA.
Le nom du fichier doit débuter par un préfixe de composant valide (jbib, lowr, feet, …) et résider dans import/male/ ou import/female/, sauf si le nom commence déjà par mp_m_ ou mp_f_.
Exécutez importaddons dans la console du serveur : les lignes commençant par ! signalent les fichiers refusés avec le motif précis.

Un vêtement importé est invisible, ou fait crasher le jeu

Il s’agit presque toujours d’une mauvaise variante : _r pour la plupart des pantalons, _u pour presque tout le reste. Inversez le suffixe et relancez l’import. Un vêtement excessivement lourd — plus de 6 Mo décompressé ou une texture intégrée dépassant 3 Mo — est refusé lors de l’import pour cette raison exacte. Si un tel fichier est déjà streamé et cause des crashs, retirez-le de mic_cloth_addons/stream/.

L’IA ne génère aucune texture

L’atelier précise la raison dans l’interface ; la console serveur affiche le retour du fournisseur accompagné d’un code :

Code	Signification
`AI_NO_KEY`	Aucune `GeminiAPIKey` dans `shared/keys.lua`, ou clé rejetée
`AI_DISABLED`	`Config.AI.Enabled` est désactivé dans `shared/keys.lua`
`AI_QUOTA`	Votre compte Google AI a épuisé son quota ou nécessite une facturation
`AI_RATELIMIT`	Trop de requêtes simultanées — patientez quelques secondes
`AI_BUSY`	Une génération est déjà en cours d’exécution
`AI_EMPTY_PROMPT`	Aucun texte n’a été saisi
`AI_BAD_RESPONSE`, `AI_PROVIDER_FAILED`	Le fournisseur a renvoyé une réponse invalide ; la console en donne le détail

Si le résultat laisse des zones blanches, l’outil Fill white gaps les comble avec la teinte dominante du design.

Des images sont manquantes, ou la base de données grossit rapidement

Sans FivemanageToken dans shared/keys.lua, chaque rendu photo est enregistré directement dans la base de données, et les items ox_inventory ne peuvent pas afficher leur design sous forme d’icône. Ajoutez un token Fivemanage.

L’utilisation de l’item ne produit rien

cloth_design est-il bien renseigné dans votre fichier d’items, avec le même nom que Config.Items.Name ?
Le serveur fonctionne-t-il bien avec ESX, QBCore ou QBox ? Les items s’enregistrent via le framework ; sans framework, les items ne sont pas gérés. Sur QBox, qbx_core doit impérativement démarrer avant mic_cloth_designer.
Pour un item de magasin : avez-vous bien cliqué sur Save name, et le nom dans votre fichier d’items correspond-il exactement ?
Avez-vous redémarré votre inventaire après l’ajout de l’item ?

Un design porté disparaît après une reconnexion

Comportement attendu. Porter un vêtement via un item dure le temps de la session ; ce changement n’est pas inscrit de façon permanente dans les données d’apparence du personnage. Utilisez l’item à nouveau.

Un design téléchargé depuis le réseau ne s’applique pas

Les designs dépendant d’un modèle 3D absent de votre serveur téléchargent d’abord le modèle. Redémarrez le serveur, puis importez le design une seconde fois pour finaliser.

Tout s’affiche en anglais

Config.Locale dans shared/config.lua sélectionne la langue (en, es, fr, de, it, pt, pl, ru, tr, nl, cs). Redémarrez après modification.

La console est saturée de lignes `[ClothDesigner]`

Config.Debug est activé par défaut. Définissez-le sur false dans shared/config.lua.