Geliştiriciler için ai-vehicles

ai-vehicles’ın sadece server export’ları vardır. Hepsi senkrondur (Promise yok, Lua’da bekleme yok); tek istisna, cevabını bir callback ile veren SpawnVehicle’dır. Tipler @aicore-fivem/shared içindedir (vehicles.ts).

import { resourceExport } from "@aicore-fivem/lib/server";
const vehicles = resourceExport("ai-vehicles");

local vehicles = exports['ai-vehicles']

TiplerCopy Anchor Link

VehicleOwnerCopy Anchor Link

Bir aracın sahibi.

OwnedVehicleCopy Anchor Link

GetVehicle ve GetVehicles’ın döndürdüğü yapı.

Server export’larıCopy Anchor Link

CreateVehicleCopy Anchor Link

Yeni bir sahipli aracı kaydeder ve park eder. Bir oyuncu araç edindiğinde kullan (satın alma, ödül, admin hediyesi). Arabayı spawn etmez: SpawnVehicle ile çıkar ya da oyuncunun onu bir garajdan almasına izin ver.

Taraf: Server · Bekler: hayır

CreateVehicle(owner: VehicleOwner, model: string, garage: string | null, props?: VehicleProps): { id: number; plate: string } | null

local created = exports['ai-vehicles']:CreateVehicle(owner, model, garage, props) -- { id = number, plate = string } ya da nil

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

Yeni aracın { id, plate } değeri. owner geçerli bir sahip değilse ya da model metin değilse null.

ÖrnekCopy Anchor Link

import { resourceExport } from "@aicore-fivem/lib/server";

const core = resourceExport("ai-core");
const vehicles = resourceExport("ai-vehicles");

// Oyuncuya Motel Parking garajında park halinde bir Sultan verir.
export function giveSultan(source: number): string | null {
  const character = core.GetCharacter(source);
  if (!character) return null;
  const created = vehicles.CreateVehicle(
    { type: "character", id: String(character.id) },
    "sultan",
    "pillbox",
  );
  return created?.plate ?? null;
}

GetVehicleCopy Anchor Link

Tek bir sahipli aracı id’si ya da plakasıyla bulur.

Taraf: Server · Bekler: hayır

GetVehicle(ref: number | string): OwnedVehicle | null

local vehicle = exports['ai-vehicles']:GetVehicle(ref) -- table ya da nil

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

OwnedVehicle; bellekte o id’ye ya da plakaya sahip araç yoksa (çevrim dışı bir karaktere aitse de) null.

ÖrnekCopy Anchor Link

const vehicle = vehicles.GetVehicle("AI00001A");
if (vehicle) console.log(vehicle.model, vehicle.state, vehicle.fuel);

GetVehiclesCopy Anchor Link

Tek bir sahibin bütün araçları.

Taraf: Server · Bekler: hayır

GetVehicles(owner: VehicleOwner): OwnedVehicle[]

local list = exports['ai-vehicles']:GetVehicles(owner) -- dizi

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

OwnedVehicle dizisi. Geçersiz bir sahip, aracı olmayan bir sahip ya da çevrim dışı bir karakter için boştur.

ÖrnekCopy Anchor Link

const fleet = vehicles.GetVehicles({ type: "job", id: "police" });
const parked = fleet.filter((v) => v.state === "garage").length;
console.log(`police: ${parked} of ${fleet.length} cars parked`);

IsOwnedPlateCopy Anchor Link

Bir plakanın bellekteki sahipli bir araca ait olup olmadığı.

Taraf: Server · Bekler: hayır

IsOwnedPlate(plate: string): boolean

local owned = exports['ai-vehicles']:IsOwnedPlate(plate)

Dönüş değeriCopy Anchor Link

Bu plakaya sahip sahipli bir araç varsa true. Bilinmeyen bir plaka, metin olmayan bir değer ya da çevrim dışı bir karakterin aracı için false.

GetVehicleIdByEntityCopy Anchor Link

Spawn edilmiş sahipli bir aracın ai-vehicles id’si.

Taraf: Server · Bekler: hayır

