Pular para o conteúdo

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

RPScripts

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

Por Luke, RPScripts

Nesta página

Um blip no FiveM é um ícone no mapa do menu de pausa e no minimapa, criado com AddBlipForCoord e estilizado com um ID de sprite e um ID de cor. A lista completa de IDs de sprite está na referência oficial de blips do FiveM; esta página reúne sprites com nomes de locais comuns de roleplay, todos os IDs de cor e um exemplo em Lua.

Todos os IDs abaixo foram copiados dessa referência em 16 de novembro de 2026. A página lista os blips do jogo "as of build 3258" (conforme o build 3258).

O que é um blip no FiveM?

Um blip é um marcador de mapa que o jogo desenha no radar. Garagens, hospitais, delegacias e locais de emprego no mapa de um servidor de roleplay são blips. Cada um tem três partes que você controla:

  • Posição: coordenadas fixas, uma entidade que ele acompanha ou uma área.
  • Sprite: o ícone, escolhido por um ID de sprite numérico.
  • Cor: um ID de cor numérico da paleta do jogo.

Não confunda blips com markers. Um marker é uma forma 3D desenhada no próprio mundo do jogo, como o cilindro brilhante na frente de uma porta; nosso guia de markers do FiveM e DrawMarker cobre esse lado.

IDs de sprite de blip comuns

A referência oficial lista 966 sprites, numerados de 0 a 965. Os abaixo foram escolhidos porque os nomes correspondem a lugares de que um mapa de roleplay costuma precisar. A coluna de nome traz o nome do sprite exatamente como a referência o apresenta.

IDNome do spriteGrupo
60radar_police_stationServiços
137radar_police_station_blueServiços
61radar_hospitalServiços
56radar_cop_patrolServiços
357radar_garageVeículos
72radar_car_mod_shopVeículos
446radar_bennysVeículos
402radar_repairVeículos
100radar_car_washVeículos
68radar_tow_truckVeículos
361radar_jerry_canVeículos
198radar_taxiVeículos
477radar_truckVeículos
64radar_helicopterVeículos
138radar_airportVeículos
73radar_clothes_storeLojas
71radar_barberLojas
75radar_tattooLojas
110radar_gun_shopLojas
98radar_burger_shotLojas
93radar_barLojas
121radar_strip_clubLojas
40radar_safehousePropriedades e empregos
267radar_propertyPropriedades e empregos
475radar_officePropriedades e empregos
473radar_warehousePropriedades e empregos
374radar_businessPropriedades e empregos
1radar_levelMapa
8radar_waypointMapa
9radar_radius_blipMapa

O nome diz para que o ícone foi feito, não para que você deve usá-lo. Confira a imagem na página de referência antes de escolher um ID.

IDs de cor de blip

As cores são definidas com SetBlipColour. A referência lista os IDs abaixo, incluindo alguns IDs que mostram variantes vermelhas ou azuis em blips inimigos e aliados. A referência observa que SetBlipAsFriendly é o nativo que alterna essas marcações de aliado e inimigo. Os valores hex são as cores de amostra que a referência exibe.

