Problemas y preguntas

Empieza por la consola del servidor. Al arrancar, el recurso dice qué framework encontró, qué tablas faltan y qué valores de la config tuvo que corregir. Ver Qué dice la consola.

Los avisos de esta página salen en el idioma de Config.Locale; acá se muestran en español.

Abrir el menú

Problema	Por qué, y qué hacer
"Ahora no podés abrir el menú."	El jugador está muerto, caído, esposado o cayendo, o tu regla de Config.CanOpenMenu dijo que no.
"Andá a una tienda del mapa para abrir el menú."	Abrir una tienda por comando es de admins. Config.CommandsForEveryone = true lo habilita para todos.
"Cerrá el panel de admin antes de abrir el menú."	El panel y el menú no pueden estar abiertos a la vez.
El panel dice que es solo para admins	Agrega add_ace group.admin zaiders_appearance.admin allow al server.cfg, y revisa que tu cuenta esté en ese grupo. Ver Comandos y permisos.
E no hace nada en una tienda	Párate dentro de su radio: la tecla del cartel se ilumina cuando E funciona. Revisa que la tienda exista en Tiendas del panel, y que Config.Shops.key sea 38 (E).
Se abren dos menús de ropa a la vez	Tu menú de ropa anterior sigue prendido. Saca su ensure.
Esc o la ✕ preguntan "Tenés cambios sin guardar"	Es lo esperado con Config.ConfirmOnExit (prendido de fábrica): el jugador cambió algo gratis, como el otro sexo, un ped suyo o sacarse algo. Guardar cambios lo deja (gratis, y el servidor lo revisa como cualquier compra), Descartarlos sale como entró, Seguir editando vuelve al menú. false: sin preguntar si no hay nada para pagar. Ver Config.ConfirmOnExit.
Guardar cambios está apagado	El ped que se está probando no es suyo: "El ped que te estás probando no es tuyo: compralo en Peds para quedártelo, o descartalo." Si no hay Guardar cambios, lo único cambiado es una altura que se ve en Cuerpo: "Solo se ve en vos: para que quede, elegila en Cuerpo."
Un jugador eligió el otro sexo o un ped, salió y volvió a como estaba	No se guardó. Con Config.ConfirmOnExit, salir pregunta antes: Guardar cambios o pagar lo deja.

Guardar y pagar

Problema	Por qué, y qué hacer
No se cobra ni se guarda nada	No encontró el framework. La consola dice framework: none. Arranca tu framework antes que ZAIDERS Appearance, o elígelo en Config.Framework.
No se guarda nada y la consola nombra oxmysql	Agrega ensure oxmysql antes del recurso.
ESX: la apariencia no se guarda	La tabla users no tiene la columna skin. Ejecuta el ALTER TABLE que muestra la consola.
"Hay prendas sin stock: sacalas (×) para comprar el resto."	Un admin se está probando una prenda sin stock. Sácala del carrito, o vuelve a ponerla en stock con clic derecho.
Una compra dice que todavía se está guardando	La base de datos está lenta, muchas veces por una copia de seguridad. El dinero solo vuelve si el guardado falla de verdad, y al jugador se le avisa.

Ropa y fotos

Problema	Por qué, y qué hacer
Las prendas muestran un dibujo en vez de una foto	Todavía no se les sacó foto. Sácalas en el panel. Ver Fotos del catálogo.
Las fotos nuevas no les aparecen a los jugadores	Ejecuta ensure zaiders_photos después de sacar fotos.
Fotos del catálogo dice que falta el recurso de las fotos	Copia zaiders_photos a resources y haz ensure antes de zaiders_appearance.
Algunas fotos salieron negras o de un solo color	El juego no estaba a la vista mientras se sacaban (ahora el estudio lo espera, y corta la tanda después de diez minutos de imagen negra). Usa Borrar las rotas en el panel, o zappearance_clean_photos, y sácalas de nuevo.
La ropa de un jugador se ve mal o invisible	/zappearance recargar le vuelve a poner la ropa guardada.
El carrito dice "No se vende acá", o al pagar sale "Esta tienda no vende eso."	Esa tienda del mapa vende solo algunas cosas (panel → Tiendas → Catálogo y precios). Además, la tienda de ropa vende la ropa y el corte con su color, nunca la cara, los ojos, la barba, las cejas ni el maquillaje de la barbería, y la barbería nunca vende ropa. Ver Lo que revisa el servidor.
"Esta tienda no vende ropa de ese pack."	Esa tienda vende solo algunos packs. Cómprala en otra tienda, o agrega el pack a esa tienda en el panel.
No hay Pelo en una tienda de ropa	Esa tienda vende solo algunas cosas, sin Pelo. Agrégalo en el panel: Tiendas → Catálogo y precios → Vende.
Las prendas cambiaron después de agregar o sacar un pack	FiveM numera la ropa en el orden de arranque. Reinicia el servidor entero (nunca un solo pack) y entra una vez con un admin. Ver IDs de ropa y outfits corridos.
Una prenda muestra la foto equivocada después de repackear	Con Config.Photos.byContent (prendido de fábrica), cada foto sigue a su prenda por lo que tienen adentro sus archivos, y se revisa al arrancar el servidor, cuando arranca o para un pack y al salir del estudio. Una foto cuya prenda ahora es otra se oculta hasta que la saques de nuevo: mira Packs de ropa → Cambios. Con byContent = false, vuelve a sacar las fotos de ese pack.
Con Config.Photos.url, los jugadores ven fotos viejas o ninguna	El estudio, Cambios y las fotos por contenido escriben solo en el servidor del juego. Vuelve a subir photos/ a tu CDN después de cada uno.

