ai-core üzerinden katmanlar

Bu nesneler asla belirli bir script ile konuşmaz. ai-core’a sorarlar ve ai-core, sunucunun o iş için çalıştırdığı script hangisiyse ona iletir: ai-death ya da başka bir ölüm script’i, ai-appearance ya da tgiann-clothing, desteklenen herhangi bir emote ya da radyal script’i. Sahip birini değiştirdiğinde script’in çalışmaya devam eder. Katmanların nasıl çalıştığı Katmanlar ve köprü sayfasındadır.

O türden hiçbir script çalışmıyorken çağrılar, her girdinin söylediği gibi false, null ya da oyunun kendi değeriyle cevap verir.

medicalCopy Anchor Link

medical.isDeadCopy Anchor Link

Hangi ölüm script’i çalışıyorsa, yerel oyuncunun yerde (ölü ya da son nefeste) olup olmadığı. Ölüm script’leri yerdeki bir ped’i canlandırmak için canlı tutar; bu yüzden tek başına IsEntityDead onları kaçırır. İlk çağrıdan sonra bir bellek okuması.

Taraf: Client · Bekler: hayır

medical.isDead(): boolean

Lua karşılığı yok: exports['ai-core']:IsDead() çağır ve yerel ai-core:client:dead (dead) event’ini dinle.

Dönüş değeriCopy Anchor Link

boolean: ai-core’un medical katmanı oyuncunun yerde olduğunu söylüyorsa ya da ped oyun için ölüyse true.

ÖrnekCopy Anchor Link

import { medical, notify } from "@aicore-fivem/lib/client";

RegisterCommand(
  "phone",
  () => {
    if (medical.isDead()) return notify("You cannot use the phone now", "error");
    SetNuiFocus(true, true);
  },
  false,
);

medical.onChangeCopy Anchor Link

Yerel oyuncu yere düştüğünde ya da ayağa kalktığında bir handler çalıştırır.

Taraf: Client · Bekler: hayır

medical.onChange(fn: (dead: boolean) => void): void

Lua karşılığı yok: AddEventHandler('ai-core:client:dead', function(dead) end).

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

void.

ÖrnekCopy Anchor Link

import { medical, Points } from "@aicore-fivem/lib/client";

const points = new Points();
medical.onChange(() => points.refresh()); // canShow’u medical.isDead()’i okuyan noktalar

appearanceCopy Anchor Link

Hangi kıyafet script’i çalışıyorsa, ai-core’un görünüm katmanı üzerinden ped’lerin görünümleri.

appearance.applyCopy Anchor Link

Kayıtlı bir görünümü, görünümün modelindeki bir ped’e giydirir. Görünümü server’da appearance.get(charId) ile al, ped’i look.model ile oluştur, sonra uygula. Oyuncunun kendi ped’inde kıyafetlerini değiştirir.

Taraf: Client · Bekler: hayır

appearance.apply(ped: number, look: CharacterAppearance): boolean

local ok = aiLib.appearance.apply(ped, look)

ParametrelerCopy Anchor Link

Tipi CharacterAppearance’dır.

Dönüş değeriCopy Anchor Link

boolean: ped yok olduysa, model farklıysa ya da hiçbir kıyafet script’i çalışmıyorsa false.

ÖrnekCopy Anchor Link

import { appearance, LocalPed, triggerServerCallback } from "@aicore-fivem/lib/client";
import type { CharacterAppearance } from "@aicore-fivem/shared";

// Bir karakterin, onun gibi giyinmiş uyuyan bir kopyası.
export async function showSleeper(charId: number): Promise<void> {
  const look = (await triggerServerCallback("mysleep:look", [charId]).catch(() => null)) as CharacterAppearance | null;
  if (!look) return;
  new LocalPed({
    model: look.model,
    coords: { x: 151.2, y: -1004.6, z: 29.4, heading: 90 },
    onSpawn: (ped) => appearance.apply(ped, look),
  });
}

appearance.readCopy Anchor Link

Bir ped’in şu an giydiği görünüm.

Taraf: Client · Bekler: hayır

appearance.read(ped: number): CharacterAppearance | null

local look = aiLib.appearance.read(ped) -- table ya da nil

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

CharacterAppearance | null: görünüm ya da kıyafet script’i bunu söyleyemiyorsa veya hiçbiri çalışmıyorsa null (Lua’da nil).

ÖrnekCopy Anchor Link

import { appearance, cache } from "@aicore-fivem/lib/client";

const before = appearance.read(cache.ped); // daha sonra appearance.apply ile geri koy

appearance.openMenuCopy Anchor Link

Kıyafet script’inin kıyafet mağazasını, berberini ya da kayıtlı kıyafetlerini oyuncu için açar.

Taraf: Client · Bekler: hayır

appearance.openMenu(menu: ClothingMenu): boolean

