Pojazdy i encje

Szukanie pojazdów w pobliżu gracza, zamiana id sieciowych z serwera w lokalne encje oraz odczyt albo nakładanie wyglądu pojazdu. Spawnowanie pojazdu jest tylko na serwerze (spawnVehicle na stronie Pojazdy); lokalne auto w salonie to PreviewVehicle.

Szukanie pojazdówCopy Anchor Link

nearestVehicleCopy Anchor Link

Najbliższy pojazd w danej odległości od lokalnego gracza. Pierwszeństwo ma pojazd, w którym siedzi gracz, chyba że notOwn. Użyj filter, żeby pominąć pojazdy, które nie pasują, więc bagażnik, za którym stoi gracz, wygrywa z bliższym autem obok.

Strona: Klient · Czeka: nie

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

local vehicle = aiLib.nearestVehicle(metres, options) -- 0, gdy nie ma żadnego

ParametryCopy Anchor Link

OpcjeCopy Anchor Link

Zwracana wartośćCopy Anchor Link

number: uchwyt pojazdu albo 0, gdy żaden nie jest w odległości metres.

PrzykładCopy 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

Pojazd, którym kieruje lokalny gracz (siedzi na miejscu kierowcy).

Strona: Klient · Czeka: nie

drivenVehicle(): number | false

Brak odpowiednika w Lua: aiLib.cache.seat == -1 and aiLib.cache.vehicle.

Zwracana wartośćCopy Anchor Link

number | false: uchwyt pojazdu, gdy gracz jest kierowcą, false pieszo albo jako pasażer.

PrzykładCopy 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,
);

Encje z id sieciowychCopy Anchor Link

Serwer wysyła encje jako id sieciowe. Na kliencie encja może jeszcze nie istnieć (gracz jest daleko albo właśnie ją utworzono).

waitForEntityCopy Anchor Link

Czeka, aż encja o danym id sieciowym będzie istnieć na tym kliencie, i ją zwraca.

Strona: Klient · Czeka: tak (Promise w TypeScript, w Lua wstrzymuje wątek)

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

local entity = aiLib.waitForEntity(netId, timeout) -- wywołuj wewnątrz wątku

ParametryCopy Anchor Link

Zwracana wartośćCopy Anchor Link

Promise<number>: uchwyt lokalnej encji albo 0 po upływie limitu czasu. Nigdy się nie odrzuca.

PrzykładCopy Anchor Link

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

// Serwer zespawnował pojazd pracy i wysyła jego id sieciowe.
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

Lokalna encja o danym id sieciowym w tej chwili, bez czekania. Opcjonalnie sprawdza typ encji.

Strona: Klient · Czeka: nie

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

Brak odpowiednika w Lua: NetworkDoesEntityExistWithNetworkId(netId) and NetToEnt(netId) or 0.

ParametryCopy Anchor Link

Zwracana wartośćCopy Anchor Link

number: uchwyt encji albo 0, gdy nie ma jej na tym kliencie albo nie jest typu type.

PrzykładCopy 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);
});

Wygląd pojazduCopy Anchor Link

getVehiclePropsCopy Anchor Link

Czyta każdą właściwość pojazdu, który widzi ten klient: tablica, kolory, modyfikacje, dodatki, neony, uszkodzenia. Zapisz wynik, żeby później przywrócić ten sam wygląd.

Strona: Klient · Czeka: nie

getVehicleProps(vehicle: number): VehicleProps

Brak odpowiednika w Lua.

ParametryCopy Anchor Link

Zwracana wartośćCopy Anchor Link

VehicleProps: v (wersja formatu 1), model, plate (przycięta), plateIndex, colors, extraColors, customPrimary, customSecondary (RGB albo null), wheelType, windowTint, livery, mods (według typu modyfikacji 0-49; modyfikacje przełączane 17-22 jako 1 albo 0), xenonColor, neon (cztery wartości logiczne), neonColor, tyreSmoke, extras (według id dodatku), dirt, engineHealth, bodyHealth.

PrzykładCopy 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

Nakłada zapisane właściwości na pojazd. Działa tylko na pojeździe, który kontroluje ten klient; inni gracze dostają wygląd przez sieć.

Strona: Klient · Czeka: nie

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

Brak odpowiednika w Lua.

ParametryCopy Anchor Link

Zwracana wartośćCopy Anchor Link

void.

PrzykładCopy 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

Nakłada konfigurację spawnu na nowy pojazd: maksymalne osiągi, kolory, malowanie, przyciemnienie szyb, brud, włączony silnik. Działa tylko na pojeździe, który kontroluje ten klient.

Strona: Klient · Czeka: nie

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

Brak odpowiednika w Lua.

ParametryCopy Anchor Link

VehicleSetupCopy Anchor Link

Typ to VehicleSetup.

Zwracana wartośćCopy Anchor Link

void.

PrzykładCopy 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 }),
  );
}