Retro Weather

Zone Editor Mode

Zone Editor mode is used by admins to draw and update region polygons directly on the map UI.

Typical Actions

• Draw/edit per-zone polygon borders.
• Save one zone or save all zones.
• Normalize borders after edits.
• Use map marker/debug helpers for alignment.

Normalize Borders

• If two zone borders are close but leave a small gap, normalization fills/smooths that gap.
• This makes neighboring zones meet cleanly instead of leaving tiny empty seams.
• Use it after manual drawing passes so zone edges touch consistently.

Related Admin Events

Event	Purpose
rs-weather:adminSetZonePolygon	Set single zone polygon
rs-weather:adminSetAllZonePolygons	Set all zone polygons
rs-weather:adminNormalizeBorders	Normalize zone borders

Forecast Overlay Mode

Forecast Overlay mode is used to visualize active/moving fronts and upcoming weather across zones.

• Shows queue/front progression between regions.
• Reflects movement mode and active target values from server state.
• Useful for planning weather transitions and live operations.

Weather Movement Mode

Setting	Description
Config.WeatherMovementModeDefault	Default mode (default: forecast_locked)
Config.WeatherMovementAllowRuntimeToggle	Allow runtime toggling

Behavior

• forecast_locked keeps a planned forecast/front queue shape.
• If runtime toggling is disabled, admin movement mode changes are rejected.

Time Mode

There are only two time behaviors admins need to know:

Realtime OFF

When Config.TimeRealtime = false:

• rs_weather runs game time itself.
• Admin time controls work:
  • Set time
  • Freeze/unfreeze
  • Change time scale
• Base values come from:
  • Config.TimeStartHour
  • Config.TimeStartMinute
  • Config.TimeScale
  • Config.TimeFrozen

Realtime ON

When Config.TimeRealtime = true:

• rs_weather follows real-world clock time from your timezone.
• Admin set/freeze/scale controls are intentionally ignored.
• Required settings:
  • Config.TimeRealtimeZone (IANA timezone, example America/Los_Angeles)
  • Config.TimeRealtimeUpdateSec (how often realtime is refreshed)
• If the timezone is invalid, realtime is disabled for that runtime.

UI Map Skin Modes

Supported skins:

Skin	Description
atlas	Atlas-style map
satellite	Satellite imagery
road	Road map style

Map skin is persisted in KVP and can be changed from admin UI.