Araçlar

import { plateOf } from "@aicore-fivem/lib/fivem"; // /client ve /server’da da var
import { normalizePlate, vehicleTypeOfClass, toVehicleProps, toVehicleSetup } from "@aicore-fivem/lib/shared";

PlakalarCopy Anchor Link

GTA plakaları boşluklarla 8 karaktere tamamlar (" AI 1 "). Plaka başına veri tutan her script (anahtarlar, yakıt, garajlar) anahtar olarak kırpılmış büyük harfli plakayı kullanır; böylece aynı araç her yerde eşleşir.

plateOfCopy Anchor Link

Anahtarların kullandığı haliyle bir aracın plakası: entity’den okunur, kırpılır, büyük harfe çevrilir.

Taraf: Client ve server · Bekler: hayır

plateOf(vehicle: number): string

Lua: karşılığı yok; GetVehicleNumberPlateText(vehicle):match('^%s*(.-)%s*$'):upper() kullan.

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

string: plaka, kırpılmış ve büyük harfli.

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

Zaten metin olarak elinde olan bir plaka (bir oyuncunun yazdığı, bir veritabanında saklanan, başka bir script’in gönderdiği) için aynı kırpma ve büyük harf.

Taraf: Client, server ve NUI · Bekler: hayır

normalizePlate(plate: string): string

Lua: karşılığı yok; plate:match('^%s*(.-)%s*$'):upper() kullan.

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

string: kırpılmış, büyük harfli.

ÖrnekCopy Anchor Link

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

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

Araç oluşturmaCopy Anchor Link

vehicleTypeOfClassCopy Anchor Link

Bir GTA araç sınıfını (GetVehicleClassFromName) CreateVehicleServerSetter’ın ihtiyaç duyduğu tipe çevirir: "bike", "boat", "heli", "plane", "train" ya da "automobile". Lib’in spawnVehicle’ı bunu senin için yapar; bunu yalnızca CreateVehicleServerSetter’ı kendin çağırdığında kullan.

Taraf: Client, server ve NUI · Bekler: hayır

vehicleTypeOfClass(vehicleClass: number): string

Lua: karşılığı yok.

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

string: spawn tipi. Yukarıda listelenmeyen her sınıf "automobile"’dır.

ÖrnekCopy Anchor Link

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

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

Güvenilmeyen veriden görünümlerCopy Anchor Link

toVehiclePropsCopy Anchor Link

Saklanan ya da alınan araç props’unu kontrol eder ve temiz bir VehicleProps nesnesi ya da veri o biçimde değilse null döndürür. Eksik isteğe bağlı parçalar varsayılanları alır (stok modlar, livery yok, tam sağlık); bilinmeyen alanlar atılır; plaka 8 karaktere kesilir.

Taraf: Client, server ve NUI · Bekler: hayır

toVehicleProps(value: unknown): VehicleProps | null

Lua: karşılığı yok.

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

VehicleProps ya da value bir nesne değilse, v 1 değilse, model veya plate yoksa ya da colors, extraColors, neonColor, tyreSmoke, mods, extras, neon’dan biri eksikse veya uzunluğu yanlışsa null.

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

Alınan bir VehicleSetup’ı alan alan kontrol eder: yanlış alanlar atılır, doğru olanlar tutulur. Bir client’tan ya da başka bir resource’tan gelen bir kurulumu spawnVehicle’a geçirmeden önce bunu kullan.

Taraf: Client, server ve NUI · Bekler: hayır

toVehicleSetup(value: unknown): VehicleSetup | null

Lua: karşılığı yok.

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

Yalnızca geçerli alanlarla VehicleSetup (renkler 0-255, livery 0-100, windowTint 0-6, dirt 0-15; maxed ve engineOn yalnızca tam olarak true iken). value bir nesne değilse null.

ÖrnekCopy Anchor Link

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

toVehicleSetup({ colors: [27, 27], windowTint: 9, maxed: "yes" });
// { colors: [27, 27], windowTint: undefined, maxed: undefined, ... }: hatalı alanlar atılır