IDCorHex
0Branco#fefefe
1Vermelho#e03232
2Verde#71cb71
2 (inimigo)Vermelho#e03232
2 (aliado)Azul#5db6e5
3Azul#5db6e5
3 (inimigo)Vermelho#e03232
4Branco#fefefe
4 (inimigo)Vermelho#e03232
4 (aliado)Azul#5db6e5
5Amarelo#eec64e
5 (inimigo)Vermelho#e03232
5 (aliado)Azul#5db6e5
6Vermelho-claro#c25050
7Violeta#9c6eaf
8Rosa#fe7ac3
9Laranja-claro#f59d79
10Marrom-claro#b18f83
11Verde-claro#8dcea7
12Azul-claro#70a8ae
13Roxo-claro#d3d1e7
14Roxo-escuro#8f7e98
15Ciano#6ac4bf
16Amarelo-claro#d5c398
17Laranja#ea8e50
18Azul-claro#97cae9
19Rosa-escuro#b26287
20Amarelo-escuro#8f8d79
21Laranja-escuro#a6755e
22Cinza-claro#afa8a8
23Rosa-claro#e78d9a
24Verde-limão#bbd65b
25Verde-floresta#0c7b56
26Azul-elétrico#7ac3fe
27Roxo-vivo#ab3ce6
28Amarelo-escuro#cda80c
29Azul-escuro#4561ab
30Ciano-escuro#29a5b8
31Marrom-claro#b89b7b
32Azul-claro#c8e0fe
33Amarelo-claro#f0f096
34Rosa-claro#ed8ca1
35Vermelho-claro#f98a8a
36Bege#fbeea5
37Branco#fefefe
38Azul#2c6db8
39Cinza-claro#9a9a9a
40Cinza-escuro#4c4c4c
41Rosa-avermelhado#F29D9D
42Azul#6CB7D6
43Verde-claro#AFEDAE
44Laranja-claro#FFA75F
45Branco#F1F1F1
46Dourado#ECF029
47Laranja#FF9A18
48Rosa-brilhante#F644A5
49Vermelho#E03A3A
49 (aliado)Azul#5db6e5
50Roxo-médio#8A6DE3
51Salmão#FF8B5C
52Verde-escuro#416C41
53Azul Blizzard#B3DDF3
54Azul Oracle#3A6479
55Prata#A0A0A0
56Marrom#847232
57Azul#65B9E7
58East Bay#4B4175
59Vermelho#E13B3B
60Amarelo-alaranjado#F0CB58
61Rosa Mulberry#CD3F98
62Cinza Alto#CFCFCF
63Azul Jelly Bean#276A9F
64Laranja-escuro#D87B1B
65Mamba#8E8393
66Amarelo-alaranjado#F0CB57
66 (inimigo)Vermelho#e03232
66 (aliado)Azul#5db6e5
67Azul#65B9E7
67 (inimigo)Vermelho#e03232
68Azul#65B9E7
68 (inimigo)Vermelho#e03232
69Verde#79CD79
69 (inimigo)Vermelho#e03232
69 (aliado)Azul#5db6e5
70Amarelo-alaranjado#EFCA57
71Amarelo-alaranjado#EFCA57
72Preto transparente#3D3D3D
73Amarelo-alaranjado#EFCA57
74Azul#65B9E7
75Vermelho#e03232
76Vermelho profundo#782323
77Azul#65B9E7
78Azul Oracle#3A6479
79Vermelho transparente#e03232
80Azul transparente#65B9E7
81Laranja#F2A40C
82Verde-claro#A4CCAA
83Roxo#A854F2
84Azul#65B9E7
85Preto transparente#3D3D3D

A página do nativo SetBlipColour também mostra um valor hex como 0x3A7F3AFF passado no lugar de um ID, para uma cor fora da paleta.

Como adicionar um blip no FiveM?

Crie o blip em um script de cliente e depois defina o estilo e o nome. Este exemplo coloca um ícone de hospital em coordenadas fixas:

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

AddTextEntry('HOSPITAL_BLIP', '~a~')

CreateThread(function()
    local blip = AddBlipForCoord(coords.x, coords.y, coords.z)
    SetBlipSprite(blip, 61)       -- radar_hospital
    SetBlipColour(blip, 2)        -- Green
    SetBlipScale(blip, 0.8)
    SetBlipAsShortRange(blip, true)

    BeginTextCommandSetBlipName('HOSPITAL_BLIP')
    AddTextComponentSubstringPlayerName('Hospital')
    EndTextCommandSetBlipName(blip)
end)

O que cada chamada faz, segundo a referência de nativos:

  • AddBlipForCoord(x, y, z) cria o blip e retorna o handle dele.
  • SetBlipSprite(blip, spriteId) define o ícone.
  • SetBlipColour(blip, color) define a cor.
  • SetBlipScale(blip, scale) recebe um float. A referência não informa valor padrão nem faixa, então teste os tamanhos no jogo.
  • SetBlipAsShortRange(blip, toggle) faz o blip aparecer só quando o jogador está por perto, em vez de sempre no minimapa.
  • BeginTextCommandSetBlipName(textLabel) e EndTextCommandSetBlipName(blip) definem o nome mostrado na legenda do mapa do menu de pausa. AddTextComponentSubstringPlayerName, chamado entre os dois, preenche o espaço reservado ~a~ do rótulo.

Substitua as coordenadas de exemplo pelas suas. Em um script de cliente, GetEntityCoords(PlayerPedId()) retorna a posição em que você está.

Blips fixos no código como estes exigem uma alteração no código para cada novo local. Se a equipe deve posicionar e gerenciar blips dentro do jogo sem editar código, essa é a função de um script criador de blips para FiveM.

O arquivo de cliente precisa estar listado como client_script no manifesto do recurso; o guia para escrever o fxmanifest.lua do FiveM mostra a estrutura.

