Saltar al contenido

Black Friday: 20 % de descuento hasta el 30 novPacks de servidor

RPScripts

Markers de FiveM: tipos de marker y cómo usar DrawMarker

Por Luke, RPScripts

En esta página

Un marker de FiveM es una forma 3D dibujada en el mundo del juego con el native DrawMarker, como el cilindro que indica dónde colocarte para abrir un garaje o una tienda. Los markers no tienen handle y no se quedan en pantalla por sí solos: un script de cliente tiene que volver a dibujarlos en cada frame.

Los IDs de tipo de marker de abajo se copiaron de la referencia oficial de markers de FiveM el 16 de noviembre de 2026. Los parámetros proceden de la entrada de DrawMarker en la referencia de natives.

¿Qué es un marker en FiveM?

Los markers señalan puntos de interacción en el mundo: un punto de servicio en una comisaría, la entrada de un garaje, un punto de recogida de un trabajo. Son puramente visuales. Pulsar una tecla en un marker, abrir un menú o teletransportar al jugador es código aparte que escribes a su alrededor, normalmente con una comprobación de distancia.

Un marker no es un blip. Un blip es un icono en el mapa y el minimapa, que se crea una vez y se conserva mediante su handle; la referencia de blips de FiveM recoge sus IDs de sprite y de color. Muchas ubicaciones usan ambos: un blip para que los jugadores encuentren el lugar y un marker para que sepan dónde colocarse.

Los markers de esta página son puntos fijos definidos en el código. Los markers que los propios jugadores colocan desde un menú son otra función, que ofrece un script de markers de ping para FiveM.

Tipos de marker de FiveM

El primer argumento de DrawMarker es el tipo de marker. La referencia recoge 44 tipos, del 0 al 43. Los nombres aparecen tal como los escribe la referencia; los tipos 41 y 43 no tienen nombre allí, solo un signo de interrogación.

IDNombre del marker
0MarkerTypeUpsideDownCone
1MarkerTypeVerticalCylinder
2MarkerTypeThickChevronUp
3MarkerTypeThinChevronUp
4MarkerTypeCheckeredFlagRect
5MarkerTypeCheckeredFlagCircle
6MarkerTypeVerticleCircle
7MarkerTypePlaneModel
8MarkerTypeLostMCTransparent
9MarkerTypeLostMC
10MarkerTypeNumber0
11MarkerTypeNumber1
12MarkerTypeNumber2
13MarkerTypeNumber3
14MarkerTypeNumber4
15MarkerTypeNumber5
16MarkerTypeNumber6
17MarkerTypeNumber7
18MarkerTypeNumber8
19MarkerTypeNumber9
20MarkerTypeChevronUpx1
21MarkerTypeChevronUpx2
22MarkerTypeChevronUpx3
23MarkerTypeHorizontalCircleFat
24MarkerTypeReplayIcon
25MarkerTypeHorizontalCircleSkinny
26MarkerTypeHorizontalCircleSkinny_Arrow
27MarkerTypeHorizontalSplitArrowCircle
28MarkerTypeDebugSphere
29MarkerTypeDollarSign
30MarkerTypeHorizontalBars
31MarkerTypeWolfHead
32MarkerTypeQuestionMark
33MarkerTypePlaneSymbol
34MarkerTypeHelicopterSymbol
35MarkerTypeBoatSymbol
36MarkerTypeCarSymbol
37MarkerTypeMotorcycleSymbol
38MarkerTypeBikeSymbol
39MarkerTypeTruckSymbol
40MarkerTypeParachuteSymbol
41?
42MarkerTypeSawbladeSymbol
43?

La página de referencia muestra una imagen de cada tipo, que es la forma más rápida de elegir uno.

Parámetros de DrawMarker

DrawMarker recibe 24 argumentos en este orden. Las descripciones están resumidas de la referencia de natives.

#ParámetroTipoQué hace
1typeintID de tipo de marker de la tabla anterior.
2–4posX, posY, posZfloatPosición en el mundo donde se dibuja el marker.
5–7dirX, dirY, dirZfloatVector de dirección; 0.0 en los tres usa en su lugar los valores de rotación.
8–10rotX, rotY, rotZfloatRotación, solo se usa cuando el vector de dirección es 0.0.
11–13scaleX, scaleY, scaleZfloatTamaño en cada eje.
14–17red, green, blue, alphaintColor y transparencia, cada uno de 0 a 255.
18bobUpAndDownBOOLAnima el marker lentamente arriba y abajo.
19faceCameraBOOLConvierte el marker en un billboard que siempre mira a la cámara.
20p19intNormalmente se pone en 2; según la referencia, no parece influir directamente.
21rotateBOOLLas rotaciones solo se aplican al heading.
22textureDictchar*Diccionario de texturas con el que se dibuja el marker, o nil.
23textureNamechar*Nombre de la textura dentro de ese diccionario, o nil.
24drawOnEntsBOOLIndica si el marker se dibuja sobre las entidades con las que se cruza.

Pasa el tipo como número. Las posiciones, direcciones, rotaciones y escalas son floats, así que escribe 1.0, no 1, como hacen los ejemplos del native.

¿Cómo se dibuja un marker en FiveM?

La referencia indica que DrawMarker «has to be called every frame» (hay que llamarlo en cada frame), por ejemplo en un bucle con Wait(0). Un marker dibujado una sola vez se ve durante un único frame y desaparece. Un script de cliente mínimo:

-- client.lua
local point = vector3(0.0, 0.0, 0.0) -- replace with your location

