Pojazdy

import { spawnVehicle, vehicleKeys, fuel, garages, vehicleFromNet } from "@aicore-fivem/lib/server";

SpawnowanieCopy Anchor Link

spawnVehicleCopy Anchor Link

Tworzy pojazd sieciowy na serwerze i konfiguruje go w jednym wywołaniu: tablica, paliwo, wygląd, zamek, routing bucket, klucze do właściwego celu, kierowca i pasażerowie. Używaj go dla każdego pojazdu skryptu (pojazdy pracy, wypożyczenia, pojazdy z garażu, spawny administratora).

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

spawnVehicle(options: SpawnVehicleOptions): Promise<number | null>

local vehicle = aiLib.spawnVehicle(options) -- encja albo nil, wywołuj wewnątrz wątku

ParametryCopy Anchor Link

SpawnVehicleOptionsCopy Anchor Link

Zwracana wartośćCopy Anchor Link

Promise<number | null>: uchwyt encji pojazdu. null, gdy model nie istnieje (tak powiedział klient asker), encja nie została utworzona w ciągu 5 sekund albo typ jest nieznany.

PrzykładCopy Anchor Link

import { onClientCallback, spawnVehicle, hasCharacter, near } from "@aicore-fivem/lib/server";
import { fail } from "@aicore-fivem/lib/shared";

const DEPOT = { x: 895.4, y: -179.3, z: 74.7 };

onClientCallback(
  "my-taxi:start",
  async (source) => {
    const vehicle = await spawnVehicle({
      model: "taxi",
      coords: { x: 899.1, y: -180.6, z: 73.8, heading: 238 },
      asker: source,
      keysTo: source,
      purpose: "job",
      driver: source,
      fuel: 100,
      setup: { dirt: 0 },
    });
    if (!vehicle) return fail("SPAWN_FAILED");
    return { ok: true, netId: NetworkGetNetworkIdFromEntity(vehicle) };
  },
  { guards: [hasCharacter(), near(DEPOT, 5)], lock: true },
);

vehicleTypeCopy Anchor Link

Typ spawnu modelu, zapytany od klienta gracza. Używaj go, żeby sprawdzić, czy model istnieje, zanim weźmiesz pieniądze.

Strona: Serwer · Czeka: tak (Promise)

vehicleType(model: string, asker: number): Promise<string | null>

Brak odpowiednika w Lua: aiLib.spawnVehicle z asker to sprawdza i zwraca nil dla nieznanego modelu.

Zwracana wartośćCopy Anchor Link

Promise<string | null>: automobile, bike, boat, heli, plane, submarine, trailer albo train; null, gdy gra nie ma takiego pojazdu albo klient nie dał poprawnej odpowiedzi. Odpowiedź jest zachowywana dla wszystkich, gdy zgodzą się co do niej klienty dwóch różnych graczy, więc jeden zmodyfikowany klient może zepsuć tylko własne spawny.

PrzykładCopy Anchor Link

import { onClientCallback, vehicleType } from "@aicore-fivem/lib/server";
import { fail, oneArg, readText } from "@aicore-fivem/lib/shared";

onClientCallback("my-dealer:buy", { args: oneArg((v) => readText(v, 32)), lock: true }, async (source, model) => {
  if (!(await vehicleType(model, source))) return fail("UNKNOWN_MODEL");
  // weź pieniądze, potem spawnVehicle(...)
  return { ok: true };
});

randomPlateCopy Anchor Link

Losowa tablica jak w samej grze (dwie cyfry, trzy litery, trzy cyfry) albo twój prefiks i po nim cyfry.

Strona: Serwer · Czeka: nie

randomPlate(prefix?: string): string

Brak odpowiednika w Lua (aiLib.spawnVehicle ustawia losową tablicę, gdy żadnej nie podasz).

Zwraca 8-znakową tablicę (42ABC123 albo TAXI1234 dla randomPlate("TAXI")). Nie jest sprawdzana pod kątem unikalności: sprawdź własną tabelę, zanim ją zapiszesz.

const plate = randomPlate("RENT");

Szukanie pojazdówCopy Anchor Link

nearestVehicleToCopy Anchor Link

