Eşyalar

Her eşya çağrısı ai-core üzerinden gider, asla bir envanter script’inin kendi export’ları üzerinden değil. ai-core her çağrıyı aktif envantere iletir: panelin Inventory script ayarının seçtiği ya da otomatik ayarlıyken çalışan ilk envanter (ai-inventory, ox_inventory, qb-inventory, tgiann-inventory ve uyumluluk listesindeki diğerleri). Sunucu sahibi envanteri değiştirdiğinde script’in hiç değişmeden çalışmaya devam eder.

Bilmen gerekenler:

• Bir envanter bir InventoryRef ile adlandırılır: o oyuncunun cepleri için oyuncunun server id’si (bir sayı), başka her şey için bir metin id (bir stash adı, bir bagaj plakası). Bkz. InventoryRef.
• Eşya adları envanterin eşya adlarıdır (water, bandage, WEAPON_PISTOL).
• Metadata tek bir yığındaki ek değerlerin tablosudur (seri numarası, dayanıklılık). Bkz. ItemMetadata.
• Hiçbir envanter çalışmıyorken her çağrı kendi "hiçbir şey" değerini döndürür: false, 0, boş bir liste ya da null.
• Kaydettiğin stash’ler, dükkanlar ve kullanılabilir eşyalar ai-core tarafından tutulur ve sonradan aktif olan her envantere, bir envanter yeniden başladıktan sonra da verilir. Onları script’in başladığında bir kez kaydet.

AddItemCopy Anchor Link

Bir envantere eşya verir.

Taraf: Server · Bekler: hayır · Lib: inventory.addItem

AddItem(inv: InventoryRef, item: string, count?: number, metadata?: ItemMetadata, slot?: number): boolean

local ok = exports['ai-core']:AddItem(source, 'water', 2)

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

boolean: envanter eşyaları eklediğinde true. Sığmıyorlarsa, eşya envanterde yoksa, bir argüman yanlışsa (count 1’in altında, boş eşya adı) ya da hiçbir envanter çalışmıyorsa false.

ÖrnekCopy Anchor Link

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

const core = resourceExport("ai-core");
const TAP = { x: 1206.4, y: -3110.2, z: 5.6 };

onClientCallback("myscript:fillBottle", { guards: [near(TAP, 2)], lock: true }, (source) => {
  if (!core.RemoveItem(source, "empty_bottle")) return fail("NO_BOTTLE");
  if (!core.AddItem(source, "water")) {
    core.AddItem(source, "empty_bottle");
    return fail("NO_SPACE");
  }
  return { ok: true };
});

RemoveItemCopy Anchor Link

Bir envanterden eşya alır.

Taraf: Server · Bekler: hayır · Lib: inventory.removeItem

RemoveItem(inv: InventoryRef, item: string, count?: number, metadata?: ItemMetadata, slot?: number): boolean

local ok = exports['ai-core']:RemoveItem(source, 'lockpick', 1)

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

boolean: eşyalar alındığında true. Envanterde daha az varsa (o zaman hiçbiri alınmaz), bir argüman yanlışsa ya da hiçbir envanter çalışmıyorsa false.

ÖrnekCopy Anchor Link

import { onClientCallback, minigameFor, resourceExport } from "@aicore-fivem/lib/server";
import { fail } from "@aicore-fivem/lib/shared";

const core = resourceExport("ai-core");

onClientCallback("myscript:pickLock", { lock: true }, async (source) => {
  if (!core.HasItem(source, "lockpick")) return fail("NO_LOCKPICK");
  const result = await minigameFor(source, { game: "lockpick", minMs: 1500 });
  if (result === "broken") core.RemoveItem(source, "lockpick");
  return result === "won" ? { ok: true } : fail("LOCKPICK_FAILED");
});

GetItemCountCopy Anchor Link

Bir envanterde bir eşyadan kaç tane olduğu.

Taraf: Server · Bekler: hayır · Lib: inventory.getItemCount

GetItemCount(inv: InventoryRef, item: string, metadata?: ItemMetadata): number

local count = exports['ai-core']:GetItemCount(source, 'fish')

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

number: tüm yığınların toplamı. Hiç yoksa, bir argüman yanlışsa ya da hiçbir envanter çalışmıyorsa 0.