Como funcionam os nomes dos blips

O nome vem de um rótulo de texto registrado com AddTextEntry. Um rótulo pode misturar texto fixo com o espaço reservado ~a~, que AddTextComponentSubstringPlayerName preenche. Este é o exemplo do próprio nativo; ele dá ao blip o nome "Food for me!":

AddTextEntry('MYBLIP', 'Food for ~a~!')

local blip = AddBlipForCoord(0.0, 0.0, 0.0)
BeginTextCommandSetBlipName('MYBLIP')
AddTextComponentSubstringPlayerName('me')
EndTextCommandSetBlipName(blip)

O espaço reservado ~a~ e os outros códigos de formatação estão documentados na referência de formatação de texto do FiveM.

Como fazer um blip de raio?

Um blip de raio sombreia um círculo no mapa, o que serve para zonas como o território de uma gangue ou uma área restrita. AddBlipForRadius(posX, posY, posZ, radius) cria apenas o círculo. A referência observa que ele não cria um sprite, então adicione um segundo blip com AddBlipForCoord se quiser um ícone no meio.

local center = vector3(0.0, 0.0, 0.0)

local zone = AddBlipForRadius(center.x, center.y, center.z, 100.0) -- radius must be a float
SetBlipColour(zone, 1)   -- Red
SetBlipAlpha(zone, 128)

SetBlipAlpha(blip, alpha) define o canal alfa da cor do blip, o que deixa o círculo sombreado mais ou menos transparente. O exemplo de AddBlipForRadius na referência usa 128.

Outros tipos de blip

  • Blips de entidade: AddBlipForEntity(entity) prende um blip a um ped, veículo ou objeto. A referência diz que ele é vermelho (inimigo) por padrão; SetBlipAsFriendly(blip, true) o deixa azul.
  • Blips de área: AddBlipForArea(x, y, z, width, height), listado na referência como _ADD_BLIP_FOR_AREA, adiciona um blip retangular.
  • Rotas: SetBlipRoute(blip, true) mostra a rota até o blip; false a esconde de novo.
  • Visibilidade: SetBlipDisplay(blip, displayId) controla onde ele aparece. A referência lista, por exemplo, 2 para mapa principal e minimapa, 3 ou 4 só para o mapa principal e 5 só para o minimapa.

Como remover um blip?

Chame RemoveBlip(blip) com o handle que você guardou ao criá-lo. Verifique antes com DoesBlipExist(blip) se o blip talvez já não exista.

if blip and DoesBlipExist(blip) then
    RemoveBlip(blip)
    blip = nil
end

A referência de RemoveBlip aponta um detalhe: ele só funciona no script que criou o blip. Para remover blips criados por outros scripts, a referência indica SetThisScriptCanRemoveBlipsCreatedByAnyScript. Guarde os handles dos blips no recurso que é dono deles e remova-os quando o recurso parar ou quando o jogador perder o acesso ao local.

Blips são do lado do cliente ou do servidor?

Os nativos usados acima são nativos de cliente, então o código de blips normalmente fica em um script de cliente que roda no jogo de cada jogador. É também ali que ficam as regras por jogador: mostrar o blip do arsenal da polícia só para jogadores com o emprego de policial, por exemplo. A introdução ao scripting em Lua para FiveM explica como os scripts de cliente e de servidor dividem o trabalho.

A referência de nativos também lista versões RPC do lado do servidor de alguns nativos de blip: AddBlipForCoord, AddBlipForRadius, AddBlipForEntity, RemoveBlip, SetBlipSprite e AddBlipForArea. Não há versão de servidor dos nativos de cor, escala ou nome nessa lista, então a maioria dos scripts de blip deixa todo o trabalho no cliente.

Perguntas

Onde está a lista completa de blips do FiveM?

Em docs.fivem.net, em Game References, Blips. Ela mostra cada sprite com imagem, ID e nome, seguida da lista de cores.

Por que meu blip não aparece?

Confira se o script é um script de cliente listado no manifesto, se as coordenadas estão certas e se SetBlipAsShortRange o esconde até você chegar perto. Um ID de exibição 0, 1 ou 7 esconde o blip em todos os lugares.

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

    Um marker no FiveM é uma forma 3D desenhada no mundo com DrawMarker, a cada frame. Todos os IDs de tipo de marker da referência oficial, os 24 parâmetros do DrawMarker e um loop em Lua com verificação de distância e interação pela tecla E.

  • 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.