Najbliższy pojazd w odległości metres od gracza, który przechodzi twój filtr. Pierwszeństwo ma pojazd, w którym siedzi gracz.

Strona: Serwer · Czeka: nie

nearestVehicleTo(source: number, metres: number, filter?: (vehicle: number) => boolean): number

local vehicle = aiLib.nearestVehicleTo(source, metres, filter) -- encja albo 0

Zwraca encję pojazdu albo 0, gdy nie ma żadnego.

const vehicle = nearestVehicleTo(source, 5);
if (!vehicle) return fail("NO_VEHICLE");

nearestVehicleAtCopy Anchor Link

Najbliższy pojazd w odległości metres od punktu. Używaj jej, żeby sprawdzić, czy miejsce spawnu jest wolne.

Strona: Serwer · Czeka: nie

nearestVehicleAt(point: { x: number; y: number; z: number }, metres: number, filter?: (vehicle: number) => boolean): number

Brak odpowiednika w Lua.

Zwraca encję pojazdu albo 0, gdy nie ma żadnego. Przechodzi po każdym pojeździe, jak nearestVehicleTo.

const SPOT = { x: 899.1, y: -180.6, z: 73.8 };
if (nearestVehicleAt(SPOT, 3)) return fail("SPOT_BLOCKED");

Encje z wejścia klientaCopy Anchor Link

Klient wysyła id sieciowe, nigdy uchwyt encji. Te funkcje zamieniają id sieciowe w żywą encję serwerową i ją sprawdzają, więc nigdy nie wywołujesz ręcznie NetworkGetEntityFromNetworkId + DoesEntityExist + GetEntityType.

entityFromNetCopy Anchor Link

Żywa encja stojąca za id sieciowym klienta.

Strona: Serwer · Czeka: nie

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

Brak odpowiednika w Lua (Lua ma vehicleFromNet).

Zwraca encję albo 0, gdy wartość nie jest dodatnią liczbą całkowitą, nie jest sieciowa, zniknęła albo jest innego typu.

const prop = entityFromNet(rawNetId, 3);
if (!prop) return fail("NOT_FOUND");

pedFromNetCopy Anchor Link

entityFromNet(netId, 1): żywy ped albo 0.

Strona: Serwer · Czeka: nie

pedFromNet(netId: unknown): number

Brak odpowiednika w Lua.

const ped = pedFromNet(rawNetId);

vehicleFromNetCopy Anchor Link

entityFromNet(netId, 2): żywy pojazd albo 0.

Strona: Serwer · Czeka: nie

vehicleFromNet(netId: unknown): number

local vehicle = aiLib.vehicleFromNet(netId) -- encja albo 0

const vehicle = vehicleFromNet(rawNetId);
if (!vehicle) return fail("NO_VEHICLE");

vehicleNearPlayerCopy Anchor Link

Pojazd stojący za id sieciowym klienta, ale tylko gdy gracz jest blisko niego (albo na jego miejscu kierowcy).

Strona: Serwer · Czeka: nie

vehicleNearPlayer(source: number, netId: unknown, options?: { metres?: number; driver?: boolean }): number

local vehicle = aiLib.vehicleNearPlayer(source, netId, options) -- encja albo 0

Zwraca pojazd albo 0, gdy id jest złe, pojazd zniknął albo gracz jest za daleko / nie jest kierowcą.

onClientCallback("my-tow:hook", { args: oneArg(readId), lock: true }, (source, netId) => {
  const vehicle = vehicleNearPlayer(source, netId, { metres: 6 });
  if (!vehicle) return fail("TOO_FAR");
  return { ok: true };
});

KluczeCopy Anchor Link

vehicleKeys przechodzi przez warstwę kluczy ai-core: odpowiada skrypt kluczy, którego używa serwer (ai-vehiclekeys albo inny wybrany przez właściciela). Pojazd to uchwyt encji serwerowej albo tablica.

vehicleKeys.giveCopy Anchor Link

Daje graczowi klucze pojazdu.

Strona: Serwer · Czeka: nie

vehicleKeys.give(source: number, vehicle: number | string, purpose?: KeyPurpose): void

aiLib.vehicleKeys.give(source, vehicle, purpose)

Zwraca void.

vehicleKeys.give(source, vehicle, "rental");

vehicleKeys.removeCopy Anchor Link