GetVehicleIdByEntity(entity: number): number | null

local id = exports['ai-vehicles']:GetVehicleIdByEntity(entity)

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

Araç id’si; entity ai-vehicles’ın spawn ettiği sahipli bir araç değilse null.

GetEntityCopy Anchor Link

Spawn edilmiş sahipli bir aracın entity’si.

Taraf: Server · Bekler: hayır

GetEntity(id: number): number | null

local entity = exports['ai-vehicles']:GetEntity(id)

Dönüş değeriCopy Anchor Link

Server entity handle’ı; araç dışarıda değilse ya da entity’si artık yoksa null.

GetPlateOwnersCopy Anchor Link

Bellekteki her sahipli araç, [plate, ownerType, ownerId] olarak. Çok sayıda plakayı kontrol etmesi gereken bir script (bir anahtar sistemi) her kontrolde export çağırmak yerine bunu açılışta bir kez okur, sonra ai-vehicles:owners event’ini takip eder.

Taraf: Server · Bekler: hayır

GetPlateOwners(): Array<[plate: string, type: VehicleOwnerType, id: string]>

local owners = exports['ai-vehicles']:GetPlateOwners() -- { { plate, type, id }, ... }

Dönüş değeriCopy Anchor Link

Üçlülerden oluşan bir dizi. Bellekte araç yoksa boştur.

SaveVehicleCopy Anchor Link

Bir aracın durumunu ve görünüşünü kaydeder: yakıt, hasar, durum, garaj ve props (renkler, ekstralar, kir). Kayıtlı modifiye (mods, neon) burada asla değişmez; böylece bir oyuncunun client’ından okunan görünüş, bir mod menüsünün yaptıklarını kaydedemez. Modifiye için SaveTuning kullan.

Taraf: Server · Bekler: hayır

SaveVehicle(id: number, change: { props?: VehicleProps; fuel?: number; engine?: number; body?: number; state?: VehicleState; garage?: string | null }): void

exports['ai-vehicles']:SaveVehicle(id, change)

ParametrelerCopy Anchor Link

changeCopy Anchor Link

Dönüş değeriCopy Anchor Link

Hiçbir şey. Bilinmeyen bir id hiçbir şey yapmaz.

ÖrnekCopy Anchor Link

// Bir tamir işi bitti: motor ve kaporta tam.
vehicles.SaveVehicle(vehicleId, { engine: 1000, body: 1000 });

SaveTuningCopy Anchor Link

Modifiye dahil (mods, neon) tam props’u kaydeder. Sadece modifiye dükkânları içindir: onu çağıran tek ai-* script’i, AI Core’un kendi modifiye dükkânı ai-mechanic’tir.

Taraf: Server · Bekler: hayır

SaveTuning(id: number, props: VehicleProps): void

exports['ai-vehicles']:SaveTuning(id, props)

Dönüş değeriCopy Anchor Link

Hiçbir şey. Geçersiz props yok sayılır. Props içindeki plaka her zaman aracın kendi plakasıyla değiştirilir.

StoreVehicleCopy Anchor Link

Bir aracı park eder: dışarıdaysa entity’sini siler, durumunu ve garajını ayarlar.

Taraf: Server · Bekler: hayır

StoreVehicle(id: number, garage: string | null, state?: VehicleState): void

exports['ai-vehicles']:StoreVehicle(id, garage, state)

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

Hiçbir şey. Önce durumu kaydetmez: hasar ve yakıt korunacaksa ondan önce SaveVehicle çağır. Server hangi garaj script’ini çalıştırıyorsa onun üzerinden park etmek için bunun yerine lib’in garages.store fonksiyonunu kullan.

SetOwnerCopy Anchor Link

Bir aracı başka bir sahibe verir (oyuncular arası satış, bir meslek filosuna aktarılan araba).

Taraf: Server · Bekler: hayır

SetOwner(id: number, owner: VehicleOwner): void

exports['ai-vehicles']:SetOwner(id, owner)

Dönüş değeriCopy Anchor Link

