Мир

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

worldCopy Anchor Link

Время и погода через ai-core, какой бы скрипт погоды ни был запущен (Renewed-Weathersync, av_weather, cd_easytime, qb-weathersync). Пока никакой не запущен, чтение отвечает null, а изменения отвечают false.

world.getWeatherCopy Anchor Link

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

world.getWeather(): string | null

local weather = aiLib.world.getWeather()

Возвращает текущий тип погоды так, как его сообщает скрипт погоды (CLEAR, RAIN...), или null, пока никакой не запущен.

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

world.setWeatherCopy Anchor Link

Задаёт погоду.

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

world.setWeather(type: Weather): boolean

local ok = aiLib.world.setWeather(weather)

Возвращает true, если задано, 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

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

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

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

Возвращает игровое время или null, пока не запущен скрипт погоды.

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

world.setTimeCopy Anchor Link

Задаёт игровое время.

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

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

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

Возвращает true, если задано, false, пока не запущен скрипт погоды.

world.setTime(12, 30);

world.setBlackoutCopy Anchor Link

Включает или выключает блэкаут в городе.

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

world.setBlackout(on: boolean): boolean

local ok = aiLib.world.setBlackout(on)

Возвращает true, если применено, false, пока не запущен скрипт погоды или в нём нет блэкаута.

world.setBlackout(true); // электростанцию вывели из строя

world.freezeTimeCopy Anchor Link

Останавливает или снова запускает игровые часы.

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

world.freezeTime(on: boolean): boolean

local ok = aiLib.world.freezeTime(on)

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

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

bucketsCopy Anchor Link

Routing buckets (отдельные миры: интерьер квартиры, инстанс) из распределителя ai-core, поэтому два скрипта никогда не получат один и тот же. Никогда не выбирайте номера buckets сами (1000 + n). Lua-аналога нет: вызывайте экспорты ai-core AcquireBucket(tag) / ReleaseBucket(id).

buckets.acquireCopy Anchor Link

Берёт свободный bucket для этого ресурса. В нём нет населения (ни фоновых педов, ни машин) и действует строгая блокировка сущностей.

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

buckets.acquire(tag: string): number

Возвращает id bucket.

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

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

buckets.releaseCopy Anchor Link

Возвращает bucket, когда из него вышли игроки.

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

buckets.release(id: number): boolean

Возвращает true, если освобождён. Каждый bucket остановленного ресурса возвращается сам.

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

doorsCopy Anchor Link

Замки дверей через слой замков ai-core, по собственному id двери в скрипте замков. Lua-аналога нет: вызывайте экспорты ai-core SetDoorLocked, IsDoorLocked.

doors.setLockedCopy Anchor Link

Запирает или отпирает дверь.

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

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

Возвращает true, если скрипт дверей принял вызов, иначе false.

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

doors.isLockedCopy Anchor Link

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

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

Возвращает true или false либо null, если неизвестно (нет скрипта замков, нет такой двери или скрипт не может сказать это на сервере).

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

doors.providerCopy Anchor Link

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

doors.provider(): string | null

Возвращает скрипт замков, который отвечает, или null, если никакой не запущен.

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

charactersCopy Anchor Link

Сохранённые персонажи через ai-core. Загруженные персонажи идут через online и экспорты игроков ai-core.

characters.setOfflinePositionCopy Anchor Link

Перемещает точку появления сохранённого (не загруженного) персонажа, например спящего тела, которое унесли. ai-core записывает её, как только персонажа не удерживает сохранение при загрузке или выгрузке.

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

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

Lua-аналога нет: вызывайте экспорт ai-core SetOfflinePosition(charId, position).

Возвращает true, если принято. false, если персонаж загружен или значения неверные.

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