Предметы

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

inventory отправляет каждый вызов, связанный с предметами, через слой инвентаря ai-core: отвечает инвентарь, запущенный на сервере (ai-inventory или другой, выбранный владельцем в панели ai-core). Ваш скрипт никогда не вызывает собственные экспорты инвентаря, поэтому продолжает работать, когда владелец меняет инвентарь.

Аргумент инвентаря (inv, тип InventoryRef) это серверный id игрока (число) или id другого инвентаря (строка: имя хранилища, номер транспорта).

Количества это целые числа от 1 и выше; дробь округляется вниз, 0 или отрицательное количество приводит к неудаче вызова.

inventory.addItemCopy Anchor Link

Выдаёт предметы в инвентарь.

Сторона: Сервер · Ждёт: нет

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

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

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

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

boolean: true, если выдано. false, если не помещается, предмета не существует, аргумент неверный или не запущен инвентарь.

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

Забирает предметы из инвентаря.

Сторона: Сервер · Ждёт: нет

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

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

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

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

boolean: true, если забрано. false, если не хватает, аргумент неверный или не запущен инвентарь.

ПримерCopy Anchor Link

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

inventory.getItemCountCopy Anchor Link

Сколько единиц предмета содержит инвентарь.

Сторона: Сервер · Ждёт: нет

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

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

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

number: сумма по всем стакам, 0, если предметов нет или не запущен инвентарь.

ПримерCopy Anchor Link

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

inventory.hasItemCopy Anchor Link

Содержит ли инвентарь не меньше count единиц предмета.

Сторона: Сервер · Ждёт: нет

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

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

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

boolean.

ПримерCopy Anchor Link

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

inventory.canCarryItemCopy Anchor Link

Поместятся ли предметы (вес и свободное место).

Сторона: Сервер · Ждёт: нет

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

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

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

boolean: true, если помещаются.

ПримерCopy Anchor Link

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

inventory.getItemsCopy Anchor Link

Все стаки инвентаря.

Сторона: Сервер · Ждёт: нет

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

local stacks = aiLib.inventory.getItems(inv)

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

InventoryStack[]: по одному { name, label, count, slot, metadata } на стак. Пусто, если инвентарь пуст, неизвестен или не запущен ни один инвентарь.

ПримерCopy Anchor Link

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

inventory.clearInventoryCopy Anchor Link

Очищает инвентарь.

Сторона: Сервер · Ждёт: нет

inventory.clearInventory(inv: InventoryRef): void

aiLib.inventory.clearInventory(inv)

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

void.

ПримерCopy Anchor Link

inventory.clearInventory("evidence_locker_12");

inventory.registerStashCopy Anchor Link

Регистрирует хранилище (ящик, шкафчик). ai-core запоминает его и заново регистрирует в любом инвентаре, который запустится позже, поэтому вызовите один раз при запуске скрипта.

Сторона: Сервер · Ждёт: нет

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

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

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

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

void.

ПримерCopy Anchor Link

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

inventory.openInventoryCopy Anchor Link

Открывает хранилище или инвентарь другого игрока на экране игрока.

Сторона: Сервер · Ждёт: нет

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

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

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

boolean: true, если инвентарь его открыл.

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

Запускает ваш обработчик, когда игрок использует предмет. ai-core хранит обработчик для инвентарей, которые запустятся позже, и при перезапусках инвентаря, поэтому регистрируйте один раз при запуске скрипта.

Сторона: Сервер · Ждёт: нет

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

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

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

Использованный стак это UsedItem.

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

void.

ПримерCopy 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; // пока оставляем предмет: bandage() заберёт его после полосы
});

inventory.getItemDefinitionCopy Anchor Link

Название, вес и флаги предмета.

Сторона: Сервер · Ждёт: нет

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

local def = aiLib.inventory.getItemDefinition(name)

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

ItemDefinition (name, label, weight, unique, close, description, image?) или null, если инвентарь не знает этот предмет.

ПримерCopy Anchor Link

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

inventory.registerShopCopy Anchor Link

Регистрирует магазин, который сервер открывает игроку (у него нет собственного места). ai-core заново регистрирует его в любом инвентаре, который запустится позже; вызовите один раз при старте.

Сторона: Сервер · Ждёт: нет

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

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

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

void.

ПримерCopy Anchor Link

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

inventory.openShopCopy Anchor Link

Открывает зарегистрированный магазин на экране игрока.

Сторона: Сервер · Ждёт: нет

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

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

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

boolean: true, если открылся.

ПримерCopy Anchor Link

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