Barbería

Problema	Por qué, y qué hacer
La carta de color muestra cuadraditos de color en un corte	La textura de ese pelo de un pack no se puede leer (BC7 o con escrow), sus mechones todavía no están, el juego del jugador no tiene WebGL, o Config.Barber.colorCard.enabled = false. El servidor prepara los pelos de los packs en segundo plano después de arrancar; para empezar ya, panel → Packs de ropa → Mechones de los pelos, o zappearance_hair_swatches en la consola del servidor. Mientras llegan los mechones de un corte, la carta dice "Preparando los mechones de este corte…".
"Este corte trae su color"	El juego no tiñe ese corte, así que el color queda como estaba y no se cobra. Es lo esperado.
No está el botón Antes | Después	Al abrir la barbería, el menú no pudo leer la imagen del juego (deshacer y Detalle siguen andando), o Config.Barber.mirror.curtain = false. Si dice "No se pudo sacar la foto del antes.", cierra la cortina y ábrela de nuevo: la foto se saca cada vez que se abre.
Mantené para ver el antes está apagado	Todavía no cambió nada ("Todavía no cambiaste nada para comparar"), o se está pagando. Solo está en la barbería.
Los ojos salen como "Ojos 12", o como casillas con su número	Un recurso que corre trae un pack de ojos (mp_eye_colour.ytd), así que los nombres del juego no sirven: ponles nombre en Config.Eyes.names. Las casillas con número y sin color son porque no cargó la imagen de los ojos, o Config.Eyes.fromGame = false. Ver Barbería: packs de ojos.

Estudio de fotos

