Lo que falla con más frecuencia, qué significa realmente y qué hacer al respecto. Casi todo esto se resuelve leyendo la consola del servidor desde el principio del arranque: Appearance indica qué cargó, qué creó y qué datos iniciales insertó.
Instalación y acceso#
El recurso da error al iniciarse
Busca esta línea en la consola:
[INFO] Successfully loaded the framework. esxSi no aparece, no se encontró ningún framework y el recurso se detiene: no hay modo standalone. La detección solo ve los recursos que ya están iniciados, así que es_extended, qb-core o qbx_core deben tener ensure antes de qs-appearance en server.cfg. Lo mismo vale para oxmysql y ox_lib.
La interfaz está en blanco o las imágenes no cargan
Se cambió el nombre de la carpeta. Debe ser exactamente qs-appearance: la interfaz carga sus propios gráficos desde nui://qs-appearance/, y cada export y evento usa ese nombre. El recurso lo comprueba al iniciarse y se niega a funcionar con cualquier otro nombre.
Si la ventana se abre pero los cuadros de ropa están vacíos, es otro problema: consulta Faltan las imágenes del catálogo más abajo.
El creador dice que no tengo permiso
La comprobación de administrador es la de tu propio framework, y es estricta en cuanto a cuál:
ESX: el grupo del jugador debe ser exactamente admin o superadmin. Un nombre de grupo personalizado no pasa.
QBCore y Qbox: el permiso god o admin, o el ace command.
Ser dueño del servidor en el sentido propio de FiveM no basta en ESX. Comprueba primero qué framework se detectó realmente: si se cargó el puente equivocado, está comprobando lo que no es.
Los outfits y las skins de todos desaparecieron después de instalarlo
[sql]/main.sql empieza con DROP TABLE para player_outfits, playerskins, clothing_player_outfits, clothing_job_outfits y management_outfits. Importar el archivo completo en un servidor que ya tenía skins u outfits de QBCore los borra.
Restaura tu copia de seguridad y luego importa solo las sentencias CREATE TABLE de las tablas que realmente te faltaban. Este es también el motivo habitual por el que los outfits desaparecen durante una migración desde illenium-appearance, que los guarda en player_outfits.
Tiendas y el menú#
No aparece ningún aviso cuando estoy en una tienda
Tres causas, en el orden en que conviene revisarlas.
Config.UseTarget es true pero no hay ningún recurso de target en ejecución. Inicia ox_target o qb-target, o vuelve a ponerlo en false para usar el aviso de zona.
Hay un recurso de target en el disco pero detenido. La detección lo acepta igualmente como backend y luego descubre que no está en ejecución, lo que deja sin ninguna interacción. Borra la carpeta del target que no uses en lugar de detenerlo.
Activa Config.ZoneDebug para dibujar la zona y confirmar que realmente estás dentro de ella.
Las tiendas de tatuajes no hacen nada
Config.RCoreTattoosCompatibility está activado. Se activa automáticamente cuando se encuentra en ejecución un recurso de tatuajes de terceros al iniciar, y mientras está activado, las zonas, los blips y los targets de tatuajes se suprimen a propósito para que el otro script gestione la función de principio a fin.
Si quieres recuperar las tiendas de tatuajes propias de Appearance, fuerza el valor a false en config/main.lua.
No puedo crear una zona de tienda
Una zona necesita al menos cuatro puntos y un perímetro de al menos Config.MinPointLength, que es 70.0 por defecto; el interior de una boutique pequeña puede quedar por debajo de verdad. Baja el valor o dibuja un contorno más amplio.
Un punto que cae dentro de una tienda existente también se rechaza; las zonas no pueden superponerse. El nombre debe tener entre 4 y 16 caracteres.
Una tienda no vende nada, o todo aparece como Out of stock
Se guardó stock para esa tienda. Se guarda por tienda y por modelo de ped, así que una tienda puede verse llena con un ped y vacía con otro. Entra como administrador, abre Admin → Stock y revisa ese modelo de ped, o borra el stock para recuperar todo el catálogo.
Borré mi tienda pero los jugadores todavía pueden usarla
Las tiendas creadas en el creador viven en la base de datos y se sincronizan en vivo. Si una zona vuelve tras un reinicio, otra cosa la está escribiendo: comprueba que nada siga rellenando Config.Stores a mano. Esa tabla se llena automáticamente en tiempo de ejecución y editarla no tiene efecto.
Ropa, fotos y packs#
Faltan las imágenes del catálogo
Abre la consola F8 en el juego y busca un 404. El catálogo incluido apunta a la CDN de Quasar y no necesita nada de tu parte, así que un 404 en una fila incluida normalmente significa que la fila se editó o se volvió a insertar con una dirección incorrecta.
Para la ropa que fotografiaste tú, la dirección apunta a tu propia cuenta de FiveManage. Un token incorrecto o revocado, o una imagen borrada allí, la rompe, y volver a fotografiar un ítem no elimina la subida anterior.
La captura de fotos se niega a iniciar
Necesita tres cosas a la vez, y la superposición indica la que falta:
Config.ImageSaver.enable en true: si está desactivado, los botones de captura aparecen en gris en todas partes.
screenshot-basic iniciado, o la consola repite un error en bucle.
greenscreen-map iniciado: el estudio al que te teletransporta la captura.
Si la consola muestra cada pocos segundos un error sobre un token vacío, rellena Config.FiveManageToken o desactiva el guardado de imágenes.
La captura se detuvo a mitad y dice que salgas del servidor
Es el límite de 1.000 fotos por conexión, y funciona como se espera. Todo lo capturado hasta ese momento se guarda. Sal del servidor, vuelve a conectarte y ejecuta la misma selección otra vez con Skip already captured photos marcado: continúa donde se detuvo.
El mismo consejo vale para el mensaje de subidas atascadas. Reinicia el recurso una vez que termine toda la sesión.
Las fotos salieron oscuras, descoloridas o inconsistentes
La captura fotografía lo que renderiza tu cliente, así que tus ajustes gráficos acaban en el catálogo. Desactiva Ambient Occlusion y pon Post FX en Normal antes de una sesión.
La hora y el clima también importan. Appearance los congela si reconoce tu recurso de clima; si no, congélalos a mano o una sesión larga pasará de la luz del día al atardecer.
Algunos ítems aparecen como inutilizables, o se ven vacíos al ponérselos
El pack declara la prenda pero no incluye ningún modelo para ella, así que el juego no puede ponérsela y no hay nada que fotografiar. Confírmalo con el botón Wear del Catalog Editor: si tampoco aparece en tu personaje ahí, el pack está roto y solo su autor puede arreglarlo.
Config.ImageSaver.brokenSlotDetection decide qué pasa con ellos. Viene en skip; ponlo primero en report si quieres ver cuántos hay.
La pestaña Clothing Packs no aparece en el creador
La pestaña se oculta cuando Config.AddonCapture.enabled, Config.ClothingReplace.enabled y Config.ClothingScan.enabled están todos desactivados. Activa el que necesites. La captura de fotos de add-ons necesita además Config.ImageSaver.enable.
Las mangas y las manos no coinciden con la chaqueta
Esa prenda superior no tiene asignación de manos. El catálogo incluido tiene 7.568, así que siempre es una prenda que añadiste tú. Entra en una tienda como administrador, abre Admin → Top → Hands, elige la prenda superior y la categoría de manos que le corresponda, y guarda.
Si no hay categorías de manos para elegir, créalas primero en la pestaña Glove Categories del creador, y para eso el componente 3 tiene que estar fotografiado antes de que haya algo que mostrar.
Mis precios y etiquetas volvieron atrás después de una actualización
Es lo esperado, y conviene tenerlo en cuenta. Los datos iniciales del catálogo son un upsert sobre todas las filas incluidas, así que cuando cambia su versión se reescriben el precio, la etiqueta, la foto y los indicadores de los ítems incluidos, y las 29 tiendas incluidas.
Hay dos cosas protegidas por nombre: los peds que ocultaste y las fotos que capturaste tú. Los datos de los jugadores nunca se tocan. Las filas de la ropa que añadiste tú no están en los datos iniciales y se conservan, así que si cambias mucho los precios, usa preferentemente tus propias colecciones o guarda el SQL para volver a aplicar tus precios.
Outfits y apariencias guardadas#
Los outfits no se guardan, o no vuelven
Las tablas de jugadores no se crean automáticamente. Si player_outfits y playerskins no existen, el guardado falla con un error de SQL en la consola. Impórtalas desde [sql]/main.sql, con cuidado, porque ese archivo elimina las tablas antes de crearlas.
Los outfits de trabajo dan un error de SQL
Los vestidores leen una tabla management_outfits. Los servidores QBCore ya la tienen; una instalación nueva no, y nada de lo incluido la crea. Créala antes de empezar a repartir uniformes.
Todos mis personajes comparten una misma apariencia
Appearance usa como clave el identificador que le da tu framework. Los citizenid de QB y los prefijos de ESX multicharacter son por personaje, así que funcionan. Una instalación básica de ESX que identifica a los usuarios por la licencia sin más le da a cada personaje el mismo identificador, y nada en Appearance puede distinguirlos. Arréglalo en tu framework, no aquí.
Un jugador se quedó con un prop pegado, o con la ropa equivocada
/clearstuckprops borra todos los props unidos a su ped, y /reloadskin vuelve a aplicar su apariencia guardada. Ambos están disponibles para cualquier jugador y ambos se rechazan mientras está muerto, en un vehículo o cayendo.
Si otro recurso también viste al jugador, los dos se sobrescribirán entre sí. Haz que escuche appearance:handleClose en lugar de aplicar ropa con su propio temporizador.
Los tatuajes desaparecen cuando se ejecuta otro script
Aplicar tatuajes implica borrar todas las decoraciones del ped y volver a poner las guardadas, así que cualquier script que pinte sus propias decoraciones las pierde en ese momento.
La solución es un evento. Appearance dispara qs-appearance:client:tattoosApplied justo después de cada reconstrucción; vuelve a añadir tus decoraciones ahí, y no llames tú a ClearPedDecorations. Así es como qs-tattoo-creator convive con él.
Los disparos no impactan en jugadores altos o bajos
GTA no escala el hitbox de las balas de un ped según su modelo, así que cuanto más se aleja un personaje de la altura normal, peor se registran los disparos. Por eso Config.EnableScale viene desactivado y está marcado como experimental.
Si quieres mantenerlo, ajusta Config.Scale.min y Config.Scale.max hasta que la diferencia deje de notarse.
Antes de abrir un ticket#
Tres cosas hacen que un ticket sobre ropa se pueda responder en una sola respuesta en lugar de cinco:
La consola del servidor desde el principio del arranque, incluida la línea del framework y las líneas del esquema y de los datos iniciales del catálogo.
La consola F8 del juego, si el problema es algo que puedes ver en pantalla.
Tu framework, tu target y si Config.UseTarget, Config.ImageSaver.enable y Config.Debug están activados.
Desactiva Config.Debug antes de concluir que algo está roto: imprime muchísimo y hace que un servidor sano parezca alarmante. Vuelve a activarlo, con la consola delante, cuando estés persiguiendo un problema concreto.