fivem docsDeutsch

Entwicklung · FiveM Docs

FiveM Natives: Funktionen, Hashes und Referenz finden

Natives sind Funktionen der GTA-V-Engine oder der Cfx.re-Laufzeit. Sie lesen oder verändern etwa Fahrzeuge, Spieler, Marker und Kameras. Entscheidend ist, ob die Funktion auf Client oder Server verfügbar ist.

Eine Native korrekt nachschlagen

  1. Suche nach dem Funktionsnamen oder der Hash-ID in der offiziellen Cfx.re Native Reference.
  2. Prüfe den API-Set-Eintrag: Client, Server oder Shared. Server-Natives lassen sich nicht einfach beliebig im Client aufrufen.
  3. Vergleiche Parameter, Rückgabewert und Sprache des Beispiels mit deiner Laufzeit.
  4. Achte auf experimentelle oder versionierte Funktionen und teste sie in deinem Ziel-Track.

Typische Fehler

Ein ähnlicher Name bedeutet nicht zwangsläufig identische Signaturen. Eine Native kann für GTA V, FiveM oder den Server unterschiedlich bereitgestellt werden. Client-Handles und netzwerkweit gültige IDs dürfen nicht verwechselt werden.

Bevor du einen Codeblock kopierst, kläre, ob er in client.lua, server.lua, JavaScript oder C# laufen soll. Werte aus nicht vertrauenswürdigen Quellen müssen auf dem Server validiert werden.

Schneller Einstieg in die Suche

Der englische FiveMDocs Native Finder kann Funktionen nach Namen, Hash, Namespace und API-Set filtern. Er kombiniert die offiziellen GTA-V- und Cfx-spezifischen Deklarationen. Für die verbindliche Signatur und aktuelle Änderungen ist die Originalreferenz maßgeblich.

Beispiel-Szenario: Du möchtest ein lokales Menü öffnen und reagierst clientseitig auf Eingaben. Prüfe zuerst die Client-APIs und anschließend, welche Daten der Server tatsächlich autorisieren muss.

Technische Beispiele sind Orientierungshilfen. Führe bei sicherheitskritischen Änderungen Backups durch und teste das Verhalten im echten FXServer sowie im FiveM-Client.