Problema	Por qué, y qué hacer
Fotos del catálogo dice "Sin la cabeza invisible"	Falta zaiders_studio. Cópialo a resources (no va en el server.cfg) y reinicia el servidor. Mientras tanto la cabeza se pinta del color del fondo.
"La cabeza invisible ya está en el servidor, pero tu juego entró antes"	Reconéctate una vez.
"Para entrar al estudio de fotos, bajá del vehículo y que tu personaje esté de pie, sin esposas."	El estudio no arranca desde un vehículo, ni con tu personaje muerto, caído, esposado, en ragdoll o cayendo. El panel en sí se abre en cualquier lugar: baja, ponte de pie y vuelve a empezar la tanda.
F8: "estudio: N pelos no se pudieron teñir (…)"	Esos pelos se sacaron al final sobre la cabeza pintada, con la cara borrada: sus fotos están bien. La línea dice por qué, por ejemplo el pelo tiene partes que el juego no tiñe, o no se pudo leer su textura (el servidor no pudo leer los nombres de adentro de su .ytd). Ver Pelo.
F8: "estudio: N fotos no se pudieron sacar: …"	Las fotos de esa tanda que fallaron, con cada motivo y cuántas. Arregla lo que dice y corre esos lugares de nuevo: Saltear las que ya tienen foto saca solo lo que falta.
Un pelo sale con sus propios colores y no con el elegido	El servidor leyó el modelo de ese pelo de un pack y el juego nunca lo tiñe (no tiene ningún shader ped_hair_*), así que los jugadores también lo ven así. Los pelos 0 de male_heist y female_heist, del juego, son iguales.
Cuentas, colitas u otras partes de un pelo salen del color del pelo	El modelo del pelo está encriptado por el escrow, así que el estudio no puede saber qué partes tiñe el juego y tiñe el pelo entero. Es un límite conocido.
Fotos de noche, con lluvia o con la luz cambiando, o F8 dice que otro script le pelea la luz al estudio	Un script de clima o de hora. Agrega sus eventos de pausa en Config.Studio.syncPause, o apágalo (o haz que deje en paz al admin) mientras sacas fotos. Ver Scripts de clima y de hora.
Te kickearon o banearon mientras sacabas fotos	Tu anticheat o tu kick por AFK vio un personaje invisible, invencible y quieto, alto sobre el mar. Exceptúa al admin en el servidor con exports.zaiders_appearance:isInStudio(source) o con el evento del servidor zaiders_appearance:studio (no con el state bag, que el juego de un jugador puede escribir): ver El estudio de fotos. O saca las fotos en un servidor de prueba sin ellos.
Un texto, un logo o un contador sale en las fotos de caras o de peds	Otro script dibuja en la pantalla. Escóndelo mientras sacas fotos, y saca esas fotos de nuevo.
Una prenda falló por ser demasiado grande para su encuadre	Dale más Distancia a ese lugar en Encuadre de las fotos y sácala de nuevo. El resto de la tanda siguió.
La tanda se cortó: "Tres fotos seguidas no dejaron ver el fondo…"	O esas prendas son más grandes que su encuadre (aleja la cámara de ese lugar en Encuadre de las fotos) o el juego perdió las texturas (reinicia FiveM). Después vuelve a sacarlas: las que ya tienen foto se saltean.
La tanda se cortó: "La imagen del juego llegó negra por más de diez minutos…"	El juego estuvo minimizado o la pantalla bloqueada todo ese tiempo. Deja el juego en pantalla y vuelve a sacarlas: las que ya tienen foto se saltean.
La tanda se cortó: "El juego dejó de mostrarse hace más de un minuto…"	Se llenó la memoria de video y el mundo se ve sin texturas. Reinicia FiveM y vuelve a sacarlas.
Algunas prendas fallaron en la primera tanda	Sus archivos todavía no habían bajado a tu juego (un servidor remoto). Corre ese lugar de nuevo: Saltear las que ya tienen foto saca solo esas.
Un pack de ropa nuevo sale en 0 % en Packs de ropa y no le saca fotos	Arrancó después de que entraste, así que tu juego no lo tiene. Reconéctate y saca sus fotos.
El juego se cerró o el servidor se reinició en medio de una tanda	No hace falta nada: la próxima vez que carga ese personaje, vuelve a donde estaba antes de entrar al estudio.

Creador de personaje

Problema	Por qué, y qué hacer
No se abre con un personaje nuevo	Tu multichar dispara otro evento. Agrégalo en Config.Creator.events.
No se abre, y hay otro menú de ropa prendido	Hay un recurso de Config.Creator.skipIfStarted prendido, así que ese se ocupa de los personajes nuevos.
ESX: se abre el menú de esx_skin	Es lo esperado con esx_skin prendido (esx_multicharacter lo necesita). Sin multichar, puedes apagar esx_skin y skinchanger.
Se abrió la tienda de ropa en vez del creador	Ese personaje ya tiene apariencia. El creador es solo para personajes nuevos.
Esc no sale del creador	Un personaje nuevo sale terminándolo: Terminar personaje.

Altura del personaje

Problema	Por qué, y qué hacer
No está Altura en el creador, ni la pestaña Cuerpo en la barbería, ni Pedidos de altura en el panel, y /zappearance pedidos no existe	La altura del personaje viene apagada de fábrica. Pon Config.Height.enabled = true y reinicia el recurso. Es solo para el hombre y la mujer freemode; creator = false la esconde en el creador, y requests.enabled = false saca los pedidos. Ver Altura del personaje.
"La altura está apagada en este servidor."	Config.Height.enabled = false (de fábrica), como arriba.
"En este servidor no se pueden pedir cambios de altura."	Config.Height.requests.enabled = false.
Los demás ven a un personaje con la altura del juego	Es lo esperado con un arma de fuego en la mano y combat = 'fair', en un vehículo, en ragdoll o sentado. Si no, OneSync está apagado (la consola lo dice una vez), o está prendido un recurso de altura de Config.Height.owners.
Los personajes se hunden en las sillas	Agrega las animaciones de sentarse de tu menú de emotes a Config.Height.pause.anims, o llama a pauseHeight desde él. Ver Emotes de sentarse.

