Cuxial Appearance is an all-in-one FiveM appearance script with a Svelte 5 NUI: clothing / barber / surgeon shops, a character creator, a physical clothing bag you place in the world, a wardrobe that turns worn garments into inventory items, and an in-game admin panel to draw shops and whitelist exclusive clothing per player.
Everything is server-authoritative: every payload is validated and every purchase is charged — and refunded on failure — on the server. It runs on QBox, ESX and QBCore through our free cuxial_bridge (same script on all three without touching code). The resource is protected by Cfx.re Escrow.
Note: our storefront is cuxial.com, where customers browse the full description, screenshots and documentation. Checkout is handled through the Tebex Headless API.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🇪🇸 APARIENCIA, BOLSA DE ROPA Y VESTUARIO
Sistema de apariencia completo multi-framework (QBox · ESX · QBCore) con NUI en Svelte 5. No es solo un menú de tienda: son cinco pantallas sobre la misma interfaz — editor de apariencia, creador de personaje, bolsa de ropa física, vestuario y panel de administración — con identidad visual propia y color de acento configurable.
✨ EDITOR DE APARIENCIA
• Herencia — padres, parecido y tono de piel, con la lista de modelos configurable.
• 20 rasgos faciales y 13 capas de rostro (barba, cejas, maquillaje, pecas, edad…) con color y opacidad.
• Pelo con color, mechas y fade automático opcional.
• Ropa y accesorios por categorías, con soporte de colecciones DLC (referencias estables, no índices que bailan con cada actualización).
• Cámara orbital por secciones del cuerpo (cuerpo entero, cabeza, torso, piernas, zapatos) con zoom y rotación del personaje.
• Poses mientras te vistes — quieto, manos arriba e idles del pack de emotes, para ver la ropa sin bamboleo.
• Tatuajes — usa rcore_tattoos si lo tienes; si no, catálogo DLC nativo incluido.
• Las prendas exclusivas de consola (gen9) se saltan solas: se acabaron los tramos vacíos al pasar prendas.
👜 BOLSA DE ROPA FÍSICA
• Item que se coloca en el suelo como objeto real: te agachas, la dejas y queda ahí para ti y para quien tú decidas.
• Vitrina en vivo — un clon tuyo prueba el conjunto al pasar el ratón por encima, sin que tú te cambies de ropa.
• Vestido por partes — ponte solo el torso, el pantalón, los zapatos o la máscara de un conjunto guardado.
• Pública o privada con un candado: los invitados pueden ver y vestirse, pero no tocar ni recoger.
• Anti-pérdida — si te desconectas o se reinicia el servidor con la bolsa en el suelo, vuelve a tu inventario al entrar. Los conjuntos pueden vivir ligados al jugador, así que perder la bolsa nunca es perder la ropa.
🧥 VESTUARIO
• Quitarte una prenda la convierte en item de inventario, con su nombre e imagen; ponértela lo consume.
• Funciona con cualquier jugador que reciba el item: se lo puede poner sin abrir el vestuario.
• Intercambio limpio: si ya llevabas algo en esa pieza, vuelve a tu inventario. Nada se duplica ni se pierde.
• 15 piezas con su animación propia y arreglo de brazos al quitar/poner la chaqueta.
👔 OUTFITS
• Guardar, renombrar y organizar conjuntos, con outfits de trabajo por rango que crea el jefe.
• Compartir en persona — apuntas a alguien cerca con un selector 3D y decide si lo acepta.
• Códigos alfanuméricos para pasar un conjunto a quien quieras.
• Item "conjunto" — empaqueta un outfit en un objeto; usarlo te viste prenda a prenda, con su gesto.
🛠️ PANEL DE ADMINISTRACIÓN "EL ATELIER"
• Tiendas desde el juego: dibujas el polígono con una cámara libre, colocas el blip donde quieras y le pones precio propio, trabajos permitidos y piezas restringidas. Sin tocar un config ni reiniciar: los cambios se ven al momento.
• Blip por tienda — icono, color y posición a tu gusto.
• Whitelist de prendas — reserva una prenda concreta para los ciudadanos que elijas, y captúrala poniéndotela en vez de teclear números.
• El precio se valida por posición real dentro de la tienda, así que nadie paga la tarifa barata desde fuera.
🔒 TODO LO DECIDE EL SERVIDOR
• Cada guardado se valida y acota en el servidor: un cliente modificado no mete basura en tu base de datos.
• Si el cobro sale bien y el guardado falla, el dinero vuelve solo.
• Las prendas exclusivas se despojan en todas las vías (apariencia, outfits, bolsa, códigos, compartir): un item o un código no sirve de puente.
• Límites y anti-spam en outfits, códigos, vestuario y bolsa.
⌨️ COMANDOS
• /vestuario — Abre el vestuario (o tecla F7)
• /adminclothing — Panel de administración de tiendas y whitelist (admin)
• /fixpj — Recarga tu apariencia si algo se ve mal
• /ropa [id] [tipo] — Abre el menú a un jugador (admin)
• /doblecx [id] — Clona la apariencia de otro jugador (admin)
• /givetrimmer — Entrega una recortadora con un corte concreto (admin)
• /migrarapariencia — Importa skins y outfits desde illenium-appearance (admin)
🔧 COMPATIBILIDAD Y DEPENDENCIAS
• Multi-framework: QBox · ESX · QBCore (vía nuestro cuxial_bridge gratuito — mismo script en los 3 sin tocar código).
• Dependencias: cuxial_bridge, ox_lib, oxmysql, ox_inventory, ox_target (o qb-target), rcore_tattoos (opcional), cuxial_emotes (opcional: poses y recortadora).
• Items a añadir: cuxial_outfitbag, cuxial_clothing, cuxial_outfit, cuxial_trimmer (imágenes incluidas en la carpeta install/).
• ¿Vienes de illenium-appearance? Un comando migra las apariencias y los outfits de tus jugadores, y hay una capa de compatibilidad opcional para los recursos que llamen a sus exports.
⚡ RENDIMIENTO
• 0.00ms en reposo — los hilos solo corren con el menú abierto.
• Interfaz troceada por pantalla: el arranque solo carga lo mínimo y cada módulo baja cuando se usa.
• Tiendas en base de datos con reconstrucción en vivo, sin reiniciar el recurso.
🛡️ EXTRAS
• Protegido por Cfx.re Escrow.
• shared/config.lua + data/*.lua + locales/ abiertos y editables.
• Español e inglés incluidos; todo el texto vive en los locales.
• Color de acento configurable — re-tematiza toda la interfaz sin recompilar.
• Soporte por tickets en la web.
• Actualizaciones incluidas.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📚 Documentación completa: https://cuxial.com/docs/appearance