Hiçbir şey. Geçersiz bir sahip ya da bilinmeyen bir id hiçbir şey yapmaz. Eski sahibin anahtarları alınmaz: gerekirse lib’in vehicleKeys.remove fonksiyonuyla kaldır.

ÖrnekCopy Anchor Link

vehicles.SetOwner(vehicleId, { type: "job", id: "mechanic" });

DeleteVehicleCopy Anchor Link

Sahipli bir aracı tamamen siler: dışarıdaysa entity’sini ve veritabanı satırını.

Taraf: Server · Bekler: hayır

DeleteVehicle(id: number): void

exports['ai-vehicles']:DeleteVehicle(id)

Dönüş değeriCopy Anchor Link

Hiçbir şey.

SpawnVehicleCopy Anchor Link

Sahipli bir aracın entity’sini dünyada görünüşü, plakası, yakıtı ve state bag’leriyle oluşturur ve anahtarları aktif anahtar sistemi üzerinden asker’a verir. Aracın durumu out olur.

Taraf: Server · Bekler: hayır (sonuç cb içinde gelir)

SpawnVehicle(id: number, at: { x: number; y: number; z: number; heading: number }, asker: number, cb: (netId: number | null) => void, purpose?: KeyPurpose, setup?: VehicleSetup): void

exports['ai-vehicles']:SpawnVehicle(id, at, asker, function(netId) end, purpose, setup)

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

Hiçbir şey. cb network id’sini alır; araç yoksa, zaten dışarıdaysa, şu an spawn ediliyorsa ya da oyun onu oluşturamadıysa null alır.

ÖrnekCopy Anchor Link

import { resourceExport } from "@aicore-fivem/lib/server";

const vehicles = resourceExport("ai-vehicles");

export function bringOut(source: number, vehicleId: number): void {
  const ped = GetPlayerPed(String(source));
  const [x, y, z] = GetEntityCoords(ped);
  const heading = GetEntityHeading(ped);
  vehicles.SpawnVehicle(vehicleId, { x: x + 3, y, z, heading }, source, (netId) => {
    if (netId === null) console.log(`vehicle ${vehicleId} could not come out`);
  });
}

Event’lerCopy Anchor Link

ai-vehicles:ownersCopy Anchor Link

Araçlar ai-vehicles’ın belleğine girdiğinde ya da sahip değiştirdiğinde ve plakalar bellekten çıktığında tetiklenir. Server tick’i başına bir toplu paket. Açılışta GetPlateOwners’ı bir kez oku, sonra plakadan sahibe bir kopya tutmak için bu paketleri uygula. Adı @aicore-fivem/shared içinde VEHICLES_EVENTS.owners’dır.

Taraf: Server (yerel event, client’lara gönderilmez)

import { resourceExport } from "@aicore-fivem/lib/server";
import { VEHICLES_EVENTS } from "@aicore-fivem/shared";

const owners = new Map<string, string>();
for (const [plate, type, id] of resourceExport("ai-vehicles").GetPlateOwners())
  owners.set(plate, `${type}:${id}`);

on(VEHICLES_EVENTS.owners, (puts: [string, string, string][], removes: string[]) => {
  for (const [plate, type, id] of puts) owners.set(plate, `${type}:${id}`);
  for (const plate of removes) owners.delete(plate);
});

State bag’lerCopy Anchor Link

ai-vehicles bunları spawn ettiği her sahipli araçta ayarlar. Adlar VEHICLE_BAGS içindedir (@aicore-fivem/shared).

local vehicle = GetVehiclePedIsIn(PlayerPedId(), false)
if Entity(vehicle).state['ai:owned'] then
  print('owned vehicle', Entity(vehicle).state['ai:vid'])
end

qbx_vehicles APICopy Anchor Link

ai-vehicles qbx_vehicles adını provide eder, bu yüzden bu çağrılar ona ulaşır. Yapılar Qbox’u izler: state değeri 0 dışarıda, 1 garajda, 2 çekilmiş araç otoparkında demektir.

GetPlayerVehicle props’u ox_lib’in değil, AI Core’un VehicleProps yapısında döner. depotPrice her zaman 0’dır.