TCA_Weather_System 1.0.0 Shaders 4.6 Community

Submitted by user ks222; MIT; 2026-03-26

TCA Weather System

Version: 1.0.0
Godot Version: 4.6+
Author: 222
License: MIT

---

Overview

English
TCA Weather System is a complete environment system for Godot 4.6+ that brings cinematic weather effects to your game. Version 1.0.0 features a production-grade water shader with 3-layer Gerstner waves, dynamic normals, caustics, foam system, god rays, spectral highlights, and underwater effects. The system includes a comprehensive environment manager with wind control, weather presets, season transitions, day/night cycle, and fully integrated particle systems. All features are zero-texture, procedurally generated, and optimized for mobile devices.

中文
TCA Weather System 是 Godot 4.6+ 的完整环境系统，为你的游戏带来电影级天气效果。1.0.0 版本包含生产级水体着色器，支持 3 层 Gerstner 波、动态法线、焦散、泡沫系统、光柱、光谱高光和水下效果。系统包含完整的环境管理器，支持风控、天气预设、季节过渡、日夜循环和完整集成的粒子系统。所有功能零纹理、程序化生成，并针对移动设备优化。

---

Features

Water Rendering System

English

· Gerstner Waves: 3-layer physical waves with crest curling and steepness control. Realistic ocean motion.
· Dynamic Normals: 4-layer procedural normals + wave normals blending. Zero texture dependencies.
· Caustics: Real-time procedural caustics with sun direction rotation. Projects onto underwater geometry.
· Foam System: Crest foam + breaking foam + shoreline foam with smoothstep threshold blending.
· God Rays: Volumetric light shafts with dynamic density and decay. Surface + underwater rendering.
· Spectral Highlights: Rainbow-colored dispersion. Realistic light refraction simulation.
· Underwater Effects: Fog + distortion + caustics + god rays with flow direction animation.
· Reflection: Screen Space Reflection + Fresnel effect + adjustable blur.
· Rain Ripples: Procedural raindrop ripples with density control.

中文

· Gerstner 波：3 层物理波浪，支持波峰卷曲和陡峭度控制，真实的海洋运动
· 动态法线：4 层程序化法线 + 波浪法线混合，零纹理依赖
· 焦散：实时程序化焦散，随太阳方向旋转，投射到水下几何体
· 泡沫系统：波峰泡沫 + 破碎泡沫 + 岸边泡沫，平滑阈值混合
· 光柱：体积光柱，动态密度和衰减，水面 + 水下双重渲染
· 光谱高光：彩虹色色散，真实的光折射模拟
· 水下效果：雾效 + 扭曲 + 焦散 + 光柱，带流动方向动画
· 反射：屏幕空间反射 + 菲涅尔效应 + 可调节模糊
· 雨滴涟漪：程序化雨滴效果，密度可调

Sky & Atmosphere System

English

· Atmospheric Scattering: Rayleigh + Mie scattering. Realistic sunset and sunrise colors.
· Cloud System: 3-layer dynamic clouds with wind movement and depth effect.
· Stars & Moon: Procedural stars with twinkling, moon with glow and spherical mapping.
· Weather Integration: Rain/snow/fog intensity affects sky color and cloud cover.

中文

· 大气散射：瑞利散射 + 米氏散射，真实的日出日落色彩
· 云层系统：3 层动态云层，支持风向移动和深度效果
· 星星与月亮：程序化星星带闪烁效果，月亮带光晕和球面映射
· 天气集成：雨/雪/雾强度影响天空颜色和云层覆盖

Environment Management System

English

· Wind Controller: Global wind system with gust, turbulence, and direction control.
· Weather Controller: Rain/snow/fog intensity control with 10+ weather presets.
· Season Controller: Summer/autumn/winter/spring transition with color tint.
· Time Controller: Day/night cycle with sun angle, color, and intensity.
· Reflection System: Automatic cubemap update for realistic water reflections.

中文

· 风控制器：全局风系统，支持阵风、湍流和风向控制
· 天气控制器：雨/雪/雾强度控制，10+ 种天气预设
· 季节控制器：春/夏/秋/冬四季过渡，带色调变化
· 时间控制器：日夜循环，太阳角度、颜色、强度动态变化
· 反射系统：自动更新 Cubemap，实现真实水面反射

Particle Systems

English

· Rain Particles: Dynamic rain with adjustable intensity and spread.
· Snow Particles: Dynamic snow with fluttering effect.
· Rain Ripples: Water surface ripples triggered by raindrops.

中文

· 雨粒子：动态雨滴，强度与扩散可调
· 雪粒子：动态雪花，飘落效果
· 雨滴涟漪：雨滴触发的水面涟漪

Resource System

English

