Fahrzeuge und Entities

Fahrzeuge in der Nähe des Spielers finden, Netzwerk-IDs vom Server in lokale Entities umwandeln und das Aussehen eines Fahrzeugs lesen oder anwenden. Ein Fahrzeug zu spawnen geht nur auf dem Server (spawnVehicle auf Fahrzeuge); ein lokales Ausstellungsauto ist PreviewVehicle.

Fahrzeuge findenCopy Anchor Link

nearestVehicleCopy Anchor Link

Das nächstgelegene Fahrzeug innerhalb einer Entfernung um den lokalen Spieler. Das Fahrzeug, in dem der Spieler sitzt, hat Vorrang, außer bei notOwn. Nutze filter, um Fahrzeuge zu überspringen, die nicht passen, damit der Kofferraum, hinter dem der Spieler steht, vor einem näheren Auto daneben gewinnt.

Seite: Client · Wartet: nein

nearestVehicle(metres: number, options?: { networked?: boolean; notOwn?: boolean; filter?: (vehicle: number) => boolean }): number

local vehicle = aiLib.nearestVehicle(metres, options) -- 0, wenn keins

ParameterCopy Anchor Link

OptionenCopy Anchor Link

RückgabewertCopy Anchor Link

number: das Fahrzeug-Handle, oder 0, wenn keins innerhalb von metres ist.

BeispielCopy Anchor Link

import { callAction, nearestVehicle, notify } from "@aicore-fivem/lib/client";

export async function impound(): Promise<void> {
  const vehicle = nearestVehicle(5, { notOwn: true, filter: (v) => GetPedInVehicleSeat(v, -1) === 0 });
  if (!vehicle) return notify("No empty vehicle near", "error");
  await callAction("mypolice:impound", [NetworkGetNetworkIdFromEntity(vehicle)], { fallback: "IMPOUND_FAILED" });
}

drivenVehicleCopy Anchor Link

Das Fahrzeug, das der lokale Spieler fährt (er sitzt auf dem Fahrersitz).

Seite: Client · Wartet: nein

drivenVehicle(): number | false

Kein Lua-Zwilling: aiLib.cache.seat == -1 and aiLib.cache.vehicle.

RückgabewertCopy Anchor Link

number | false: das Fahrzeug-Handle, wenn der Spieler der Fahrer ist, false zu Fuß oder als Beifahrer.

BeispielCopy Anchor Link

import { drivenVehicle, notify } from "@aicore-fivem/lib/client";

RegisterCommand(
  "flip",
  () => {
    const vehicle = drivenVehicle();
    if (vehicle === false) return notify("You must drive a vehicle", "error");
    SetVehicleOnGroundProperly(vehicle);
  },
  false,
);

Entities aus Netzwerk-IDsCopy Anchor Link

Der Server sendet Entities als Netzwerk-IDs. Auf einem Client existiert die Entity eventuell noch nicht (der Spieler ist weit weg, oder sie wurde gerade erstellt).

waitForEntityCopy Anchor Link

Wartet, bis die Entity einer Netzwerk-ID auf diesem Client existiert, und gibt sie zurück.

Seite: Client · Wartet: ja (Promise in TypeScript, hält in Lua den Thread an)

waitForEntity(netId: number, timeoutMs?: number): Promise<number>

local entity = aiLib.waitForEntity(netId, timeout) -- innerhalb eines Threads aufrufen

ParameterCopy Anchor Link

RückgabewertCopy Anchor Link

Promise<number>: das lokale Entity-Handle, oder 0 nach dem Timeout. Es wird nie abgelehnt.

BeispielCopy Anchor Link

import { onServerEvent, waitForEntity } from "@aicore-fivem/lib/client";
import { readId } from "@aicore-fivem/lib/shared";

// Der Server hat ein Job-Fahrzeug gespawnt und sendet seine Net-ID.
onServerEvent(
  "myjob:vehicle",
  { args: ([id]) => { const netId = readId(id); return netId === null ? null : [netId]; } },
  async (netId) => {
    const vehicle = await waitForEntity(netId);
    if (vehicle) SetVehicleFuelLevel(vehicle, 100);
  },
);

entityFromNetIdCopy Anchor Link

Die lokale Entity einer Netzwerk-ID genau jetzt, ohne zu warten. Prüft optional den Entity-Typ.

Seite: Client · Wartet: nein

