Fahrzeuge

import { plateOf } from "@aicore-fivem/lib/fivem"; // auch auf /client und /server
import { normalizePlate, vehicleTypeOfClass, toVehicleProps, toVehicleSetup } from "@aicore-fivem/lib/shared";

KennzeichenCopy Anchor Link

GTA füllt Kennzeichen mit Leerzeichen auf 8 Zeichen auf (" AI 1 "). Jedes Skript, das Daten pro Kennzeichen hält (Schlüssel, Sprit, Garagen), nutzt das getrimmte, großgeschriebene Kennzeichen als Schlüssel, damit dasselbe Fahrzeug überall passt.

plateOfCopy Anchor Link

Das Kennzeichen eines Fahrzeugs, wie Schlüssel es nutzen: von der Entity gelesen, getrimmt, großgeschrieben.

Seite: Client und Server · Wartet: nein

plateOf(vehicle: number): string

Lua: kein Zwilling; nutze GetVehicleNumberPlateText(vehicle):match('^%s*(.-)%s*$'):upper().

ParameterCopy Anchor Link

RückgabewertCopy Anchor Link

string: das Kennzeichen, getrimmt und großgeschrieben.

BeispielCopy Anchor Link

import { plateOf, vehicleOf } from "@aicore-fivem/lib/server";

function plateOfPlayerVehicle(source: number): string | null {
  const vehicle = vehicleOf(source);
  return vehicle === 0 ? null : plateOf(vehicle);
}

normalizePlateCopy Anchor Link

Dasselbe Trimmen und Großschreiben für ein Kennzeichen, das du schon als Text hast (von einem Spieler eingegeben, in einer Datenbank gespeichert, von einem anderen Skript gesendet).

Seite: Client, Server und NUI · Wartet: nein

normalizePlate(plate: string): string

Lua: kein Zwilling; nutze plate:match('^%s*(.-)%s*$'):upper().

ParameterCopy Anchor Link

RückgabewertCopy Anchor Link

string: getrimmt, großgeschrieben.

BeispielCopy Anchor Link

import { normalizePlate } from "@aicore-fivem/lib/shared";

normalizePlate("  ai 123 "); // "AI 123"

SpawnenCopy Anchor Link

vehicleTypeOfClassCopy Anchor Link

Wandelt eine GTA-Fahrzeugklasse (GetVehicleClassFromName) in den Typ um, den CreateVehicleServerSetter braucht: "bike", "boat", "heli", "plane", "train" oder "automobile". spawnVehicle der Lib erledigt das für dich; nutze es nur, wenn du CreateVehicleServerSetter selbst aufrufst.

Seite: Client, Server und NUI · Wartet: nein

vehicleTypeOfClass(vehicleClass: number): string

Lua: kein Zwilling.

ParameterCopy Anchor Link

RückgabewertCopy Anchor Link

string: der Spawn-Typ. Jede oben nicht aufgeführte Klasse ist "automobile".

BeispielCopy Anchor Link

import { vehicleTypeOfClass } from "@aicore-fivem/lib/shared";

const type = vehicleTypeOfClass(GetVehicleClassFromName("frogger")); // "heli"

Aussehen aus nicht vertrauenswürdigen DatenCopy Anchor Link

toVehiclePropsCopy Anchor Link

Prüft gespeicherte oder empfangene Fahrzeug-Props und gibt ein sauberes VehicleProps-Objekt zurück, oder null, wenn die Daten nicht diese Form haben. Fehlende optionale Teile bekommen Standardwerte (Serien-Mods, keine Lackierung, volle Gesundheit); unbekannte Felder werden verworfen; das Kennzeichen wird auf 8 Zeichen gekürzt.

Seite: Client, Server und NUI · Wartet: nein

toVehicleProps(value: unknown): VehicleProps | null

Lua: kein Zwilling.

ParameterCopy Anchor Link

RückgabewertCopy Anchor Link

VehicleProps, oder null, wenn value kein Objekt ist, v nicht 1 ist, model oder plate fehlt oder eines von colors, extraColors, neonColor, tyreSmoke, mods, extras, neon fehlt oder die falsche Länge hat.

BeispielCopy Anchor Link

import { optionalExport } from "@aicore-fivem/lib/server";
import { toVehicleProps } from "@aicore-fivem/lib/shared";

function storedColors(vehicleId: number): [number, number] | null {
  const vehicle = optionalExport("ai-vehicles")?.GetVehicle(vehicleId);
  const props = toVehicleProps(vehicle?.props);
  return props ? props.colors : null;
}

toVehicleSetupCopy Anchor Link

Prüft ein empfangenes VehicleSetup Feld für Feld: Falsche Felder werden verworfen, die richtigen behalten. Nutze es auf einem Setup, das von einem Client oder einer anderen Ressource kommt, bevor du es an spawnVehicle übergibst.

Seite: Client, Server und NUI · Wartet: nein

toVehicleSetup(value: unknown): VehicleSetup | null

Lua: kein Zwilling.

ParameterCopy Anchor Link

RückgabewertCopy Anchor Link

VehicleSetup mit nur den gültigen Feldern (Farben 0-255, livery 0-100, windowTint 0-6, dirt 0-15; maxed und engineOn nur, wenn genau true). null, wenn value kein Objekt ist.

BeispielCopy Anchor Link

import { toVehicleSetup } from "@aicore-fivem/lib/shared";

toVehicleSetup({ colors: [27, 27], windowTint: 9, maxed: "yes" });
// { colors: [27, 27], windowTint: undefined, maxed: undefined, ... }: die fehlerhaften Felder werden verworfen