Aller au contenu

Black Friday : 20 % de remise jusqu’au 30 nov.Packs serveur

RPScripts

Markers FiveM : types de markers et utilisation de DrawMarker

Par Luke, RPScripts

Sur cette page

Un marker FiveM est une forme 3D dessinée dans le monde du jeu avec le native DrawMarker, comme le cylindre qui indique où se placer pour ouvrir un garage ou une boutique. Les markers n'ont pas de handle et ne restent pas affichés d'eux-mêmes : un script client doit les redessiner à chaque frame.

Les ID de types de markers ci-dessous ont été copiés depuis la référence officielle des markers FiveM le 16 novembre 2026. Les paramètres proviennent de l'entrée DrawMarker de la référence des natives.

Qu'est-ce qu'un marker dans FiveM ?

Les markers signalent des points d'interaction dans le monde : un point de prise de service dans un commissariat, l'entrée d'un garage, un point de collecte pour un métier. Ils sont purement visuels. Appuyer sur une touche devant un marker, ouvrir un menu ou téléporter le joueur relève d'un code distinct que vous écrivez autour, généralement avec une vérification de distance.

Un marker n'est pas un blip. Un blip est une icône sur la carte et la minicarte, créée une seule fois et conservée par son handle ; la référence des blips FiveM couvre leurs ID de sprites et de couleurs. Beaucoup de lieux utilisent les deux : un blip pour que les joueurs trouvent l'endroit, et un marker pour qu'ils sachent où se placer.

Les markers de cette page sont des points fixes définis dans le code. Les markers que les joueurs placent eux-mêmes depuis un menu sont une autre fonctionnalité, qu'apporte un script de markers de ping pour FiveM.

Types de markers FiveM

Le premier argument de DrawMarker est le type de marker. La référence liste 44 types, de 0 à 43. Les noms sont reproduits exactement comme la référence les écrit ; les types 41 et 43 n'y ont pas de nom, seulement un point d'interrogation.

IDNom du 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?

La page de référence montre une image de chaque type, ce qui est le moyen le plus rapide d'en choisir un.

Paramètres de DrawMarker

DrawMarker prend 24 arguments dans cet ordre. Les descriptions sont résumées d'après la référence des natives.

#ParamètreTypeRôle
1typeintID du type de marker, tiré du tableau ci-dessus.
2–4posX, posY, posZfloatPosition dans le monde où dessiner le marker.
5–7dirX, dirY, dirZfloatVecteur de direction ; 0.0 pour les trois utilise à la place les valeurs de rotation.
8–10rotX, rotY, rotZfloatRotation, utilisée seulement quand le vecteur de direction vaut 0.0.
11–13scaleX, scaleY, scaleZfloatTaille sur chaque axe.
14–17red, green, blue, alphaintCouleur et transparence, chacune de 0 à 255.
18bobUpAndDownBOOLFait monter et descendre lentement le marker.
19faceCameraBOOLTransforme le marker en panneau toujours tourné vers la caméra.
20p19intGénéralement réglé sur 2 ; selon la référence, il ne semble pas avoir d'effet direct.
21rotateBOOLLes rotations ne s'appliquent qu'au cap (heading).
22textureDictchar*Dictionnaire de textures avec lequel dessiner le marker, ou nil.
23textureNamechar*Nom de la texture dans ce dictionnaire, ou nil.
24drawOnEntsBOOLIndique si le marker se dessine sur les entités qu'il croise.

Passez le type sous forme de nombre. Les positions, directions, rotations et tailles sont des floats : écrivez 1.0 et non 1, comme le font les exemples du native.

Comment dessiner un marker dans FiveM ?

La référence indique que DrawMarker « has to be called every frame » (doit être appelé à chaque frame), par exemple dans une boucle Wait(0). Un marker dessiné une seule fois s'affiche pendant une seule frame puis disparaît. Un script client minimal :

-- 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)

Ce code dessine le marker, mais il exécute le dessin à chaque frame pour chaque joueur, où qu'il se trouve sur la carte. Le modèle suivant corrige ce problème.

Dessiner les markers seulement quand le joueur est proche

Vérifiez d'abord la distance et n'entrez dans la branche exécutée à chaque frame qu'à proximité du point. Loin de celui-ci, la boucle dort plus longtemps :

