Cuxial Appearance
Apariencia todo-en-uno — editor de personaje, bolsa de ropa física, vestuario con prendas como items y panel admin de tiendas.
Resumen
Apariencia todo-en-uno — editor de personaje, bolsa de ropa física, vestuario con prendas como items y panel admin de tiendas (QBox · ESX · QBCore)
Sistema de apariencia completo 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 que se deja en el suelo, vestuario que convierte las prendas que te quitas en items de inventario y un panel de administración para dibujar tiendas y reservar prendas por jugador. Identidad visual propia (hexágonos cosidos por un hilo, tipografía Bebas Neue) con color de acento configurable. Todo lo decide el servidor: cada payload se valida y cada compra se cobra (y se devuelve si algo falla) en el servidor.
Requisitos
Requiere cuxial_bridge. Descárgalo e inícialo antes que este script (ver la doc del bridge). El bridge es lo que le da compatibilidad con QBox, ESX y QBCore.
Compatible con QBox, ESX y QBCore. No necesitas listar tu framework como dependencia: el bridge lo detecta y lo conecta por ti.
Asegúrate de tener estos recursos instalados e iniciados antes que el script:
Las dependencias opcionales (rcore_tattoos, cuxial_emotes) añaden funciones extra pero no son obligatorias.
Instalación
- Instala cuxial_bridge si aún no lo tienes (ver su doc).
- Sube la carpeta cuxial_appearance a resources/[cuxial]/.
- Instala las dependencias listadas arriba.
- Añade los ensure a tu server.cfg respetando el orden.
- Reinicia el servidor por completo.
# Tu framework (QBox / ESX / QBCore) ya debe estar iniciado
ensure ox_lib
ensure oxmysql
# Núcleo de Cuxial — siempre antes que los scripts
ensure cuxial_bridge
ensure ox_inventory
ensure ox_target
# El script
ensure cuxial_appearanceConfiguración
Toda la configuración editable está en texto plano (la lógica va protegida por Cfx.re Escrow). Edita estos ficheros para ajustar el script a tu servidor:
- shared/config.lua
- data/
- locales/
- install/
Protegido por Cfx.re Escrow — Compatible con QBox · ESX · QBCore (vía cuxial_bridge) — Requiere registrar los items en ox_inventory (cuxial_outfitbag, cuxial_clothing, cuxial_outfit, cuxial_trimmer; imágenes incluidas en install/) — Migración por comando desde illenium-appearance — shared/config.lua, data/*.lua y locales/ abiertos y editables — Español e inglés incluidos — Color de acento configurable sin recompilar — Soporte por tickets en la web — Actualizaciones incluidas
Comandos
/vestuarioAbre el vestuario (o tecla F7)/adminclothingPanel de administración de tiendas y whitelist (admin)/fixpjRecarga 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)/givetrimmerEntrega una recortadora con un corte concreto (admin)/migraraparienciaImporta skins y outfits desde illenium-appearance (admin)Características
- 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)
- Cámara orbital por secciones del cuerpo (cuerpo entero, cabeza, torso, piernas, zapatos) con zoom y rotación
- 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 — sin tramos vacíos al pasar prendas
- Bolsa de ropa física — item que se coloca en el suelo como objeto real y queda ahí para ti y para quien decidas
- Vitrina en vivo — un clon tuyo prueba el conjunto al pasar el ratón, 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
- Bolsa pública o privada con candado: los invitados ven y se visten, pero no tocan ni recogen
- Anti-pérdida — si te desconectas o reinicia el servidor con la bolsa en el suelo, vuelve a tu inventario al entrar
- Vestuario — quitarte una prenda la convierte en item con su nombre e imagen; ponértela lo consume
- Cualquier jugador que reciba el item puede ponérselo sin abrir el vestuario; el intercambio devuelve la pieza anterior
- 15 piezas con 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 con selector 3D (el otro jugador acepta) + códigos alfanuméricos
- Item "conjunto" — empaqueta un outfit en un objeto; usarlo te viste prenda a prenda con su gesto
- Panel admin "El Atelier" — dibuja el polígono de la tienda con cámara libre y ponle precio, trabajos permitidos y piezas restringidas, sin tocar config ni reiniciar
- Blip por tienda — icono, color y posición a tu gusto
- Whitelist de prendas — reserva una prenda concreta para los ciudadanos que elijas, capturándola al ponértela
- El precio se valida por posición real dentro de la tienda: nadie paga la tarifa barata desde fuera
- Server-autoritativo — cada guardado se valida y acota en el servidor; 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)
- Migración desde illenium-appearance por comando (skins y outfits) + capa de compatibilidad opcional para sus exports
Rendimiento
Los hilos solo corren con el menú abierto; interfaz troceada por pantalla (cada módulo baja cuando se usa) y tiendas en DB con reconstrucción en vivo