Weather Script Compatibility

Zone weather has to win against whatever weather/time script your server already runs. Those scripts work by force-writing the weather in a loop (qb-weathersync rewrites it every 100 ms), so simply calling SetWeatherTypeNow once is not enough — the other script overwrites it a fraction of a second later.

Zone Creator solves this with two mechanisms that work together.

1. The hold loop (always on, no setup)

While you are inside a weather zone, Zone Creator watches the live weather and re-asserts it the instant anything moves it. Whatever the other script writes, it is immediately written back.

• Runs only while a zone weather override is active — zero cost otherwise.
• Only writes when it detects a change; otherwise it is one cheap comparison.
• Also re-applies the rain level and a frozen clock, which sync loops zero out even when the weather type itself matches (this is why RAIN / THUNDER zones used to look dry).
• If another script hijacks the weather during a fade, the fade is abandoned and the weather is set instantly — a fade that is being fought never completes.

2. Pause adapters (optional, recommended)

The hold loop guarantees the result, but two systems writing the weather every frame is wasteful. If we can politely pause the other script while the override is active, they stop fighting entirely — and its clock/rain loops stop stomping on ours.

Built in

Adding your own

Add an entry to Config.WeatherSyncs in config.lua:

Config.WeatherSyncs = {
    -- key   = resource name (only called when that resource is started)
    -- value = function(taking)  taking=true → pause it, false → resume it
    ['cd_easytime']         = function(taking) exports['cd_easytime']:PauseSync(taking) end,
    ['Renewed-Weathersync'] = function(taking) exports['Renewed-Weathersync']:setPermanentWeather(taking) end,
    ['vSync']               = function(taking) TriggerEvent('vSync:toggleSync', not taking) end,
    ['av_weather']          = function(taking) exports['av_weather']:SetSyncEnabled(not taking) end,
}

For a single custom script you can also use the older one-off hook:

Config.Integrations = {
    onWeatherOverride = function(taking) exports['my-weather']:PauseSync(taking) end,
}

3. Patching a weather script that has no pause API

Some scripts expose no way to stop them. You do not need this for zone weather to work (the hold loop covers it), but patching gives the cleanest result. The recipe is the same for almost every weather resource:

1. Open its client file and find the loop that writes the weather — it will look something like:

CreateThread(function()
    while true do
        Wait(100)
        SetWeatherTypePersist(CurrentWeather)
        SetWeatherTypeNowPersist(CurrentWeather)
        SetRainLevel(...)
    end
end)

2. Add a module-level flag and an event to toggle it:

local zcPaused = false

RegisterNetEvent('myweather:pause', function(state) zcPaused = state end)

3. Guard the loop body with it:

CreateThread(function()
    while true do
        Wait(100)
        if not zcPaused then
            SetWeatherTypePersist(CurrentWeather)
            -- … the rest of the loop
        end
    end
end)

4. Point Zone Creator at it:

Config.WeatherSyncs = {
    ['my-weather'] = function(taking) TriggerEvent('myweather:pause', taking) end,
}

Do the same for the script's time/clock loop if it has a separate one.

Side effects of pausing (and how they are handled)

Pausing a weather script usually has consequences. qb-weathersync's DisableSync is a good example — it does three things beyond stopping the loop, and Zone Creator compensates for all of them:

If you write your own adapter and the clock freezes or the rain disappears, look for the same three behaviours in that script.

Verifying it works

1. Set Config.Debug = true.
2. Walk into a weather zone. With Config.Debug on you will see a [zc-weather] drift -> re-asserting <TYPE> line only if another script is fighting the override. No line means the pause adapter is working cleanly.
3. Walk out — the weather should return to your server's normal weather within a few seconds.