en-weathersync

en-weathersync owns the clock, the weather and the ambient temperature for the whole server. Time runs at GTA's pace by default (2 real seconds per in-game minute), but nights pass slower, and both time and weather survive restarts.

Weather follows a weighted cycle: each type lists what it can turn into. A weather lasts 15-35 real minutes with a 45 second blend, and snow is off by default. Each weather has a base temperature, and ambient temperature swings with time of day (warmest at 15:00, coldest at 03:00) and drops with altitude. On every survival tick, survivors outside the comfort band get colder or hotter: shelter (interiors and vehicles) cuts exposure, rain and water chill you, clothing warmth protects against cold but makes heat worse, and nearby heat sources warm you up.

#At a glance

#How it works

#Time

The server advances the clock by secondsPerMinute, scaled by nightPace during nightHours, and publishes GlobalState.gameHour and gameMinute. Clients apply the state bags through change handlers.

#Weather

When a weather's duration ends, the next type is picked from its next weights. Snow types (SNOWLIGHT, SNOW, BLIZZARD, XMAS) only join the cycle when Config.weather.snow is true. Clients re-assert the current weather every 5 seconds.

#Body temperature

Every Config.temperature.interval ms, for each loaded player:

1. Ambient temperature is the weather's base temperature, plus the day swing, minus altitudeLapse per metre of height.
2. Past the comfort band, body temperature is pulled by coldRate or heatRate per degree, capped at maxPull per tick.
3. Shelter multiplies exposure by shelter. Being soaked in rain or in water removes extra degrees. nearHeat adds heatSource degrees.
4. Clothing warmth (0-1, from en-clothing) protects against cold and makes heat worse.

The result is written with en-core's SetTemperature. See Survival system for what body temperature does to a player.

#Configuration

config/shared.lua.

#Time and weather

Example base temperatures: EXTRASUNNY 90°F, CLEAR 82, CLOUDS 72, OVERCAST 64, FOGGY 60, RAIN 56 (wet), THUNDER 52 (wet, wind 8), SNOW 22, BLIZZARD 6.

#Temperature

A winter server with long nights and snow in the cycle:

-- config/shared.lua
Config.time.secondsPerMinute = 3.0
Config.time.nightPace = 0.6
Config.weather.start = 'SNOWLIGHT'
Config.weather.snow = true
Config.temperature.comfort = { low = 62, high = 90 }

#Exports

#Server

#Client

#Commands

All restricted to group.admin.

The same controls are in the World tab of en-admin.

#Events

#State bags

Global state published by the server:

Player state read by the temperature system:

#Examples

A campfire that warms whoever stands near it:

-- server
RegisterNetEvent('my-camp:nearFire', function(isNear)
    Player(source).state:set('nearHeat', isNear == true, true)
end)

A night storm event:

-- server
exports['en-weathersync']:SetWeather('THUNDER', 20)
if exports['en-weathersync']:IsNight() then
    exports['en-weathersync']:SetBlackout(true)
end

AddEventHandler('en-weathersync:server:weatherChanged', function(newName, previousName)
    if previousName == 'THUNDER' then
        exports['en-weathersync']:SetBlackout(false)
    end
end)

A cutscene at noon in clear weather for one player:

-- client
exports['en-weathersync']:SetOverride({ weather = 'EXTRASUNNY', hour = 12, minute = 0 })
-- ... scene ...
exports['en-weathersync']:ClearOverride()

#Related

• Survival system
• en-clothing
• en-zombies
• en-admin