· Weather Resource: Define custom weather types with color, intensity, and duration.
· Season Resource: Define seasonal color tints and effects.
· Sky Color Resource: Preset sky color configurations for different times.
· Precipitation Resource: Rain/snow particle settings for different intensities.

中文

· 天气资源：自定义天气类型，包含颜色、强度和持续时间
· 季节资源：定义季节色调和效果
· 天空颜色资源：不同时间的天空颜色预设配置
· 降水资源：不同强度的雨/雪粒子设置

---

Weather Presets

Weather Rain Snow Fog Cloud Description
clear 0 0 0 0.1 Sunny, clear sky
light_rain 0.3 0 0.2 0.6 Light drizzle
rain 0.7 0 0.3 0.8 Moderate rain
heavy_rain 1.0 0 0.5 0.95 Heavy downpour
light_snow 0 0.4 0.2 0.7 Light snowfall
snow 0 0.7 0.4 0.85 Moderate snowfall
heavy_snow 0 1.0 0.6 0.95 Heavy blizzard
fog 0 0 0.9 0.5 Dense fog
storm 0.9 0 0.4 0.98 Thunderstorm
clouded 0 0 0.2 0.8 Overcast

---

Installation

English

1. Download from GitHub Releases or Godot Asset Library
2. Copy the addons/TCA_Weather_System folder to your project's addons/ directory
3. Open Godot Editor → Project → Project Settings → Plugins
4. Enable "TCA Weather System"
5. Restart the editor

中文

1. 从 GitHub Releases 或 Godot Asset Library 下载
2. 将 addons/TCA_Weather_System 文件夹复制到项目的 addons/ 目录
3. 打开 Godot 编辑器 → 项目 → 项目设置 → 插件
4. 启用 "TCA Weather System"
5. 重启编辑器

---

Quick Start

```gdscript
# Add weather system to your scene
# Simply drag weather_controller.tscn into your scene

# Get environment manager reference
var env = $EnvironmentManager

# Control weather
env.set_weather("rain") # clear / rain / heavy_rain / snow / heavy_snow / fog / storm
env.set_weather("snow")
env.set_weather("clear")

# Control wind
env.set_wind(Vector2(1, 0), 0.6) # direction, strength

# Control time
env.set_time(14.5) # 2:30 PM
env.auto_time = true # Automatic day/night cycle
env.time_speed = 0.1 # 10x real time

# Control season
env.set_season("autumn") # summer / autumn / winter / spring
env.season_progress = 0.5 # Mid season

# Get current state
print(env.get_weather_description()) # "Heavy Rain"
print(env.get_wind_description()) # "Strong Breeze"
print(env.get_current_time_string()) # "14:30"
print(env.get_season_description()) # "Mid autumn"

# Listen to events
func _ready():
env.weather_changed.connect(_on_weather_changed)
env.time_changed.connect(_on_time_changed)

func _on_weather_changed(type, rain, snow, fog):
print("Weather changed to: ", type)

func _on_time_changed(time, hour, minute):
print("Time: ", hour, ":", minute)
```

---

Water Shader Parameters

Parameter Default Range Description
Wave System
spd1 1.2 0-5 Layer 1 wave speed
str1 0.28 0-1 Layer 1 amplitude
len1 14.0 5-25 Layer 1 wavelength
stp1 0.42 0-0.8 Layer 1 steepness (crest curl)
spd2 1.8 0-5 Layer 2 wave speed
str2 0.18 0-1 Layer 2 amplitude
len2 8.5 5-25 Layer 2 wavelength
stp2 0.28 0-0.8 Layer 2 steepness
spd3 2.6 0-5 Layer 3 wave speed
str3 0.10 0-1 Layer 3 amplitude
len3 5.5 5-25 Layer 3 wavelength
stp3 0.16 0-0.8 Layer 3 steepness
wind_effect 0.6 0-1 Wind influence on waves
wind_dir (1,0.3) - Wind direction vector
Visual
water_deep (0.01,0.04,0.10) RGB Deep ocean color
water_shallow (0.12,0.45,0.68) RGB Shallow/tropical color
transparency 0.92 0-1 Water transparency
smoothness 0.99 0-1 Surface smoothness (1 = mirror)
metallic 0.96 0-1 Metallic reflection
norm_scale 1.4 0-3 Normal map intensity
Foam
foam_int 0.7 0-2 Foam intensity
foam_thresh 0.52 0-1 Crest foam sensitivity
foam_break 0.6 0-1 Breaking foam intensity
shore_foam 0.9 0-2 Shoreline foam intensity
shore_dist 1.5 0-5 Shoreline foam distance
Caustics
caustic_int 0.9 0-2 Caustic intensity
caustic_scale 6.0 1-15 Caustic texture scale
Effects
ripple_int 0.0 0-1 Rain ripple intensity
godray_int 0.6 0-2 God ray brightness
godray_decay 1.6 0.5-5 God ray decay rate
under_fog 0.6 0-1 Underwater fog density
under_warp 0.045 0-0.2 Underwater distortion
spectral 0.35 0-1 Spectral highlight strength

