Solución de problemas

Los problemas con los que la gente se encuentra de verdad, más o menos en el orden en que aparecen.

Un cambio en el recurso no ha hecho nada

restart no vuelve a leer fxmanifest.lua. Si has añadido un archivo — un idioma nuevo, por ejemplo — escribe primero refresh en la consola y luego reinicia. Y todo lo que tenga que ver con prendas necesita un reinicio completo del servidor, no un reinicio del recurso: GTA solo registra la ropa cuando arranca el servidor.

`/clothdesigner` dice que no tengo permiso

Te falta el ACE indicado en Config.OpenPermission (mic_clothdesigner). Concédelo en server.cfg a tu grupo o a tu identificador. Para descartar el permiso mientras pruebas, pon Config.OpenPermission = false.

“mic_cloth_addons no accesible aún” en la consola

El estudio no puede escribir en mic_cloth_addons. Una de estas:

falta el permiso de escritura en el sistema de archivos de mic_cloth_designer a mic_cloth_addons;
está, pero debajo de las líneas ensure — tiene que ir antes de que arranquen los recursos;
mic_cloth_addons no está arrancado, o arranca después del diseñador;
se ha renombrado una carpeta, o se ha cambiado la línea author en uno de los dos archivos fxmanifest.lua.

Arréglalo y luego reinicia el servidor entero. Consulta el paso 3 de 🪛 Instalación.

El estudio se abre pero la Library está vacía, o las miniaturas nunca cargan

Casi siempre por la misma causa que arriba: mic_cloth_addons no está en marcha, o el diseñador no puede leerlo. Comprueba que arranca antes que mic_cloth_designer. La primera vez que se abre la Library, las miniaturas se renderizan y se guardan en caché en html/previews/, así que la primera carga es más lenta que las demás.

He pulsado Replace y mi personaje sigue mostrando el diseño antiguo

Es lo esperado. El juego guarda en caché en tu cliente la textura de la prenda que llevas puesta; un Replace se ve después de reconectar. Save (una textura nueva) se ve al momento.

“Slot limit reached for this garment”

Cada prenda tiene un número limitado de ranuras de textura. Reinicia el recurso para que pueda compactarlas, borra diseños que ya no necesites o diseña sobre otra prenda.

Una prenda importada no está en la Library

Necesita un reinicio del servidor después de importarla — a veces dos: el primer arranque la importa, y el siguiente la registra.
Su nombre de archivo debe empezar por un prefijo de componente (jbib, lowr, feet, …) y estar en import/male/ o import/female/, salvo que el nombre ya empiece por mp_m_ o mp_f_.
Ejecuta importaddons en la consola del servidor: las líneas que empiezan por ! son prendas que ha rechazado, con el motivo.

Una prenda importada es invisible, o hace crashear el juego

Casi siempre es la variante equivocada: _r para la mayoría de los pantalones, _u para casi todo lo demás. Cámbiala e impórtala de nuevo. Una prenda demasiado pesada — más de 6 MB descomprimida o con una textura incrustada de más de unos 3 MB — se rechaza al importar justo por esto. Si ya hay una cargándose por streaming y haciendo crashear a los clientes, quítala de mic_cloth_addons/stream/.

La IA no genera nada

El estudio te dice el motivo; la consola del servidor muestra la respuesta del propio proveedor junto a un código:

Código	Qué significa
`AI_NO_KEY`	No hay `GeminiAPIKey` en `shared/keys.lua`, o la clave ha sido rechazada
`AI_DISABLED`	`Config.AI.Enabled` está desactivado en `shared/keys.lua`
`AI_QUOTA`	Tu cuenta de Google AI se ha quedado sin cuota o necesita facturación
`AI_RATELIMIT`	Demasiadas peticiones — espera unos segundos
`AI_BUSY`	Ya tienes una generación en marcha
`AI_EMPTY_PROMPT`	No se ha escrito nada
`AI_BAD_RESPONSE`, `AI_PROVIDER_FAILED`	El proveedor ha respondido algo inservible; la línea de la consola dice qué

Si el resultado deja zonas blancas, Fill white gaps las pinta con el color principal del diseño.

Faltan fotos, o la base de datos crece muy rápido

Sin un FivemanageToken en shared/keys.lua, cada foto de diseño se guarda dentro de la base de datos, y los ítems de ox_inventory no pueden mostrar su diseño como imagen. Añade un token de Fivemanage.

Usar el ítem no hace nada

¿Está cloth_design en el archivo de ítems de tu inventario, con el mismo nombre que Config.Items.Name?
¿El servidor funciona con ESX, QBCore o QBox? Los ítems se registran a través del framework; sin uno no hay soporte de ítems. En QBox, qbx_core debe arrancar antes que mic_cloth_designer para que el bridge lo encuentre a través de su compatibilidad con QBCore.
Para un ítem de tienda: ¿pulsaste Save name, y el nombre de tu archivo de ítems coincide exactamente?
¿Reiniciaste el inventario después de añadir el ítem?

Un diseño puesto desaparece al reconectar

Es lo esperado. Ponerse un ítem dura lo que dura la sesión; no se escribe en la apariencia guardada del personaje. Vuelve a usar el ítem.

Un diseño descargado de la red no se aplica

Los diseños que necesitan un modelo de prenda que tu servidor todavía no tiene descargan primero el modelo. Reinicia el servidor, y luego vuelve a importar el diseño para terminar.

Todo sale en inglés

Config.Locale en shared/config.lua elige el idioma (en, es, fr, de, it, pt, pl, ru, tr, nl, cs). Reinicia después de cambiarlo.

La consola está llena de líneas `[ClothDesigner]`

Config.Debug viene activado. Ponlo en false en shared/config.lua.