FAQ

HZ-Weather soporta QBCore, ESX, QBX y el modo Standalone. El framework es detectado automáticamente al inicio — no se necesita configuración manual.

Sí. HZ-Weather es totalmente compatible con OneSync y OneSync Infinity. La sincronización meteorológica utiliza GlobalState y los state bags para un rendimiento optimo.

No. Debe desactivar todos los demás scripts de clima antes de utilizar HZ-Weather. Tener dos scripts de clima activos causara conflictos visuales y de sincronización.

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

HZ-Weather reemplaza automáticamente qb-weathersync y cd_easytime mediante la directiva provide y expone sus exports para retrocompatibilidad.

No. HZ-Weather está optimizado para un impacto mínimo: 0.00 ms en reposo del lado del cliente, ~0.08 ms durante eventos activos (tornado, tsunami). El impacto del lado del servidor es despreciable.

• hz_lib (gratis, común a todos los scripts HZ)
• ox_lib v3.0+
• oxmysql v2.0+
• PolyZone

No se requiere framework — el script funciona en standalone.

Verifique que:

1. La carpeta se llama exactamente hz_weather


2. El script está en su directorio resources/ (ej: resources/[standalone]/hz_weather/)


3. Su licencia está activa en keymaster.fivem.net


4. Utiliza la misma cuenta FiveM vinculada a su compra Tebex

Es normal si está en standalone (sin framework). El script utilizara el modo standalone.

Si tiene un framework, asegúrese de que es_extended o qb-core tiene ensure antes de hz_weather en su server.cfg.

Hz-Weather no crea sus tablas por sí solo: importa sql/install.sql en tu base de datos antes del primer inicio. Sin ellas, la consola muestra Please import sql/install.sql into your database. Si la importación falla:

1. Verifica que oxmysql está funcionando y configurado correctamente


2. Verifica que tu usuario de base de datos tiene los permisos CREATE TABLE


3. Importa el archivo de nuevo: se puede importar varias veces sin error

1. Descargue la última versión desde Keymaster
2. Guarde su carpeta config/
3. Reemplace todos los archivos excepto config/
4. Consulte el Changelog para los nuevos parámetros de configuración
5. Reinicie el recurso: ensure hz_weather

1. Ábrelo con /weather, o con /hzpanel y luego el módulo Clima
2. Verifica que tienes acceso de administrador: el ACE admin (Config.AdminPermission), el grupo admin de tu framework, el ACE weather.admin o un rol de hz_lib con el derecho manage sobre hz_weather

   add_ace group.admin weather.admin allow

1. Cuando se rechaza el acceso, la consola del servidor indica el permiso que falta
2. Intenta reiniciar el recurso: ensure hz_weather

• Asegúrese de que la base de datos es accesible (verifique el estado de oxmysql)
• Verifique la consola F8 en busca de errores JavaScript
• Reinicie el recurso para forzar una sincronización de datos

Verifica estos puntos:

• Config.FreezeWeather = false, y el clima no está congelado en el panel


• Con las estaciones activadas (por defecto), el clima sigue la weatherSequence de la estación en config/seasons.lua (duraciones en minutos reales, de 35 a 100 min por entrada por defecto)


• Con las estaciones desactivadas, Config.DynamicWeather = true hace girar la lista de config/weather.lua (weatherCycletimer, 90 minutos por defecto)


• Una zona ajustada por un admin queda bloqueada hasta que se desbloquea (insignia de candado en el mapa del panel, o /weatherunlock <zone|all>)


• Las zonas con ignoreSeason = true (Cayo Perico) mantienen su propio clima

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

Con las estaciones activadas (por defecto), quita SNOW, SNOWLIGHT y BLIZZARD de la weatherSequence del invierno en config/seasons.lua (las otras estaciones no tienen nieve).

Con las estaciones desactivadas, pon decemberSnow = false en config/weather.lua y da probability = 0 a las secuencias de nevada y de tormenta de nieve (solo se usan en diciembre).

Aumente Config.ZoneTransitionDistance en config/config.lua. El valor por defecto es 800.0 metros. Un valor más alto crea una zona de mezcla más amplia entre las zonas.

