Позиции

Математика для точек, записанных простыми объектами (Vec3: { x, y, z } в метрах). Им не нужны нативы, поэтому один и тот же код работает на сервере, на клиенте и на странице NUI.

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

distanceCopy Anchor Link

Расстояние по прямой между двумя точками, в метрах.

Сторона: Клиент, сервер и NUI · Ждёт: нет

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

Lua: аналога нет; используйте #(a - b) с двумя vector3.

ПараметрыCopy Anchor Link

ВозвращаетCopy Anchor Link

number: метры, 0 или больше.

ПримерCopy 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

Расстояние по плоскости земли без учёта высоты (только x и y), в метрах. Используйте для областей, где высота не важна (парковка на склоне, радиус блипа).

Сторона: Клиент, сервер и NUI · Ждёт: нет

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

Lua: аналога нет; используйте #(a.xy - b.xy).

ПараметрыCopy Anchor Link

ВозвращаетCopy Anchor Link

number: метры по плоскости земли.

ПримерCopy 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

Направление от одной точки к другой по соглашению GTA: 0-360 градусов, 0 = север, против часовой стрелки. Используйте, чтобы повернуть педа или камеру к чему-либо.

Сторона: Клиент, сервер и NUI · Ждёт: нет

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

local heading = aiLib.numbers.headingTo(from, to) -- vector3 или таблицы { x, y }

ПараметрыCopy Anchor Link

ВозвращаетCopy Anchor Link

number: направление от 0 до 360 (не включая 360).

ПримерCopy 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

Элемент списка, ближайший к точке (расстояние в 3D), в пределах необязательного радиуса. Работает с любым списком: вы указываете, как прочитать позицию элемента.

Сторона: Клиент, сервер и NUI · Ждёт: нет

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

Lua: аналога нет.

ПараметрыCopy Anchor Link

ВозвращаетCopy Anchor Link

Ближайший элемент или undefined, если список пуст или все элементы дальше max.

ПримерCopy 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

Целочисленная ячейка сетки, в которую попадает точка, на сетке из квадратов со стороной size метров. Потоковая передача областей в lib (AreaStream на сервере, AreaFollower на клиенте) использует её, поэтому обе стороны сходятся в том, в какой ячейке находится точка. Ячейки ограничены значениями плюс-минус 16 000.

Сторона: Клиент, сервер и NUI · Ждёт: нет

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

Lua: аналога нет.

ПараметрыCopy Anchor Link

ВозвращаетCopy Anchor Link

{ cx, cy }: столбец и строка ячейки.

ПримерCopy 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

Одно число для ячейки сетки, достаточно маленькое, чтобы быть быстрым ключом Map (меньше 2^30).

Сторона: Клиент, сервер и NUI · Ждёт: нет

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

Lua: аналога нет.

ПараметрыCopy Anchor Link

ВозвращаетCopy Anchor Link

number: одно и то же число для одной и той же ячейки на любой стороне.

ПримерCopy 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]);
}