Hora e clima

Hora e clima passam pelo ai-core, nunca pelos exports ou eventos próprios de um script de clima. O ai-core encaminha cada chamada ao primeiro script de clima que estiver rodando: Renewed-Weathersync, av_weather, cd_easytime e depois qb-weathersync (o ai-weathersync responde sob esse nome). Todos seguem o contrato do qb-weathersync. Enquanto nenhum está rodando, cada chamada responde null ou false.

Para pausar a sincronização no jogo de um jogador (um interior com luz própria, uma cutscene), use o lado cliente (PauseWorldSync, world.pauseSync da lib); veja Exports de cliente.

GetWeatherCopy Anchor Link

O tipo de clima atual.

Lado: Servidor · Espera: não · Lib: world.getWeather

GetWeather(): string | null

local weather = exports['ai-core']:GetWeather() -- 'EXTRASUNNY', 'RAIN'... ou nil

ParâmetrosCopy Anchor Link

Nenhum.

RetornoCopy Anchor Link

string | null: o tipo de clima em maiúsculas (EXTRASUNNY, CLEAR, RAIN, THUNDER...). null quando nenhum script de clima está rodando.

ExemploCopy Anchor Link

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

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

/** Street races pay more in the rain. */
export function raceBonus(): number {
  const weather = core.GetWeather();
  return weather === "RAIN" || weather === "THUNDER" ? 1.25 : 1;
}

SetWeatherCopy Anchor Link

Define o clima para todos.

Lado: Servidor · Espera: não · Lib: world.setWeather (recebe os nomes tipados de Weather)

SetWeather(type: string): boolean

local ok = exports['ai-core']:SetWeather('RAIN')

ParâmetrosCopy Anchor Link

RetornoCopy Anchor Link

boolean: true quando o script de clima o aceitou. false quando type não é texto, o script o recusou (um tipo desconhecido) ou nenhum script de clima está rodando.

ExemploCopy Anchor Link

import { addCommand, resourceExport } from "@aicore-fivem/lib/server";
import { isWeather } from "@aicore-fivem/shared";

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

addCommand("weather", { help: "Sets the weather", params: [{ name: "type", type: "string" }], restricted: true }, (_source, args) => {
  const type = args.type.toUpperCase();
  if (!isWeather(type)) return console.log("unknown weather type");
  core.SetWeather(type);
});

GetTimeCopy Anchor Link

A hora do jogo (o relógio dentro do jogo).

Lado: Servidor · Espera: não · Lib: world.getTime

GetTime(): { hour: number; minute: number } | null

local time = exports['ai-core']:GetTime() -- { hour, minute } ou nil

ParâmetrosCopy Anchor Link

Nenhum.

RetornoCopy Anchor Link

{ hour, minute } | null: hora 0-23 e minuto 0-59. null quando nenhum script de clima está rodando.

ExemploCopy Anchor Link

import { onClientCallback, resourceExport } from "@aicore-fivem/lib/server";
import { fail } from "@aicore-fivem/lib/shared";

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

// O traficante só vende à noite (22:00 - 05:59 no horário do jogo).
onClientCallback("myscript:dealer", (source) => {
  const time = core.GetTime();
  const night = time !== null && (time.hour >= 22 || time.hour < 6);
  return night ? { ok: true } : fail("COME_BACK_AT_NIGHT");
});

SetTimeCopy Anchor Link

Define a hora do jogo para todos.

Lado: Servidor · Espera: não · Lib: world.setTime

SetTime(hour: number, minute?: number): boolean

local ok = exports['ai-core']:SetTime(12, 0)

ParâmetrosCopy Anchor Link

RetornoCopy Anchor Link

boolean: true quando o script de clima a aceitou. false quando hour não é um número, o script recusou ou nenhum script de clima está rodando.

ExemploCopy Anchor Link

import { addCommand, resourceExport } from "@aicore-fivem/lib/server";

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

addCommand("noon", { help: "Sets the time to 12:00", restricted: true }, () => {
  core.SetTime(12, 0);
});

SetBlackoutCopy Anchor Link

Liga ou desliga o blackout da cidade (todas as luzes artificiais apagadas).

Lado: Servidor · Espera: não · Lib: world.setBlackout

SetBlackout(on: boolean): boolean

local ok = exports['ai-core']:SetBlackout(true)

ParâmetrosCopy Anchor Link

RetornoCopy Anchor Link

boolean: true quando o script de clima o aceitou. false quando o script não tem blackout, recusou ou nenhum script de clima está rodando.

ExemploCopy Anchor Link

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

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

/** The power plant was sabotaged: 5 minutes of darkness. */
export function sabotagePowerPlant(): void {
  if (!core.SetBlackout(true)) return;
  setTimeout(() => core.SetBlackout(false), 5 * 60_000);
}

FreezeTimeCopy Anchor Link

Para ou reinicia o relógio do jogo.

Lado: Servidor · Espera: não · Lib: world.freezeTime

FreezeTime(on: boolean): boolean

local ok = exports['ai-core']:FreezeTime(true)

ParâmetrosCopy Anchor Link

RetornoCopy Anchor Link

boolean: true quando o script de clima o aceitou. false quando o script não consegue congelar a hora, recusou ou nenhum script de clima está rodando.

ExemploCopy Anchor Link

import { addCommand, resourceExport } from "@aicore-fivem/lib/server";

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

// Uma noite de evento: sempre 21:00.
addCommand("eventnight", { help: "Freezes the clock at 21:00", restricted: true }, () => {
  core.SetTime(21, 0);
  core.FreezeTime(true);
});