Dünya

import { world, buckets, doors, characters } from "@aicore-fivem/lib/server";

worldCopy Anchor Link

Hangi hava script’i çalışıyorsa (Renewed-Weathersync, av_weather, cd_easytime, qb-weathersync) ai-core üzerinden saat ve hava. Hiçbiri çalışmıyorken okumalar null, değişiklikler false cevabını verir.

world.getWeatherCopy Anchor Link

Taraf: Server · Bekler: hayır

world.getWeather(): string | null

local weather = aiLib.world.getWeather()

Dönüş değeri: hava script’inin bildirdiği haliyle güncel hava tipi (CLEAR, RAIN...) ya da hiçbiri çalışmıyorken null.

const raining = ["RAIN", "THUNDER"].includes(world.getWeather() ?? "");

world.setWeatherCopy Anchor Link

Havayı ayarlar.

Taraf: Server · Bekler: hayır

world.setWeather(type: Weather): boolean

local ok = aiLib.world.setWeather(weather)

Dönüş değeri: ayarlandıysa true; hiçbir hava script’i çalışmıyorken ya da değer bir string değilse false.

import { addCommand, world } from "@aicore-fivem/lib/server";
import { isWeather } from "@aicore-fivem/shared";

addCommand("weather", { restricted: true, params: [{ name: "type", type: "string" }] }, (_source, { type }) => {
  const upper = type.toUpperCase();
  if (isWeather(upper)) world.setWeather(upper);
});

world.getTimeCopy Anchor Link

Taraf: Server · Bekler: hayır

world.getTime(): { hour: number; minute: number } | null

local time = aiLib.world.getTime() -- { hour, minute } ya da nil

Dönüş değeri: oyun içi saat ya da hiçbir hava script’i çalışmıyorken null.

const time = world.getTime();
const night = time !== null && (time.hour >= 22 || time.hour < 6);

world.setTimeCopy Anchor Link

Oyun içi saati ayarlar.

Taraf: Server · Bekler: hayır

world.setTime(hour: number, minute?: number): boolean

local ok = aiLib.world.setTime(hour, minute)

Dönüş değeri: ayarlandıysa true, hiçbir hava script’i çalışmıyorken false.

world.setTime(12, 30);

world.setBlackoutCopy Anchor Link

Şehir genelindeki elektrik kesintisini açar ya da kapatır.

Taraf: Server · Bekler: hayır

world.setBlackout(on: boolean): boolean

local ok = aiLib.world.setBlackout(on)

Dönüş değeri: uygulandıysa true; hiçbir hava script’i çalışmıyorken ya da script’in kesinti özelliği yoksa false.

world.setBlackout(true); // elektrik santrali sabote edildi

world.freezeTimeCopy Anchor Link

Oyun içi saati durdurur ya da yeniden başlatır.

Taraf: Server · Bekler: hayır

world.freezeTime(on: boolean): boolean

local ok = aiLib.world.freezeTime(on)

Dönüş değeri: uygulandıysa true; hiçbir hava script’i çalışmıyorken ya da script saati donduramıyorsa false.

world.setTime(20, 0);
world.freezeTime(true);

bucketsCopy Anchor Link

ai-core’un dağıtıcısından routing bucket’lar (ayrı dünyalar: bir daire içi, bir instance); böylece iki script asla aynı bucket’ı paylaşmaz. Bucket numaralarını asla kendin seçme (1000 + n). Lua karşılığı yok: ai-core’un AcquireBucket(tag) / ReleaseBucket(id) export’larını çağır.

buckets.acquireCopy Anchor Link

Bu resource için boş bir bucket alır. Bucket’ta nüfus yoktur (çevredeki ped’ler ve arabalar yok) ve katı entity kilidi (lockdown) vardır.

Taraf: Server · Bekler: hayır

buckets.acquire(tag: string): number

Dönüş değeri: bucket id’si.

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

const bucket = buckets.acquire(`property:${propertyId}`);
SetPlayerRoutingBucket(String(source), bucket);

buckets.releaseCopy Anchor Link

İçindeki oyuncular çıktıktan sonra bir bucket’ı geri verir.

Taraf: Server · Bekler: hayır

buckets.release(id: number): boolean

Dönüş değeri: serbest bırakıldıysa true. Duran bir resource’un her bucket’ı kendiliğinden geri döner.

SetPlayerRoutingBucket(String(source), 0);
buckets.release(bucket);

doorsCopy Anchor Link

Kapı kilidi script’inin kendi kapı id’siyle, ai-core’un kapı kilidi katmanı üzerinden kapı kilitleri. Lua karşılığı yok: ai-core’un SetDoorLocked, IsDoorLocked export’larını çağır.

doors.setLockedCopy Anchor Link

Bir kapıyı kilitler ya da kilidini açar.

Taraf: Server · Bekler: hayır

doors.setLocked(id: string, locked: boolean, by?: number): boolean

Dönüş değeri: bir kapı script’i isteği aldıysa true, değilse false.

if (outcome === "won") doors.setLocked("bank_vault", false, source);

doors.isLockedCopy Anchor Link

Taraf: Server · Bekler: hayır

doors.isLocked(id: string): boolean | null

Dönüş değeri: true ya da false, bilinmiyorsa null (kapı kilidi yok, böyle bir kapı yok ya da script server’da bunu söyleyemiyor).

if (doors.isLocked("bank_vault") === false) return fail("ALREADY_OPEN");

doors.providerCopy Anchor Link

Taraf: Server · Bekler: hayır

doors.provider(): string | null

Dönüş değeri: cevap veren kapı kilidi script’i ya da hiçbiri çalışmıyorsa null.

console.log(`doors through ${doors.provider() ?? "nothing"}`);

charactersCopy Anchor Link

ai-core üzerinden kayıtlı karakterler. Yüklü karakterler online ve ai-core’un oyuncu export’ları üzerinden gider.

characters.setOfflinePositionCopy Anchor Link

Kayıtlı (yüklü olmayan) bir karakterin doğma noktasını taşır; örneğin başka yere taşınmış uyuyan bir beden. ai-core bunu, karakteri tutan bir yükleme ya da çıkış kaydı kalmadığında yazar.

Taraf: Server · Bekler: hayır

characters.setOfflinePosition(charId: number, position: { x: number; y: number; z: number; heading?: number }): boolean

Lua karşılığı yok: ai-core’un SetOfflinePosition(charId, position) export’unu çağır.

Dönüş değeri: kabul edildiyse true. Karakter yüklüyse ya da değerler yanlışsa false.

characters.setOfflinePosition(sleeperCharId, { x: 340.2, y: -1396.7, z: 32.5, heading: 50 });