Instalación

Instalarlo lleva unos diez minutos: copiar dos 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 dos carpetas

   Pon zaiders_appearance y zaiders_fotos 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_fotos.

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_fotos primero:

   ensure ox_lib
   ensure oxmysql
   ensure qb-core              # o qbx_core, o es_extended
   
   ensure zaiders_fotos
   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. 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.

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.
There are N outfits or uniforms from another clothing menu to bring ...	Opcional. Ver Si vienes de otro menú.
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.