ÖrnekCopy Anchor Link

import { onClientCallback, resourceExport } from "@aicore-fivem/lib/server";

const core = resourceExport("ai-core");

// Balık alıcısı oyuncunun ne kadar alacağını gösterir.
onClientCallback("myscript:fishQuote", (source) => ({
  ok: true,
  price: core.GetItemCount(source, "fish") * 25,
}));

HasItemCopy Anchor Link

Bir envanterde bir eşyadan en az belli sayıda olup olmadığı.

Taraf: Server · Bekler: hayır · Lib: inventory.hasItem

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

local has = exports['ai-core']:HasItem(source, 'repairkit')

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

boolean: envanterde count ya da daha fazla varsa true. Daha az varsa, count 1’in altındaysa ya da hiçbir envanter çalışmıyorsa false.

ÖrnekCopy Anchor Link

import { onClientCallback, progressFor, resourceExport } from "@aicore-fivem/lib/server";
import { fail } from "@aicore-fivem/lib/shared";
import { Locale } from "common";

const core = resourceExport("ai-core");

onClientCallback("myscript:repair", { lock: true }, async (source) => {
  if (!core.HasItem(source, "repairkit")) return fail("NO_KIT");
  if (!(await progressFor(source, { label: Locale("REPAIRING"), duration: 8000 }))) return fail("CANCELLED");
  if (!core.RemoveItem(source, "repairkit")) return fail("NO_KIT");
  return { ok: true };
});

CanCarryItemCopy Anchor Link

Eşyaların eklenmeden bir envantere sığıp sığmayacağı (ağırlık ve slotlar).

Taraf: Server · Bekler: hayır · Lib: inventory.canCarryItem

CanCarryItem(inv: InventoryRef, item: string, count?: number, metadata?: ItemMetadata): boolean

local fits = exports['ai-core']:CanCarryItem(source, 'water', 5)

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

boolean: sığıyorlarsa true. Sığmıyorlarsa, bir argüman yanlışsa ya da hiçbir envanter çalışmıyorsa false.

ÖrnekCopy Anchor Link

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

const core = resourceExport("ai-core");

onClientCallback("myscript:buyWater", { lock: true }, (source) => {
  if (!core.CanCarryItem(source, "water", 5)) return fail("NO_SPACE");
  if (!core.RemoveMoney(source, "cash", 50, "shop_water")) return fail("NOT_ENOUGH_MONEY");
  core.AddItem(source, "water", 5);
  return { ok: true };
});

GetItemsCopy Anchor Link

Bir envanterdeki her yığın, etiketleriyle.

Taraf: Server · Bekler: hayır · Lib: inventory.getItems

GetItems(inv: InventoryRef): InventoryStack[]

local stacks = exports['ai-core']:GetItems(source) -- tablo listesi

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

InventoryStack[]: yığın başına name, label, count, slot ve metadata içeren bir kayıt. Bkz. InventoryStack. Boş ya da bilinmeyen bir envanter, yanlış bir argüman ya da çalışan envanter yokken boş liste.

ÖrnekCopy Anchor Link

import { onClientCallback, resourceExport } from "@aicore-fivem/lib/server";

const core = resourceExport("ai-core");

// Bir rehinci, oyuncunun taşıdığı ve kendisinin satın aldığı her eşyayı listeler.
const BUYS: Record<string, number> = { gold_ring: 120, rolex: 400 };

onClientCallback("myscript:pawnList", (source) => ({
  ok: true,
  rows: core.GetItems(source)
    .filter((stack) => BUYS[stack.name] !== undefined)
    .map((stack) => ({ slot: stack.slot, label: stack.label, count: stack.count, price: BUYS[stack.name] })),
}));

ClearInventoryCopy Anchor Link

Bir envanteri tamamen boşaltır.

Taraf: Server · Bekler: hayır · Lib: inventory.clearInventory

ClearInventory(inv: InventoryRef): void

exports['ai-core']:ClearInventory(source)

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

Hiçbir şey. Yanlış bir argüman ya da çalışan envanter yoksa hiçbir şey yapmaz.

ÖrnekCopy Anchor Link

