Lo que falla con más frecuencia, qué significa realmente y qué hacer al respecto. La mayoría de los problemas imprimen una línea roja CLOTHING ERROR en la consola del servidor que ya indica la solución — léela primero.
Instalación y acceso#
"server.cfg is missing required permissions"
El bloque rojo se repite en la consola cada diez segundos, y los administradores que abren el estudio reciben el mismo aviso con las líneas en F8. Toda publicación se rechaza hasta que se arregle. Añade las cinco líneas encima de la línea que hace ensure de qs-clothing-designer:
add_ace resource.qs-clothing-designer command.ensure allow
add_ace resource.qs-clothing-designer command.start allow
add_ace resource.qs-clothing-designer command.stop allow
add_ace resource.qs-clothing-designer command.restart allow
add_ace resource.qs-clothing-designer command.refresh allowPegarlas en la consola en vivo funciona al instante; el bloque se detiene y la consola confirma que se encontraron los permisos.
El comando no hace nada, o dice "You do not have permission to do that"
El jugador no es administrador de Clothing Creator: un grupo de ESX listado en Config.AdminGroups, god / admin en QBCore y Qbox, o el ace command en standalone — consulta Reclamar acceso de administrador.
Si el comando ni siquiera se reconoce, se renombró o se vació en Settings → Commands. La consola imprime el nombre actual en cada arranque (admin command: /…), o indica que el comando de administración está desactivado. El export OpenStudio sigue funcionando en cualquier caso.
"Database never became ready"
Clothing Creator esperó 30 segundos a sus tablas y se rindió. oxmysql no se inicia antes que él, o mysql_connection_string es incorrecto. Corrige el orden en server.cfg y reinicia.
selfcheck dotnet: "C# service not answering"
El pipeline de assets es un módulo de C# que se ejecuta en el runtime Mono de FXServer. Actualiza el artifact de tu servidor a uno reciente y asegúrate de que server/dotnet/QsClothingCreator.Server.net.dll esté presente — una subida incompleta o un antivirus pueden eliminarlo. No se puede construir nada hasta que pase esta comprobación.
"The clothing templates on this server are encrypted" o "damaged"
Los archivos de plantillas de qs-clothing-designer/templates no llegaron intactos. Descarga de nuevo el recurso desde el CFX Portal y reemplaza la carpeta; si subes por FTP, usa el modo binario. Tus datos en qs-clothing-data se conservan.
El estudio es una página en blanco
La interfaz viene ya compilada en web/build. Si la autocomprobación informa web/build/index.html missing, la subida estaba incompleta — reinstala el recurso.
"The studio only works on freemode peds"
Tu personaje no es mp_m_freemode_01 ni mp_f_freemode_01. Cambia a un personaje freemode antes de diseñar.
Publicación#
"qs-clothing-meta is not running and cannot be started while players are online"
Alguien detuvo o reinició qs-clothing-meta a mano con jugadores conectados. Volver a iniciarlo con una partida en curso hace crashear a los clientes, así que la publicación se pausa. Reinicia el servidor una vez y se resuelve. Nunca reinicies ese recurso a mano — Clothing Creator lo hace en momentos seguros.
La prenda se publicó pero está "waiting for a server restart"
Fue a una ranura nueva, una colección nueva o una reserva agotada, y elegiste no aplicar la declaración en vivo. Se activa sola cuando el servidor se vacía o se reinicia. Para hacerlo ahora, usa Admin → Apply now (no restart) o escribe qsc-apply en la consola. Un valor mayor de Reserved cells per slot hace que esto pase menos.
"Your game still held a freemode model after the refresh" o "Someone joined during the publish"
La nueva declaración se retuvo para proteger los juegos de los jugadores. O bien un script en el propio juego del administrador mantiene vivo un ped freemode (una vista previa de personaje, un menú de peds, un maniquí), o bien un jugador entró después de que confirmaras y nunca fue avisado. La prenda espera a un reinicio o a que el servidor quede vacío; Apply now lo intenta de nuevo.
"qs-clothing-assets refused to stop" o "failed to start"
El ciclo agotó el tiempo esperando al recurso de drawables. En un host lento u ocupado, aumenta Settings → Publishing → Restart timeout. Si no, busca en la consola del servidor un error del propio qs-clothing-assets y comprueba que las líneas add_ace estén en su sitio. La prenda se marca como fallida y nada más cambia.
"Every collection for this slot is full"
Una ranura admite 128 prendas por colección, y las colecciones de desbordamiento llegan hasta ocho por género. Retira las prendas que nadie usa: con Reuse retired slots activado, la siguiente publicación ocupa sus celdas.
"This slot would exceed 255 total texture slots in the collection"
Todas las variaciones de todas las prendas de una ranura de una colección comparten un presupuesto de 255 — un límite del propio juego. Publica con menos variaciones, o retira prendas que tengan muchas.
Prendas en "Needs re-publishing"
Sus archivos de textura ya no están en qs-clothing-data/items — normalmente porque la carpeta de datos se borró o se reemplazó durante una actualización. Esas celdas se envían vacías para que el resto de la colección siga publicándose. Abre cada diseño desde Saved Designs y vuelve a publicarlo; vuelve a la misma celda.
"The build timed out" o "The C# asset service is not running"
El servicio de build no responde. Lee la consola desde el arranque del recurso: la línea de autocomprobación dotnet indica por qué. Reiniciar qs-clothing-designer es seguro en cualquier momento.
"A publish is already restarting the assets resource"
La publicación de otro administrador está a mitad de ciclo. Espera unos segundos y pulsa Publish de nuevo.
Jugadores y uso de la ropa#
"This item is not in your game yet"
El juego del jugador no tiene la colección de la prenda: espera a un reinicio, o se aplicó después de que el jugador entrara y no la recibió. Reconectarse soluciona el segundo caso. qsc-collections en F8 muestra lo que realmente tiene el juego del jugador — si no aparece ninguna colección qsc_, nunca se montó.
"Reconnect now — the next clothing update could crash your game"
Las declaraciones de ropa cambiaron mientras este jugador estaba en el juego y su juego no pudo recibir el cambio. Debe reconectarse antes de la siguiente publicación.
Algunos jugadores siguen viendo el diseño antiguo
No pulsaron la tecla de actualización antes de que se agotara Flush prompt timeout, así que la publicación continuó sin ellos. Ejecuta qsc-flush para dar a todos otro aviso, o pídeles que se reconecten.
Pulsar la tecla de actualización no hace nada
La tecla solo se acepta cuando la ropa del jugador ha terminado de cargar — mientras tanto ve Your clothes are still loading — press again in a second. Si el jugador reasignó la tecla, la tarjeta muestra la predeterminada; la que funciona es su propia asignación de Refresh clothing streaming cache en las teclas de FiveM.
Opciones vacías en el menú de ropa
Es lo esperado. Las celdas reservadas — declaradas antes de usarse para que las prendas nuevas se activen sin reiniciar — y las prendas retiradas se muestran como opciones vacías. Pon Reserved cells per slot en 0 para dejar de reservar, a cambio de que más publicaciones esperen un reinicio.
"Variation B is not in the game yet"
Se añadieron variaciones a una prenda que ya estaba activa. El juego conoce el nuevo número en el siguiente arranque del servidor (o con el servidor vacío); hasta entonces se usa la variación A.
"This item was built for the other gender"
Las prendas masculinas y femeninas están en colecciones separadas. Cambia de ped, o vuelve a diseñar la pieza en el otro género.
Imágenes y ropa addon#
Se rechaza un enlace de imagen
Mensaje | Solución |
|---|---|
Remote image import is disabled | Activa Settings → Images → Allow image URLs, o sube el archivo. |
That host is not on the allow-list | Añade el host a |
URLs pointing at private networks are blocked | Aloja la imagen de forma pública — los enlaces a localhost o a tu LAN se rechazan a propósito. |
The image is larger than the configured limit | Redúcela, o aumenta Maximum image size. |
The URL did not return an image | Usa el enlace directo al archivo (normalmente termina en .png o .jpg), no la página donde se muestra. |
Los drawables addon están "Locked by Asset Escrow"
El pack está cifrado, y solo el juego del propietario de la licencia puede abrirlo — el servidor no tiene la clave. Estos drawables no pueden convertirse en plantillas. Pide al vendedor una versión abierta (sin escrow).
"Damaged file", "File missing" o "Match-previous drawable, not supported"
El drawable del pack está incompleto o es ilegible, o es un drawable _m de tipo match-previous, que no se puede importar. Vuelve a subir el pack en modo binario, o sáltate esos drawables.
"Imported, but hidden: the … slot is switched off"
Desactivaste esa ranura tú mismo en Settings → Slots, así que la importación no la volvió a activar. Activa la ranura y aparecerán las plantillas.
No se puede quitar una plantilla importada
Hay prendas publicadas construidas sobre ella, y quitarla las dejaría sin base. Retira primero esas prendas.
Claves de error#
Los callbacks y exports devuelven códigos cortos; el texto que leen jugadores y administradores es la clave errors.<code> de los archivos de idioma. Las que más verás:
Clave | Significa |
|---|---|
| El jugador no es administrador. |
| Faltan las líneas add_ace en server.cfg. |
| La publicación está en pausa hasta que el servidor se reinicie una vez. |
| Una fila de la comprobación previa está en rojo: nombre, variaciones o capacidad. |
| Hay otros jugadores conectados: una declaración en vivo necesita confirmación. |
| Se pulsó Apply now sin nada pendiente. |
| Se alcanzó el límite de diseños guardados por jugador — borra uno, o aumenta el ajuste. |
| La plantilla del diseño ya no está instalada. |
| Ya hay una importación de addon en curso. |
¿Sigues con problemas? Abre un ticket e incluye las líneas rojas
CLOTHING ERRORde la consola del servidor, la salida deqsc-collectionsdel F8 del jugador afectado, tu framework y tu script de apariencia, y el artifact de tu servidor y la build del juego.