Przedmioty

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

inventory wysyła każde wywołanie przedmiotów przez warstwę ekwipunku ai-core: odpowiada ekwipunek, którego używa serwer (ai-inventory albo inny wybrany przez właściciela w panelu ai-core). Twój skrypt nigdy nie wywołuje własnych eksportów ekwipunku, więc działa dalej, gdy właściciel zmieni ekwipunek.

Argument ekwipunku (inv, typ InventoryRef) to id serwerowe gracza (liczba) albo id innego ekwipunku (string: nazwa schowka, tablica rejestracyjna).

Ilości to liczby całkowite od 1 w górę; ułamek jest zaokrąglany w dół, 0 albo ujemna ilość sprawia, że wywołanie się nie udaje.

inventory.addItemCopy Anchor Link

Daje przedmioty do ekwipunku.

Strona: Serwer · Czeka: nie

inventory.addItem(inv: InventoryRef, item: string, count?: number, metadata?: ItemMetadata, slot?: number): boolean

local ok = aiLib.inventory.addItem(inv, item, count, metadata, slot)

ParametryCopy Anchor Link

Zwracana wartośćCopy Anchor Link

boolean: true, gdy dano. false, gdy się nie mieszczą, przedmiot nie istnieje, argument jest zły albo nie działa żaden ekwipunek.

PrzykładCopy Anchor Link

import { inventory } from "@aicore-fivem/lib/server";
import { fail } from "@aicore-fivem/lib/shared";

if (!inventory.addItem(source, "phone", 1, { number: "555-0101" })) return fail("INVENTORY_FULL");

inventory.removeItemCopy Anchor Link

Zabiera przedmioty z ekwipunku.

Strona: Serwer · Czeka: nie

inventory.removeItem(inv: InventoryRef, item: string, count?: number, metadata?: ItemMetadata, slot?: number): boolean

local ok = aiLib.inventory.removeItem(inv, item, count, metadata, slot)

ParametryCopy Anchor Link

Zwracana wartośćCopy Anchor Link

boolean: true, gdy zabrano. false, gdy jest ich za mało, argument jest zły albo nie działa żaden ekwipunek.

PrzykładCopy Anchor Link

if (!inventory.removeItem(source, "lockpick")) return fail("NO_LOCKPICK");

inventory.getItemCountCopy Anchor Link

Ile sztuk przedmiotu ma ekwipunek.

Strona: Serwer · Czeka: nie

inventory.getItemCount(inv: InventoryRef, item: string, metadata?: ItemMetadata): number

local count = aiLib.inventory.getItemCount(inv, item, metadata)

Zwracana wartośćCopy Anchor Link

number: suma ze wszystkich stosów, 0, gdy nie ma żadnych albo nie działa żaden ekwipunek.

PrzykładCopy Anchor Link

const bags = inventory.getItemCount(source, "weed_bag");
notify(source, `You have ${bags} bags`);

inventory.hasItemCopy Anchor Link

Czy ekwipunek ma co najmniej count sztuk przedmiotu.

Strona: Serwer · Czeka: nie

inventory.hasItem(inv: InventoryRef, item: string, count?: number): boolean

local has = aiLib.inventory.hasItem(inv, item, count)

Zwracana wartośćCopy Anchor Link

boolean.

PrzykładCopy Anchor Link

if (!inventory.hasItem(source, "scrap_metal", 10)) return fail("NEED_10_SCRAP");

inventory.canCarryItemCopy Anchor Link

Czy przedmioty by się zmieściły (waga i wolne miejsce).

Strona: Serwer · Czeka: nie

inventory.canCarryItem(inv: InventoryRef, item: string, count?: number, metadata?: ItemMetadata): boolean

local fits = aiLib.inventory.canCarryItem(inv, item, count, metadata)

Zwracana wartośćCopy Anchor Link

boolean: true, gdy się mieszczą.

PrzykładCopy Anchor Link

if (!inventory.canCarryItem(source, "fish", 5)) return fail("TOO_HEAVY");
inventory.addItem(source, "fish", 5);

inventory.getItemsCopy Anchor Link

Każdy stos ekwipunku.

Strona: Serwer · Czeka: nie

inventory.getItems(inv: InventoryRef): InventoryStack[]

local stacks = aiLib.inventory.getItems(inv)

Zwracana wartośćCopy Anchor Link

InventoryStack[]: jeden { name, label, count, slot, metadata } na stos. Pusta, gdy ekwipunek jest pusty, nieznany albo nie działa żaden ekwipunek.

PrzykładCopy Anchor Link

const weapons = inventory.getItems(source).filter((stack) => stack.name.startsWith("weapon_"));

inventory.clearInventoryCopy Anchor Link

Opróżnia ekwipunek.

Strona: Serwer · Czeka: nie

inventory.clearInventory(inv: InventoryRef): void

