Los problemas más habituales tras instalar Cuxial Appearance, con la causa y la solución de cada uno.
El recurso no arranca
Causa. Falta una dependencia o arranca más tarde. Cuxial Appearance necesita OneSync, ox_lib, oxmysql y cuxial_bridge.
Solución. Activa OneSync y arranca antes las dependencias:
ensure ox_lib
ensure oxmysql
ensure cuxial_bridge
ensure cuxial_appearanceEl menú no aparece nunca, o la pantalla se queda vacía con el cursor visible
Causa. La interfaz no carga. La carpeta web/build falta o está incompleta, normalmente tras una subida parcial.
Solución. Comprueba que web/build/index.html existe dentro del recurso. Si no, vuelve a copiar el recurso desde el paquete original y reinicia el servidor.
La consola muestra consultas fallidas sobre las tablas appearance u outfits
Causa. La base de datos ya tenía una tabla llamada appearance u outfits de otro script, con columnas distintas. El recurso no sustituye una tabla existente.
Solución. Detén el servidor, haz una copia de seguridad de la base de datos, renombra o elimina las tablas antiguas y arranca de nuevo para que se creen con las columnas correctas. Después trae los aspectos antiguos con el comando de migración, si admite tu script anterior.
He cambiado un precio en shared/config.lua y no ha cambiado nada
Causa. prices, secondHand, ui.menuAlpha y parte de wardrobe y trimmer se guardan en la base de datos en el primer arranque. Desde entonces la base de datos manda sobre el archivo.
Solución. Cambia el valor en el panel de staff, sección ajustes. Para volver a los valores del archivo, edita el archivo, reinicia el recurso y usa el botón de restablecer de ese bloque.
He editado data/shops.lua y las tiendas no han cambiado
Causa. Ese archivo solo se lee cuando la tabla de tiendas está vacía, en el primer arranque.
Solución. Edita las tiendas desde el panel de staff. El botón de importar añade las tiendas del archivo que faltan por nombre; no cambia las que ya existen.
La consola dice que el ítem de prenda no está registrado y falla al quitarse una prenda
Causa. El ítem de wardrobe.item no existe en tu inventario.
Solución. Añade los ítems de la página de Instalación y reinicia el inventario y el recurso. El nombre en el inventario debe coincidir con el del config.
Usar un ítem de prenda no hace nada
Causa. El ítem no tiene función de uso.
Solución. En ox_inventory, el ítem necesita client = { export = 'cuxial_appearance.useClothing' }. La carpeta del recurso debe llamarse cuxial_appearance.
Faltan el panel de ropa, las bolsas de prendas o el registro corporal
Causa. El modo inventario está desactivado, o la convar se definió con set y el cliente no puede leerla.
Solución. Usa setr y reinicia el servidor:
setr cuxial_appearance:inventory 1El modo inventario necesita además un inventario que aporte el panel de ropa y los contenedores de las bolsas de prendas.
El estudio de fotos dice que el servidor no conoce el recurso de fotos
Causa. cuxial_appearance_photos no está en el directorio resources, o el servidor no lo ha escaneado.
Solución. Copia el recurso y ejecuta refresh y ensure cuxial_appearance_photos en la consola del servidor. Añade la línea ensure a server.cfg.
El estudio de fotos dice que el servidor no puede escribir en el recurso de fotos
Causa. Falta el permiso de sistema de archivos.
Solución. Añade esta línea a server.cfg y reinicia el servidor:
add_filesystem_permission cuxial_appearance write cuxial_appearance_photosEl estudio de fotos se cierra enseguida con un error sobre las capturas
Causa. No hay ningún recurso de captura en marcha.
Solución. Arranca screencapture o screenshot-basic antes que Cuxial Appearance, o pon el nombre del tuyo en photos.captureResource.
Las fotos se toman pero el catálogo no muestra ninguna
Causa. El recurso de fotos no está arrancado, o no se reinició tras la sesión y los clientes no tienen los archivos nuevos.
Solución. Comprueba que cuxial_appearance_photos está en marcha. El estudio lo reinicia al terminar; si la consola indica que el comando fue rechazado, reinícialo a mano con ensure cuxial_appearance_photos, o permítelo:
add_ace resource.cuxial_appearance command.ensure allowLas fotos muestran la prenda anterior o una a medio cargar
Causa. La captura ocurre antes de que la prenda termine de cargar.
Solución. Sube photos.waitApply y photos.waitCapture, marca las fotos incorrectas y repite la sesión.
Los comandos de staff responden que no tengo permiso
Causa. Tu framework no te concede el permiso de admin.permission.
Solución. Date ese permiso en tu framework, o cambia admin.permission por uno que tengas. En ESX, 'admin' acepta los grupos admin y superadmin. Si definiste restricted en un comando, también necesitas ese ACE.
La recortadora dice que necesita el sistema de emotes
Causa. cuxial_emotes no está en marcha, o el emote de trimmer.emote no existe en él.
Solución. Arranca cuxial_emotes antes que Cuxial Appearance y revisa el nombre del emote.
Un jugador no puede cambiarse el pelo
Causa. Lo raparon con la recortadora. El pelo queda bloqueado durante trimmer.hairLockMinutes.
Solución. Espera, o baja el valor en el panel de staff. 0 quita el bloqueo en los próximos rapados.
Alguien sigue llevando algo reservado en la whitelist
Causa. El jugador es staff con el Modo staff activado, o la concesión viene de la versión 2.0 y se compara solo por número, así que tras añadir packs de ropa apunta a otra pieza.
Solución. Apaga el Modo staff en la sección Whitelist del panel de staff. Para una concesión antigua, ponte la prenda, abre la concesión, vuelve a capturarla y guarda.
Falta la pestaña de tatuajes
Causa. rcore_tattoos está en marcha. Cuxial Appearance le deja los tatuajes y oculta su propia pestaña. La pestaña solo existe en el menú appearance.
Solución. Para usar los tatuajes propios, detén rcore_tattoos.
La bolsa de outfits colocada no se puede abrir
Causa. No hay ningún recurso de target en marcha, o cuxial_bridge eligió otro.
Solución. Arranca sleepless_interact, ox_target o qb-target antes que cuxial_bridge.
Los personajes de mi script de ropa anterior aparecen con el aspecto por defecto
Causa. Sus skins no se han importado.
Solución. Mantén compat.legacySkins = true para importar cada una cuando haga falta por primera vez, o ejecuta una vez el comando de migración. Consulta Comandos y permisos.
He cambiado menu.openControl pero la tienda se sigue abriendo con la tecla anterior
Causa. menu.openControl es solo el valor por defecto. Cuando un jugador ya ha entrado, FiveM recuerda su asignación de tecla.
Solución. Cada jugador la cambia en los ajustes de GTA, en asignación de teclas, FiveM.
Un personaje nuevo no pasa por el creador
Causa. Nada llama al creador. Cuxial Appearance no lo abre por sí solo.
Solución. Tu recurso de multipersonaje tiene que llamar a exports.cuxial_appearance:InitialCreation() o disparar qb-clothes:client:CreateFirstCharacter para los personajes nuevos. Consulta Exports y eventos.