import { addCommand, resourceExport } from "@aicore-fivem/lib/server";

const core = resourceExport("ai-core");

addCommand("clearinv", { help: "Empties a player inventory", params: [{ name: "id", type: "playerId" }], restricted: true }, (_source, args) => {
  core.ClearInventory(args.id);
});

RegisterStashCopy Anchor Link

Bir stash oluşturur: oyuncuların adıyla açtığı bir depolama kutusu. ai-core onu tutar ve aktif olan her envantere yeniden kaydeder.

Taraf: Server · Bekler: hayır · Lib: inventory.registerStash

RegisterStash(name: string, label: string, slots: number, maxWeight: number, jobs?: string[]): void

exports['ai-core']:RegisterStash('police_evidence', 'Evidence', 100, 500000, { 'police' })

ParametrelerCopy Anchor Link

Bir değer eksik ya da yanlış olduğunda varsayılanlar uygulanır.

Dönüş değeriCopy Anchor Link

Hiçbir şey. Metin bir name olmadan çağrı hiçbir şey yapmaz. Aynı adı tekrar kaydetmek stash’i değiştirir.

ÖrnekCopy Anchor Link

import { onClientCallback, resourceExport, near } from "@aicore-fivem/lib/server";
import { fail } from "@aicore-fivem/lib/shared";
import { Locale } from "common";

const core = resourceExport("ai-core");
const LOCKER = { x: 474.9, y: -994.7, z: 26.3 };

// Açılışta bir kez; ai-core onu sonradan başlayan envanterlere verir.
core.RegisterStash("police_evidence", Locale("STASH_EVIDENCE"), 100, 500_000, ["police"]);

onClientCallback("myscript:openEvidence", { guards: [near(LOCKER, 2)] }, (source) => {
  if (core.GetDutyJob(source) !== "police") return fail("NOT_POLICE");
  return core.OpenInventory(source, "police_evidence") ? { ok: true } : fail("STASH_FAILED");
});

OpenInventoryCopy Anchor Link

Bir oyuncunun ekranında, kendi envanterinin yanında bir stash, bir bagaj ya da başka bir oyuncunun envanterini açar.

Taraf: Server · Bekler: hayır · Lib: inventory.openInventory

OpenInventory(source: number, inv: InventoryRef): boolean

local opened = exports['ai-core']:OpenInventory(source, 'police_evidence')

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

boolean: envanter ekranı açtığında true. Açamadığında (bilinmeyen stash, oyuncunun envanteri yok), bir argüman yanlışsa ya da hiçbir envanter çalışmıyorsa false.

ÖrnekCopy Anchor Link

import { onClientCallback, isNear, coordsOf, resourceExport } from "@aicore-fivem/lib/server";
import { fail, oneArg, readId } from "@aicore-fivem/lib/shared";

const core = resourceExport("ai-core");

// Polis yanında duran kelepçeli bir oyuncuyu arar.
onClientCallback("myscript:search", { args: oneArg(readId) }, (source, target) => {
  if (core.GetDutyJob(source) !== "police") return fail("NOT_POLICE");
  if (target === source || !isNear(target, coordsOf(source), 2)) return fail("TOO_FAR");
  return core.OpenInventory(source, target) ? { ok: true } : fail("SEARCH_FAILED");
});

RegisterShopCopy Anchor Link

Bir script dükkanı oluşturur: script’inin bir oyuncu için açtığı fiyatlı bir eşya listesi (bir cephanelik, bir otomat). Envanter dükkanı çizer ve ödemeyi kendi yöntemiyle alır (önce nakit, sonra banka). ai-core onu tutar ve aktif olan her envantere verir.

Taraf: Server · Bekler: hayır · Lib: inventory.registerShop

RegisterShop(name: string, label: string, items: ShopProduct[]): void

exports['ai-core']:RegisterShop('police_armoury', 'Armoury', { { name = 'bandage', price = 0 } })

ParametrelerCopy Anchor Link

Bkz. ShopProduct.

Dönüş değeriCopy Anchor Link

Hiçbir şey. Metin bir name olmadan ya da geçerli ürün olmadan çağrı hiçbir şey yapmaz. Aynı adı tekrar kaydetmek dükkanı değiştirir.

