Véhicules

import { plateOf } from "@aicore-fivem/lib/fivem"; // aussi sur /client et /server
import { normalizePlate, vehicleTypeOfClass, toVehicleProps, toVehicleSetup } from "@aicore-fivem/lib/shared";

PlaquesCopy Anchor Link

GTA complète les plaques à 8 caractères avec des espaces (" AI 1 "). Chaque script qui garde des données par plaque (clés, carburant, garages) utilise comme clé la plaque sans espaces autour et en majuscules, pour que le même véhicule corresponde partout.

plateOfCopy Anchor Link

La plaque d’un véhicule telle que les clés l’utilisent : lue sur l’entité, sans espaces autour, en majuscules.

Côté : client et serveur · Attend : non

plateOf(vehicle: number): string

Lua : pas d’équivalent ; utilisez GetVehicleNumberPlateText(vehicle):match('^%s*(.-)%s*$'):upper().

ParamètresCopy Anchor Link

RetourCopy Anchor Link

string : la plaque, sans espaces autour et en majuscules.

ExempleCopy 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

Le même nettoyage des espaces et passage en majuscules pour une plaque que vous avez déjà sous forme de texte (tapée par un joueur, stockée en base de données, envoyée par un autre script).

Côté : client, serveur et NUI · Attend : non

normalizePlate(plate: string): string

Lua : pas d’équivalent ; utilisez plate:match('^%s*(.-)%s*$'):upper().

ParamètresCopy Anchor Link

RetourCopy Anchor Link

string : sans espaces autour, en majuscules.

ExempleCopy Anchor Link

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

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

SpawnCopy Anchor Link

vehicleTypeOfClassCopy Anchor Link

Transforme une classe de véhicule GTA (GetVehicleClassFromName) en type dont CreateVehicleServerSetter a besoin : "bike", "boat", "heli", "plane", "train" ou "automobile". spawnVehicle de la lib le fait pour vous ; ne l’utilisez que quand vous appelez vous-même CreateVehicleServerSetter.

Côté : client, serveur et NUI · Attend : non

vehicleTypeOfClass(vehicleClass: number): string

Lua : pas d’équivalent.

ParamètresCopy Anchor Link

RetourCopy Anchor Link

string : le type de spawn. Chaque classe non listée ci-dessus donne "automobile".

ExempleCopy Anchor Link

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

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

Apparence à partir de données non fiablesCopy Anchor Link

toVehiclePropsCopy Anchor Link

Vérifie des props de véhicule stockées ou reçues et renvoie un objet VehicleProps propre, ou null quand les données n’ont pas cette forme. Les parties facultatives manquantes reçoivent des valeurs par défaut (mods d’origine, pas de livrée, santé pleine) ; les champs inconnus sont retirés ; la plaque est coupée à 8 caractères.

Côté : client, serveur et NUI · Attend : non

toVehicleProps(value: unknown): VehicleProps | null

Lua : pas d’équivalent.

ParamètresCopy Anchor Link

RetourCopy Anchor Link

VehicleProps, ou null quand value n’est pas un objet, que v ne vaut pas 1, que model ou plate manque, ou que l’un de colors, extraColors, neonColor, tyreSmoke, mods, extras, neon manque ou n’a pas la bonne longueur.

ExempleCopy 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

Vérifie champ par champ un VehicleSetup reçu : les champs invalides sont retirés, les bons gardés. Utilisez-le sur une configuration qui vient d’un client ou d’une autre ressource avant de la passer à spawnVehicle.

Côté : client, serveur et NUI · Attend : non

toVehicleSetup(value: unknown): VehicleSetup | null

Lua : pas d’équivalent.

ParamètresCopy Anchor Link

RetourCopy Anchor Link

VehicleSetup avec seulement les champs valides (couleurs 0-255, livery 0-100, windowTint 0-6, dirt 0-15 ; maxed et engineOn seulement quand ils valent exactement true). null quand value n’est pas un objet.

ExempleCopy Anchor Link

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

toVehicleSetup({ colors: [27, 27], windowTint: 9, maxed: "yes" });
// { colors: [27, 27], windowTint: undefined, maxed: undefined, ... } : les champs invalides sont retirés