Comment créer des blips de carte dans FiveM : AddBlipForCoord et blips de rayon

Vous appelez AddBlipForCoord et obtenez un point blanc sans icône, ou un blip avec le nom « Blip » ou « NULL », ou un qui reste sur la carte après l'arrêt du script. Les blips sont simples une fois que vous connaissez l'ordre des appels. Cet article vous guide dans la création d'un, son nommage, le dessin d'un rayon, sa suppression, et l'affichage des blips seulement à un job.

#Un blip basique

Tous les natives de blips s'exécutent sur le client. Cela crée une icône de magasin à une position :

local blip = AddBlipForCoord(25.7, -1347.3, 29.5)

SetBlipSprite(blip, 52)
SetBlipDisplay(blip, 4)
SetBlipScale(blip, 0.8)
SetBlipColour(blip, 2)
SetBlipAsShortRange(blip, true)

BeginTextCommandSetBlipName('STRING')
AddTextComponentSubstringPlayerName('24/7 Shop')
EndTextCommandSetBlipName(blip)

Ce que chaque appel fait :

Les nombres pour les sprites et les couleurs sont listés sur le site de documentation FiveM, sous références de jeu, blips. Le sprite 52 ci-dessus est une icône de magasin. Si vous ne voyez qu'un point blanc, le numéro de sprite est faux ou manquant.

#Définir le nom

Le label affiché sur la carte et dans le menu pause n'est pas un argument de chaîne simple. Il passe par les natives de commandes de texte, dans cet ordre :

BeginTextCommandSetBlipName('STRING')
AddTextComponentSubstringPlayerName('24/7 Shop')
EndTextCommandSetBlipName(blip)

Le blip doit déjà exister, et vous devez appeler tous les trois. Sautez-en un et le nom est vide ou affiche un défaut. Sans un nom, un blip apparaît dans la légende comme « Blip » ou par son sprite.

Conseil : mettez ces appels dans une fonction qui prend une table, pour que chaque blip soit une ligne dans une config au lieu de dix lignes de natives.

local function createBlip(data)
    local blip = AddBlipForCoord(data.coords.x, data.coords.y, data.coords.z)
    SetBlipSprite(blip, data.sprite)
    SetBlipDisplay(blip, 4)
    SetBlipScale(blip, data.scale or 0.8)
    SetBlipColour(blip, data.colour or 0)
    SetBlipAsShortRange(blip, data.shortRange ~= false)

    BeginTextCommandSetBlipName('STRING')
    AddTextComponentSubstringPlayerName(data.name)
    EndTextCommandSetBlipName(blip)

    return blip
end

local shopBlip = createBlip({
    coords = vec3(25.7, -1347.3, 29.5),
    sprite = 52,
    colour = 2,
    name = '24/7 Shop',
})

#Courte portée ou toujours visible

SetBlipAsShortRange(blip, true) signifie que le blip s'affiche seulement sur la mini-carte quand le joueur est proche, et il reste visible sur la carte complète. Avec false, il s'affiche toujours sur la mini-carte, serré aux bords, peu importe où le joueur est. Utilisez la courte portée pour les magasins et les jobs, et false pour un objectif principal.

#Blips de rayon

Un blip de rayon est un cercle coloré pour une zone, comme une zone de recherche ou un territoire. AddBlipForRadius crée le cercle, mais pas une icône, donc ajoutez un blip normal au même endroit si vous voulez les deux :

local area = AddBlipForRadius(25.7, -1347.3, 29.5, 150.0)
SetBlipColour(area, 1)
SetBlipAlpha(area, 100)

Le dernier argument est le rayon en mètres. Définissez l'alpha (0 à 255) bas, ou le cercle couvre la carte. Le blip de rayon est une poignée séparée, donc supprimez-le séparément.

#Supprimer les blips

Gardez toujours la poignée, et supprimez le blip quand il n'est plus nécessaire :

if DoesBlipExist(shopBlip) then
    RemoveBlip(shopBlip)
end

Les blips ne sont pas supprimés pour vous quand une ressource s'arrête, ou pas de manière fiable, donc nettoyez dans un gestionnaire. Sans cela, redémarrer votre script accumule les doublons sur la carte :

AddEventHandler('onResourceStop', function(resource)
    if resource ~= GetCurrentResourceName() then return end
    if DoesBlipExist(shopBlip) then RemoveBlip(shopBlip) end
    if DoesBlipExist(area) then RemoveBlip(area) end
end)

#Blips réservés aux jobs

Les blips sont créés sur le client propre de chaque joueur, donc un blip réservé aux jobs signifie : créez-le pour le bon job, supprimez-le pour tout le monde d'autre. Gardez une table de ce que vous avez créé, et réagissez aux changements de job.

Sur ESX :

local blips = {}

local function refreshBlips(job)
    for i = #blips, 1, -1 do
        RemoveBlip(blips[i])
        blips[i] = nil
    end

    if job and job.name == 'police' then
        blips[#blips + 1] = createBlip({
            coords = vec3(441.2, -981.9, 30.7),
            sprite = 60,
            colour = 3,
            name = 'Police station',
        })
    end
end

RegisterNetEvent('esx:playerLoaded', function(xPlayer)
    refreshBlips(xPlayer.job)
end)

RegisterNetEvent('esx:setJob', function(job)
    refreshBlips(job)
end)

Sur QBCore (et QBox via sa couche de compatibilité) :

local QBCore = exports['qb-core']:GetCoreObject()

RegisterNetEvent('QBCore:Client:OnPlayerLoaded', function()
    refreshBlips(QBCore.Functions.GetPlayerData().job)
end)

RegisterNetEvent('QBCore:Client:OnJobUpdate', function(job)
    refreshBlips(job)
end)

Les deux utilisent le même refreshBlips et createBlip d'en haut. Si le script peut redémarrer alors que le joueur est en ligne, appelez aussi refreshBlips une fois au démarrage avec le job courant, puisque l'événement chargé a déjà été déclenché à ce moment-là.

Attention : cacher un blip sur le client n'est pas sécurisé. Un joueur peut toujours le voir s'il patchs le client. Pour un secret, comme un repaire illégal, n'envoyez pas la position au client du tout jusqu'à ce que le joueur l'gagne.

#Autres types de blips

• AddBlipForEntity(entity) suit un véhicule ou un ped.
• SetBlipRoute(blip, true) dessine une route GPS au blip.
• SetBlipFlashes(blip, true) le fait clignoter.

#Checklist