Zum Inhalt springen

Black Friday: 20 % Rabatt bis 30. Nov.Server-Pakete

RPScripts

FiveM-Marker: Marker-Typen und wie du DrawMarker nutzt

Von Luke, RPScripts

Auf dieser Seite

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.

IDMarker-Name
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?

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.

#ParameterTypWas er bewirkt
1typeintMarker-Typ-ID aus der Tabelle oben.
2–4posX, posY, posZfloatWeltposition, an der der Marker gezeichnet wird.
5–7dirX, dirY, dirZfloatRichtungsvektor; 0.0 für alle drei verwendet stattdessen die Rotationswerte.
8–10rotX, rotY, rotZfloatRotation, wird nur genutzt, wenn der Richtungsvektor 0.0 ist.
11–13scaleX, scaleY, scaleZfloatGröße auf jeder Achse.
14–17red, green, blue, alphaintFarbe und Transparenz, jeweils 0–255.
18bobUpAndDownBOOLBewegt den Marker langsam auf und ab.
19faceCameraBOOLMacht den Marker zu einem Billboard, das immer zur Kamera zeigt.
20p19intMeist auf 2 gesetzt; laut Referenz scheint der Wert nicht direkt eine Rolle zu spielen.
21rotateBOOLRotationen gelten nur für das Heading.
22textureDictchar*Textur-Dictionary, mit dem der Marker gezeichnet wird, oder nil.
23textureNamechar*Texturname in diesem Dictionary oder nil.
24drawOnEntsBOOLOb 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.

  • FiveM-Blips: Sprite-IDs, Farb-IDs und wie du sie hinzufügst

    Ein FiveM-Blip ist ein Symbol auf Karte und Minimap, erstellt mit AddBlipForCoord und gestaltet über eine Sprite-ID und eine Farb-ID. Häufige Sprites, alle Farb-IDs aus der offiziellen Referenz und Lua zum Hinzufügen, Benennen und Entfernen von Blips.

  • Eine kleine FiveM-Telefon-App mit NUI entwickeln

    Eine kleine FiveM-Telefon-App mit NUI entwickeln

    Entwickle zunächst eine kleine telefonähnliche NUI-App, um den vollständigen Ablauf aus Öffnen, Nachrichten, Callbacks und Schließen zu lernen. Dieses Beispiel zeigt eine Sitzungsnotiz, die während der Ressourcenlaufzeit erhalten bleibt. Es enthält weder Anrufe noch Nachrichtendienst, Datenbank oder Framework-Abhängigkeit; dafür brauchst du zusätzliche serverseitige Berechtigungsprüfungen und dauerhafte Speicherung.

  • So entfernst du das Fadenkreuz in FiveM (HideHudComponentThisFrame 14)

    So entfernst du das Fadenkreuz in FiveM (HideHudComponentThisFrame 14)

    Kurze Antwort: FiveM-Server entfernen das standardmäßige GTA-Fadenkreuz – HUD-Komponente 14, das Zielkreuz – indem sie HideHudComponentThisFrame(14) in jedem Frame in einem Client-Skript ausführen. Der Aufruf muss auf dem Client, innerhalb einer Schleife, ausgeführt werden, da HUD-Komponenten im nächsten Frame erneut gerendert werden. Unten: die Copy-Paste-Ressource, ein optionaler Spieler-Umschaltbefehl und Lösungen für ein Fadenkreuz, das immer wieder auftaucht.