Lo que falla con más frecuencia, qué significa realmente y qué hacer al respecto. La mayoría de estos casos son un ajuste haciendo exactamente lo que se le indicó — el comando waypointdebug y la consola F8 suelen decir cuál.
Instalación y el creador#
No se dibuja nada cuando marco un waypoint
Comprueba, en este orden:
El recurso está iniciado:
ensure qs-waypointenserver.cfg, y la carpeta se sigue llamandoqs-waypoint.El jugador no lo ha desactivado:
/waypoint→ General → Waypoint marker. La vista previa muestra entonces Waypoint disabled.Config.OnlyInVehiclesestruey el jugador va a pie.El Visibility del perfil lo oculta: Hide when closer than es mayor que la distancia, o Maximum distance es menor.
La consola F8 muestra
[qs-waypoint] the icon page did not load— consulta la siguiente entrada.
"the icon page did not load; markers will not be drawn"
El icono es una pequeña página dentro del recurso, y el juego no pudo abrirla en los diez segundos posteriores al arranque. Casi siempre falta la carpeta web/build o está incompleta — una subida parcial por FTP, o archivos eliminados por un antivirus. Descarga de nuevo el recurso desde el CFX Portal y reemplaza la carpeta entera. Mientras tanto, el marcador del mundo, el anillo y el haz siguen funcionando; solo faltan el icono y el indicador de borde.
/waypoint no hace nada
O bien Config.Command está vacío o tiene otra palabra, o bien otro recurso también registra /waypoint y gana. Cambia Config.Command a una palabra que no use nada más, como "wpcreator", y reinicia el recurso.
Cambié Config.Keybind y la tecla no cambió
Es el comportamiento correcto. FiveM guarda las asignaciones de teclas de cada jugador, y el valor de la config solo es la tecla inicial para los jugadores que nunca han tenido la asignación. Los jugadores que ya la tienen la cambian ellos mismos en Settings → Key Bindings → FiveM → Waypoint creator.
Cambié el estilo por defecto y los jugadores siguen viendo el antiguo
Es el comportamiento correcto. Config.DefaultStyle solo es el punto de partida. Los jugadores que ya entraron tienen sus perfiles guardados en su propia computadora, y nunca se sobrescriben desde el servidor. El nuevo estilo llega a los jugadores nuevos, a los perfiles nuevos y a quien pulse Reset. Para dar un nuevo aspecto a una comunidad existente, expórtalo desde el creador y comparte el código.
Los jugadores perdieron sus estilos
Los estilos se guardan en la computadora de cada jugador con el nombre del recurso. Se pierden cuando:
Se renombró la carpeta del recurso. Vuelve a llamarla
qs-waypointy los estilos regresan.El jugador entró desde otra computadora, o borró la caché y los datos de FiveM.
Config.MaxProfilesse redujo — los perfiles por encima del nuevo límite se descartan.
La ruta#
No hay flechas en el suelo
Show the route está desactivado en el perfil activo.
El destino está a menos de 40 m o a más de 4 km (3 km en modo rendimiento). Las flechas aparecen solas en cuanto se está dentro de ese rango.
No hay carretera que seguir: el jugador está fuera de la carretera, en el agua, dentro de un interior o en el aire. La ruta recorre la red de carreteras y empieza en la carretera más cercana.
Trail length es muy corto, o Trail opacity muy baja.
Ejecuta waypointdebug: imprime la distancia, si la ruta está activada y cuántos puntos de carretera encontró.
La ruta toma un camino más largo, o se detiene antes del destino
El rastro se construye paso a paso por las carreteras, tomando siempre el siguiente punto de carretera que se acerca más — una guía de calles, no un GPS completo. En un enlace grande puede elegir un camino más largo o detenerse antes, y se reconstruye mientras el jugador conduce, así que se corrige solo en unos segundos. Si pasa a menudo, configura Config.PerformanceMode = false: el preset preciso pide al juego distancias reales de conducción en los cruces y elige giros mucho mejores.
Las flechas desaparecen bajo un puente o en un túnel
A propósito. Donde el suelo encontrado sobre la carretera es el tablero de un puente, un tejado o el techo de un túnel en lugar de la propia carretera, la flecha se omite en vez de dibujarse flotando en el sitio equivocado. El rastro continúa al otro lado. waypointdebug las cuenta como dropped, off the ground line.
La ruta lleva al waypoint de mi mapa, no al punto del trabajo
Hay un solo rastro a la vez, y el waypoint del mapa tiene prioridad. El punto del trabajo se sigue dibujando con su icono y su marcador. Para trazar la ruta hacia él, el jugador quita su waypoint del mapa — o el trabajo marca él mismo el waypoint del mapa con SetNewWaypoint, como se describe en Integraciones.
Iconos y marcadores#
El marcador 3D no se ve desde lejos
Es un límite del juego, no del script: GTA solo dibuja marcadores 3D a unos pocos cientos de metros, sea cual sea su tamaño. Desde más lejos, el icono muestra el camino. Para algo visible por encima de la ciudad, activa el Light beam y aumenta su altura.
El indicador de borde no aparece
Show at the screen edge está desactivado en el perfil, o el destino está justo fuera del borde de la pantalla. El indicador aparece cuando el destino está a más de 45° de donde mira la cámara, así que girar un poco más lo hace aparecer.
Un script pidió otro icono y recibió el del jugador
Es el comportamiento correcto. Cada waypoint usa el icono del perfil activo del jugador; AddWaypoint puede cambiar su color, su tamaño y todo lo demás, pero no el dibujo en sí. Usa el color para distinguir los puntos.
Un waypoint de un script nunca desaparece
Los puntos añadidos con AddWaypoint permanecen hasta que el script que los añadió llama a RemoveWaypoint con el mismo id — llegar no los elimina. Comprueba que el script elimine su punto al llegar y al cancelar. Un jugador que se quede con uno se libera reconectándose.
Compartir estilos#
"That code could not be read"
El código se cortó al copiarlo, o se copió con texto extra alrededor. Vuelve a copiarlo entero — al hacer clic en el cuadro Export se selecciona todo — y pégalo solo. Los códigos empiezan por QSWP1:; los códigos de otros scripts no son compatibles.
Importar no hace nada
El jugador está en el límite de perfiles — la ventana Share muestra Profile limit reached. Borra un perfil, o aumenta Config.MaxProfiles, e importa de nuevo.
¿Sigues con problemas? Abre un ticket e incluye la salida de
waypointdebug, cualquier línea[qs-waypoint]de la consola F8, tuconfig.luay los pasos que reproducen el problema.