Cuxial Appearance no necesita importar SQL. Crea sus tablas en el primer arranque y rellena la lista de tiendas con las tiendas por defecto.

Comprueba las dependencias

Deben estar instaladas y funcionando antes:

• ox_lib
• oxmysql
• cuxial_bridge, con uno de los frameworks compatibles: QBox, QBCore o ESX
• OneSync activado en el servidor

Opcionales; cada una activa una parte del script:

• Un inventario (ox_inventory o qb-inventory): prendas como ítems, ítems de outfit, bolsas, recortadora y segunda mano.
• Un target (sleepless_interact, ox_target o qb-target): la bolsa de outfits colocada en el suelo.
• cuxial_appearance_photos más screencapture o screenshot-basic: fotos del catálogo.
• cuxial_emotes: poses en el menú y la recortadora.

Quita otros scripts de ropa

Detén cualquier otro recurso de apariencia o ropa. Dos a la vez compiten por el mismo ped y los mismos eventos.

El recurso crea tablas llamadas appearance y outfits. Si tu base de datos ya tiene tablas con esos nombres de otro script, haz una copia de seguridad antes del primer arranque.

Copia los recursos

Coloca cuxial_appearance y cuxial_appearance_photos dentro de tu directorio resources. Mantén los nombres de las carpetas tal cual.

Añade los ítems

Añade estos ítems a tu inventario. El ejemplo es para ox_inventory:

ox_inventory/data/items.lua

['cuxial_clothing'] = {
    label = 'Prenda',
    weight = 220,
    stack = false,
    close = true,
    description = 'Una prenda de tu vestuario. Úsala para ponértela.',
    client = { export = 'cuxial_appearance.useClothing' },
},

['cuxial_garmentbag'] = {
    label = 'Bolsa de prendas',
    weight = 300,
    stack = false,
    close = false,
    consume = 0,
    description = 'Guarda prendas sueltas.',
},

['cuxial_outfit'] = {
    label = 'Conjunto de ropa',
    weight = 350,
    stack = false,
    close = true,
    description = 'Un conjunto completo empaquetado. Úsalo para ponértelo.',
},

['cuxial_outfitbag'] = {
    label = 'Bolsa de conjuntos',
    weight = 800,
    stack = false,
    close = true,
    description = 'Guarda hasta 5 outfits para vestirlos donde quieras.',
},

['cuxial_trimmer'] = {
    label = 'Recortadora',
    weight = 350,
    stack = false,
    close = true,
    description = 'Rapa la cabeza al cero. El pelo tarda en volver a crecer.',
},

Después copia los iconos de la carpeta install del recurso a la carpeta de imágenes de tu inventario.

Los nombres de los ítems se pueden cambiar en shared/config.lua (wardrobe.item, wardrobe.bag.item, outfits.setItem, outfits.bagItem, trimmer.item). cuxial_garmentbag solo se usa en modo inventario.

Los ítems de prenda nunca deben apilarse: cada uno lleva su pieza, su drawable y su textura.

Define las convars

Todas son opcionales.

server.cfg

# Idioma (se incluyen en y es)
setr ox:locale "es"

# Modo inventario: 1 = activado, 0 = desactivado (por defecto)
setr cuxial_appearance:inventory 0

# Webhook de Discord para los registros
set cuxial_appearance_webhook "https://discord.com/api/webhooks/..."

# Permite al estudio de fotos guardar sus fotos
add_filesystem_permission cuxial_appearance write cuxial_appearance_photos

# Trazas de depuración en la consola
setr cuxial_appearance_debug "0"

El modo inventario necesita un ox_inventory que aporte el panel de ropa y los contenedores de las bolsas de prendas. Con un inventario de serie déjalo en 0: quitarse y ponerse prendas desde el comando de vestuario sigue funcionando.

El webhook va en server.cfg, nunca en shared/config.lua. El nombre de la convar se puede cambiar en logs.convar.

Arranca los recursos

Arranca Cuxial Appearance después de sus dependencias, tu framework, tu inventario y tu target:

server.cfg

ensure ox_lib
ensure oxmysql
# tu framework aquí (qbx_core, qb-core o es_extended)
# tu inventario y tu target aquí
ensure cuxial_bridge
# opcionales
ensure cuxial_emotes
ensure screencapture
ensure cuxial_appearance_photos
ensure cuxial_appearance

No hay SQL que ejecutar. En el primer arranque el recurso crea sus tablas e inserta las tiendas de data/shops.lua.

Si actualizas desde la 2.0. En el primer arranque las concesiones de whitelist pasan a las tablas nuevas appearance_wl_grants y appearance_wl_members, y se borran las tablas antiguas appearance_whitelist y appearance_whitelist_players. Haz una copia de esas dos tablas antes de actualizar. Si alguna concesión no se copia, las tablas antiguas se conservan y el paso se repite en el siguiente arranque.

Las concesiones migradas valen para los dos sexos y se comparan solo por número. Vuelve a capturarlas con el botón de captura para que sobrevivan a packs de ropa nuevos.

Conecta tu multipersonaje

Un personaje nuevo necesita el creador. Tu recurso de multipersonaje tiene que llamarlo cuando el personaje ya ha aparecido:

exports.cuxial_appearance:InitialCreation(function()
    -- el jugador ha terminado el creador
end)

Los recursos que disparan qb-clothes:client:CreateFirstCharacter no necesitan cambios. Cuxial Multichar ya lo hace. La apariencia guardada se aplica sola cada vez que carga un personaje.

Comprueba que funciona

1. Entra con un personaje nuevo. Se abre el creador.
2. Entra en una tienda de ropa y pulsa E. Se abre el menú con el precio de esa tienda.
3. Cambia una prenda y confirma. Se cobra el dinero y el aspecto se conserva al reconectar.
4. Como staff, ejecuta /adminclothing. Se abre el panel con la lista de tiendas.
5. Mira la consola del servidor: no debe haber ningún aviso de ítem sin registrar.

Siguiente: ajusta precios, tiendas y restricciones en Configuración.