-- 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) est la distance entre deux vecteurs. La documentation FiveM utilise la même forme dans ses propres exemples.
  • Le contrôle 38 est INPUT_PICKUP, la touche E au clavier, d'après la référence des contrôles FiveM. Vérifiez-le dans la branche exécutée à chaque frame, car une vérification « just released » doit s'exécuter pendant la frame où la touche est relâchée.
  • my_resource:openMenu est un espace réservé pour votre propre événement ou fonction.

Les valeurs 20.0, 1.5 et 1000 sont des points de départ, pas des limites documentées. Ajustez-les selon le lieu.

Pourquoi les markers coûtent en performances

La documentation FiveM décrit les scripts comme fonctionnant en multitâche coopératif : une boucle doit rendre la main au jeu avec Wait, et une boucle avec Wait(0) s'exécute de nouveau à la frame suivante. Une boucle de marker coûte peu ; des dizaines, chacune exécutée à chaque frame pour chaque lieu de la carte, finissent par peser. Trois habitudes permettent de le maîtriser :

  • Dormez plus longtemps tant que le joueur est loin de tous les markers, comme dans l'exemple ci-dessus.
  • Utilisez un seul thread qui parcourt une table de lieux au lieu d'un thread par marker.
  • Mesurez avant et après une modification au lieu de deviner.

Le guide pour optimiser les performances d'un serveur FiveM explique comment mesurer le coût d'une ressource avec resmon et le profiler. Ces habitudes découlent de la règle du dessin à chaque frame ; nous n'avons pas mesuré les performances des exemples de cette page.

Markers et checkpoints

Les checkpoints sont un système différent. Ils sont créés une seule fois avec CreateCheckpoint, qui renvoie un handle ; son entrée dans la référence avertit que le jeu gère déjà les checkpoints, et que vous ne devez donc pas les appeler en boucle comme des markers. Ils utilisent leurs propres ID de types, listés dans la référence des checkpoints FiveM. Ne passez pas un ID de checkpoint à DrawMarker, ni l'inverse.

Questions

Pourquoi mon marker clignote-t-il ou disparaît-il ?

L'appel de dessin ne s'exécute pas à chaque frame. Assurez-vous que la boucle attend 0 ms tant que le marker doit être visible.

Pourquoi mon marker flotte-t-il ou est-il enterré ?

Ajustez la valeur Z de la position. Les exemples soustraient 1.0 au Z du point ; modifiez ce décalage jusqu'à ce que le marker soit placé où vous le voulez.

Peut-on dessiner des markers depuis un script serveur ?

DrawMarker est un native client et n'a pas de version serveur dans la référence des natives. Le serveur peut envoyer les lieux à un client, et c'est le client qui les dessine.

  • Blips FiveM : ID de sprites, ID de couleurs et comment les ajouter

    Un blip FiveM est une icône sur la carte et la minicarte, créée avec AddBlipForCoord et définie par un ID de sprite et un ID de couleur. Sprites courants, tous les ID de couleur de la référence officielle et du Lua pour ajouter, nommer et supprimer des blips.

  • Créer une petite application de téléphone FiveM avec NUI

    Créer une petite application de téléphone FiveM avec NUI

    Commencez par créer une petite application NUI de type téléphone pour apprendre l'intégralité du cycle de vie : ouverture, message, callback et fermeture. Cet exemple affiche une note de session qui persiste pendant l'exécution de la ressource. Il n'a ni appels, ni service de messagerie, ni base de données, ni dépendance à un framework ; les ajouter nécessite une autorisation côté serveur et une persistance distinctes.

  • Comment supprimer le réticule dans FiveM (HideHudComponentThisFrame 14)

    Comment supprimer le réticule dans FiveM (HideHudComponentThisFrame 14)

    Réponse rapide : les serveurs FiveM suppriment le réticule GTA par défaut — le composant HUD 14 — en appelant HideHudComponentThisFrame(14) à chaque frame dans un script client. L'appel doit s'exécuter côté client, à l'intérieur d'une boucle, car les composants HUD sont réaffichés à la frame suivante. Ci-dessous : la ressource à copier-coller, une commande de bascule optionnelle pour les joueurs et des solutions pour un réticule qui revient sans cesse.