Lo que falla con más frecuencia, qué significa realmente y qué hacer al respecto. La mayoría son cuestiones de configuración, no fallos, y la consola del servidor y la consola F8 suelen decir exactamente cuál. Léelas antes de abrir un ticket.
Instalación y acceso#
ESC sigue abriendo el menú de pausa de GTA
Escribe primero /pausemenu. Abre el mismo menú sin el hook de ESC, así que te dice en una pulsación si el problema es el menú o solo su activación. Si /pausemenu funciona, comprueba que Config.Menu.replacePauseMenu está en true y que ningún otro recurso se apropia también de ESC.
Veo el menú de GTA durante una fracción de segundo
No hay nada que arreglar. ESC no pasa por el sistema de controles de FiveM: el juego abre su menú de pausa por sí solo, así que vigilarlo y cerrarlo es el único enfoque que funciona. Eso cuesta un fotograma, y es igual para cualquier reemplazo del menú de pausa.
"The interface is still loading, try again in a second"
Es normal durante los primeros segundos tras entrar, mientras carga la página. Si nunca desaparece y la consola F8 dice the menu never mounted — releasing NUI focus, el recurso se copió de forma incompleta: la interfaz viene ya compilada dentro de la carpeta, así que vuelve a copiar la carpeta qs-pausemenu completa desde tu descarga y reiníciala.
"You are not allowed to open the pause menu creator"
No se ha concedido ninguna de las vías de permiso. Añade el ace command.pausecreator en server.cfg, o pon al jugador en un grupo indicado en Config.Creator.adminGroups; Dar acceso al creador tiene las líneas. Sin ningún framework, el ace es la única vía.
El permiso se comprueba una vez por sesión. Si lo concediste después de que el jugador ya lo intentara, tendrá que reconectarse.
La consola dice "no database resource found"
Ni oxmysql ni mysql-async estaban en ejecución cuando arrancó el recurso. Arranca uno de ellos por encima de ensure qs-pausemenu y reinicia. Hasta entonces el menú se sigue abriendo y muestra los temas incluidos, pero no se puede almacenar nada: ni temas, ni el tema activo, ni lugares guardados.
Dice "framework loaded: standalone" pero uso ESX o QBCore
El framework aún no estaba en ejecución cuando arrancó este recurso. Con Config.Framework = 'auto' la detección se vuelve a intentar unos segundos después y se activa el adaptador correcto; busca una segunda línea framework loaded. Si no la hay, mueve tu framework por encima de ensure qs-pausemenu, o fíjalo con Config.Framework = 'esx' (o 'qb', 'qs').
La tarjeta del jugador solo muestra el nombre, o faltan filas
Es intencionado. Un valor que el framework no puede proporcionar se deja vacío, y el módulo oculta esa fila en lugar de mostrar $0. En standalone se ocultan el dinero, el trabajo y la identidad. En ESX, el hambre, la sed y el estrés necesitan esx_status. Si falta un campo que tu framework sí tiene, su adaptador en custom/ es donde añadirlo.
"You cannot open the pause menu while you are down"
Comportamiento correcto: el menú no se abre mientras el jugador está muerto, así que no se puede usar para escapar de una pantalla de muerte.
Temas y el creador#
"Could not save the theme"
El servidor lo rechazó. Los motivos habituales:
El servidor ya tiene
Config.MaxThemes(50) temas. Borra uno o aumenta el límite.El tema supera los 512 KB; casi siempre por una imagen pegada como texto en lugar de elegida desde
images/o enlazada por URL.La base de datos no está en ejecución; consulta "no database resource found" arriba.
"Save the theme before setting it live"
El tema tiene cambios sin guardar. Pulsa Save y luego Set live; los jugadores solo reciben lo que está almacenado.
Los jugadores se quedan atrapados en el menú
El tema tiene Escape closes the menu desactivado y ningún módulo puede cerrarlo. Añade un botón con la acción Close the menu, o vuelve a activar el ajuste. Precisamente por eso el creador muestra una advertencia roja en su pestaña Settings.
Edité un tema incluido y el original ha desaparecido
Guardar un tema incluido conserva tu versión en su lugar en tu servidor. Borra tu versión guardada y vuelve el original. La próxima vez, pulsa primero Duplicate y edita la copia.
Se rechaza un código de tema importado
El código se cortó al copiarlo. Vuelve a copiarlo entero: empieza por QSPM1: y es una sola línea larga.
El tema Launch está en español
Así viene. Config.Language traduce el creador y las notificaciones, no las palabras dentro de un tema. Cada cadena de un tema es un módulo de texto, así que traducirlo es una pasada por el inspector; o parte de otro tema.
Un tema se ve distinto en algunos equipos
Usa una fuente que el recurso no incluye. Hackerman (Consolas) y Velvet (Georgia) son los dos ejemplos incluidos; ambos usan pilas de fuentes, así que un equipo sin la primera fuente acaba en algo parecido. Todo lo demás usa Poppins, que viene incluida.
El mapa, los blips y los lugares#
El mapa es solo una cuadrícula
El juego del jugador no puede contactar con los servidores de mapas de Rockstar. La cuadrícula de radar dibujada bajo las teselas es el respaldo, así que sigue teniendo un mapa usable con su propia escala. No hay nada que instalar por tu parte.
El mapa no se desplaza ni acepta clics
El modo radar está activado. Es solo de lectura por diseño: desplazar, hacer clic y el botón Realistic están desactivados mientras el mundo gira con el jugador. Desactívalo en el inspector del mapa.
La ruta es una línea recta discontinua
El juego no tiene ruta por carretera que dar: una isla, una azotea, mar abierto. La línea discontinua y la distancia en línea recta se dibujan distinto a propósito, para que una estimación nunca se confunda con una ruta. Si ocurre en una calle normal, marca un punto de ruta y ejecuta /pausemenuroute; la salida de F8 es lo que necesita soporte.
No hay blips en el mapa
Comprueba Config.Menu.showGameBlips. Los blips aparecen unos segundos después de abrir el menú. Los blips que un script configuró para mostrarse solo en el minimapa se omiten a propósito, igual que los omite el propio mapa de pausa de GTA; y una fila de la leyenda con el ojo cerrado oculta ese tipo de blip.
Los blips muestran el nombre del icono en lugar de su nombre real
No se pudo leer el nombre del juego. Comprueba que Config.Menu.readBlipNames está activado. Si la consola F8 dice que la lectura se paused until the next restart o switched off on this PC, el juego dejó de responder y el recurso se retiró por seguridad. En cualquier caso, la solución fiable es entregar tú los nombres: la línea del hook de blips en el recurso que crea los blips, el export SetBlipName, o Config.BlipNames; todo en Integraciones.
Un jugador no puede guardar más lugares
Ha alcanzado Config.Places.limit (30 por defecto). Borrar uno libera un hueco; editar uno existente nunca cuenta para el límite.
Los lugares que guardé al probar en el creador han desaparecido
Comportamiento correcto. Dentro del creador el panel funciona, pero los lugares viven en el borrador y no se escribe nada, así que probar la función nunca llena tu propio mapa. Guarda los lugares desde el menú real.
El botón Realistic no aparece
Uno de tres interruptores está desactivado: Config.RealisticMap.enabled en el servidor, Realistic button en el módulo de mapa de ese tema, o el mapa está en modo radar. El creador muestra un aviso en el inspector del mapa cuando el servidor lo tiene desactivado.
Multimedia y la foto del jugador#
Un vídeo muestra una pantalla negra
El archivo es un .mp4. El navegador de FiveM no incluye la licencia de H.264, así que el vídeo debe ser WebM (VP9):
ffmpeg -i in.mp4 -c:v libvpx-vp9 -crf 34 -b:v 0 -an out.webmUn vídeo dice que no se pudo cargar
El módulo sigue reintentando por debajo del mensaje y lo quita en cuanto el clip se reproduce, así que un fallo puntual no inutiliza el módulo durante la sesión. Si nunca se recupera, comprueba el nombre del archivo y que sea WebM.
Mis imágenes y vídeos no cargan en absoluto
Se renombró la carpeta del recurso. Los archivos multimedia se sirven desde https://cfx-nui-qs-pausemenu/, así que la carpeta debe llamarse qs-pausemenu.
Una imagen no se muestra
Solo los archivos .png, .jpg, .webp y .gif de images/ se envían a los jugadores. Un archivo .jpeg aparece en la lista del creador pero nunca llega; renómbralo a .jpg.
Un archivo que añadí no está en la lista del creador
Las carpetas se leen cuando arranca el recurso, y los archivos nuevos solo se envían a los jugadores tras un reinicio. Reinicia qs-pausemenu después de añadir archivos. Si la consola dice could not read images/ (io.readdir is missing on this server build), los artifacts de tu servidor son demasiado antiguos para listar carpetas: actualízalos, o escribe a mano la URL del archivo en el creador.
Los jugadores tardan mucho en conectarse
Archivos demasiado grandes en images/ o videos/. Todo lo que hay en esas carpetas lo descarga cada jugador al entrar, así que mantén los archivos con un tamaño acorde a lo que son. El mapa del mundo no entra aquí: se transmite desde Rockstar.
La foto del jugador no aparece
Una URL de avatar configurada en la tarjeta del jugador tiene prioridad sobre la foto; bórrala si quieres el retrato. Comprueba que Use the player's photo está activado en esa tarjeta y que Config.Mugshot.enabled está en true. La foto se toma unos segundos después de aparecer; si el juego no logra generarla, la tarjeta mantiene su icono.
Claves de error#
Cuando se rechaza el creador o un lugar guardado, el servidor responde con una de estas claves:
Clave | Significa |
|---|---|
| El jugador no puede usar el creador. |
| Demasiados temas ( |
| El tema supera los 512 KB. |
| No se pudo escribir en la base de datos. Revisa el driver y la consola. |
| El tema que se está borrando ya no existe. |
| Lo enviado estaba mal formado; normalmente un tema importado dañado. |
| El jugador no tiene identificador al que asociar los lugares: ni personaje del framework ni licencia de Rockstar. |
| El servidor no respondió a tiempo. Normalmente por una base de datos lenta o ausente. |
¿Sigues atascado? Abre un ticket e incluye las líneas
[qs-pausemenu]de la consola de tu servidor (sobre todoframework loadedystorage driver), una captura de la consola F8 y tu framework con su versión.