Wetter- und Zeitsynchronisierung

Das Wetter-Skript (ai-weathersync oder eines eines Drittanbieters) hält jeden Spieler auf dem Wetter und der Uhr des Servers. Wenn dein Skript auf dem Bildschirm eines Spielers eigenes Wetter oder eine eigene Zeit braucht (ein dunkles Interior, ein Charakter-Editor, eine Zwischensequenz), halte zuerst die Synchronisierung an, sonst überschreibt das Wetter-Skript deine Werte einen Moment später.

Das Anhalten arbeitet mit Gründen, wie beim HUD: Die Synchronisierung bleibt angehalten, solange mindestens ein Grund gesetzt ist, und läuft wieder, wenn der letzte gelöscht ist. Gründe gehören der Ressource, die sie gesetzt hat, und werden entfernt, wenn sie stoppt. ai-core informiert das Wetter-Skript über sein eigenes Client-Event ai-core:client:worldSync und über die üblichen Pause-Events, auf die Wetter-Skripte von Drittanbietern hören (qb-weathersync, cd_easytime, vSync, av_weather). Umgekehrt zählt ai-core es ebenfalls als Grund, wenn ein Skript selbst eines dieser Events sendet, sodass das Fortsetzen eines Skripts nie die Pause eines anderen beendet.

PauseWorldSyncCopy Anchor Link

Hält die Wetter- und Zeitsynchronisierung im Spiel dieses Spielers unter einem Grund deiner Ressource an.

Seite: Client · Wartet: nein

PauseWorldSync(reason: string): void

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

ParameterCopy Anchor Link

RückgabeCopy Anchor Link

Nichts. Ein reason, der kein String ist, wird ignoriert.

BeispielCopy Anchor Link

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

// Eine dunkle, klare Nacht in einem eigenen Interior, beim Verlassen zurück zum Wetter des Servers.
export function enterInterior(): void {
  world.pauseSync("interior"); // dasselbe wie resourceExport("ai-core").PauseWorldSync("interior")
  NetworkOverrideClockTime(23, 0, 0);
  SetWeatherTypeNowPersist("CLEAR");
}

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

ResumeWorldSyncCopy Anchor Link

Löscht einen Pause-Grund deiner Ressource. Die Synchronisierung läuft wieder, und das Wetter-Skript stellt Wetter und Uhr des Servers wieder her, wenn kein Grund mehr übrig ist.

Seite: Client · Wartet: nein

ResumeWorldSync(reason: string): void

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

ParameterCopy Anchor Link

RückgabeCopy Anchor Link

Nichts.

BeispielCopy Anchor Link

Siehe das Beispiel zu PauseWorldSync.

IsWorldSyncPausedCopy Anchor Link

Sagt, ob die Synchronisierung gerade von irgendeiner Ressource oder einem Pause-Event eines Drittanbieters angehalten ist. Ein Wetter-Skript, das später startet, liest es einmal; danach folgt es dem Client-Event ai-core:client:worldSync.

Seite: Client · Wartet: nein

IsWorldSyncPaused(): boolean

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

ParameterCopy Anchor Link

Keine.

RückgabeCopy Anchor Link

boolean: true, solange mindestens ein Grund gesetzt ist, false, wenn die Synchronisierung läuft.

BeispielCopy Anchor Link

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

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

// Ein eigenes Wetter-Skript: das Wetter des Servers nicht anwenden, solange angehalten.
let paused = core.IsWorldSyncPaused();
on(CORE.clientWorldSyncEvent, (value: boolean) => {
  paused = value;
});

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