Sincronización de clima y hora

El script de clima (ai-weathersync, o uno de terceros) mantiene a cada jugador con el clima y el reloj del servidor. Cuando tu script necesita su propio clima u hora en la pantalla de un jugador (un interior oscuro, un creador de personajes, una cinemática), pausa primero la sincronización; si no, el script de clima sobrescribe tus valores un momento después.

La pausa funciona con motivos, como el HUD: la sincronización sigue en pausa mientras haya al menos un motivo puesto y vuelve a correr cuando se quita el último. Los motivos pertenecen al recurso que los puso y se quitan cuando se detiene. ai-core avisa al script de clima con su propio evento de cliente ai-core:client:worldSync y con los eventos de pausa comunes que escuchan los scripts de clima de terceros (qb-weathersync, cd_easytime, vSync, av_weather). En sentido contrario, cuando un script envía él mismo uno de esos eventos, ai-core también lo cuenta como un motivo, así que la reanudación de un script nunca termina la pausa de otro.

PauseWorldSyncCopy Anchor Link

Pausa la sincronización de clima y hora en el juego de este jugador bajo un motivo de tu recurso.

Lado: Cliente · Espera: no

PauseWorldSync(reason: string): void

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

ParámetrosCopy Anchor Link

DevuelveCopy Anchor Link

Nada. Un reason que no es una cadena se ignora.

EjemploCopy Anchor Link

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

// Una noche oscura y despejada dentro de un interior propio, y de vuelta al clima del servidor al salir.
export function enterInterior(): void {
  world.pauseSync("interior"); // igual que resourceExport("ai-core").PauseWorldSync("interior")
  NetworkOverrideClockTime(23, 0, 0);
  SetWeatherTypeNowPersist("CLEAR");
}

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

ResumeWorldSyncCopy Anchor Link

Quita un motivo de pausa de tu recurso. Cuando no queda ningún motivo, la sincronización vuelve a correr y el script de clima restablece el clima y el reloj del servidor.

Lado: Cliente · Espera: no

ResumeWorldSync(reason: string): void

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

ParámetrosCopy Anchor Link

DevuelveCopy Anchor Link

Nada.

EjemploCopy Anchor Link

Consulta el ejemplo de PauseWorldSync.

IsWorldSyncPausedCopy Anchor Link

Indica si la sincronización está en pausa ahora mismo por algún recurso o evento de pausa de terceros. Un script de clima que se inicia más tarde lo lee una vez; después sigue el evento de cliente ai-core:client:worldSync.

Lado: Cliente · Espera: no

IsWorldSyncPaused(): boolean

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

ParámetrosCopy Anchor Link

Ninguno.

DevuelveCopy Anchor Link

boolean: true mientras haya al menos un motivo puesto, false cuando la sincronización corre.

EjemploCopy Anchor Link

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

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

// Un script de clima propio: deja de aplicar el clima del servidor mientras está en pausa.
let paused = core.IsWorldSyncPaused();
on(CORE.clientWorldSyncEvent, (value: boolean) => {
  paused = value;
});

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