local ok = aiLib.appearance.openMenu(menu)

ParametrelerCopy Anchor Link

Tipi ClothingMenu’dür.

Dönüş değeriCopy Anchor Link

boolean: kıyafet script’inin böyle bir menüsü yoksa ya da hiçbiri çalışmıyorsa false.

ÖrnekCopy Anchor Link

import { appearance, Points } from "@aicore-fivem/lib/client";

const points = new Points();
points.add("barber", {
  coords: { x: -814.3, y: -183.8, z: 37.6 },
  label: "Barber",
  onPressed: () => appearance.openMenu("barber"),
});

appearance.wearOutfitCopy Anchor Link

Oyuncuya reloadSkin’e kadar bir meslek kıyafeti (bir üniforma) giydirir. Kaydedilmez: yeniden bağlanmak ya da reloadSkin oyuncunun kendi kıyafetlerini geri verir. Yalnızca listelenen parçalar değişir.

Taraf: Client · Bekler: hayır

appearance.wearOutfit(outfit: JobOutfit): boolean

local ok = aiLib.appearance.wearOutfit(outfit)

ParametrelerCopy Anchor Link

Tipler JobOutfit ve OutfitPiece’tir.

Dönüş değeriCopy Anchor Link

boolean: yapamıyorsa (kıyafet script’i yok, desteklemediği bir model) false.

ÖrnekCopy Anchor Link

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

appearance.wearOutfit({
  components: [
    { id: 11, collection: "", index: 55, texture: 0 },
    { id: 4, collection: "", index: 35, texture: 0 },
  ],
  props: [{ id: 0, collection: "", index: -1, texture: 0 }],
});

appearance.reloadSkinCopy Anchor Link

Oyuncunun kayıtlı görünümünü geri giydirir (bir meslek kıyafetini çıkarır).

Taraf: Client · Bekler: hayır

appearance.reloadSkin(): boolean

local ok = aiLib.appearance.reloadSkin()

Dönüş değeriCopy Anchor Link

boolean: kıyafet script’i yoksa false.

ÖrnekCopy Anchor Link

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

RegisterCommand("offduty", () => appearance.reloadSkin(), false);

gesturesCopy Anchor Link

Hangi emote script’i çalışıyorsa, ai-core üzerinden eller yukarı, işaret etme ve emote’lar.

gestures.isHandsUpCopy Anchor Link

Yerel oyuncunun ellerinin yukarıda olup olmadığı.

Taraf: Client · Bekler: hayır

gestures.isHandsUp(): boolean

local up = aiLib.gestures.isHandsUp()

Dönüş değeriCopy Anchor Link

boolean: çalışan emote script’inde eller yukarıdayken true.

ÖrnekCopy Anchor Link

import { gestures, onServerCallback } from "@aicore-fivem/lib/client";

// Server bir soygundan önce kurbanın teslim olup olmadığını sorar.
onServerCallback("myrob:surrendered", () => gestures.isHandsUp());

gestures.isPointingCopy Anchor Link

Yerel oyuncunun işaret edip etmediği.

Taraf: Client · Bekler: hayır

gestures.isPointing(): boolean

local pointing = aiLib.gestures.isPointing()

Dönüş değeriCopy Anchor Link

boolean: işaret ederken true.

ÖrnekCopy Anchor Link

if (gestures.isPointing()) return; // işaret etmenin üzerine bir emote başlatma

gestures.providerCopy Anchor Link

Eller yukarı ve işaret etmeye cevap veren emote script’i.

Taraf: Client · Bekler: hayır

gestures.provider(): string | null

local name = aiLib.gestures.provider()

Dönüş değeriCopy Anchor Link

string | null: resource adı ya da hiçbiri çalışmıyorsa null (nil).

ÖrnekCopy Anchor Link

console.log(`hands up from ${gestures.provider() ?? "nothing"}`);

gestures.playEmoteCopy Anchor Link

Çalışan emote script’inde bir emote’u komut adıyla (oyuncuların e’den sonra yazdığı) oynatır.

Taraf: Client · Bekler: hayır

gestures.playEmote(name: string): boolean

local ok = aiLib.gestures.playEmote(name)

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

boolean: emote script’i yoksa false.

ÖrnekCopy Anchor Link

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

RegisterCommand("hi", () => gestures.playEmote("wave"), false);

gestures.cancelEmoteCopy Anchor Link

Oyuncunun oynattığı emote’u durdurur (kelepçelendi, yere düşürüldü).

Taraf: Client · Bekler: hayır

gestures.cancelEmote(): boolean

local ok = aiLib.gestures.cancelEmote()

Dönüş değeriCopy Anchor Link

boolean: emote script’i yoksa false.

ÖrnekCopy Anchor Link

onServerEvent("mypolice:cuffed", () => gestures.cancelEmote());

