Objets

Ces exports passent par la couche d’inventaire d’ai-core : l’inventaire que le propriétaire du serveur a choisi (ai-inventory, ou un inventaire tiers pris en charge) y répond. Votre script n’appelle jamais les exports d’un inventaire précis, il continue donc de fonctionner quand l’inventaire change. Tant qu’aucun inventaire ne tourne, les vérifications répondent false / null et l’ouverture ne fait rien.

Le client ne fait que lire et ouvrir. Donner et retirer des objets se fait toujours sur le serveur (inventory de la lib côté serveur, ou les exports serveur d’ai-core), où le serveur vérifie d’abord le joueur.

OpenInventoryCopy Anchor Link

Ouvre l’écran d’inventaire du joueur dans l’inventaire actif (avec ce que cet inventaire montre autour : le sol, un coffre de véhicule, une boîte à gants).

Côté : Client · Attend : non

OpenInventory(): void

exports['ai-core']:OpenInventory() -- ou aiLib.inventory.openInventory()

ParamètresCopy Anchor Link

Aucun.

RetourCopy Anchor Link

Rien. Sans inventaire actif, rien ne s’ouvre.

ExempleCopy Anchor Link

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

RegisterCommand("bag", () => inventory.openInventory(), false);

HasItemCopy Anchor Link

Indique si le joueur possède au moins une quantité d’un objet. Utilisez-le pour afficher ou masquer une option (une entrée radiale, une option de ciblage) avant de demander au serveur de faire quelque chose.

Côté : Client · Attend : non

HasItem(item: string, count?: number): boolean

local has = exports['ai-core']:HasItem(item, count) -- ou aiLib.inventory.hasItem(item, count)

ParamètresCopy Anchor Link

RetourCopy Anchor Link

boolean : true quand le joueur en possède au moins count. false quand il en a moins, quand item n’est pas une chaîne, ou quand aucun inventaire ne tourne.

ExempleCopy Anchor Link

import { inventory, notify, triggerServerCallback } from "@aicore-fivem/lib/client";
import { Locale } from "common";

RegisterCommand(
  "picklock",
  async () => {
    // Une vérification rapide pour le joueur ; le serveur revérifie l’objet avant de faire quoi que ce soit.
    if (!inventory.hasItem("lockpick")) return notify(Locale("NEED_LOCKPICK"), "error");
    await triggerServerCallback("myscript:picklock", []);
  },
  false,
);

GetCurrentWeaponCopy Anchor Link

Renvoie l’objet arme que le joueur tient en main, avec son libellé et son image, via l’inventaire actif.

Côté : Client · Attend : non

GetCurrentWeapon(): HeldWeapon | null

local weapon = exports['ai-core']:GetCurrentWeapon() -- { name, label, image? } ou nil

ParamètresCopy Anchor Link

Aucun.

RetourCopy Anchor Link

HeldWeapon tant qu’un objet arme est en main, null quand les mains sont vides ou qu’aucun inventaire ne tourne.

ExempleCopy Anchor Link

import { inventory, onCache } from "@aicore-fivem/lib/client";

// Le lire quand l’arme en main change, pas à chaque frame.
onCache("weapon", () => {
  const weapon = inventory.currentWeapon();
  SendNUIMessage({ action: "weapon", data: weapon });
});

OpenItemPickerCopy Anchor Link

Ouvre le sélecteur d’objets d’ai-core : une grille de recherche de chaque objet de l’inventaire actif avec images, où le joueur compose une liste d’objets et de quantités. Il est destiné aux outils d’administration (donner des objets à un joueur) : la liste d’objets vient du serveur, qui ne l’envoie qu’aux admins. La liste que prend le joueur arrive plus tard par l’événement client ai-lib:client:menuResult.

Côté : Client · Attend : non (la réponse arrive par un événement ; itemPicker de la lib attend pour vous)

OpenItemPicker(requestId: number, request: ItemPickerRequest): void

local list = aiLib.itemPicker({ title = 'Give items', target = 12 }) -- attend ; appelez dans un thread

ParamètresCopy Anchor Link

ItemPickerRequestCopy Anchor Link

Voir aussi ItemPickerRequest.

RetourCopy Anchor Link

Rien sur le moment. Plus tard, ai-core déclenche ai-lib:client:menuResult avec (resource, requestId, value) : value est une liste PickedItem[] ({ name, count }) quand le joueur l’a prise, null quand il a fermé le sélecteur. itemPicker(request) de la lib renvoie Promise<PickedItem[] | null> avec cette valeur, et aiLib.itemPicker(request) renvoie la liste ou nil.

ExempleCopy Anchor Link

import { itemPicker, triggerServerCallback } from "@aicore-fivem/lib/client";
import { Locale } from "common";

// Outil d’admin : choisir des objets pour un joueur, le serveur vérifie l’admin et donne chaque objet.
export async function giveItemsTo(target: number): Promise<void> {
  const list = await itemPicker({ title: Locale("GIVE_ITEMS"), target });
  if (!list || list.length === 0) return;
  await triggerServerCallback("myadmin:giveItems", [target, list]);
}