Ein FiveM-Marker ist eine 3D-Form, die mit dem Native DrawMarker in die Spielwelt gezeichnet wird, etwa der Zylinder, der zeigt, wo du stehen musst, um eine Garage oder einen Shop zu öffnen. Marker haben kein Handle und bleiben nicht von selbst auf dem Bildschirm: Ein Client-Skript muss sie in jedem Frame neu zeichnen.
Die Marker-Typ-IDs unten wurden am 16. November 2026 aus der offiziellen FiveM-Marker-Referenz übernommen. Die Parameter stammen aus dem DrawMarker-Eintrag in der Natives-Referenz.
Was ist ein Marker in FiveM?
Marker kennzeichnen Interaktionspunkte in der Welt: einen Dienstpunkt in einer Polizeistation, eine Garageneinfahrt, eine Abholstelle für einen Job. Sie sind rein visuell. Eine Taste am Marker drücken, ein Menü öffnen oder den Spieler teleportieren ist eigener Code, den du drumherum schreibst, meist mit einer Distanzprüfung.
Ein Marker ist kein Blip. Ein Blip ist ein Symbol auf der Karte und der Minimap, das einmal erstellt und über ein Handle gehalten wird; die FiveM-Blips-Referenz behandelt deren Sprite- und Farb-IDs. Viele Orte nutzen beides: einen Blip, damit Spieler den Ort finden, und einen Marker, damit sie wissen, wo sie stehen müssen.
Die Marker auf dieser Seite sind feste, im Code definierte Punkte. Marker, die Spieler selbst über ein Menü setzen, sind eine andere Funktion, die ein Ping-Marker-Skript für FiveM bietet.
FiveM-Marker-Typen
Das erste Argument von DrawMarker ist der Marker-Typ. Die Referenz führt 44 Typen, von 0 bis 43. Die Namen stehen genau so da, wie die Referenz sie schreibt; die Typen 41 und 43 haben dort keinen Namen, nur ein Fragezeichen.
| ID | Marker-Name |
| 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 | ? |
Die Referenzseite zeigt zu jedem Typ ein Bild, so wählst du am schnellsten einen aus.
DrawMarker-Parameter
DrawMarker nimmt 24 Argumente in dieser Reihenfolge. Die Beschreibungen sind aus der Natives-Referenz zusammengefasst.
| # | Parameter | Typ | Was er bewirkt |
| 1 | type | int | Marker-Typ-ID aus der Tabelle oben. |
| 2–4 | posX, posY, posZ | float | Weltposition, an der der Marker gezeichnet wird. |
| 5–7 | dirX, dirY, dirZ | float | Richtungsvektor; 0.0 für alle drei verwendet stattdessen die Rotationswerte. |
| 8–10 | rotX, rotY, rotZ | float | Rotation, wird nur genutzt, wenn der Richtungsvektor 0.0 ist. |
| 11–13 | scaleX, scaleY, scaleZ | float | Größe auf jeder Achse. |
| 14–17 | red, green, blue, alpha | int | Farbe und Transparenz, jeweils 0–255. |
| 18 | bobUpAndDown | BOOL | Bewegt den Marker langsam auf und ab. |
| 19 | faceCamera | BOOL | Macht den Marker zu einem Billboard, das immer zur Kamera zeigt. |
| 20 | p19 | int | Meist auf 2 gesetzt; laut Referenz scheint der Wert nicht direkt eine Rolle zu spielen. |
| 21 | rotate | BOOL | Rotationen gelten nur für das Heading. |
| 22 | textureDict | char* | Textur-Dictionary, mit dem der Marker gezeichnet wird, oder nil. |
| 23 | textureName | char* | Texturname in diesem Dictionary oder nil. |
| 24 | drawOnEnts | BOOL | Ob der Marker auf sich überschneidende Entities gezeichnet wird. |
Übergib den Typ als Zahl. Positionen, Richtungen, Rotationen und Skalierungen sind Floats, schreibe also 1.0 statt 1, wie es die Native-Beispiele tun.
Wie zeichnest du in FiveM einen Marker?
Laut Referenz muss DrawMarker „in jedem Frame aufgerufen werden“, zum Beispiel in einer Wait(0)-Schleife. Ein einmal gezeichneter Marker erscheint für ein einziges Frame und ist dann weg. Ein minimales Client-Skript:
-- 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)
Das zeichnet den Marker, führt das Zeichnen aber in jedem Frame für jeden Spieler aus, egal wo er sich auf der Karte befindet. Das nächste Muster behebt das.
Marker nur zeichnen, wenn der Spieler in der Nähe ist
Prüfe zuerst die Distanz und betritt den Zweig, der in jedem Frame läuft, nur nahe am Punkt. Weit entfernt schläft die Schleife länger:
-- 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) ist die Distanz zwischen zwei Vektoren. Die FiveM-Dokumentation nutzt dieselbe Form in ihren eigenen Beispielen.
- Control 38 ist
INPUT_PICKUP, laut FiveM-Controls-Referenz die Taste E auf der Tastatur. Prüfe sie im Zweig, der in jedem Frame läuft, denn eine „just released“-Prüfung muss in dem Frame laufen, in dem die Taste losgelassen wird.
my_resource:openMenu ist ein Platzhalter für dein eigenes Event oder deine eigene Funktion.
Die Werte 20.0, 1.5 und 1000 sind Startwerte, keine dokumentierten Grenzen. Passe sie an den Ort an.
Warum Marker Leistung kosten
Laut FiveM-Dokumentation laufen Skripte im kooperativen Multitasking: Eine Schleife muss dem Spiel mit Wait Zeit geben, und eine Schleife mit Wait(0) läuft im nächsten Frame erneut. Eine Marker-Schleife ist günstig; Dutzende davon, jede in jedem Frame für jeden Ort auf der Karte, summieren sich. Drei Gewohnheiten halten das in Grenzen:
- Schlafe länger, solange der Spieler weit von allen Markern entfernt ist, wie im Beispiel oben.
- Nutze einen Thread, der über eine Tabelle von Orten läuft, statt einen Thread pro Marker.
- Miss vor und nach einer Änderung, statt zu raten.
Die Anleitung zum Optimieren der FiveM-Server-Performance erklärt, wie du die Kosten einer Ressource mit resmon und dem Profiler misst. Diese Gewohnheiten folgen aus der Regel, in jedem Frame zu zeichnen; wir haben die Beispiele auf dieser Seite nicht gebenchmarkt.
Marker und Checkpoints
Checkpoints sind ein anderes System. Sie werden einmal mit CreateCheckpoint erstellt, das ein Handle zurückgibt; dessen Referenzeintrag warnt, dass das Spiel Checkpoints bereits selbst verwaltet, du darfst sie also nicht wie Marker in einer Schleife aufrufen. Sie haben eigene Typ-IDs, die in der FiveM-Checkpoints-Referenz stehen. Übergib keine Checkpoint-ID an DrawMarker und umgekehrt.
Fragen
Warum flackert mein Marker oder verschwindet er?
Der Zeichenaufruf läuft nicht in jedem Frame. Stelle sicher, dass die Schleife 0 ms wartet, solange der Marker sichtbar sein soll.
Warum schwebt mein Marker oder steckt im Boden?
Passe den Z-Wert der Position an. Die Beispiele ziehen 1.0 vom Z des Punkts ab; ändere diesen Versatz, bis der Marker dort sitzt, wo du ihn willst.
Können Marker aus einem Server-Skript gezeichnet werden?
DrawMarker ist ein Client-Native und hat in der Natives-Referenz keine Server-Version. Der Server kann einem Client die Orte schicken, und der Client zeichnet sie.