Um marker no FiveM é uma forma 3D desenhada no mundo do jogo com o nativo DrawMarker, como o cilindro que mostra onde ficar para abrir uma garagem ou uma loja. Markers não têm handle e não ficam na tela sozinhos: um script de cliente precisa desenhá-los de novo a cada frame.
Os IDs de tipo de marker abaixo foram copiados da referência oficial de markers do FiveM em 16 de novembro de 2026. Os parâmetros vêm da entrada de DrawMarker na referência de nativos.
O que é um marker no FiveM?
Markers indicam pontos de interação no mundo: um ponto de serviço em uma delegacia, a entrada de uma garagem, um ponto de coleta de um emprego. Eles são puramente visuais. Apertar uma tecla em um marker, abrir um menu ou teletransportar o jogador é código separado que você escreve em volta dele, normalmente com uma verificação de distância.
Um marker não é um blip. Um blip é um ícone no mapa e no minimapa, criado uma vez e mantido por handle; a referência de blips do FiveM cobre os IDs de sprite e de cor deles. Muitos locais usam os dois: um blip para os jogadores encontrarem o lugar e um marker para saberem onde ficar.
Os markers desta página são pontos fixos definidos no código. Markers que os próprios jogadores posicionam por um menu são outra funcionalidade, oferecida por um script de ping markers para FiveM.
Tipos de marker do FiveM
O primeiro argumento de DrawMarker é o tipo de marker. A referência lista 44 tipos, de 0 a 43. Os nomes aparecem exatamente como a referência os escreve; os tipos 41 e 43 não têm nome ali, apenas um ponto de interrogação.
| ID | Nome do 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 | ? |
A página de referência mostra uma imagem de cada tipo, que é o jeito mais rápido de escolher um.
Parâmetros de DrawMarker
DrawMarker recebe 24 argumentos nesta ordem. As descrições são resumidas da referência de nativos.
| # | Parâmetro | Tipo | O que faz |
| 1 | type | int | ID do tipo de marker da tabela acima. |
| 2–4 | posX, posY, posZ | float | Posição no mundo onde o marker é desenhado. |
| 5–7 | dirX, dirY, dirZ | float | Vetor de direção; 0.0 nos três usa os valores de rotação. |
| 8–10 | rotX, rotY, rotZ | float | Rotação, usada só quando o vetor de direção é 0.0. |
| 11–13 | scaleX, scaleY, scaleZ | float | Tamanho em cada eixo. |
| 14–17 | red, green, blue, alpha | int | Cor e transparência, cada um de 0 a 255. |
| 18 | bobUpAndDown | BOOL | Anima o marker lentamente para cima e para baixo. |
| 19 | faceCamera | BOOL | Transforma o marker em um billboard que sempre fica de frente para a câmera. |
| 20 | p19 | int | Normalmente definido como 2; a referência diz que não parece importar diretamente. |
| 21 | rotate | BOOL | As rotações se aplicam só à direção (heading). |
| 22 | textureDict | char* | Dicionário de texturas usado para desenhar o marker, ou nil. |
| 23 | textureName | char* | Nome da textura dentro desse dicionário, ou nil. |
| 24 | drawOnEnts | BOOL | Se o marker é desenhado sobre as entidades que o cruzam. |
Passe o tipo como número. Posições, direções, rotações e escalas são floats, então escreva 1.0, não 1, como fazem os exemplos do nativo.
Como desenhar um marker no FiveM?
A referência diz que DrawMarker "tem que ser chamado a cada frame", por exemplo em um loop com Wait(0). Um marker desenhado uma vez aparece por um único frame e some. Um 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)
Isso desenha o marker, mas executa o desenho a cada frame para cada jogador, onde quer que ele esteja no mapa. O próximo padrão resolve isso.
Desenhar markers só quando o jogador está perto
Verifique a distância primeiro e só entre no trecho executado a cada frame perto do ponto. Longe dele, o loop dorme por mais tempo:
-- 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) é a distância entre dois vetores. A documentação do FiveM usa a mesma forma nos próprios exemplos.
- O controle 38 é
INPUT_PICKUP, a tecla E no teclado, segundo a referência de controles do FiveM. Verifique-o dentro do trecho executado a cada frame, porque uma verificação de "just released" (acabou de soltar) precisa rodar no frame em que a tecla é solta.
my_resource:openMenu é um espaço reservado para o seu próprio evento ou função.
Os valores 20.0, 1.5 e 1000 são pontos de partida, não limites documentados. Ajuste-os ao local.
Por que markers custam desempenho
A documentação do FiveM descreve os scripts como multitarefa cooperativa: um loop precisa dar tempo ao jogo com Wait, e um loop com Wait(0) roda de novo no frame seguinte. Um loop de marker é barato; dezenas deles, cada um rodando a cada frame para cada local do mapa, se somam. Três hábitos mantêm isso sob controle:
- Deixe o loop dormir por mais tempo enquanto o jogador está longe de todos os markers, como no exemplo acima.
- Use uma thread que percorre uma tabela de locais em vez de uma thread por marker.
- Meça antes e depois de uma alteração em vez de adivinhar.
O guia para otimizar o desempenho do servidor FiveM explica como medir o custo dos recursos com o resmon e o profiler. Esses hábitos decorrem da regra de desenhar a cada frame; não fizemos benchmark dos exemplos desta página.
Markers e checkpoints
Checkpoints são outro sistema. Eles são criados uma vez com CreateCheckpoint, que retorna um handle; a entrada dele na referência avisa que o jogo já cuida dos checkpoints, então você não deve colocá-los em loop como markers. Eles usam IDs de tipo próprios, listados na referência de checkpoints do FiveM. Não passe um ID de checkpoint para DrawMarker, nem o contrário.
Perguntas
Por que meu marker pisca ou desaparece?
A chamada de desenho não está rodando a cada frame. Garanta que o loop espere 0 ms enquanto o marker deve ficar visível.
Por que meu marker está flutuando ou enterrado?
Ajuste o valor Z da posição. Os exemplos subtraem 1.0 do Z do ponto; mude esse deslocamento até o marker ficar onde você quer.
Markers podem ser desenhados por um script de servidor?
DrawMarker é um nativo de cliente e não tem versão de servidor na referência de nativos. O servidor pode enviar os locais para um cliente, e o cliente os desenha.