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.
| ID | Nom du 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 | ? |
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ètre | Type | Rôle |
| 1 | type | int | ID du type de marker, tiré du tableau ci-dessus. |
| 2–4 | posX, posY, posZ | float | Position dans le monde où dessiner le marker. |
| 5–7 | dirX, dirY, dirZ | float | Vecteur de direction ; 0.0 pour les trois utilise à la place les valeurs de rotation. |
| 8–10 | rotX, rotY, rotZ | float | Rotation, utilisée seulement quand le vecteur de direction vaut 0.0. |
| 11–13 | scaleX, scaleY, scaleZ | float | Taille sur chaque axe. |
| 14–17 | red, green, blue, alpha | int | Couleur et transparence, chacune de 0 à 255. |
| 18 | bobUpAndDown | BOOL | Fait monter et descendre lentement le marker. |
| 19 | faceCamera | BOOL | Transforme le marker en panneau toujours tourné vers la caméra. |
| 20 | p19 | int | Généralement réglé sur 2 ; selon la référence, il ne semble pas avoir d'effet direct. |
| 21 | rotate | BOOL | Les rotations ne s'appliquent qu'au cap (heading). |
| 22 | textureDict | char* | Dictionnaire de textures avec lequel dessiner le marker, ou nil. |
| 23 | textureName | char* | Nom de la texture dans ce dictionnaire, ou nil. |
| 24 | drawOnEnts | BOOL | Indique 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.
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.
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.