Casi todos los fallos vienen de una dependencia que falta, del orden de arranque o de una convar. Mira primero la consola del servidor: el recurso avisa de lo que está mal.
El recurso no arranca
Causa. Falta una dependencia obligatoria o arranca después: OneSync, ox_lib, oxmysql o cuxial_bridge.
Solución. Activa OneSync y arranca esos recursos antes que cuxial_multichar. Tienes el orden en Instalación.
La selección se abre pero no se puede entrar ni crear ningún personaje
Causa. El framework no se ha detectado. Cuxial Multichar requiere QBox o QBCore.
Solución. Arranca tu framework antes que cuxial_bridge, y cuxial_bridge antes que cuxial_multichar.
El personaje sale con el cuerpo base o no se abre el creador
Causa. No hay ningún recurso de apariencia compatible en marcha. Cuxial Multichar usa cuxial_appearance y, si no está en marcha, illenium-appearance. Con apartamentos iniciales en uso, este script tampoco abre el creador.
Solución. Arranca uno de los dos antes que cuxial_multichar. Con illenium-appearance, el aspecto sale de la tabla playerskins: el personaje necesita una fila con active = 1.
Pantalla negra o vacía en lugar de la selección
Causa. Falta la carpeta web/build o está incompleta, o hay otro recurso de pantalla de carga en marcha.
Solución. Vuelve a subir el recurso con su carpeta web/build completa y quita cualquier otra pantalla de carga de tu server.cfg.
Los roles de Discord no dan huecos extra
Causa. Una de estas:
discordSlots.enabledestá enfalse.- Faltan las convars. La consola avisa de que los huecos por Discord están activos pero faltan las convars del bot o del servidor.
- El bot no está en tu servidor de Discord, o el token es incorrecto. La consola muestra el código de estado con el que respondió Discord.
- El jugador no tiene Discord vinculado a FiveM.
- El ID del rol es incorrecto, o
characters.maxSlotses menor que los huecos del rol.
Solución. Revisa cada punto. Los cambios de rol tardan hasta discordSlots.cacheMinutes en aplicarse, o hasta que el jugador se reconecta.
Los huecos extra desaparecen de vez en cuando
Causa. Discord no contestó dentro de discordSlots.timeoutMs. El jugador recibe los huecos base, y la consulta se repite un minuto después.
Solución. Sube discordSlots.timeoutMs. A los usuarios importantes añádelos en discordSlots.users, que no depende de que Discord conteste.
Los personajes nuevos aparecen sin objetos
Causa. Un objeto inicial no existe en tu inventario, o el inventario no cargó a tiempo. La consola indica el objeto o el jugador.
Solución. Crea los objetos o edita starterItems en el config.
No aparece el carné al crear un personaje
Causa. El recurso indicado en idCard.resource no está en marcha, o no tiene carné para idCard.item.
Solución. Arranca ese recurso antes que cuxial_multichar, o pon idCard.enabled = false.
No sale la opción de vehículo en la selección
Causa. El recurso indicado en vehicles.resource no está en marcha, o el personaje no tiene ningún coche ni moto.
Solución. Arranca ese recurso, o pon vehicles.enabled = false para ocultar la función.
Los personajes se quedan quietos, sin emote
Causa. cuxial_emotes no está en marcha. La escena recurre a scene.fallbackScenario.
Solución. Arranca cuxial_emotes, o usa ubicaciones con emote = { scenario = '...' }.
No se puede jugar con un personaje menor
Causa. La solicitud sigue pendiente, o fue rechazada o revocada. Los menores necesitan la aprobación del staff antes de aparecer por primera vez.
Solución. Revisa la solicitud con los exports.
No llegan registros a Discord
Causa. La convar cuxial_multichar_webhook está vacía, logs.enabled está en false, o el webhook se ha borrado. La consola muestra el código de estado cuando el webhook rechaza un mensaje.
Solución. Define la convar con set y reinicia el recurso.
El HUD sigue visible en la selección
Causa. La función hud del config está vacía o falla. Si falla, se avisa en la consola del cliente.
Solución. Llama al export de tu HUD dentro de hud = function(visible) ... end.
Los comandos de staff responden que no tienes permiso
Causa. El jugador no pertenece al grupo indicado en restricted.
Solución. Añade al jugador a ese grupo con add_principal. Mira Comandos y permisos.
