Транспорт

import { plateOf } from "@aicore-fivem/lib/fivem"; // также в /client и /server
import { normalizePlate, vehicleTypeOfClass, toVehicleProps, toVehicleSetup } from "@aicore-fivem/lib/shared";

НомераCopy Anchor Link

GTA дополняет номера пробелами до 8 символов (" AI 1 "). Каждый скрипт, который хранит данные по номеру (ключи, топливо, гаражи), использует в качестве ключа номер без пробелов по краям и в верхнем регистре, поэтому один и тот же транспорт совпадает везде.

plateOfCopy Anchor Link

Номер транспорта в том виде, в каком его используют ключи: прочитан с сущности, без пробелов по краям, в верхнем регистре.

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

plateOf(vehicle: number): string

Lua: аналога нет; используйте GetVehicleNumberPlateText(vehicle):match('^%s*(.-)%s*$'):upper().

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

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

string: номер без пробелов по краям, в верхнем регистре.

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

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

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

normalizePlate(plate: string): string

Lua: аналога нет; используйте plate:match('^%s*(.-)%s*$'):upper().

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

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

string: без пробелов по краям, в верхнем регистре.

ПримерCopy Anchor Link

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

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

СпавнCopy Anchor Link

vehicleTypeOfClassCopy Anchor Link

Превращает класс транспорта GTA (GetVehicleClassFromName) в тип, который нужен CreateVehicleServerSetter: "bike", "boat", "heli", "plane", "train" или "automobile". spawnVehicle из lib делает это за вас; используйте, только если сами вызываете CreateVehicleServerSetter.

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

vehicleTypeOfClass(vehicleClass: number): string

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

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

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

string: тип спавна. Каждый класс, не перечисленный выше, это "automobile".

ПримерCopy Anchor Link

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

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

Внешний вид из недоверенных данныхCopy Anchor Link

toVehiclePropsCopy Anchor Link

Проверяет сохранённые или полученные свойства транспорта и возвращает чистый объект VehicleProps или null, если данные не в этой форме. Отсутствующие необязательные части получают значения по умолчанию (стоковые моды, без ливреи, полное здоровье); неизвестные поля отбрасываются; номер урезается до 8 символов.

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

toVehicleProps(value: unknown): VehicleProps | null

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

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

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

VehicleProps или null, если value не является объектом, v не равно 1, отсутствует model или plate либо одно из colors, extraColors, neonColor, tyreSmoke, mods, extras, neon отсутствует или имеет неверную длину.

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

Проверяет полученный VehicleSetup поле за полем: неверные поля отбрасываются, верные сохраняются. Используйте для настройки, которая пришла от клиента или другого ресурса, прежде чем передавать её в spawnVehicle.

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

toVehicleSetup(value: unknown): VehicleSetup | null

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

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

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

VehicleSetup только с верными полями (цвета 0-255, livery 0-100, windowTint 0-6, dirt 0-15; maxed и engineOn только если ровно true). null, если value не является объектом.

ПримерCopy Anchor Link

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

toVehicleSetup({ colors: [27, 27], windowTint: 9, maxed: "yes" });
// { colors: [27, 27], windowTint: undefined, maxed: undefined, ... }: неверные поля отброшены