ÖrnekCopy Anchor Link

import { onClientCallback, resourceExport, near } from "@aicore-fivem/lib/server";
import { fail } from "@aicore-fivem/lib/shared";
import { Locale } from "common";

const core = resourceExport("ai-core");
const ARMOURY = { x: 482.6, y: -995.2, z: 30.7 };

core.RegisterShop("police_armoury", Locale("SHOP_ARMOURY"), [
  { name: "WEAPON_STUNGUN", price: 0 },
  { name: "bandage", price: 10 },
]);

onClientCallback("myscript:armoury", { guards: [near(ARMOURY, 2)] }, (source) => {
  if (core.GetDutyJob(source) !== "police") return fail("NOT_POLICE");
  return core.OpenShop(source, "police_armoury") ? { ok: true } : fail("SHOP_FAILED");
});

OpenShopCopy Anchor Link

RegisterShop ile kaydedilmiş bir dükkanı bir oyuncunun ekranında açar.

Taraf: Server · Bekler: hayır · Lib: inventory.openShop

OpenShop(source: number, name: string): boolean

local opened = exports['ai-core']:OpenShop(source, 'police_armoury')

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

boolean: dükkan açıldığında true. O adda dükkan yoksa, aktif envanterin script dükkanları yoksa, açamadıysa ya da hiçbir envanter çalışmıyorsa false.

ÖrnekCopy Anchor Link

Yukarıdaki RegisterShop örneğine bak: açılışta bir kez kaydet, sonra kendi meslek ve mesafe kontrollerinden sonra aç.

RegisterUsableItemCopy Anchor Link

Bir eşyayı kullanılabilir yapar: bir oyuncu onu envanterde kullandığında fonksiyonun çalışır. ai-core fonksiyonu tutar, böylece sonradan başlayan envanterlerle çalışır ve bir envanter yeniden başlamasından sağ çıkar.

Taraf: Server · Bekler: hayır · Lib: inventory.registerUsableItem

RegisterUsableItem(name: string, handler: UsableItemHandler): void
// UsableItemHandler = (source: number, item: UsedItem) => unknown

exports['ai-core']:RegisterUsableItem('bandage', function(source, item) end)

ParametrelerCopy Anchor Link

Bkz. UsableItemHandler ve UsedItem.

Dönüş değeriCopy Anchor Link

Hiçbir şey. Metin bir name ya da bir fonksiyon olmadan çağrı hiçbir şey yapmaz. Aynı eşya için ikinci bir çağrı handler’ı değiştirir.

Kullanımdan sonra eşyaya ne olacağı envantere bağlıdır: kullanılan eşyayı kendisi alan envanterler (ai-inventory eşyanın consume miktarını alır) handler’ın false döndürdüğünde onu tutar; diğer envanterler kendi eşya ayarlarına uyar, bu yüzden orada gerektiğinde eşyayı kendin çıkar.

ÖrnekCopy Anchor Link

import { progressFor, resourceExport } from "@aicore-fivem/lib/server";
import { Locale } from "common";

const core = resourceExport("ai-core");

core.RegisterUsableItem("bandage", (source) => {
  // Handler hemen cevap vermelidir; zamanlı kısım kendi başına çalışır.
  void (async () => {
    if (!(await progressFor(source, { label: Locale("BANDAGING"), duration: 4000 }))) return;
    if (!core.RemoveItem(source, "bandage")) return;
    emitNet("myscript:client:heal", source, 25); // client script’in canı ekler
  })();
  return false; // yerinde tut: çubuk bittiğinde yukarıda çıkarılır
});

GetItemDefinitionCopy Anchor Link

Aktif envanterin tanımladığı haliyle tek bir eşya: etiket, ağırlık, yığılıp yığılmadığı, resim.

Taraf: Server · Bekler: hayır · Lib: inventory.getItemDefinition

GetItemDefinition(name: string): ItemDefinition | null

local def = exports['ai-core']:GetItemDefinition('water') -- tablo ya da nil

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

ItemDefinition | null: name, label, weight, unique, close, description ve envanterde varsa image içeren eşya. Bkz. ItemDefinition. Bilinmeyen bir eşya, boş bir ad ya da çalışan envanter yokken null.

