Pular para o conteúdo

Black Friday: 20% de desconto até 30 de nov.Pacotes de servidor

RPScripts

Markers no FiveM: tipos de marker e como usar o DrawMarker

Por Luke, RPScripts

Nesta página

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.

IDNome do 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?

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âmetroTipoO que faz
1typeintID do tipo de marker da tabela acima.
2–4posX, posY, posZfloatPosição no mundo onde o marker é desenhado.
5–7dirX, dirY, dirZfloatVetor de direção; 0.0 nos três usa os valores de rotação.
8–10rotX, rotY, rotZfloatRotação, usada só quando o vetor de direção é 0.0.
11–13scaleX, scaleY, scaleZfloatTamanho em cada eixo.
14–17red, green, blue, alphaintCor e transparência, cada um de 0 a 255.
18bobUpAndDownBOOLAnima o marker lentamente para cima e para baixo.
19faceCameraBOOLTransforma o marker em um billboard que sempre fica de frente para a câmera.
20p19intNormalmente definido como 2; a referência diz que não parece importar diretamente.
21rotateBOOLAs rotações se aplicam só à direção (heading).
22textureDictchar*Dicionário de texturas usado para desenhar o marker, ou nil.
23textureNamechar*Nome da textura dentro desse dicionário, ou nil.
24drawOnEntsBOOLSe 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.

  • Blips no FiveM: IDs de sprite, IDs de cor e como adicioná-los

    Um blip no FiveM é um ícone no mapa e no minimapa, criado com AddBlipForCoord e estilizado com um ID de sprite e um ID de cor. Sprites comuns, todos os IDs de cor da referência oficial e Lua para adicionar, nomear e remover blips.

  • Crie um pequeno aplicativo de telefone FiveM com NUI

    Crie um pequeno aplicativo de telefone FiveM com NUI

    Crie primeiro um pequeno aplicativo NUI com aparência de telefone para aprender o ciclo completo de abertura, mensagem, callback e fechamento. Este exemplo mostra uma nota de sessão que permanece enquanto o recurso está em execução. Ele não tem chamadas, serviço de mensagens, banco de dados nem dependência de framework; adicionar essas funções exige autorização e persistência separadas no servidor.

  • Como Remover a Mira no FiveM (HideHudComponentThisFrame 14)

    Como Remover a Mira no FiveM (HideHudComponentThisFrame 14)

    Resposta rápida: Servidores FiveM removem a mira padrão do GTA — componente HUD 14, o retículo — executando HideHudComponentThisFrame(14) a cada quadro em um script de cliente. A chamada deve ser executada no cliente, dentro de um loop, porque os componentes HUD são renderizados novamente no próximo quadro. Abaixo: o recurso de copiar e colar, um comando opcional de alternância do jogador e correções para uma mira que continua voltando.