Zabiera graczowi klucze pojazdu.

Strona: Serwer · Czeka: nie

vehicleKeys.remove(source: number, vehicle: number | string): void

aiLib.vehicleKeys.remove(source, vehicle)

Zwraca void.

vehicleKeys.remove(source, "RENT1234");

vehicleKeys.hasCopy Anchor Link

Czy gracz ma klucze.

Strona: Serwer · Czeka: nie

vehicleKeys.has(source: number, vehicle: number | string): boolean

local has = aiLib.vehicleKeys.has(source, vehicle)

Zwraca boolean. true także wtedy, gdy skrypt kluczy nie potrafi tego stwierdzić albo żaden nie działa, więc nie używaj tego jako jedynego zabezpieczenia czegoś cennego.

if (!vehicleKeys.has(source, vehicle)) return fail("NO_KEYS");

PaliwoCopy Anchor Link

fuel czyta i ustawia paliwo pojazdu (od 0 do 100) przez warstwę paliwa ai-core, niezależnie od tego, jaki skrypt paliwa działa. Brak odpowiednika w Lua na serwerze: wywołaj eksporty ai-core GetVehicleFuel / SetVehicleFuel.

fuel.getCopy Anchor Link

Strona: Serwer · Czeka: nie

fuel.get(vehicle: number): number | null

Zwraca poziom encji pojazdu serwerowego (od 0 do 100) albo null, gdy go nie ma.

const level = fuel.get(vehicle) ?? 0;

fuel.setCopy Anchor Link

Strona: Serwer · Czeka: nie

fuel.set(vehicle: number, level: number): boolean

Zwraca true, gdy ustawiono, false dla złego pojazdu.

fuel.set(vehicle, 100);

fuel.providerCopy Anchor Link

Strona: Serwer · Czeka: nie

fuel.provider(): string | null

Zwraca nazwę zasobu skryptu paliwa, który odpowiada (ai-fuel, ox_fuel, LegacyFuel...), albo null, gdy żaden nie działa.

console.log(`fuel through ${fuel.provider() ?? "nothing"}`);

GarażeCopy Anchor Link

garages przechodzi przez warstwę garaży ai-core, niezależnie od tego, jaki skrypt garaży działa; każdy skrypt odpowiada tylko na to, co udostępnia. Brak odpowiednika w Lua.

garages.impoundCopy Anchor Link

Wysyła pojazd na parking policyjny albo otwiera formularz parkingu policyjnego skryptu garaży dla by.

Strona: Serwer · Czeka: nie

garages.impound(vehicle: number, by?: number): boolean

Zwraca true, gdy skrypt garaży go przyjął. false, gdy nic go nie przyjęło: usuń pojazd sam.

if (!garages.impound(vehicle, source)) DeleteEntity(vehicle);

garages.storeCopy Anchor Link

Zapisuje pojazd w garażu.

Strona: Serwer · Czeka: nie

garages.store(vehicle: number, garage?: string | null, by?: number): boolean

Zwraca true, gdy zapisano, false, gdy nic go nie przyjęło.

if (!garages.store(vehicle, "legion", source)) return fail("STORE_FAILED");

garages.openCopy Anchor Link

Otwiera menu garażu skryptu garaży dla gracza.

Strona: Serwer · Czeka: nie

garages.open(source: number, garage?: string | null): boolean

Zwraca true, gdy otwarto, false, gdy skrypt nie ma takiego menu.

garages.open(source, "pillbox");

garages.storedCopy Anchor Link

Pojazdy gracza w garażach albo na parkingu policyjnym.

Strona: Serwer · Czeka: tak (Promise)

garages.stored(source: number): Promise<GaragedVehicle[] | null>

Zwraca GaragedVehicle[] (plate, model, garage, impounded) albo null, gdy skrypt nie potrafi tego stwierdzić albo ai-core jest zatrzymany.

const list = await garages.stored(source);
const impounded = list?.filter((v) => v.impounded).length ?? 0;

garages.providerCopy Anchor Link

Strona: Serwer · Czeka: nie

garages.provider(): string | null

Zwraca skrypt garaży, który odpowiada, albo null, gdy żaden nie działa.

if (!garages.provider()) console.warn("no garage script runs");