ai-smallresources pour les développeurs

Les trois exports sont côté client, synchrones, et lisent le joueur local. GetSeatbelt est typé AiSmallResourcesClientExports dans @aicore-fivem/shared ; IsHandsUp et IsPointing ne sont pas typés (utilisez callExport).

import { resourceExport, callExport } from "@aicore-fivem/lib/client";
const small = resourceExport("ai-smallresources");

Exports clientCopy Anchor Link

GetSeatbeltCopy Anchor Link

Indique si le joueur local porte une ceinture de sécurité.

Côté : client · Attend : non

GetSeatbelt(): boolean | null

local worn = exports['ai-smallresources']:GetSeatbelt() -- true, false ou nil

RetourCopy Anchor Link

true quand il est attaché, false sinon. null quand la fonctionnalité Seatbelt est désactivée dans le panneau, ou que le joueur n’est pas dans un véhicule équipé d’une ceinture.

ExempleCopy Anchor Link

import { seatbelt } from "@aicore-fivem/lib/client";

// L’icône de ceinture d’un HUD : lire une fois, puis suivre les changements.
let worn = seatbelt.isOn();
seatbelt.onChange((value) => {
  worn = value;
});

IsHandsUpCopy Anchor Link

Indique si le joueur local a les mains en l’air (le geste X).

Côté : client · Attend : non

IsHandsUp(): boolean

local up = exports['ai-smallresources']:IsHandsUp()

RetourCopy Anchor Link

true tant que les mains sont levées, false sinon.

IsPointingCopy Anchor Link

Indique si le joueur local pointe du doigt (le geste B).

Côté : client · Attend : non

IsPointing(): boolean

local pointing = exports['ai-smallresources']:IsPointing()

RetourCopy Anchor Link

true pendant le pointage, false sinon.

EventsCopy Anchor Link

ai-smallresources:seatbeltCopy Anchor Link

Se déclenche sur le client local quand la ceinture change. Le nom est SEATBELT_EVENT dans @aicore-fivem/shared. ai-core le relaie comme son propre event de ceinture, que le seatbelt.onChange de la lib écoute ; préférez celui-ci.

Côté : client (event local)

AddEventHandler('ai-smallresources:seatbelt', function(worn)
  print('seat belt', worn)
end)

Tous les autres events d’ai-smallresources sont internes (son client et son serveur).

State bags et métadonnéesCopy Anchor Link

// Serveur : la vraie plaque d’un véhicule, fausse plaque ou non.
export function realPlate(vehicle: number): string {
  const real = Entity(vehicle).state.aiRealPlate as string | undefined;
  return real ?? GetVehicleNumberPlateText(vehicle);
}

Objets utilisablesCopy Anchor Link

Enregistrés via la couche inventaire d’ai-core, ils fonctionnent donc avec l’inventaire qui tourne, quel qu’il soit : binoculars, firework1-firework4, newscam, newsmic, newsboom, fakeplate, notepad, note (métadonnées text et description), diving_gear, diving_fill.