ÖrnekCopy Anchor Link

import { notify, resourceExport } from "@aicore-fivem/lib/server";
import { Locale } from "common";

const core = resourceExport("ai-core");

/** Envanterin kendi etiketiyle "2x Water aldın". */
export function giveWithNotice(source: number, item: string, count: number): void {
  if (!core.AddItem(source, item, count)) return;
  const label = core.GetItemDefinition(item)?.label ?? item;
  notify(source, Locale("NOTIFY_RECEIVED", count, label), "success");
}

GetItemDefinitionsCopy Anchor Link

Aktif envanterin tanımladığı her eşya, ada göre anahtarlanmış. Seyrek kullan (bir listeyi bir kez kurmak); tek bir eşya için GetItemDefinition kullan.

Taraf: Server · Bekler: hayır · Lib: yok

GetItemDefinitions(): Record<string, ItemDefinition>

local items = exports['ai-core']:GetItemDefinitions() -- eşya adına göre anahtarlanmış tablo

ParametrelerCopy Anchor Link

Yok.

Dönüş değeriCopy Anchor Link

Record<string, ItemDefinition>: her eşya. Hiçbir envanter çalışmıyorken boş tablo.

ÖrnekCopy Anchor Link

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

const core = resourceExport("ai-core");

/** Açılışta config’indeki envanterin tanımadığı eşyalar hakkında uyarır. */
export function checkItems(names: string[]): void {
  const known = core.GetItemDefinitions();
  for (const name of names) if (!known[name]) console.log(`unknown item: ${name}`);
}

GetInventoryWeightCopy Anchor Link

Bir oyuncunun ağırlık olarak ne taşıdığı ve ne taşıyabileceği.

Taraf: Server · Bekler: hayır · Lib: yok

GetInventoryWeight(source: number): { weight: number; maxWeight: number } | null

local w = exports['ai-core']:GetInventoryWeight(source) -- { weight, maxWeight } ya da nil

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

{ weight, maxWeight } | null: taşınan ağırlık ve sınır, gram cinsinden. Aktif envanter bunları söylemiyorsa, oyuncunun yüklü envanteri yoksa ya da hiçbir envanter çalışmıyorsa null.

ÖrnekCopy Anchor Link

import { onClientCallback, resourceExport } from "@aicore-fivem/lib/server";

const core = resourceExport("ai-core");

onClientCallback("myscript:weight", (source) => {
  const w = core.GetInventoryWeight(source);
  return { ok: true, free: w ? w.maxWeight - w.weight : null };
});

UseItemCopy Anchor Link

Bir eşya için kaydedilmiş handler’ı, oyuncu onu kullanmış gibi çalıştırır. ai-core’un ESX / QB köprüsü bunu çağırır (ESX.UseItem ve QB’nin CanUseItem’ından); normal bir script’in bunu yapması için bir sebep yoktur.

Taraf: Server · Bekler: hayır · Lib: yok (yalnızca köprü)

UseItem(source: number, name: string, item?: unknown): unknown

local result = exports['ai-core']:UseItem(source, 'bandage', stack)

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

unknown: handler’ın döndürdüğü. Kayıtlı handler yoksa, argümanlar yanlışsa ya da handler hata fırlattıysa (loglanır) false.

ÖrnekCopy Anchor Link

Örnek yok: envanterler ve köprü bunu çağırır. Bir kullanıma tepki vermek için eşyayı RegisterUsableItem ile kaydet.

IsUsableItemCopy Anchor Link

Bir eşya için handler kayıtlı olup olmadığı. ai-core’un köprüsü bunu kullanır.

Taraf: Server · Bekler: hayır · Lib: yok (yalnızca köprü)

IsUsableItem(name: string): boolean

local usable = exports['ai-core']:IsUsableItem('bandage')

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

boolean: bir resource eşyayı RegisterUsableItem ile kaydettiyse true. Aksi halde false.

ÖrnekCopy Anchor Link

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

const core = resourceExport("ai-core");

/** Eşya ipuçları "Kullan"ı yalnızca kullanılabilir eşyalar için gösterir. */
export function canUse(item: string): boolean {
  return core.IsUsableItem(item);
}