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.

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

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 crea las tablas automáticamente en el primer inicio. Si falla:

1. Verifique que oxmysql está funcionando y configurado correctamente


2. Verifique que su usuario de base de datos tiene los permisos CREATE TABLE


3. Como último recurso, importe manualmente sql/install.sql

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. Verifique que tiene el permiso ACE: hz_weather.admin

   add_ace group.admin hz_weather.admin allow

1. Verifique recursos en conflicto que utilicen el mismo atajo
2. Intente 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

Verifique estos ajustes en config/config.lua:

• Config.DynamicWeather = true (debe estar activado)


• Config.FreezeWeather = false (no debe estar congelado)


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

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

En config/weather_types.lua, elimine o desactive los tipos de clima relacionados con la nieve (SNOW, SNOWLIGHT, BLIZZARD, XMAS).

O en los presets de estaciones (config/seasons.lua), elimine los tipos de nieve de todas las secuencias meteorológicas.

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. Verifique que las zonas existen en la base de datos (tabla hz_weather_zones)
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 → CLEARING) que cicla automáticamente. Las estaciones también controlan los rangos de temperatura y los perfiles de viento.

Tres modos de ciclo están disponibles:

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


• auto — Rotación a través de 4 estaciones con un temporizador (por defecto: 120 minutos para el ciclo completo)


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

La temperatura se muestra a través de las aplicaciones meteorológicas para teléfono (LB Phone / QS Smartphone) y opcionalmente en el HUD. 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. Necesita el permiso ACE de administrador (hz_weather.admin)
3. Comandos: /tornado start, /tornado stop, /tsunami start, /tsunami stop

Ajuste las fuerzas en config/config.lua:

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


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


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

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.

Verifique que Config.GameplayEffects.VehicleTraction.enabled = true en la configuración. Los modificadores por defecto son: lluvia 70%, nieve 50%, ventisca 30% de la adherencia normal.

Aumente los umbrales de histeresis en la configuración:

• Config.GameplayEffects.PlayerEffects.ColdHysteresis — banda de temperatura antes de re-disparar el frío


• Config.GameplayEffects.PlayerEffects.HeatHysteresis — lo mismo para el calor

Cada efecto de gameplay tiene su propio toggle en 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 },
}

Establezca enabled = false para desactivar individualmente.

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