entityFromNetId(netId: number, type?: 1 | 2 | 3): number

Kein Lua-Zwilling: NetworkDoesEntityExistWithNetworkId(netId) and NetToEnt(netId) or 0.

ParameterCopy Anchor Link

RückgabewertCopy Anchor Link

number: das Entity-Handle, oder 0, wenn sie nicht auf diesem Client ist oder nicht vom Typ type.

BeispielCopy Anchor Link

import { entityFromNetId, EntityState, stateBoolean } from "@aicore-fivem/lib/client";

const sirens = new EntityState("sirensMuted", stateBoolean);

sirens.onChange((netId, muted) => {
  const vehicle = entityFromNetId(netId, 2);
  if (vehicle) SetVehicleHasMutedSirens(vehicle, muted === true);
});

Aussehen von FahrzeugenCopy Anchor Link

getVehiclePropsCopy Anchor Link

Liest jede Eigenschaft eines Fahrzeugs, das dieser Client sehen kann: Kennzeichen, Farben, Mods, Extras, Neon, Schaden. Speichere das Ergebnis, um später dasselbe Aussehen wiederherzustellen.

Seite: Client · Wartet: nein

getVehicleProps(vehicle: number): VehicleProps

Kein Lua-Zwilling.

ParameterCopy Anchor Link

RückgabewertCopy Anchor Link

VehicleProps: v (Formatversion 1), model, plate (getrimmt), plateIndex, colors, extraColors, customPrimary, customSecondary (RGB oder null), wheelType, windowTint, livery, mods (nach Mod-Typ 0-49; Schalt-Mods 17-22 als 1 oder 0), xenonColor, neon (vier Booleans), neonColor, tyreSmoke, extras (nach Extra-ID), dirt, engineHealth, bodyHealth.

BeispielCopy Anchor Link

import { callAction, drivenVehicle, getVehicleProps } from "@aicore-fivem/lib/client";

export async function saveLook(): Promise<void> {
  const vehicle = drivenVehicle();
  if (vehicle === false) return;
  await callAction("mygarage:saveProps", [NetworkGetNetworkIdFromEntity(vehicle), getVehicleProps(vehicle)], { fallback: "SAVE_FAILED" });
}

setVehiclePropsCopy Anchor Link

Wendet gespeicherte Eigenschaften auf ein Fahrzeug an. Funktioniert nur bei einem Fahrzeug, das dieser Client kontrolliert; andere Spieler bekommen das Aussehen über das Netzwerk.

Seite: Client · Wartet: nein

setVehicleProps(vehicle: number, props: VehicleProps): void

Kein Lua-Zwilling.

ParameterCopy Anchor Link

RückgabewertCopy Anchor Link

void.

BeispielCopy Anchor Link

import { onServerEvent, setVehicleProps, waitForEntity } from "@aicore-fivem/lib/client";
import { readId, toVehicleProps } from "@aicore-fivem/lib/shared";

onServerEvent(
  "mygarage:look",
  {
    args: ([id, raw]) => {
      const netId = readId(id);
      const props = toVehicleProps(raw);
      return netId === null || props === null ? null : [netId, props];
    },
  },
  async (netId, props) => {
    const vehicle = await waitForEntity(netId);
    if (vehicle && NetworkHasControlOfEntity(vehicle)) setVehicleProps(vehicle, props);
  },
);

setVehicleSetupCopy Anchor Link

Wendet ein Spawn-Setup auf ein neues Fahrzeug an: maximale Leistung, Farben, Lackierung, Tönung, Schmutz, Motor an. Funktioniert nur bei einem Fahrzeug, das dieser Client kontrolliert.

Seite: Client · Wartet: nein

setVehicleSetup(vehicle: number, setup: VehicleSetup): void

Kein Lua-Zwilling.

ParameterCopy Anchor Link

VehicleSetupCopy Anchor Link

Der Typ ist VehicleSetup.

RückgabewertCopy Anchor Link

void.

BeispielCopy Anchor Link

import { PreviewVehicle, setVehicleSetup } from "@aicore-fivem/lib/client";

const preview = new PreviewVehicle();

export function showMaxed(model: string): Promise<number> {
  return preview.show(model, { x: -44.4, y: -1097.1, z: 26.4, heading: 120 }, (vehicle) =>
    setVehicleSetup(vehicle, { maxed: true, primary: [20, 200, 120], windowTint: 1 }),
  );
}