FAQ

HZ-Weather suporta QBCore, ESX, QBX e o modo Standalone. O framework e detectado automaticamente na inicializacao — nenhuma configuracao manual necessaria.

Sim. HZ-Weather e totalmente compativel com OneSync e OneSync Infinity. A sincronizacao de clima utiliza GlobalState e state bags para desempenho otimo.

Nao. Voce deve desativar todos os outros scripts de clima antes de usar o HZ-Weather. Ter dois scripts de clima ativos causara conflitos visuais e de sincronizacao.

Scripts a serem parados: vSync, qb-weathersync, cd_easytime, esx_weather, etc.

HZ-Weather substitui automaticamente qb-weathersync e cd_easytime via diretiva provide e expoe seus exports para retrocompatibilidade.

Nao. HZ-Weather e otimizado para impacto minimo: 0.00 ms em repouso no lado do cliente, ~0.08 ms durante eventos ativos (tornado, tsunami). O impacto no lado do servidor e desprezivel.

• ox_lib v3.0+
• oxmysql v2.0+
• PolyZone

Verifique que:

1. A pasta se chama exatamente hz_weather


2. O script esta no seu diretorio resources/ (ex: resources/[standalone]/hz_weather/)


3. Sua licenca esta ativa em keymaster.fivem.net


4. Voce esta usando a mesma conta FiveM vinculada a sua compra Tebex

Isso e normal se voce esta em standalone (sem framework). O script usara o modo standalone.

Se voce tem um framework, certifique-se de que es_extended ou qb-core esta com ensure antes do hz_weather no seu server.cfg.

Hz-Weather cria as tabelas automaticamente na primeira inicializacao. Se falhar:

1. Verifique se o oxmysql esta rodando e configurado corretamente


2. Verifique se seu usuario de banco de dados tem permissoes CREATE TABLE


3. Em ultimo caso, importe manualmente o sql/install.sql

1. Baixe a versao mais recente no Keymaster
2. Faca backup da sua pasta config/
3. Substitua todos os arquivos exceto config/
4. Consulte o Changelog para novos parametros de configuracao
5. Reinicie o recurso: ensure hz_weather

1. Verifique se voce tem a permissao ACE: hz_weather.admin

   add_ace group.admin hz_weather.admin allow

1. Verifique recursos em conflito usando o mesmo atalho
2. Tente reiniciar o recurso: ensure hz_weather

• Certifique-se de que o banco de dados esta acessivel (verifique o status do oxmysql)
• Verifique o console F8 para erros JavaScript
• Reinicie o recurso para forcar uma sincronizacao dos dados

Verifique estas configuracoes em config/config.lua:

• Config.DynamicWeather = true (deve estar ativado)


• Config.FreezeWeather = false (nao deve estar congelado)


• Config.WeatherChangeInterval (padrao: 600 segundos = 10 minutos)

exports['hz_weather']:setZoneWeather('all', 'XMAS')
-- Ou para uma zona especifica:
exports['hz_weather']:setZoneWeather('Mount Chiliad', 'XMAS')

Em config/weather_types.lua, remova ou desative os tipos de clima relacionados a neve (SNOW, SNOWLIGHT, BLIZZARD, XMAS).

Ou nos presets de estacoes (config/seasons.lua), remova os tipos de neve de todas as sequencias de clima.

Aumente Config.ZoneTransitionDistance em config/config.lua. O valor padrao e 800.0 metros. Um valor mais alto cria uma zona de mesclagem mais ampla entre as zonas.

Voce tambem pode ativar Config.WeatherInfluence.enabled = true para que zonas vizinhas se misturem naturalmente.

1. Certifique-se de que o PolyZone esta iniciado antes do hz_weather no server.cfg
2. Verifique o console do servidor para erros de banco de dados
3. Verifique se as zonas existem no banco de dados (tabela hz_weather_zones)
4. Tente criar uma zona pelo painel admin para testar

exports['hz_weather']:createZone({
    name = 'ma_zone',
    label = 'Minha Zona Personalizada',
    center = vector3(x, y, z),
    radius = 1500.0,
    shape = 'circle',
    priority = 1,
    weather = 'CLEAR',
})

Cada estacao define uma sequencia de clima (ex: Verao = EXTRASUNNY → CLEAR → CLOUDS → CLEARING) que cicla automaticamente. As estacoes tambem controlam as faixas de temperatura e os perfis de vento.

Tres modos de ciclo estao disponiveis:

• disabled — Controle manual apenas (via painel admin ou comandos)


• auto — Rotacao pelas 4 estacoes em um timer (padrao: 120 minutos para o ciclo completo)


• realtime — Faz corresponder os meses reais do calendario as estacoes

A temperatura e exibida pelos aplicativos de clima no celular (LB Phone / QS Smartphone) e opcionalmente no HUD. A unidade e configuravel em Config.TemperatureUnit — 'C' para Celsius ou 'F' para Fahrenheit.

O modo realtime utiliza o horario do servidor (o relogio da sua maquina). Se seu servidor esta em UTC, as estacoes seguem o calendario UTC. Para ajustar, configure o fuso horario da maquina do seu servidor.

1. Verifique se Config.Tornado.Enabled = true e Config.Tsunami.Enabled = true na config
2. Voce precisa da permissao ACE admin (hz_weather.admin)
3. Comandos: /tornado start, /tornado stop, /tsunami start, /tsunami stop

Ajuste as forcas em config/config.lua:

• Config.Tornado.PullForce — forca de atracao para o centro


• Config.Tornado.LiftForce — forca de elevacao vertical


• Config.Tornado.SpinForce — forca de rotacao

O tsunami utiliza LoadWaterFromPath — essa funcao nativa requer um caminho de agua valido. Verifique se o arquivo de dados de agua esta presente no recurso e se o servidor suporta essa funcionalidade nativa.

Verifique se Config.GameplayEffects.VehicleTraction.enabled = true na config. Os modificadores padrao sao: chuva 70%, neve 50%, nevasca 30% da aderencia normal.

Aumente os limites de histerese na config:

• Config.GameplayEffects.PlayerEffects.ColdHysteresis — faixa de temperatura antes de re-acionar o frio


• Config.GameplayEffects.PlayerEffects.HeatHysteresis — idem para o calor

Cada efeito de gameplay tem seu proprio toggle em config/config.lua:

Config.GameplayEffects = {
    VehicleTraction = { enabled = true },
    ReducedVisibility = { enabled = true },
    AutoWipers = { enabled = true },
    AutoHeadlights = { enabled = true },
    PlayerEffects = { enabled = true },
    SpeedReduction = { enabled = true },
    AmbientSounds = { enabled = true },
    SyncedLightning = { enabled = true },
    Blackout = { enabled = true },
}

Defina enabled = false para desativar individualmente.

• LB Phone — Aplicativo de clima dedicado (gratuito, recurso separado)
• QS Smartphone V3 — Aplicativo de clima dedicado (gratuito, recurso separado)
• QS Smartphone V2 (Pro) — Versao legada (use a v1.x do app)

O QS Smartphone V3 utiliza um sistema de aplicativo de clima nativo integrado. O app HZ-Weather precisa substituir essa entrada nativa, o que requer uma modificacao de uma linha no arquivo de configuracao do QS Smartphone. Isso e uma limitacao da arquitetura do QS V3, nao do HZ-Weather.

Sim. Use a pagina map.html autonoma via iframe:

<iframe src="https://cfx-nui-hz_weather/web/dist/map.html"
  style="width:100%;height:100%;border:none" />

Ela exibe as zonas, clima, temperatura, vento e informacoes da estacao com atualizacao automatica.