HUD, tiendas y tatuajes

Problema	Por qué, y qué hacer
El HUD del servidor se ve encima del menú	Agrega tu HUD en Config.HideHud.resources con su export o su evento, o usa Config.HideHud.custom. Ver la Referencia de la config.
No hay blips en el mapa	Config.Shops.blips = false, o los blips de ese tipo están apagados en Blips del mapa del panel.
El mapa grande lista los blips con los nombres de otro script	Otro script usa las categorías de blips 121 a 124. Pon otro número en Config.Shops.blipLegend, o false.
"Los tatuajes de este servidor los maneja otro recurso."	Hay un recurso de Config.Tattoos.owners prendido, así que la tienda de tatuajes se apagó sola.
"La tienda de tatuajes está apagada en este servidor."	Config.Tattoos.enabled = false.
Los demás ven mis tatuajes más claros, o sin los addon	Revisa que OneSync esté prendido, no en legacy: si no, la consola lo avisa al arrancar el servidor. Revisa Config.Tattoos.sync. Mientras otro recurso está a cargo de los tatuajes, los demás ven cada uno una vez, sin las capas más oscuras. ZAIDERS Tattoos se hace a un lado solo mientras este menú sincroniza; el script de sincronización propio de otro pack de tatuajes que les pone tatuajes a los demás jugadores hay que apagarlo. Ver Lo que ven los demás jugadores.
Los demás ven los tatuajes que me pruebo en otra tienda de tatuajes	Esa tienda no tiene una pantalla con el mouse ni una cámara de script mientras los prueba. Su script puede llamar a exports.zaiders_appearance:setTattooBusy(true) al abrirse y con false al cerrarse. Ver setTattooBusy.
Los tatuajes de un pack no aparecen en la tienda	El pack tiene que estar prendido, y su fxmanifest.lua tiene que cargar sus archivos de overlays con data_file 'PED_OVERLAY_FILE'. Si F8 dice el juego no tiene la colección <nombre>, al archivo de overlays del pack le falta la línea <nameHash> después de </presets>, que le da nombre a la colección. ZAIDERS Tattoos 1.0.0 tenía este problema: actualiza a la 1.0.1. Ver Packs de tatuajes addon.
"La barbería es solo para personajes freemode."	El jugador lleva un ped. Puede pasar a Hombre o Mujer en Peds.

Peds

Problema	Por qué, y qué hacer
La tienda de peds está vacía	Revisa Config.PedShop.enabled y las categorías en Peds → Venta del panel. La consola F8 de un admin tiene una línea «tienda de peds» que dice cuántos peds encontró y por qué.
Falta un ped en la tienda	Es de una actualización de GTA más nueva que el game build de tu servidor, o su categoría no se vende.
"Otra persona ya tiene comprado este ped"	Un ped, un solo dueño está prendido, y ese ped ya tiene dueño.
Un código de ped no funciona	Ya se canjeó o se anuló, los códigos están apagados (Venta → Códigos de canje), o el ped ya tiene su único dueño. Los códigos se escriben como se entregaron, como M4KQ-2TZB.

Idioma y config

Problema	Por qué, y qué hacer
La consola lista valores de la config que corrigió	Hay un valor faltante o mal escrito en config.lua. El menú funciona igual. Corrige las líneas que nombra. Ver Cómo se revisa la config.
La consola dice "... ya no existe en esta versión: se ignora"	Una opción que una versión nueva sacó, como Config.Barber.handsOn o Config.Barber.colorCard.matchClothes. Borra esa línea de config.lua.
Los textos salen en inglés aunque Config.Locale es otro idioma	Falta el archivo de ese idioma o está roto. Una comilla o una coma de menos rompen el archivo entero. Revísalo con un validador de JSON.
Cambiaste Config.Locale y algunas tiendas no cambiaron de nombre	Los nombres que escribiste tú se conservan. Solo se traducen los que puso el juego o el panel.

Escrow

Problema	Por qué, y qué hacer
You lack the required entitlement	La clave de licencia del servidor no es de la cuenta de Cfx.re que compró ZAIDERS Appearance. Ver Asset Escrow y la ropa.

¿Sigues trabado?

Junta las líneas de la consola que empiezan con [zaiders_appearance], tu framework y su versión, y lo que hiciste justo antes del problema. Después abre un ticket. Nunca envíes claves de licencia ni contraseñas.

Si el juego crashea con la ropa, la causa suele estar en tus packs de ropa, no en el menú. Empieza por el Diagnóstico de crasheos.