Edit of asset "TCA_Weather_System" Accepted

Old/Current New/Edit
Title TCA_Weather_System TCA_Weather_System
Description TCA Weather System v1.3.0 — 动态生态 + 高级水体

TCA Weather System v1.3.0 — Dynamic Ecosystem + Advanced Water

---

What's New in v1.3.0 / 1.3.0 新特性

Advanced Water Interaction System / 高级水体交互系统

English 中文
Dynamic Ripples 动态涟漪 — 玩家/物体行走时产生实时水面波纹
Object Buoyancy 物体浮力 — 漂浮物体带真实物理浮力效果
Wake Trails 尾迹拖痕 — 移动物体留下 V 形尾迹
Water Splash Particles 水花粒子 — 基于冲击力产生不同大小的水花
Shoreline Waves 岸边浪涌 — 动态波浪拍打岸边
Underwater Caustics Projection 水下焦散投射 — 焦散投射到水下物体表面

Dynamic Ecosystem / 动态生态系统

English 中文
Seasonal Foliage Color 季节植被变色 — 树叶/草地颜色随季节色调变化
Wind-Strength Foliage Response 风力植被响应 — 强风时草木弯曲幅度更大
Rain Puddle Formation 雨水水坑形成 — 雨天在地形上动态形成水坑
Snow Accumulation 积雪堆积 — 雪逐渐在表面累积
Terrain Decal System 地面贴花系统 — 雨/雪/落叶等地面细节贴花
Fog Density by Altitude 海拔雾密度 — 体积雾随地形高度变化

Player Environment Interaction / 玩家环境交互

English 中文
Footstep Effects 足迹效果 — 根据地形/天气产生不同音效和粒子
Camera Wetness 镜头水雾 — 雨天镜头上的水滴效果(可选)
Breath Vapor 呼吸白雾 — 寒冷天气镜头前的呼吸雾气
Dynamic Shadow Softness 动态阴影柔化 — 阴天/雨天阴影更柔和

Performance & Mobile Enhancements / 性能与移动端优化

English 中文
LOD System for All Effects 全效果 LOD 系统 — 基于距离的效果降级
Effect Budget System 效果预算系统 — 限制每帧活跃效果总数
Batched Particle Rendering 合批粒子渲染 — 减少雨/雪粒子绘制调用
Low-Quality Mode for Intermediates 中低质量模式 — Low 和 Medium 之间新增一档

---

New Modules in v1.3.0 / 1.3.0 新增模块

```
TCA_Weather_System/
├── scripts/
│ ├── WaterInteraction.gd # 水体交互(浮力、涟漪、尾迹)
│ ├── EcosystemManager.gd # 生态管理(季节变色、植被响应)
│ ├── GroundDecalSystem.gd # 地面贴花(水坑、积雪、落叶)
│ ├── PlayerEnvironment.gd # 玩家环境(足迹、镜头效果)
│ ├── EffectBudget.gd # 效果预算(性能控制)
│ └── LODManager.gd # LOD 管理(距离降级)
├── particles/
│ ├── splash_particle.tscn # 水花粒子
│ ├── footstep_rain.tscn # 雨足迹水花
│ └── breath_vapor.tscn # 呼吸白雾
└── decals/
└── puddle_decal.tscn # 水坑贴花
```

---

Quick Start / 快速上手

```gdscript
# Water Interaction / 水体交互
var water = $WaterInteraction
water.enable_buoyancy = true
water.add_buoyant_object($Boat, 1.2)

# Ecosystem / 生态系统
var eco = $EcosystemManager
eco.seasonal_foliage = true
eco.wind_response_strength = 1.5

# Player Environment / 玩家环境
var player_env = $PlayerEnvironment
player_env.footstep_effects = true
player_env.camera_wetness = true

# Performance / 性能
var budget = $EffectBudget
budget.max_effects_per_frame = 20
budget.target_fps = 60
```

---

Performance Tuning / 性能调优(1.3.0 更新)

Setting Low Medium High Ultra
Water Ripples Off Simple Full Full
Buoyancy Off Off Simple Full
Wake Trails Off Off Simple Full
Underwater Caustics Off Off On On
Seasonal Foliage Off On On On
Rain Puddles Off Low Full Full
Snow Accumulation Off Off Simple Full
Ground Decals Off Low Full Full
Breath Vapor Off Off On On
Camera Wetness Off Off On On

---

Changelog / 更新日志

Version 1.3.0

English 中文
Added Advanced Water Interaction System 新增高级水体交互系统
Added Dynamic Ecosystem System 新增动态生态系统
Added Player Environment Interaction 新增玩家环境交互
Added Effect Budget System 新增效果预算系统
Added LOD System for all effects 新增全效果 LOD 系统
Optimized particle batching for mobile 优化移动端粒子合批
Added low-quality mode for intermediates 新增中低质量模式
Bug fixes and stability improvements 修复 Bug 并提升稳定性

---

总结 / Summary

English 中文
TCA Weather System v1.3.0 transforms your environment from "beautiful" to "alive" TCA Weather System v1.3.0 让你的环境从「好看」升级到「生动」
Water responds to players and objects 水体会对玩家和物体产生真实反应
Ecosystems change with seasons and weather 生态系统随季节和天气变化
Every interaction leaves a trace 每一次交互都会留下痕迹
All while maintaining mobile-friendly performance 同时保持移动端友好的性能
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
Category Shaders Shaders
License MIT MIT
Repository Provider GitHub GitHub
Repository Url https://github.com/kS222138/TCA_Weather_System/ https://github.com/kS222138/TCA_Weather_System/
Issues Url https://github.com/kS222138/TCA_Weather_System/issues https://github.com/kS222138/TCA_Weather_System/issues
Godot version Godot 4.6 Godot 4.6
Version String 1.3.0 1.0.0
Download Commit 7a75bf7b77d93620f131943a484e7536bb25383e 2a820d58388946d370a6b3c52428a2fe2250d192
Download Url (Computed) https://github.com/kS222138/TCA_Weather_System/archive/7a75bf7b77d93620f131943a484e7536bb25383e.zip https://github.com/kS222138/TCA_Weather_System/archive/2a820d58388946d370a6b3c52428a2fe2250d192.zip
Icon Url https://raw.githubusercontent.com/kS222138/1/main/icon(1).png
https://raw.githubusercontent.com/kS222138/1/main/icon(1).png