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.

• hz_lib (gratuito, comum a todos os scripts HZ)
• ox_lib v3.0+
• oxmysql v2.0+
• PolyZone

Nenhum framework e necessario — o script funciona em standalone.

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 não cria suas tabelas sozinho: importe o sql/install.sql no seu banco de dados antes da primeira inicialização. Sem elas, o console mostra Please import sql/install.sql into your database. Se a importação falhar:

1. Verifique se o oxmysql está rodando e configurado corretamente


2. Verifique se seu usuário de banco de dados tem permissões CREATE TABLE


3. Importe o arquivo novamente: ele pode ser importado várias vezes sem erro

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. Abra com /weather, ou com /hzpanel e depois o módulo Clima
2. Verifique se você tem acesso de admin: o ACE admin (Config.AdminPermission), o grupo admin do seu framework, o ACE weather.admin ou um papel do hz_lib com o direito manage sobre hz_weather

   add_ace group.admin weather.admin allow

1. Quando o acesso é recusado, o console do servidor indica a permissão que falta
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 estes pontos:

• Config.FreezeWeather = false, e o clima não está congelado no painel


• Com as estações ativadas (padrão), o clima segue a weatherSequence da estação em config/seasons.lua (durações em minutos reais, de 35 a 100 min por entrada por padrão)


• Com as estações desativadas, Config.DynamicWeather = true roda a lista de config/weather.lua (weatherCycletimer, 90 minutos por padrão)


• Uma zona definida por um admin fica bloqueada até ser desbloqueada (ícone de cadeado no mapa do painel, ou /weatherunlock <zone|all>)


• Zonas com ignoreSeason = true (Cayo Perico) mantêm o próprio clima

exports['hz_weather']:setZoneWeather('mont_josiah', 'XMAS')

Com as estações ativadas (padrão), remova SNOW, SNOWLIGHT e BLIZZARD da weatherSequence do inverno em config/seasons.lua (as outras estações não têm neve).

Com as estações desativadas, defina decemberSnow = false em config/weather.lua e dê probability = 0 às sequências de nevasca e tempestade de neve (elas só rodam em dezembro).

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. As zonas vêm de config/zones.lua. A tabela hz_weather_zones só contém as zonas salvas pelo editor do painel, e essas linhas têm prioridade sobre o arquivo (o console as lista na inicialização)
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 → CLEAR) que cicla automaticamente, e sua própria curva de temperatura.

Tres modos de ciclo estao disponiveis (cycleMode em config/seasons.lua):

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


• auto — Rotacao pelas 4 estacoes em um timer (cycleDuration, padrão: 120 minutos reais por estação)


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

A temperatura é exibida no HUD do script (Config.HUD), com o comando /temp e nos aplicativos de clima no celular (LB Phone / QS Smartphone). 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. Você precisa de acesso de admin (veja Instalação)
3. Comandos: /tornado start, /tornado stop, /tsunami start, /tsunami stop

Ajuste as forcas em config/config.lua:

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


• Config.Tornado.VerticalForce — forca de elevacao vertical


• Config.Tornado.TangentialForce — forca de rotacao


• Config.Tornado.ForceScale — multiplicador global

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. A fase de alerta dura 120 segundos antes de a água subir (Config.Tsunami.WarningDuration).

A tração está desativada por padrão: defina Config.Effects.vehicleTraction.enabled = true na config. Os modificadores padrao sao: chuva 70%, neve 50%, nevasca 30% da aderencia normal.

Essas notificações estão desativadas por padrão desde a v1.4.2. Para recebê-las, defina Config.Notifications.Temperature = true (e mantenha notifications = true em Config.Effects.playerEffects).

Os limites são coldThreshold (10 °C) e heatThreshold (30 °C) em Config.Effects.playerEffects. Uma margem fixa de 2 °C e uma espera de 2 minutos entre duas notificações evitam repetições quando a temperatura oscila em torno de um limite.

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

Config.Effects = {
    vehicleTraction = { enabled = false },
    reducedVisibility = { enabled = true },
    playerEffects = { enabled = true },
    speedReduction = { enabled = false },
}
Config.BlackoutEnabled = true

Defina enabled = false (ou Config.BlackoutEnabled = false) para desativar cada um.

• 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.