Instalación

Instalarlo lleva unos diez minutos: copiar tres carpetas, ejecutar un archivo SQL y agregar unas líneas al server.cfg. Tus jugadores conservan la apariencia que ya tenían.

Dificultad: Principiante · Necesitas: los archivos del servidor, la base de datos y el server.cfg

Antes de empezar

Requisito	Detalle
Servidor de FiveM	Con OneSync, en un artifact reciente.
ox_lib	Arrancado antes que ZAIDERS Appearance.
oxmysql	Arrancado antes que ZAIDERS Appearance. Sin él no se guarda nada.
Framework	QBCore, Qbox o ESX. Se detecta solo. Sin framework el menú abre igual, pero no se cobra ni se guarda nada.
Base de datos	MySQL 5.7 o más nuevo, o MariaDB 10.2 o más nuevo.
Game build	Cualquiera. Los tatuajes y peds de una actualización más nueva de GTA solo aparecen en servidores cuyo game build los trae.

Un solo menú de ropa a la vez

Si corren dos menús de ropa, los dos atienden los mismos eventos y los dos se abren con un personaje nuevo. El paso 5 apaga el anterior. La apariencia que tus jugadores tenían guardada queda donde está.

Pasos

1. Descárgalo del Portal de Cfx.re

   ZAIDERS Appearance es un asset con escrow de Cfx.re. Después de comprarlo, entra en portal.cfx.re con la misma cuenta de Cfx.re y descárgalo desde Granted assets.

   El servidor tiene que usar una clave de licencia creada con esa misma cuenta. Si no, la consola muestra You lack the required entitlement y el recurso no arranca. Ver Asset Escrow y la ropa.

2. Copia las tres carpetas

   Pon zaiders_appearance, zaiders_photos y zaiders_studio en tu carpeta resources. También sirve una carpeta de categoría como resources/[zaiders]/.

   No les cambies el nombre. Otros scripts llaman al menú como exports.zaiders_appearance, y la config busca las fotos en zaiders_photos. zaiders_studio es la cabeza invisible del estudio de fotos: no va en el server.cfg, la prende zaiders_appearance después de todo lo demás.

3. Ejecuta el archivo SQL

   Abre tu base de datos con HeidiSQL, phpMyAdmin o la consola de MySQL. Elige la base del servidor (en la consola, USE tu_base;) y ejecuta Appearancez.sql.

   Las tablas que ya existen no se tocan, así que la apariencia y los outfits que tus jugadores ya tenían siguen funcionando. El recurso también crea sus propias tablas la primera vez que las necesita. Si aun así falta alguna, la consola dice cuál.

4. Agrégalo al server.cfg

   Después de ox_lib, oxmysql y tu framework, con zaiders_photos primero:

   ensure ox_lib
   ensure oxmysql
   ensure qb-core              # o qbx_core, o es_extended
   
   ensure zaiders_photos
   ensure zaiders_appearance
   
   add_ace group.admin zaiders_appearance.admin allow

   La línea add_ace le abre el panel de admin a tu group.admin. También entran los admins de qb-core (god, admin) y de ESX (admin, superadmin). Ver Comandos y permisos.

5. Apaga tu menú de ropa anterior

   Saca o comenta el ensure del menú que usabas, por ejemplo qb-clothing, illenium-appearance o fivem-appearance. La apariencia guardada sigue funcionando porque ZAIDERS Appearance lee las mismas tablas: playerskins en QBCore y Qbox, users.skin en ESX.

   • ESX con esx_multicharacter: deja corriendo esx_skin y skinchanger, porque esx_multicharacter los necesita para arrancar. Los personajes nuevos se hacen con el menú de esx_skin; las tiendas, la barbería, los tatuajes y el guardarropa son de este menú.
   • ESX sin multichar: puedes apagar esx_skin y skinchanger. Este menú contesta en su lugar y abre su propio creador para los personajes nuevos.

   Los outfits y uniformes de illenium-appearance o qb-clothing se traen con un comando de consola. Los tatuajes que illenium-appearance y fivem-appearance guardaron dentro de cada apariencia pasan solos, los de cada personaje la primera vez que entra; en ESX con esx_skin, ejecuta zappearance_migrate tattoos confirm recién instalado. Ver Si vienes de otro menú.

