Sigue estos pasos en orden para dejar la selección de personajes funcionando sin romper lo que ya tienes.

Comprueba las dependencias

Estos recursos tienen que estar instalados y funcionando antes de empezar:

• OneSync activado
• ox_lib
• oxmysql
• cuxial_bridge
• Un framework soportado: QBox o QBCore

Cuxial Multichar requiere QBox o QBCore.

Los recursos opcionales (cuxial_emotes, cuxial_license, cuxial_garages, av_weather, qbx_properties) se detectan solos. Si faltan, no se rompe nada.

El recurso de apariencia también es opcional. Cuxial Multichar usa cuxial_appearance y, si no está en marcha, illenium-appearance. Con cualquiera de los dos se ve el aspecto del personaje en la escena y se abre el creador al crear uno nuevo. Con illenium-appearance, el aspecto se lee de la tabla playerskins (fila con active = 1).

Sin recurso de apariencia, el personaje se ve con el cuerpo base (modelo por defecto según el género) y no se abre ningún creador al crear personaje.

No arranques otra selección de personajes ni otra pantalla de carga a la vez. Cuxial Multichar trae su propia pantalla de carga y se encarga del inicio de sesión del personaje.

Copia el recurso

Coloca la carpeta cuxial_multichar dentro de tu directorio resources. No le cambies el nombre.

La interfaz ya viene compilada en web/build. No hay que compilar nada.

Base de datos

No hay nada que importar. La tabla cuxial_family (personajes menores) se crea sola cuando el recurso arranca con family.enabled = true, y las columnas que falten se añaden en las actualizaciones.

Si prefieres crearla a mano, el archivo está en install/cuxial_family.sql.

Objetos iniciales

Los personajes nuevos reciben los objetos de la lista starterItems. Por defecto: phone, id_card y driver_license.

Asegúrate de que esos objetos existen en tu inventario, o edita la lista en shared/config.lua. Si un objeto no existe, la consola del servidor lo avisa al arrancar.

Convars

Añade a tu server.cfg las que necesites. Todas son opcionales.

server.cfg

# Huecos extra de personaje por rol de Discord
set cuxial_multichar_discord_token "TU_TOKEN_AQUI"
set cuxial_multichar_discord_guild "ID_DE_TU_SERVIDOR_DE_DISCORD"

# Registros en Discord
set cuxial_multichar_webhook "TU_WEBHOOK_AQUI"

Convar	Para qué sirve
cuxial_multichar_discord_token	Token del bot de Discord que lee los roles de cada jugador
cuxial_multichar_discord_guild	ID de tu servidor de Discord
cuxial_multichar_webhook	Webhook de Discord que recibe los registros
cuxial_multichar_debug	1 muestra mensajes de depuración en la consola del servidor. Para verlos también en la consola del cliente, usa debug = true en el config

El token del bot es secreto. Define estas convars con set, nunca con setr: setr replica el valor a todos los clientes conectados, y cualquiera podría leer tu token. No pegues el token en el config, en capturas ni en un repositorio público. Si se filtra, regenéralo de inmediato en el Discord Developer Portal.

El idioma de la interfaz es el de ox_lib. Se cambia con setr ox:locale es (o en).

Huecos por Discord (opcional)

Sáltate este paso si todos los jugadores tienen el mismo número de personajes.

1. Crea un bot en el Discord Developer Portal e invítalo a tu servidor de Discord.
2. Pon su token y el ID de tu servidor en las convars del paso anterior.
3. Activa la función y añade tus roles en shared/config.lua:

shared/config.lua

discordSlots = {
    enabled = true,
    roles = {
        { id = '123456789012345678', slots = 5 },
    },
    users = {
        ['123456789012345678'] = 4,
    },
},

Los huecos por ID de usuario (users) funcionan sin el bot y sin las convars. Más detalle en Configuración.

Orden de arranque

Arranca Cuxial Multichar después de sus dependencias.

server.cfg

ensure oxmysql
ensure ox_lib
ensure qbx_core            # o qb-core
ensure ox_inventory        # o qb-inventory
ensure cuxial_bridge

# Apariencia (opcional): uno de los dos
ensure cuxial_appearance   # o illenium-appearance

# Opcionales
ensure cuxial_emotes
ensure cuxial_license
ensure cuxial_garages

ensure cuxial_multichar

Comprobación final

1. Reinicia el servidor y conéctate.
2. Aparece la pantalla de carga y termina en un botón de comenzar.
3. Se abre la selección con tus personajes, o el formulario de creación si no tienes ninguno.
4. Crea un personaje: pasas por el creador de apariencia (si tienes un recurso de apariencia) y apareces con los objetos iniciales.

Si algo falla, mira Problemas frecuentes.