También puede activar Config.WeatherInfluence.enabled = true para que las zonas vecinas se mezclen de forma natural.

1. Asegúrese de que PolyZone se inicia antes de hz_weather en server.cfg
2. Verifique la consola del servidor en busca de errores de base de datos
3. Las zonas vienen de config/zones.lua. La tabla hz_weather_zones solo contiene las zonas guardadas desde el editor del panel, y esas filas tienen prioridad sobre el archivo (la consola las lista al iniciar)
4. Intente crear una zona desde el panel de administración para probar

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

Cada estación define una secuencia meteorológica (ej: Verano = EXTRASUNNY → CLEAR → CLOUDS → CLEAR) que cicla automáticamente, y su propia curva de temperatura.

Tres modos de ciclo están disponibles (cycleMode en config/seasons.lua):

• disabled — Control manual unicamente (vía panel de administración o comandos)


• auto — Rotación a través de las 4 estaciones con un temporizador (cycleDuration, por defecto: 120 minutos reales por estación)


• realtime — Hace coincidir los meses reales del calendario con las estaciones

La temperatura se muestra en el HUD del script (Config.HUD), con el comando /temp, y en las aplicaciones meteorológicas para teléfono (LB Phone / QS Smartphone). La unidad es configurable en Config.TemperatureUnit — 'C' para Celsius o 'F' para Fahrenheit.

El modo realtime utiliza el tiempo del servidor (el reloj de su máquina). Si su servidor está en UTC, las estaciones siguen el calendario UTC. Para ajustar, configure la zona horaria de su máquina servidor.

1. Verifique que Config.Tornado.Enabled = true y Config.Tsunami.Enabled = true en la configuración
2. Necesitas acceso de administrador (ver Instalación)
3. Comandos: /tornado start, /tornado stop, /tsunami start, /tsunami stop

Ajuste las fuerzas en config/config.lua:

• Config.Tornado.HorizontalPullForce — fuerza de atracción hacia el centro


• Config.Tornado.VerticalForce — fuerza de elevación vertical


• Config.Tornado.TangentialForce — fuerza de rotación


• Config.Tornado.ForceScale — multiplicador global

El tsunami utiliza LoadWaterFromPath — esta función nativa requiere una ruta de agua valida. Verifique que el archivo de datos de agua está presente en el recurso y que el servidor soporta esta funcionalidad nativa. La fase de alerta dura 120 segundos antes de que suba el agua (Config.Tsunami.WarningDuration).

La tracción está desactivada por defecto: pon Config.Effects.vehicleTraction.enabled = true en la configuración. Los modificadores por defecto son: lluvia 70%, nieve 50%, ventisca 30% de la adherencia normal.

Estas notificaciones están desactivadas por defecto desde la v1.4.2. Para tenerlas, pon Config.Notifications.Temperature = true (y mantén notifications = true en Config.Effects.playerEffects).

Los umbrales son coldThreshold (10 °C) y heatThreshold (30 °C) en Config.Effects.playerEffects. Un margen fijo de 2 °C y una espera de 2 minutos entre dos notificaciones evitan que se repitan cuando la temperatura oscila alrededor de un umbral.

Cada efecto de gameplay tiene su propio toggle en config/config.lua:

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

Pon enabled = false (o Config.BlackoutEnabled = false) para desactivar cada uno.

• LB Phone — Aplicación meteorológica dedicada (gratuita, recurso separado)
• QS Smartphone V3 — Aplicación meteorológica dedicada (gratuita, recurso separado)
• QS Smartphone V2 (Pro) — Versión legacy (utilice la v1.x de la app)

QS Smartphone V3 utiliza un sistema de aplicación meteorológica nativa integrado. La app HZ-Weather debe reemplazar está entrada nativa, lo cual requiere una modificación de una línea en el archivo de configuración de QS Smartphone. Es una limitación de la arquitectura de QS V3, no de HZ-Weather.

Sí. Utilice la página map.html autónoma vía iframe:

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

Muestra las zonas, el clima, la temperatura, el viento y la información de estación con actualización automática.