La mayoría de los problemas con Multicharacter vienen de otro recurso que hace el mismo trabajo — un segundo menú de personajes, un segundo script de apariencia, un script de spawn — o del orden de carga. Cada mensaje de abajo se muestra exactamente como aparece en la consola del servidor o en F8, así que busca en esta página el texto que ves. Activa Config.Debug para obtener un log paso a paso de la entrada al servidor.
Instalación y arranque#
"No framework found, please ensure you have qs-core, es_extended, qb-core, or qbx_core installed"
Multicharacter se inició antes que tu framework. Mueve ensure qs-multicharacter debajo del framework en server.cfg, o comprueba que el propio framework arrancó sin errores.
"Both es_extended and qbx_core are started; using the esx adapter"
Hay dos frameworks en ejecución — normalmente un puente de compatibilidad. Si el adaptador elegido es incorrecto, fuerza el correcto con Config.FrameworkOverride = 'qb' (o 'esx', 'qs').
Un aviso sobre @qb-apartments/config.lua en ESX
El manifiesto carga la config de qb-apartments para servidores QB. En ESX o qs-core, comenta '@qb-apartments/config.lua' en fxmanifest.lua.
"Failed to get database name from mysql_connection_string convar"
Multicharacter lee el nombre de la base de datos de la cadena de conexión para limpiar los personajes borrados. Usa la forma URI (mysql://user:pass@host/database) o la forma de claves con database=, como en la guía de oxmysql.
La pantalla de carga nunca termina, o el menú es invisible
Si la consola imprime The multicharacter UI has not initialised after 120000 ms seguido de Still waiting for the multicharacter UI, la interfaz no se pudo cargar. Comprueba que la carpeta se llame exactamente qs-multicharacter, que se haya subido el recurso completo (incluido web/) y abre F8 para ver errores de qs-multicharacter.
Frameworks#
"[esx] Config.Multichar is not true"
ESX no cambió al modo multipersonaje. En ESX 1.9 y posteriores, la carpeta qs-multicharacter debe existir cuando es_extended arranca — comprueba el nombre de la carpeta y que se haya quitado esx_multicharacter. En ESX v1 pon Config.Multichar = true en es_extended/config.lua.
"[qb] qbx_core characters.useExternalCharacters must be true"
Qbox sigue abriendo su propio menú de personajes. Pon useExternalCharacters = true dentro de characters en qbx_core/config/client.lua y reinicia.
Se abren dos menús en QBCore, o qb-spawn aparece después del selector
Quita qb-multicharacter, y quita qb-spawn mientras Config.EnableDefaultSpawnSelector = true. En Qbox, comenta el trigger CreateFirstCharacter en qbx_properties y qbx_core si el creador de ropa se abre dos veces.
Un personaje de QB desapareció al cambiar desde qb-multicharacter
qb-multicharacter numera los slots desde 1; Multicharacter desde 0, con cuatro slots (cid 0–3) por defecto. Un personaje con cid 4 no tiene sitio y se omite:
[qb] Skipping character cid 4 (citizenid ABC12345) — no Config.CharacterPositions entry. QB slots stay 0-based.Añade un quinto slot (consulta Añadir más slots) o cambia el cid de ese personaje en la tabla players a un slot libre.
"Character creation timed out" en ESX
esx_identity no respondió. En versiones antiguas de esx_identity pon Config.UseDeferrals = false en su config para que exista el callback de registro, o aumenta Config.ESXIdentityTimeoutMs si la base de datos es lenta.
"Character skin is missing for character" en ESX
Una fila de users no tiene skin — normalmente un personaje que nunca se terminó. Borra esa fila a mano, o activa Config.WipeIfThereIsNoData = true para borrar esas filas automáticamente. Esa opción elimina datos — haz una copia de seguridad antes.
Apariencia y ropa#
"Multiple appearance resources detected"
Hay dos scripts de apariencia iniciados — por ejemplo qs-appearance y esx_skin. Deja uno y quita la línea ensure del otro. El mensaje nombra a ambos.
"No appearance found"
Ninguno de los scripts de apariencia compatibles se inició antes que Multicharacter. Haz su ensure antes en server.cfg.
ESX: errores sobre esx_skin o skinchanger con qs-appearance
Los scripts antiguos de ESX dependen de esx_skin y skinchanger. Quita todas las referencias a ellos de tus manifiestos, o deja que qs-appearance los sustituya añadiendo esto al final de qs-appearance/fxmanifest.lua:
provides { 'esx_skin', 'skinchanger' }Ropa incorrecta con illenium-appearance
Abre illenium-appearance/fxmanifest.lua y quita provides { 'esx_skin', 'skin_changer' } si está presente, quita cualquier dependencies { 'esx_skin', 'skin_changer' } de tus otros scripts, luego borra la caché del servidor y reinicia.
"Failed to load model. This not a script ERROR!"
Un modelo de ped de tu pack de ropa no se pudo cargar — normalmente un pack hecho para una build más nueva del juego. Prueba sv_enforceGameBuild 3095 o posterior. Cuando sepas la causa, Config.DisableLoadModelLoopError = true evita que el mensaje se repita.
"Export missing, please update rcore_clothing to latest version."
Tu rcore_clothing es demasiado antiguo para la integración. Actualízalo desde el portal de Cfx.re.
Selección y spawn#
Entradas lentas: "showing the scene with what is ready"
Mensajes como Some selection peds were still streaming after N ms o playerSpawned did not arrive within N ms significan que la PC del jugador o tu servidor necesitaron más tiempo del que permiten los límites. La entrada continúa; en servidores con packs de ropa pesados, aumenta los tiempos de espera listados en Rendimiento y tiempos de espera.
"This slot already has a character. The list has been refreshed."
El jugador intentó crear un personaje en un slot ya ocupado — normalmente tras un doble clic o un menú desactualizado. La lista se recarga; elige un slot vacío.
"You are unconscious, you must respawn at the last location."
El personaje cerró sesión muerto, y Config.DeathOnlyLastLocation impide que escape reconectándose. Ponlo en false para permitir cualquier spawn.
"No spawn location is available for this character, using Config.Spawn"
Todas las entradas de Config.SpawnLocations tienen un filtro jobs que el personaje no cumple. Deja al menos una entrada sin jobs.
Los personajes nuevos de QB no pueden elegir apartamento
La consola imprime Missing the apps table so probably you have not set up the qb-apartments. Asegúrate de que qb-apartments se inicie antes que Multicharacter y de que la línea @qb-apartments/config.lua del manifiesto no esté comentada.
"The spawn selector camera was destroyed from outside"
Otro recurso — a menudo un tutorial que se cierra tarde — eliminó la cámara del selector. Multicharacter la reconstruye por sí solo; el mensaje es informativo.
No hay música de fondo
Config.Music reproduce web/sounds/background.mp3, que debes aportar tú. Añade el archivo, o usa la música de YouTube configurada en Config.YouTubeMusicUrl.
Slots y Tebex#
"You have enabled tebex in your character positions but you have not set your TEBEX_SECRET convar"
Un slot tiene tebex = true pero sv_tebexSecret no está en server.cfg. Añádelo para vender slots, o ignóralo si solo das slots con /addslot [server id] (el mensaje dice /giveslot; el comando es /addslot).
"The first slot cannot be managed by tebex"
Config.CharacterPositions[0] tiene tebex = true. El slot 0 siempre es gratis; ponlo en false.
Se rechaza un ID de transacción válido
Comprueba que sv_tebexSecret pertenezca a la misma tienda en la que compró el jugador, que el pago esté completado en Tebex y que el ID empiece por tbx-. Un ID solo se puede canjear una vez, y You have reached the maximum number of slots significa que todos los slots bloqueados ya están abiertos.
Un slot mensual nunca se bloquea tras cancelar
Su ID de paquete no está en Config.TebexAccess.SubscriptionPackageIds, así que se trató como una compra única. Añade el ID; los slots comprados antes siguen siendo permanentes.
"You do not have permission to do this." con /addslot
Tu cuenta no es administradora en tu framework. Consulta Quién cuenta como administrador. En ESX, ejecuta el comando en el juego y no desde la consola del servidor.
¿Sigues con problemas? Activa
Config.Debug, reproduce el problema y abre un ticket con la salida de la consola del servidor y de F8 de la entrada al servidor.