Lo que falla con más frecuencia, qué significa realmente y qué hacer al respecto. La mayoría se reduce al orden de carga, a la importación de la base de datos o a un ajuste en config/main.lua.
Instalación y acceso#
"You don't have permission to use /guitarcreator"
Al jugador le falta el ACE command.guitarcreator. Añade add_ace group.admin command.guitarcreator allow a server.cfg, asegúrate de que el jugador está en ese grupo y reinicia. El mismo permiso cubre /guitarmusic y /guitarprogress, salvo que les hayas dado uno propio en el config.
Las máquinas son invisibles, o "Model could not be loaded"
guitarpro-assets no está en ejecución, o se inicia después de qs-guitarpro. Inicia primero los assets. Si reemplazaste Config.MachineModel por tu propio prop, comprueba que el prop está en streaming y que el nombre está escrito exactamente igual.
La consola dice "framework: standalone" en un servidor ESX o QBCore
Tu framework se inició después de Guitar Pro, así que no se encontró. Lo notarás porque las máquinas son gratuitas y las clasificaciones muestran nombres de FiveM. Mueve ensure qs-guitarpro debajo de tu framework, o fuérzalo con Config.Framework = 'esx' (o 'qb').
Los jugadores pueden usar /guitarautoplay y los editores
Config.Debug.enabled sigue activado — viene activado para la configuración inicial. Ponlo en false y reinicia. Si se publicaron partidas con autoplay, las puntuaciones están en guitar_score y se pueden eliminar ahí.
Advertencias "Missing locale key" en la consola
Al idioma que elegiste le faltan algunas claves que sí tiene el inglés, normalmente después de que una actualización añadiera texto nuevo. Se muestran en inglés hasta que se traduzcan, lo cual es inofensivo. Copia las claves indicadas de locales/en.json a tu archivo de idioma para silenciarlas.
Canciones y charts#
Las 18 canciones incluidas dicen "not generated"
database/sql.sql nunca se importó, así que los charts incluidos no están en la base de datos. Impórtalo una vez y reinicia, o pulsa Generate en cada canción en /guitarmusic.
Una canción está en el gestor de música pero los jugadores no la ven
Los jugadores solo ven canciones que tienen un chart. Una canción marcada como not generated necesita que un administrador pulse Generate — en cuanto termina, aparece al instante para los jugadores en una máquina.
Añadí un mp3 y no aparece en /guitarmusic
Reinicia el recurso — la carpeta se escanea una vez al arrancar y los archivos nuevos solo se sirven tras un reinicio. Luego comprueba:
Que sea un mp3, ogg o wav, directamente en
songs/o una carpeta más abajo (songs/my_song/song.mp3).Que el nombre use solo letras, números,
_y-. Los demás nombres se cambian automáticamente cuando el recurso se detiene, así que un segundo reinicio los corrige.
El análisis falla en una pista
El overlay indica qué paso falló:
Mensaje | Qué hacer |
|---|---|
The audio file could not be read | El archivo aún no se está sirviendo. Reinicia el recurso y vuelve a intentarlo. |
Corrupt or not a supported format | Vuelve a exportarlo como mp3, ogg o wav. |
Too short / silent | El archivo está vacío o casi. Comprueba que se reproduce en un reproductor normal. |
No clear beat / tempo could not be tracked / too few usable beats | La pista no tiene una percusión constante a la que engancharse. El material ambient, rubato y en directo poco preciso no genera buenos charts: elige una canción con un ritmo más firme. |
"Another player is analyzing this song, try again shortly"
Solo una persona puede generar una canción a la vez. El bloqueo se libera cuando termina, o tras tres minutos si se desconectó a mitad.
Consola: "skipped N song(s) that play from the internet"
Esas canciones se añadieron en una versión anterior desde YouTube o un enlace, algo que ya no es compatible. Sus filas siguen en guitar_songs pero no se ofrecen. Para recuperar una pista, pon su archivo de audio en songs/, reinicia y genérala.
Consola: "stored beatmap is invalid, it will be regenerated"
El chart guardado para esa canción no se pudo leer, así que la canción se trata como no generada. Pulsa Generate en ella en /guitarmusic.
Las luces y los cortes de cámara no van al ritmo
El BPM de la canción es incorrecto — normalmente porque se escribió a mano. Ábrela en /guitarmusic y pulsa USE junto al tempo del chart para devolver el tempo al medido, o escribe el valor correcto con dos decimales.
Jugar#
Las notas llegan tarde o pronto
Config.Gameplay.audioOffsetMs. Viene con -90; un valor más negativo adelanta la sincronización. Se aplica a todo el servidor, no por jugador.
Las canciones son demasiado difíciles o demasiado fáciles
Config.Beatmap.difficulties define la densidad de cada chart y Config.Gameplay.judgments lo permisivas que son las ventanas de acierto. Un cambio de densidad solo afecta a los charts generados después — regenera las canciones que quieras recortar de nuevo. approachTimeMs hace que las notas viajen más lento o más rápido.
A los jugadores los abuchean y los echan del escenario una y otra vez
Suaviza Config.Gameplay.life — sube start, reduce miss y bad — o pon failEnabled = false para desactivar el fallo por completo.
Falta Duo o Versus, o "not available on this machine"
Ambos necesitan una máquina de dos pads, con el modo marcado en Game Modes en el creador — y un segundo jugador de pie en el otro pad.
Una partida no se guardó o no dio XP
Las partidas abandonadas nunca se guardan. Además, el servidor rechaza un resultado que no encaja con el chart — más notas de las que tiene, una puntuación por encima de su máximo o un final muy anterior a la duración de la canción — que es lo que produce un pico de lag o un cliente manipulado. Con Config.Debug.enabled activado, cada rechazo se imprime en la consola del servidor. La XP y los puntos también necesitan Config.Progression.enabled.
La guitarra queda mal colocada en el personaje
Ese prop necesita ajuste: /guitarplace machine <guitarId> para la máquina y /guitarplace stage <guitarId> para el escenario. Las guitarras incluidas ya están ajustadas; los props del juego base, como la High Roller, normalmente lo necesitan.
La hora o el clima saltan mientras se toca
Tu script de clima no es uno que Guitar Pro sepa pausar. Añade sus eventos de pausa y reanudación a applyStageTime en client/custom/main.lua, o pon Config.Stage.forceNight = false. Consulta Integraciones.
Un escenario que añadí no tiene público
La cámara funciona en cualquier lugar, pero el público se coloca por escenario. Colócate en el escenario, ejecuta /guitarcrowd, coloca a los espectadores y pega el bloque impreso en Config.Stage.crowd.spectators.
Mensajes para el jugador#
Qué significa cada mensaje que un jugador puede ver en una máquina. El texto viene de la sección notify de los archivos de idioma.
Mensaje | Significado |
|---|---|
This machine is full. | Todos los pads están ocupados. |
You are too far from the machine. | El servidor ve al jugador lejos de la máquina — o, en una máquina de arcade, el jugador no está en ese arcade. |
You do not have enough money to play. | El precio supera su efectivo o su banco. En Duo y Versus ambos jugadores deben poder pagarlo. |
Wait for the other player to finish their selection. | El otro pad está navegando por la lista de canciones; de uno en uno. |
The other player is busy right now. | Se envió una invitación mientras el otro pad está jugando o ya está invitado. |
This song is not ready yet. | La canción o la dificultad no tiene chart, o un administrador acaba de quitarle la generación. |
The game session has ended. | La máquina se editó, se eliminó o su arcade la quitó mientras estaba en uso, o el jugador se alejó. |
Your partner left the machine. | En Duo la canción sigue en solitario; en Versus gana el que se quedó. |
¿Sigues atascado? Abre un ticket e incluye las líneas
[qs-guitarpro]de la consola de tu servidor, la salida de la consola F8 del momento en que falló y el orden de carga de tuserver.cfg.