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.
| ID | Nombre del marker |
| 0 | MarkerTypeUpsideDownCone |
| 1 | MarkerTypeVerticalCylinder |
| 2 | MarkerTypeThickChevronUp |
| 3 | MarkerTypeThinChevronUp |
| 4 | MarkerTypeCheckeredFlagRect |
| 5 | MarkerTypeCheckeredFlagCircle |
| 6 | MarkerTypeVerticleCircle |
| 7 | MarkerTypePlaneModel |
| 8 | MarkerTypeLostMCTransparent |
| 9 | MarkerTypeLostMC |
| 10 | MarkerTypeNumber0 |
| 11 | MarkerTypeNumber1 |
| 12 | MarkerTypeNumber2 |
| 13 | MarkerTypeNumber3 |
| 14 | MarkerTypeNumber4 |
| 15 | MarkerTypeNumber5 |
| 16 | MarkerTypeNumber6 |
| 17 | MarkerTypeNumber7 |
| 18 | MarkerTypeNumber8 |
| 19 | MarkerTypeNumber9 |
| 20 | MarkerTypeChevronUpx1 |
| 21 | MarkerTypeChevronUpx2 |
| 22 | MarkerTypeChevronUpx3 |
| 23 | MarkerTypeHorizontalCircleFat |
| 24 | MarkerTypeReplayIcon |
| 25 | MarkerTypeHorizontalCircleSkinny |
| 26 | MarkerTypeHorizontalCircleSkinny_Arrow |
| 27 | MarkerTypeHorizontalSplitArrowCircle |
| 28 | MarkerTypeDebugSphere |
| 29 | MarkerTypeDollarSign |
| 30 | MarkerTypeHorizontalBars |
| 31 | MarkerTypeWolfHead |
| 32 | MarkerTypeQuestionMark |
| 33 | MarkerTypePlaneSymbol |
| 34 | MarkerTypeHelicopterSymbol |
| 35 | MarkerTypeBoatSymbol |
| 36 | MarkerTypeCarSymbol |
| 37 | MarkerTypeMotorcycleSymbol |
| 38 | MarkerTypeBikeSymbol |
| 39 | MarkerTypeTruckSymbol |
| 40 | MarkerTypeParachuteSymbol |
| 41 | ? |
| 42 | MarkerTypeSawbladeSymbol |
| 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ámetro | Tipo | Qué hace |
| 1 | type | int | ID de tipo de marker de la tabla anterior. |
| 2–4 | posX, posY, posZ | float | Posición en el mundo donde se dibuja el marker. |
| 5–7 | dirX, dirY, dirZ | float | Vector de dirección; 0.0 en los tres usa en su lugar los valores de rotación. |
| 8–10 | rotX, rotY, rotZ | float | Rotación, solo se usa cuando el vector de dirección es 0.0. |
| 11–13 | scaleX, scaleY, scaleZ | float | Tamaño en cada eje. |
| 14–17 | red, green, blue, alpha | int | Color y transparencia, cada uno de 0 a 255. |
| 18 | bobUpAndDown | BOOL | Anima el marker lentamente arriba y abajo. |
| 19 | faceCamera | BOOL | Convierte el marker en un billboard que siempre mira a la cámara. |
| 20 | p19 | int | Normalmente se pone en 2; según la referencia, no parece influir directamente. |
| 21 | rotate | BOOL | Las rotaciones solo se aplican al heading. |
| 22 | textureDict | char* | Diccionario de texturas con el que se dibuja el marker, o nil. |
| 23 | textureName | char* | Nombre de la textura dentro de ese diccionario, o nil. |
| 24 | drawOnEnts | BOOL | Indica 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.