---

Sky Shader Parameters

Parameter Default Description
Colors
sky_top_color (0.02,0.05,0.12) Top sky color
sky_mid_color (0.15,0.25,0.45) Middle sky color
sky_horizon_color (0.55,0.65,0.85) Horizon color
ground_bottom_color (0.02,0.03,0.05) Bottom ground color
ground_horizon_color (0.35,0.45,0.55) Horizon ground color
Sun
sun_glow_intensity 1.2 Sun glow strength
sun_disk_size 2.0 Sun disk size
sun_glow_size 32.0 Sun glow size
sunset_color (1.0,0.35,0.15) Sunset color
Clouds
small_cloud_cover 0.5 Small cloud density
large_cloud_cover 0.4 Large cloud density
cloud_speed 0.0008 Cloud movement speed
cloud_lighting 0.8 Cloud brightness
Stars & Moon
stars_enabled true Enable stars
star_density 45.0 Star density
moon_enabled true Enable moon
moon_size 0.055 Moon size
moon_glow 0.45 Moon glow intensity

---

File Structure

```
TCA_Weather_System/
├── materials/
│ ├── water_material.tres # Water material configuration
│ └── water_material.tscn # Water material scene
├── nodes/
│ └── world_environment.tscn # WorldEnvironment with sky
├── particles/
│ ├── rain_particles.tscn # Rain particle system
│ └── snow_particles.tscn # Snow particle system
├── precipitation/
│ ├── heavy_rain.tres # Heavy rain preset
│ ├── heavy_snow.tres # Heavy snow preset
│ ├── rain.tres # Light rain preset
│ └── snow.tres # Light snow preset
├── scripts/
│ ├── EnvironmentManager.gd # Main environment controller
│ ├── PrecipitationResource.gd # Precipitation data class
│ ├── SeasonResource.gd # Season data class
│ ├── SkyColourResource.gd # Sky color data class
│ ├── WeatherController.gd # Weather state machine
│ ├── WeatherOccurrenceResource.gd # Weather event data class
│ └── WeatherResource.gd # Weather type data class
├── seasons/
│ ├── summer.tres # Summer color preset
│ └── winter.tres # Winter color preset
├── shaders/
│ ├── der_water_shader.gdshader # Cinematic water shader (108 lines)
│ └── weather_system_sky.gdshader # Atmospheric sky shader
├── textures/ # Optional texture assets
├── weather/
│ ├── clouded.tres # Cloudy weather preset
│ ├── fine.tres # Clear weather preset
│ ├── heavy_rain.tres # Heavy rain preset
│ ├── heavy_snow.tres # Heavy snow preset
│ ├── rain.tres # Light rain preset
│ └── snow.tres # Light snow preset
└── weather_controller.tscn # Pre-configured weather scene
```

---

Performance

Metric Rating Notes
Water Shader 108 lines Zero external textures
Draw Calls Minimal Single material for water
Mobile Ready Optimized for ARM Mali/Adreno
Memory Usage ~2MB No texture memory
GPU Cost Medium 4-8ms on mid-range devices

---

Changelog

Version 1.0.0

English

· Initial release
· 3-layer Gerstner wave system with crest curling
· 4-layer procedural normal generation
· Real-time caustics with sun direction rotation
· Foam system with crest, breaking, and shoreline foam
· God rays with surface and underwater rendering
· Spectral highlights for rainbow dispersion
· Underwater effects with fog, distortion, caustics, and god rays
· Sky shader with atmospheric scattering and 3-layer clouds
· Environment manager with wind, weather, season, and time control
· 10+ weather presets
· Rain and snow particle systems
· Resource system for custom weather, season, and sky colors
· Mobile-optimized with LOD controls
· Zero external textures, fully procedural

中文

· 首次发布
· 3 层 Gerstner 波系统，支持波峰卷曲
· 4 层程序化法线生成
· 实时焦散，随太阳方向旋转
· 泡沫系统，支持波峰、破碎和岸边泡沫
· 光柱效果，水面和水下双重渲染
· 光谱高光，彩虹色色散
· 水下效果，包含雾效、扭曲、焦散和光柱
· 天空着色器，支持大气散射和 3 层云层
· 环境管理器，支持风控、天气、季节和时间控制
· 10+ 种天气预设
· 雨和雪粒子系统
· 资源系统，支持自定义天气、季节和天空颜色
· 移动端优化，LOD 控制
· 零外部纹理，完全程序化生成

---

License

MIT License - Free for personal and commercial use