gestures.emoteProviderCopy Anchor Link

Emote’ları oynatan emote script’i (eller yukarıya cevap verenden farklı olabilir).

Taraf: Client · Bekler: hayır

gestures.emoteProvider(): string | null

local name = aiLib.gestures.emoteProvider()

Dönüş değeriCopy Anchor Link

string | null: resource adı ya da hiçbiri çalışmıyorsa null (nil).

ÖrnekCopy Anchor Link

if (gestures.emoteProvider() === null) console.log("no emote script: skipping the emote");

seatbeltCopy Anchor Link

Hangi emniyet kemeri script’i çalışıyorsa, ai-core üzerinden yerel oyuncunun emniyet kemeri.

seatbelt.isOnCopy Anchor Link

Kemerin takılı olup olmadığı. Her karede değil, gerektiğinde sor.

Taraf: Client · Bekler: hayır

seatbelt.isOn(): boolean | null

local worn = aiLib.seatbelt.isOn() -- boolean ya da nil

Dönüş değeriCopy Anchor Link

boolean | null: true ya da false; hiçbir emniyet kemeri script’i cevap vermiyorsa null (nil).

ÖrnekCopy Anchor Link

import { cache, notify, onCache, seatbelt } from "@aicore-fivem/lib/client";

onCache("vehicle", (vehicle) => {
  if (vehicle !== false && seatbelt.isOn() === false) notify("Buckle up", "warning");
});

seatbelt.onChangeCopy Anchor Link

Kemer değiştiğinde bir handler çalıştırır. Yalnızca değişiklikleri bildiren emniyet kemeri script’leri onu tetikler.

Taraf: Client · Bekler: hayır

seatbelt.onChange(fn: (worn: boolean | null) => void): void

aiLib.seatbelt.onChange(function(worn) end)

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

void.

ÖrnekCopy Anchor Link

seatbelt.onChange((worn) => SendNUIMessage({ action: "belt", data: worn === true }));

seatbelt.providerCopy Anchor Link

Cevap veren emniyet kemeri script’i.

Taraf: Client · Bekler: hayır

seatbelt.provider(): string | null

local name = aiLib.seatbelt.provider()

Dönüş değeriCopy Anchor Link

string | null: resource adı ya da hiçbiri cevap vermiyorsa null (nil).

ÖrnekCopy Anchor Link

if (seatbelt.provider() === null) console.log("no seat belt script runs");

fuelCopy Anchor Link

fuel.getCopy Anchor Link

Bir aracın yakıt seviyesi. Server, hangi yakıt script’i çalışırsa çalışsın her araç için bir fuel state bag’i tutar; bu yüzden bu bir bellek okumasıdır; o bag yoksa oyunun depo seviyesidir.

Taraf: Client · Bekler: hayır

fuel.get(vehicle: number): number

Lua karşılığı yok: Entity(vehicle).state.fuel’i oku. Yakıt ayarlamak yalnızca server’dadır (Araçlar sayfasındaki fuel.set).

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

number: 0-100.

ÖrnekCopy Anchor Link

import { cache, every, fuel } from "@aicore-fivem/lib/client";

every(1000, () => {
  if (cache.vehicle !== false) SendNUIMessage({ action: "fuel", data: Math.round(fuel.get(cache.vehicle)) });
});

mdtCopy Anchor Link

mdt.openCopy Anchor Link

Aktif polis MDT’sini yerel oyuncu için açar. MDT mesleği kendisi kontrol eder.

Taraf: Client · Bekler: hayır

mdt.open(): boolean

local ok = aiLib.mdt.open()

Dönüş değeriCopy Anchor Link

boolean: hiçbir MDT çalışmıyorsa ya da dışarıdan açılamıyorsa false.

ÖrnekCopy Anchor Link

import { mdt, notify } from "@aicore-fivem/lib/client";

RegisterCommand("mdt", () => {
  if (!mdt.open()) notify("No MDT available", "error");
}, false);

radialCopy Anchor Link

Hangi radyal menü çalışıyorsa (ai-radialmenu ya da ai-core’un radyal katmanı üzerinden başka biri) üzerindeki öğeler. ai-core onları radyal yeniden başlatmalarında tutar ve resource’un durduğunda kaldırır: açılışta bir kez ekle.

radial.addCopy Anchor Link

Çarka bir öğe ekler ya da aynı id’ye sahip öğenin yerine geçer.

Taraf: Client · Bekler: hayır

radial.add(item: RadialItem): void

aiLib.radial.add(item)

ParametrelerCopy Anchor Link

RadialItemCopy Anchor Link

Tipi RadialItem’dir.

Dönüş değeriCopy Anchor Link

void.

ÖrnekCopy Anchor Link

import { cache, createLocale, hasJob, radial } from "@aicore-fivem/lib/client";
import { RADIAL_VEHICLE } from "@aicore-fivem/shared";

