← Plugins ยท HyWeather

Configuration

JSON-backed runtime config with auto-merge of missing sections.

Config Path

Top-Level Fields

FieldTypePurpose
FogProfilestringDefault fog profile: CLEAR, BALANCED, VANILLA.
DynamicWeatherEnabledboolGlobal dynamic cycle toggle.
SpecialEventsEnabledboolGlobal event bucket toggle.
WeatherCycleIntervalSecondsintCycle interval; clamped to 30-1800.
DefaultProfileIdstringFallback profile ID.
WorldRulesobjectLegacy world key to profile mapping support.
ZoneProfilesobjectPrimary per-zone behavior + visuals state.
WeatherProfilesobjectProfile templates and defaults.
WeatherVisualsobjectPer-weather visual defaults map.
SkyRampTuningobjectGlobal default tuning; merged if missing.

ZoneProfile Fields

FieldTypePurpose
AssignedProfileIdstringSelected profile for this zone.
WeatherProfileobjectIn-zone mutable copy of event chance + weight maps.
GlobalVisualSettingsobjectTheme enum per sky/cloud/sun/moon/fog.
CustomVisualPaletteobjectCustom hex palette for 8 channels.
TintOpacityPercentByChannelobjectPer-channel opacity percentages (0-100).
GradientChannelMaskobjectEnable/disable gradient channel contributions.
GradientPaletteobjectStart/end palette pairs for each channel.
SunlightBrightnessPercentintSunlight intensity percentage (0-200).
MoonlightBrightnessPercentintMoonlight intensity percentage (0-200).
SkyRampTuningobjectPer-zone sky ramp factor arrays and precipitation blend scalar.

Minimal Example

{
  "DefaultProfileId": "temperate",
  "ZoneProfiles": {
    "zone1": {
      "AssignedProfileId": "temperate",
      "DynamicWeatherEnabled": true,
      "SpecialEventsEnabled": true,
      "WeatherCycleIntervalSeconds": 240,
      "GlobalVisualSettings": {
        "SkyTheme": "CUSTOM",
        "CloudTheme": "CUSTOM",
        "SunTheme": "CUSTOM",
        "MoonTheme": "CUSTOM",
        "FogTheme": "CUSTOM"
      }
    }
  }
}

Auto-Merge Behavior

On load, missing config sections such as SkyRampTuning, TintOpacityPercentByChannel, and ZoneProfiles are automatically written back to disk.