Synchro de la météo et de l’heure

Le script météo (ai-weathersync, ou un script tiers) garde chaque joueur sur la météo et l’horloge du serveur. Quand votre script a besoin de sa propre météo ou de sa propre heure sur l’écran d’un joueur (un intérieur sombre, un créateur de personnage, une cinématique), mettez d’abord la synchro en pause, sinon le script météo écrase vos valeurs un instant plus tard.

La pause fonctionne avec des raisons, comme le HUD : la synchro reste en pause tant qu’au moins une raison est posée et reprend quand la dernière est effacée. Les raisons appartiennent à la ressource qui les a posées et sont retirées quand elle s’arrête. ai-core prévient le script météo par son propre événement client ai-core:client:worldSync et par les événements de pause courants qu’écoutent les scripts météo tiers (qb-weathersync, cd_easytime, vSync, av_weather). Dans l’autre sens, quand un script envoie lui-même l’un de ces événements, ai-core le compte aussi comme une raison, si bien que la reprise d’un script ne met jamais fin à la pause d’un autre.

PauseWorldSyncCopy Anchor Link

Met en pause la synchro de la météo et de l’heure dans le jeu de ce joueur, sous une raison de votre ressource.

Côté : Client · Attend : non

PauseWorldSync(reason: string): void

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

ParamètresCopy Anchor Link

RetourCopy Anchor Link

Rien. Une reason qui n’est pas une chaîne est ignorée.

ExempleCopy Anchor Link

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

// Une nuit sombre et claire dans un intérieur personnalisé, retour à la météo du serveur en sortant.
export function enterInterior(): void {
  world.pauseSync("interior"); // identique à resourceExport("ai-core").PauseWorldSync("interior")
  NetworkOverrideClockTime(23, 0, 0);
  SetWeatherTypeNowPersist("CLEAR");
}

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

ResumeWorldSyncCopy Anchor Link

Efface une raison de pause de votre ressource. La synchro reprend, et le script météo remet la météo et l’horloge du serveur, quand il ne reste plus aucune raison.

Côté : Client · Attend : non

ResumeWorldSync(reason: string): void

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

ParamètresCopy Anchor Link

RetourCopy Anchor Link

Rien.

ExempleCopy Anchor Link

Voir l’exemple de PauseWorldSync.

IsWorldSyncPausedCopy Anchor Link

Indique si la synchro est en pause en ce moment, par une ressource ou un événement de pause tiers. Un script météo qui démarre plus tard la lit une fois ; ensuite il suit l’événement client ai-core:client:worldSync.

Côté : Client · Attend : non

IsWorldSyncPaused(): boolean

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

ParamètresCopy Anchor Link

Aucun.

RetourCopy Anchor Link

boolean : true tant qu’au moins une raison est posée, false quand la synchro tourne.

ExempleCopy Anchor Link

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

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

// Votre propre script météo : cesser d’appliquer la météo du serveur pendant la pause.
let paused = core.IsWorldSyncPaused();
on(CORE.clientWorldSyncEvent, (value: boolean) => {
  paused = value;
});

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