Comandos#
Waypoint registra un comando para los jugadores y uno de diagnóstico. Ambos se ejecutan en el propio cliente del jugador, así que ninguno necesita permiso.
Comando | Dónde | Descripción |
|---|---|---|
| En el juego | Abre el Waypoint Creator, o lo cierra si ya está abierto. La palabra es |
| En el juego / F8 | Imprime por qué la ruta actual se ve como se ve. Ver más abajo. |
La tecla#
El creador también está registrado en los ajustes de teclas de FiveM como Waypoint creator, en Settings → Key Bindings → FiveM. Config.Keybind define la tecla con la que empieza — por ejemplo "F7". Si se deja vacío, empieza sin asignar y cada jugador elige la suya.
FiveM recuerda la asignación de cada jugador.
Config.Keybindsolo es el valor por defecto para los jugadores que nunca han visto la asignación — cambiarlo más tarde no mueve la tecla de los jugadores que ya tienen una.
Cómo leer waypointdebug#
Marca un waypoint, conduce hacia él y ejecuta el comando. Cada comprobación de seguridad de la ruta solo puede quitar flechas, así que cuando el rastro es más corto de lo esperado, el número grande es el que lo explica:
Línea | Significa |
|---|---|
| Si el icono se cargó. |
| Cuántos puntos se están dibujando, si el perfil activo tiene la ruta activada y qué preset se está ejecutando. |
| La ruta solo existe entre 40 m y 4 km (3 km en modo rendimiento). |
| De cuántos puntos de carretera se construyó la ruta. Casi cero significa que no hay carretera que seguir desde donde está el jugador. |
| Cuántas flechas podría haber tenido la ruta. |
| Flechas que habrían caído en un tejado, el tablero de un puente o el techo de un túnel. |
| Flechas fuera del asfalto. Cero con los ajustes de serie. |
| Flechas detrás de una pared. Cero con los ajustes de serie. |
| Flechas en la ruta final, y cuál es la más cercana al jugador. |
Exports de cliente#
Para marcar puntos desde tus propios scripts — un trabajo de reparto, una llamada de dispatch, una misión, una búsqueda del tesoro — y para cambiar el estilo del jugador. Los seis son de cliente y devuelven el resultado al instante. Desde el servidor, dispara un evento de cliente y llámalos allí; consulta Integraciones para ver ejemplos completos.
AddWaypoint
local ok = exports['qs-waypoint']:AddWaypoint(id, coords, options)
-- In the player's own style
exports['qs-waypoint']:AddWaypoint('mytaxi:pickup', vector3(215.8, -810.1, 30.7))
-- With a label over the icon and a colour of its own
exports['qs-waypoint']:AddWaypoint('mytaxi:pickup', vector3(215.8, -810.1, 30.7), {
label = 'Customer',
style = { color = { 250, 204, 21 }, markerColor = { 250, 204, 21 } },
})Marca un punto hasta que se elimina. Devuelve true, o false cuando falta el id o las coordenadas no tienen x, y y z.
Argumento | Tipo | Descripción |
|---|---|---|
| string o number | Tu nombre para el punto, que se usa para eliminarlo. Añadir con un id que ya existe reemplaza ese punto. |
|
| Dónde dibujarlo. La z se usa tal cual, así que pasa la altura del suelo. |
| string, opcional | Texto dibujado sobre el icono mientras el destino está en pantalla. |
| table, opcional | Cualquier campo de la Referencia de estilos, combinado sobre el estilo activo del jugador solo para este punto. El icono en sí no se puede cambiar por punto. |
La forma 1.x { color = { r, g, b, a } } se sigue aceptando: colorea el icono y el marcador y usa el cuarto valor como opacidad.
RemoveWaypoint · ClearWaypoints
-- One point. true if it existed, false if there was nothing with that id
local removed = exports['qs-waypoint']:RemoveWaypoint('mytaxi:pickup')
-- Every point added through the exports, by any resource. Always true
exports['qs-waypoint']:ClearWaypoints()Ninguno de los dos toca el waypoint del mapa del propio jugador. ClearWaypoints elimina los puntos de todos los recursos, no solo los tuyos — mejor elimina tus propios ids.
GetWaypoints
local points = exports['qs-waypoint']:GetWaypoints()
for id, point in pairs(points) do
print(id, point.coords, point.label)
endUna copia de cada punto añadido mediante los exports, indexada por id, cada uno con su coords y label. Cambiar la copia no cambia nada en pantalla. El waypoint del mapa del jugador no se incluye.
SetProfile · GetProfiles
-- Every saved profile of this player: { { id = 'p…', name = 'Default' }, … }
local profiles = exports['qs-waypoint']:GetProfiles()
-- Make one active, by name or by id. false if the player has none by that name
local switched = exports['qs-waypoint']:SetProfile('Police')El cambio se guarda, exactamente como si el jugador hubiera hecho clic en el perfil en el creador, y cada punto en pantalla adopta el nuevo estilo al instante. Los nombres deben coincidir exactamente, mayúsculas incluidas.
Sobre los exports de servidor#
No hay ninguno, a propósito. Waypoint dibuja en la pantalla de cada jugador, así que un script de servidor decide qué marcar y se lo indica al cliente de ese jugador con TriggerClientEvent, que luego llama a los exports anteriores. Waypoint no emite eventos propios ni los necesita.