Araçlar ve entity’ler

Oyuncunun yakınındaki araçları bulmak, server’dan gelen network id’leri yerel entity’lere çevirmek ve bir aracın görünümünü okumak ya da uygulamak. Araç oluşturmak yalnızca server’dadır (Araçlar sayfasındaki spawnVehicle); yerel bir galeri (showroom) arabası PreviewVehicle’dır.

Araç bulmakCopy Anchor Link

nearestVehicleCopy Anchor Link

Yerel oyuncuya belirli bir mesafe içindeki en yakın araç. notOwn verilmedikçe oyuncunun oturduğu araç önceliklidir. Uymayan araçları atlamak için filter kullan; böylece oyuncunun arkasında durduğu bagaj, yanındaki daha yakın bir arabaya tercih edilir.

Taraf: Client · Bekler: hayır

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

local vehicle = aiLib.nearestVehicle(metres, options) -- hiç yoksa 0

ParametrelerCopy Anchor Link

SeçeneklerCopy Anchor Link

Dönüş değeriCopy Anchor Link

number: araç handle’ı ya da metres içinde hiç yoksa 0.

ÖrnekCopy 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

Yerel oyuncunun sürdüğü (sürücü koltuğunda oturduğu) araç.

Taraf: Client · Bekler: hayır

drivenVehicle(): number | false

Lua karşılığı yok: aiLib.cache.seat == -1 and aiLib.cache.vehicle.

Dönüş değeriCopy Anchor Link

number | false: oyuncu sürücüyse araç handle’ı; yayayken ya da yolcuyken false.

ÖrnekCopy 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,
);

Network id’lerinden entity’lerCopy Anchor Link

Server entity’leri network id olarak gönderir. Bir client’ta entity henüz var olmayabilir (oyuncu uzaktadır ya da entity yeni oluşturulmuştur).

waitForEntityCopy Anchor Link

Bir network id’nin entity’si bu client’ta var olana kadar bekler ve onu döndürür.

Taraf: Client · Bekler: evet (TypeScript’te Promise, Lua’da thread’i yield eder)

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

local entity = aiLib.waitForEntity(netId, timeout) -- bir thread içinde çağır

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

Promise<number>: yerel entity handle’ı ya da zaman aşımından sonra 0. Asla reddedilmez.

ÖrnekCopy Anchor Link

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

// Server bir meslek aracı oluşturdu ve net id’sini gönderiyor.
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

Beklemeden, bir network id’nin şu anki yerel entity’si. İsteğe bağlı olarak entity tipini kontrol eder.

Taraf: Client · Bekler: hayır

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

Lua karşılığı yok: NetworkDoesEntityExistWithNetworkId(netId) and NetToEnt(netId) or 0.

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

number: entity handle’ı ya da bu client’ta yoksa veya type tipinde değilse 0.

ÖrnekCopy 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);
});

Araç görünümüCopy Anchor Link

getVehiclePropsCopy Anchor Link

Bu client’ın görebildiği bir aracın tüm özelliklerini okur: plaka, renkler, modlar, ekstralar, neon, hasar. Aynı görünümü daha sonra geri koymak için sonucu sakla.

Taraf: Client · Bekler: hayır

getVehicleProps(vehicle: number): VehicleProps

Lua karşılığı yok.

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

VehicleProps: v (format sürümü 1), model, plate (kırpılmış), plateIndex, colors, extraColors, customPrimary, customSecondary (RGB ya da null), wheelType, windowTint, livery, mods (mod tipine göre 0-49; aç/kapa modları 17-22, 1 ya da 0 olarak), xenonColor, neon (dört boolean), neonColor, tyreSmoke, extras (ekstra id’sine göre), dirt, engineHealth, bodyHealth.

ÖrnekCopy 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

Kayıtlı özellikleri bir araca uygular. Yalnızca bu client’ın kontrol ettiği bir araçta çalışır; diğer oyuncular görünümü ağ üzerinden alır.

Taraf: Client · Bekler: hayır

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

Lua karşılığı yok.

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

void.

ÖrnekCopy 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

Yeni bir araca bir spawn kurulumu uygular: maksimum performans, renkler, livery, cam filmi, kir, motor açık. Yalnızca bu client’ın kontrol ettiği bir araçta çalışır.

Taraf: Client · Bekler: hayır

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

Lua karşılığı yok.

ParametrelerCopy Anchor Link

VehicleSetupCopy Anchor Link

Tipi VehicleSetup’tır.

Dönüş değeriCopy Anchor Link

void.

ÖrnekCopy 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 }),
  );
}