Синхронизация погоды и времени

Скрипт погоды (ai-weathersync или сторонний) держит всех игроков на погоде и часах сервера. Когда вашему скрипту нужна своя погода или время на экране одного игрока (тёмный интерьер, редактор персонажа, катсцена), сначала приостановите синхронизацию, иначе скрипт погоды через мгновение перезапишет ваши значения.

Пауза работает с причинами, как у HUD: синхронизация стоит, пока задана хотя бы одна причина, и снова идёт, когда снята последняя. Причины принадлежат ресурсу, который их задал, и удаляются, когда он останавливается. ai-core сообщает скрипту погоды через собственное клиентское событие ai-core:client:worldSync и через общие события паузы, которые слушают сторонние скрипты погоды (qb-weathersync, cd_easytime, vSync, av_weather). И наоборот: когда скрипт сам отправляет одно из этих событий, ai-core тоже считает его причиной, поэтому возобновление от одного скрипта никогда не завершает паузу другого.

PauseWorldSyncCopy Anchor Link

Приостанавливает синхронизацию погоды и времени в игре этого игрока под причиной вашего ресурса.

Сторона: клиент · Ожидание: нет

PauseWorldSync(reason: string): void

exports['ai-core']:PauseWorldSync(reason) -- или aiLib.world.pauseSync(reason)

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

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

Ничего. reason, который не является строкой, игнорируется.

ПримерCopy Anchor Link

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

// Тёмная ясная ночь внутри своего интерьера, при выходе возврат к погоде сервера.
export function enterInterior(): void {
  world.pauseSync("interior"); // то же, что resourceExport("ai-core").PauseWorldSync("interior")
  NetworkOverrideClockTime(23, 0, 0);
  SetWeatherTypeNowPersist("CLEAR");
}

export function leaveInterior(): void {
  NetworkClearClockTimeOverride();
  world.resumeSync("interior");
}

ResumeWorldSyncCopy Anchor Link

Снимает одну причину паузы вашего ресурса. Когда причин не остаётся, синхронизация снова идёт, и скрипт погоды возвращает погоду и часы сервера.

Сторона: клиент · Ожидание: нет

ResumeWorldSync(reason: string): void

exports['ai-core']:ResumeWorldSync(reason) -- или aiLib.world.resumeSync(reason)

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

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

Ничего.

ПримерCopy Anchor Link

См. пример PauseWorldSync.

IsWorldSyncPausedCopy Anchor Link

Сообщает, приостановлена ли синхронизация прямо сейчас каким-либо ресурсом или сторонним событием паузы. Скрипт погоды, который запускается позже, читает это один раз; после этого он следит за клиентским событием ai-core:client:worldSync.

Сторона: клиент · Ожидание: нет

IsWorldSyncPaused(): boolean

local paused = exports['ai-core']:IsWorldSyncPaused() -- boolean

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

Нет.

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

boolean: true, пока задана хотя бы одна причина, false, когда синхронизация идёт.

ПримерCopy Anchor Link

import { resourceExport } from "@aicore-fivem/lib/client";
import { CORE } from "@aicore-fivem/shared";

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

// Собственный скрипт погоды: не применять погоду сервера, пока стоит пауза.
let paused = core.IsWorldSyncPaused();
on(CORE.clientWorldSyncEvent, (value: boolean) => {
  paused = value;
});

export const shouldApplyWeather = (): boolean => !paused;