CreateThread(function()
    while true do
        Wait(0)
        DrawMarker(1, point.x, point.y, point.z - 1.0,
            0.0, 0.0, 0.0,      -- direction
            0.0, 0.0, 0.0,      -- rotation
            1.5, 1.5, 1.0,      -- scale
            0, 150, 255, 120,   -- red, green, blue, alpha
            false, false, 2, false, nil, nil, false)
    end
end)

Esto dibuja el marker, pero ejecuta el dibujado en cada frame para cada jugador, esté donde esté en el mapa. El siguiente patrón lo soluciona.

Dibujar markers solo cuando el jugador está cerca

Comprueba primero la distancia y entra en la rama de cada frame solo cerca del punto. Lejos, el bucle espera más tiempo:

-- client.lua
local point = vector3(0.0, 0.0, 0.0) -- replace with your location
local drawDistance = 20.0
local useDistance = 1.5

CreateThread(function()
    while true do
        local sleep = 1000
        local playerCoords = GetEntityCoords(PlayerPedId())
        local distance = #(playerCoords - point)

        if distance < drawDistance then
            sleep = 0
            DrawMarker(1, point.x, point.y, point.z - 1.0,
                0.0, 0.0, 0.0, 0.0, 0.0, 0.0,
                1.5, 1.5, 1.0,
                0, 150, 255, 120,
                false, false, 2, false, nil, nil, false)

            if distance < useDistance and IsControlJustReleased(0, 38) then
                -- E was released while standing in the marker
                TriggerEvent('my_resource:openMenu')
            end
        end

        Wait(sleep)
    end
end)
  • #(playerCoords - point) es la distancia entre dos vectores. La documentación de FiveM usa la misma forma en sus propios ejemplos.
  • El control 38 es INPUT_PICKUP, la tecla E del teclado, según la referencia de controles de FiveM. Compruébalo dentro de la rama de cada frame, porque una comprobación de «just released» (recién soltada) tiene que ejecutarse en el frame en que se suelta la tecla.
  • my_resource:openMenu es un marcador de posición para tu propio evento o función.

Los valores 20.0, 1.5 y 1000 son puntos de partida, no límites documentados. Ajústalos a la ubicación.

Por qué los markers cuestan rendimiento

La documentación de FiveM describe los scripts como multitarea cooperativa: un bucle tiene que ceder tiempo al juego con Wait, y un bucle con Wait(0) vuelve a ejecutarse en el siguiente frame. Un bucle de marker sale barato; docenas de ellos, cada uno ejecutándose en cada frame para cada ubicación del mapa, se acumulan. Tres hábitos lo mantienen bajo control:

  • Deja que el bucle espere más tiempo mientras el jugador está lejos de todos los markers, como en el ejemplo anterior.
  • Usa un solo hilo que recorra una tabla de ubicaciones en lugar de un hilo por marker.
  • Mide antes y después de un cambio en lugar de adivinar.

La guía para optimizar el rendimiento del servidor FiveM explica cómo medir el coste de los recursos con resmon y el profiler. Estos hábitos se derivan de la regla de cada frame; no hemos hecho benchmarks de los ejemplos de esta página.

Markers y checkpoints

Los checkpoints son un sistema distinto. Se crean una vez con CreateCheckpoint, que devuelve un handle; su entrada en la referencia advierte de que el juego ya gestiona los checkpoints, así que no debes meterlos en un bucle como los markers. Usan sus propios IDs de tipo, recogidos en la referencia de checkpoints de FiveM. No pases un ID de checkpoint a DrawMarker ni al revés.

Preguntas

¿Por qué mi marker parpadea o desaparece?

La llamada de dibujado no se ejecuta en cada frame. Asegúrate de que el bucle espera 0 ms mientras el marker deba verse.

¿Por qué mi marker flota o queda enterrado?

Ajusta el valor Z de la posición. Los ejemplos restan 1.0 a la Z del punto; cambia ese desplazamiento hasta que el marker quede donde quieres.

¿Se pueden dibujar markers desde un script de servidor?

DrawMarker es un native de cliente y no tiene versión de servidor en la referencia de natives. El servidor puede enviar las ubicaciones a un cliente, y el cliente las dibuja.

  • Blips de FiveM: IDs de sprite, IDs de color y cómo añadirlos

    Un blip de FiveM es un icono en el mapa y el minimapa, creado con AddBlipForCoord y personalizado con un ID de sprite y un ID de color. Sprites habituales, todos los IDs de color de la referencia oficial y Lua para añadir, nombrar y eliminar blips.

  • Crea una pequeña aplicación de teléfono FiveM con NUI

    Crea una pequeña aplicación de teléfono FiveM con NUI

    Crea primero una pequeña aplicación NUI estilo teléfono para aprender el ciclo completo de abrir, enviar mensajes, callback y cerrar. Este ejemplo muestra una nota de sesión que permanece mientras el recurso se ejecuta. No tiene llamadas, servicio de mensajería, base de datos o dependencia de framework; añadir eso requiere autorización y persistencia separadas del lado del servidor.

  • Cómo eliminar la mira en FiveM (HideHudComponentThisFrame 14)

    Cómo eliminar la mira en FiveM (HideHudComponentThisFrame 14)

    Respuesta rápida: los servidores de FiveM eliminan la mira predeterminada de GTA — componente HUD 14, la retícula — ejecutando HideHudComponentThisFrame(14) en cada fotograma en un script de cliente. La llamada debe ejecutarse en el cliente, dentro de un bucle, porque los componentes HUD se renderizan de nuevo en el siguiente fotograma. A continuación: el recurso de copiar y pegar, un comando opcional de alternancia para el jugador y soluciones para una mira que sigue reapareciendo.