Pozycje

Obliczenia na punktach zapisanych jako zwykłe obiekty (Vec3: { x, y, z } w metrach). Nie potrzebują natywek, więc ten sam kod działa na serwerze, na kliencie i na stronie NUI.

import { distance, flatDistance, headingTo, nearestOf, gridCell, cellKey } from "@aicore-fivem/lib/shared";

distanceCopy Anchor Link

Odległość w linii prostej między dwoma punktami, w metrach.

Strona: Klient, serwer i NUI · Czeka: nie

distance(a: Vec3, b: Vec3): number

Lua: brak odpowiednika; użyj #(a - b) z dwoma vector3.

ParametryCopy Anchor Link

Zwracana wartośćCopy Anchor Link

number: metry, 0 lub więcej.

PrzykładCopy Anchor Link

import { coordsOf } from "@aicore-fivem/lib/server";
import { distance } from "@aicore-fivem/lib/shared";

const counter = { x: 25.7, y: -1347.3, z: 29.5 };

function nearCounter(source: number): boolean {
  return distance(coordsOf(source), counter) <= 3;
}

flatDistanceCopy Anchor Link

Odległość na płaszczyźnie ziemi, z pominięciem wysokości (tylko x i y), w metrach. Używaj jej dla obszarów, w których wysokość nie ma znaczenia (parking na zboczu, promień blipa).

Strona: Klient, serwer i NUI · Czeka: nie

flatDistance(a: { x: number; y: number }, b: { x: number; y: number }): number

Lua: brak odpowiednika; użyj #(a.xy - b.xy).

ParametryCopy Anchor Link

Zwracana wartośćCopy Anchor Link

number: metry na płaszczyźnie ziemi.

PrzykładCopy Anchor Link

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

flatDistance({ x: 0, y: 0, z: 0 }, { x: 3, y: 4, z: 50 }); // 5

headingToCopy Anchor Link

Kierunek, który patrzy z jednego punktu na drugi, w konwencji GTA: 0-360 stopni, 0 = północ, przeciwnie do ruchu wskazówek zegara. Używaj go, żeby obrócić peda albo kamerę w stronę czegoś.

Strona: Klient, serwer i NUI · Czeka: nie

headingTo(from: { x: number; y: number }, to: { x: number; y: number }): number

local heading = aiLib.numbers.headingTo(from, to) -- vector3 albo tabele { x, y }

ParametryCopy Anchor Link

Zwracana wartośćCopy Anchor Link

number: kierunek od 0 do 360 (bez 360).

PrzykładCopy Anchor Link

import { cache, player } from "@aicore-fivem/lib/client";
import { headingTo } from "@aicore-fivem/lib/shared";

const counter = { x: 25.7, y: -1347.3, z: 29.5 };
SetEntityHeading(cache.ped, headingTo(player.coords(), counter));

nearestOfCopy Anchor Link

Element listy najbliższy punktowi (odległość 3D), w opcjonalnym zasięgu. Działa dla każdej listy: mówisz, jak odczytać pozycję elementu.

Strona: Klient, serwer i NUI · Czeka: nie

nearestOf<T>(items: Iterable<T>, point: Vec3, pos: (item: T) => Vec3, max?: number): T | undefined

Lua: brak odpowiednika.

ParametryCopy Anchor Link

Zwracana wartośćCopy Anchor Link

Najbliższy element albo undefined, gdy lista jest pusta albo każdy element jest dalej niż max.

PrzykładCopy Anchor Link

import { coordsOf } from "@aicore-fivem/lib/server";
import { nearestOf, type Vec3 } from "@aicore-fivem/lib/shared";

const atms: Array<{ id: string; coords: Vec3 }> = [
  { id: "legion", coords: { x: 147.4, y: -1035.8, z: 29.3 } },
  { id: "pillbox", coords: { x: 296.2, y: -591.6, z: 43.3 } },
];

function atmNear(source: number) {
  return nearestOf(atms, coordsOf(source), (atm) => atm.coords, 2);
}

gridCellCopy Anchor Link

Całkowitoliczbowa komórka siatki, w którą wpada punkt, na siatce kwadratów o boku size metrów. Strumieniowanie obszarów liba (AreaStream na serwerze, AreaFollower na kliencie) jej używa, więc obie strony zgadzają się, w której komórce jest punkt. Komórki są ograniczone do plus minus 16 000.

Strona: Klient, serwer i NUI · Czeka: nie

gridCell(x: number, y: number, size: number): { cx: number; cy: number }

Lua: brak odpowiednika.

ParametryCopy Anchor Link

Zwracana wartośćCopy Anchor Link

{ cx, cy }: kolumna i wiersz komórki.

PrzykładCopy Anchor Link

import { gridCell, cellKey } from "@aicore-fivem/lib/shared";

const { cx, cy } = gridCell(147.4, -1035.8, 100); // { cx: 1, cy: -11 }
const key = cellKey(cx, cy);

cellKeyCopy Anchor Link

Jedna liczba dla komórki siatki, na tyle mała, żeby była szybkim kluczem Map (poniżej 2^30).

Strona: Klient, serwer i NUI · Czeka: nie

cellKey(cx: number, cy: number): number

Lua: brak odpowiednika.

ParametryCopy Anchor Link

Zwracana wartośćCopy Anchor Link

number: ta sama liczba dla tej samej komórki, po każdej stronie.

PrzykładCopy Anchor Link

import { gridCell, cellKey } from "@aicore-fivem/lib/shared";

const byCell = new Map<number, string[]>();

function addSign(id: string, x: number, y: number): void {
  const { cx, cy } = gridCell(x, y, 100);
  const key = cellKey(cx, cy);
  byCell.set(key, [...(byCell.get(key) ?? []), id]);
}