6. Revisa la config

   Abre zaiders_appearance/shared/config.lua. Viene en inglés (Config.Locale = 'en'). Para español, pon Config.Locale = 'es'. Los demás idiomas están en Idiomas y textos.

   Revisa al menos el idioma, los precios (Config.Prices) y quién es admin (Config.AdminAces). Todo lo demás funciona con los valores de fábrica. Ver la Referencia de la config.

   Con un pack de caras: la config viene solo con las caras del juego (0 a 45). Pon en Config.ShapeMax la última cara del pack y agrega sus caras de hombre y de mujer a Config.FaceRanges (pregúntale al que vende el pack qué números son de hombre y cuáles de mujer). Hasta entonces sus caras no aparecen en Padres ni en las fotos de Caras del panel. Ver Packs de caras. La cabeza invisible del estudio de fotos no necesita nada para un pack de caras.

   Con un pack de ojos: no hay nada que poner. La barbería y el creador muestran los ojos que tiene cargados el juego de cada jugador, también los de tu pack. Ver Barbería: packs de ojos.

   La altura del personaje viene apagada de fábrica (Config.Height.enabled = false). Para usarla, ver Altura del personaje.

7. Arranca el servidor y lee la consola

   Al arrancar, la consola dice qué framework encontró:

   [zaiders_appearance] framework: qb

   Dice qb (QBCore), qbx (Qbox), esx o none. Si falta algo (una tabla, el framework, oxmysql) o hay un valor mal escrito en la config, lo dice en el mismo lugar. Ver Qué dice la consola.

8. Entra una vez con un admin

   El servidor aprende qué prenda hay detrás de cada número con el juego de un admin, la primera vez que hay un admin conectado. Hazlo después de instalar, y de nuevo cada vez que agregues o saques un pack de ropa. Mientras tanto, las prendas solo para un trabajo, un grupo VIP o sin stock se reconocen por lo que informa el juego de cada jugador. Ver Lo que revisa el servidor.

9. Pruébalo

   • Entra a una tienda de ropa del mapa y presiona E.
   • Escribe /zappearance panel para abrir ZAIDERS Studio, el panel de admin.
   • Crea un personaje nuevo: el creador se abre solo.

   El menú muestra un dibujo de cada prenda hasta que saques las fotos del catálogo. Ver Fotos del catálogo.

Qué dice la consola

Todas estas líneas empiezan con [zaiders_appearance]. La consola habla en el idioma de Config.Locale; acá se muestran en inglés, el idioma de fábrica.

Mensaje	Qué hacer
framework: none	No encontró tu framework. Arráncalo antes que ZAIDERS Appearance, o elige uno a mano en Config.Framework ('qb', 'qbx' o 'esx').
QBCore, Qbox or ESX not found (...)	Lo mismo que arriba. El menú funciona, pero no se cobra ni se guarda nada.
oxmysql is missing: without a database nothing is saved.	Agrega ensure oxmysql antes del recurso.
tables missing in the database: ...	Ejecuta Appearancez.sql en la base del servidor.
the users table has no skin column ...	Solo ESX. Ejecuta el ALTER TABLE que muestra (normalmente esx_skin agrega esa columna).
these tables of the resource are not utf8mb4 ...	Los nombres con emojis o de otros alfabetos no se guardarían. Ejecuta el ALTER TABLE ... CONVERT TO CHARACTER SET utf8mb4; que muestra para cada tabla.
config.lua: N values were fixed at start ...	Hay un valor faltante o mal escrito en config.lua. El menú lo corrige y sigue funcionando, y las líneas siguientes explican cada arreglo. Ver Cómo se revisa la config.
... no longer exists in this version: it is ignored (you can delete it from config.lua).	Una opción que una versión nueva sacó. Borra esa línea cuando quieras.
the language changed from 'es' to 'en' (Config.Locale) ...	Cambiaste Config.Locale. Las tiendas con el nombre que les dio el juego o el panel toman el idioma nuevo. Ver Idiomas y textos.
There are N outfits or uniforms from another clothing menu to bring ...	Opcional. Ver Si vienes de otro menú.
Tattoos from another clothing menu inside ...: N characters ... To bring them: zappearance_migrate tattoos confirm	En ESX con esx_skin, ejecuta ese comando una vez. En los demás pasan solos. Ver Si vienes de otro menú.
... handles the tattoos: this menu's tattoo shop is off and the tattoo sync stays on ...	Está prendido un recurso de tatuajes de Config.Tattoos.owners. Es lo esperado si lo usas. Ver Tienda de tatuajes.
OneSync is off: other players see the tattoos the game sends ... o OneSync is in legacy mode ...	Prende OneSync (no legacy) para que los demás vean los tatuajes de cada uno con sus capas.
You lack the required entitlement	La clave de licencia no es de la cuenta dueña del asset. Ver Asset Escrow y la ropa.

Después de instalar

Escrow y archivos editablesQué puedes cambiar, y dónde.Referencia de la configCada opción, su valor de fábrica y qué hace.Fotos del catálogoFotografía tu ropa desde el panel de admin.