const Locale = createLocale<typeof import("../../locales/en.json")>();

radial.add({
  id: "myscript:engine",
  label: Locale("ENGINE"),
  icon: "power-off",
  parent: RADIAL_VEHICLE,
  keepOpen: true,
  canShow: () => cache.seat === -1,
  onPressed: () => {
    if (cache.vehicle === false) return;
    SetVehicleEngineOn(cache.vehicle, !GetIsVehicleEngineRunning(cache.vehicle), false, true);
  },
});

radial.add({
  id: "myscript:police",
  label: Locale("POLICE"),
  icon: "shield-halved",
  canShow: () => hasJob(["police"]),
  items: [
    { id: "myscript:cuff", label: Locale("CUFF"), icon: "handcuffs", onPressed: () => emitNet("mypolice:cuff") },
  ],
});

radial.removeCopy Anchor Link

Öğelerinden birini kaldırır. Bilinmeyen bir id hiçbir şey yapmaz.

Taraf: Client · Bekler: hayır

radial.remove(id: string): void

aiLib.radial.remove(id)

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

void.

ÖrnekCopy Anchor Link

radial.remove("myscript:engine");

radial.refreshCopy Anchor Link

Açık bir çarkın her canShow’unu yeniden okur. Çark açık olabilirken okudukları bir şey değiştikten sonra çağır.

Taraf: Client · Bekler: hayır

radial.refresh(): void

aiLib.radial.refresh()

Dönüş değeriCopy Anchor Link

void.

ÖrnekCopy Anchor Link

onMembershipChange(() => radial.refresh());

worldCopy Anchor Link

Hangi hava script’i çalışıyorsa onun hava ve saat senkronu; bir sebep geçerliyken duraklatılır.

world.pauseSyncCopy Anchor Link

Hava ve saat senkronunu bir sebeple duraklatır: bir iç mekânın içinde, bir sahne sırasında ya da script’in kendi havasını ayarlarken.

Taraf: Client · Bekler: hayır

world.pauseSync(reason: string): void

aiLib.world.pauseSync(reason)

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

void.

ÖrnekCopy Anchor Link

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

export function enterApartment(): void {
  world.pauseSync("apartment");
  NetworkOverrideClockTime(12, 0, 0);
  SetWeatherTypeNowPersist("EXTRASUNNY");
}

export function leaveApartment(): void {
  world.resumeSync("apartment");
}

world.resumeSyncCopy Anchor Link

Bir duraklatma sebebini kaldırır; hiçbir sebep kalmadığında senkron yeniden çalışır.

Taraf: Client · Bekler: hayır

world.resumeSync(reason: string): void

aiLib.world.resumeSync(reason)

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

void. world.pauseSync örneğine bak.

inventoryCopy Anchor Link

ai-core’un envanter katmanı üzerinden yerel oyuncunun envanteri: server’ın seçtiği envanter cevap verir. Eşya vermek ve almak yalnızca server’dadır (Eşyalar).

inventory.openInventoryCopy Anchor Link

Oyuncunun kendi envanter ekranını açar.

Taraf: Client · Bekler: hayır

inventory.openInventory(): void

aiLib.inventory.openInventory()

Dönüş değeriCopy Anchor Link

void.

ÖrnekCopy Anchor Link

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

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

inventory.hasItemCopy Anchor Link

Oyuncunun bir eşyadan en az count tane tutup tutmadığı. Oyuncunun yalnızca yapabildiklerini görmesi için canShow içinde kullan; server tekrar kontrol eder.

Taraf: Client · Bekler: hayır

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

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

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

boolean: oyuncunun yeterince varsa true.

ÖrnekCopy Anchor Link

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

const points = new Points();
points.addVehicle("lockpick", {
  label: "Lockpick",
  icon: "unlock",
  canShow: (vehicle) => GetVehicleDoorLockStatus(vehicle) >= 2 && inventory.hasItem("lockpick"),
  onPressed: (vehicle) => emitNet("mykeys:lockpick", NetworkGetNetworkIdFromEntity(vehicle)),
});

inventory.currentWeaponCopy Anchor Link

Oyuncunun elindeki silah eşyası: adı, etiketi ve resmi.

Taraf: Client · Bekler: hayır

inventory.currentWeapon(): HeldWeapon | null

local weapon = aiLib.inventory.currentWeapon() -- table ya da nil

Dönüş değeriCopy Anchor Link

HeldWeapon { name: string; label: string; image?: string } (name WEAPON_PISTOL gibi, envanterin bir resmi varsa image bir nui:// url’si) ya da el boşsa null (nil).

ÖrnekCopy Anchor Link

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

// Silah değiştiğinde oku, asla her karede değil.
onCache("weapon", () => SendNUIMessage({ action: "weapon", data: inventory.currentWeapon() }));