aiLib.inventory.clearInventory(inv)

Zwracana wartośćCopy Anchor Link

void.

PrzykładCopy Anchor Link

inventory.clearInventory("evidence_locker_12");

inventory.registerStashCopy Anchor Link

Rejestruje schowek (skrzynię, szafkę). ai-core go zapamiętuje i rejestruje ponownie w każdym ekwipunku, który wystartuje później, więc wywołaj go raz, gdy twój skrypt startuje.

Strona: Serwer · Czeka: nie

inventory.registerStash(name: string, label: string, slots: number, maxWeight: number, jobs?: string[]): void

aiLib.inventory.registerStash(name, label, slots, maxWeight, jobs)

ParametryCopy Anchor Link

Zwracana wartośćCopy Anchor Link

void.

PrzykładCopy Anchor Link

inventory.registerStash("police_armory", "Armory", 50, 200_000, ["police"]);

inventory.openInventoryCopy Anchor Link

Otwiera schowek albo ekwipunek innego gracza na ekranie gracza.

Strona: Serwer · Czeka: nie

inventory.openInventory(source: number, inv: InventoryRef): boolean

local ok = aiLib.inventory.openInventory(source, inv)

Zwracana wartośćCopy Anchor Link

boolean: true, gdy ekwipunek go otworzył.

PrzykładCopy Anchor Link

import { onClientCallback, near, online, inventory } from "@aicore-fivem/lib/server";
import { fail } from "@aicore-fivem/lib/shared";

const ARMORY = { x: 452.3, y: -980.0, z: 30.7 };

onClientCallback(
  "my-police:armory",
  (source) => {
    if (!online.onDutyIn(source, ["police"])) return fail("NOT_ON_DUTY");
    return { ok: inventory.openInventory(source, "police_armory") };
  },
  { guards: [near(ARMORY, 3)] },
);

inventory.registerUsableItemCopy Anchor Link

Uruchamia twój handler, gdy gracz używa przedmiotu. ai-core trzyma handler dla ekwipunków, które startują później, i przez restarty ekwipunku, więc zarejestruj go raz, gdy twój skrypt startuje.

Strona: Serwer · Czeka: nie

inventory.registerUsableItem(name: string, handler: UsableItemHandler): void

aiLib.inventory.registerUsableItem(name, handler) -- handler(source, item)

ParametryCopy Anchor Link

Użyty stos to UsedItem.

Zwracana wartośćCopy Anchor Link

void.

PrzykładCopy Anchor Link

import { inventory, progressFor, medical, createLocale } from "@aicore-fivem/lib/server";

const Locale = createLocale();

async function bandage(source: number) {
  const done = await progressFor(source, { label: Locale("BANDAGING"), duration: 4000, canCancel: true });
  if (done && inventory.removeItem(source, "bandage")) medical.heal(source);
}

inventory.registerUsableItem("bandage", (source) => {
  void bandage(source);
  return false; // na razie zostaw przedmiot: bandage() zabiera go po pasku
});

inventory.getItemDefinitionCopy Anchor Link

Etykieta, waga i flagi przedmiotu.

Strona: Serwer · Czeka: nie

inventory.getItemDefinition(name: string): ItemDefinition | null

local def = aiLib.inventory.getItemDefinition(name)

Zwracana wartośćCopy Anchor Link

ItemDefinition (name, label, weight, unique, close, description, image?) albo null, gdy ekwipunek nie zna przedmiotu.

PrzykładCopy Anchor Link

const label = inventory.getItemDefinition("water")?.label ?? "water";
notify(source, `You bought ${label}`, "success");

inventory.registerShopCopy Anchor Link

Rejestruje sklep, który serwer otwiera dla gracza (nie ma własnego miejsca). ai-core rejestruje go ponownie w każdym ekwipunku, który wystartuje później; wywołaj go raz przy starcie.

Strona: Serwer · Czeka: nie

inventory.registerShop(name: string, label: string, items: ShopProduct[]): void

aiLib.inventory.registerShop(name, label, items)

Zwracana wartośćCopy Anchor Link

void.

PrzykładCopy Anchor Link

inventory.registerShop("police_shop", "Police supplies", [
  { name: "handcuffs", price: 0 },
  { name: "radio", price: 50 },
]);

inventory.openShopCopy Anchor Link

Otwiera zarejestrowany sklep na ekranie gracza.

Strona: Serwer · Czeka: nie

inventory.openShop(source: number, name: string): boolean

local ok = aiLib.inventory.openShop(source, name)

Zwracana wartośćCopy Anchor Link

boolean: true, gdy się otworzył.

PrzykładCopy Anchor Link

onClientCallback("my-police:shop", (source) => {
  if (!online.onDutyIn(source, ["police"])) return fail("NOT_ON_DUTY");
  return { ok: inventory.openShop(source, "police_shop") };
});