Edit of asset "TCA_Weather_System" Accepted

Old/Current New/Edit
Title 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 - Complete Environment System

Version: 1.1.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.1.0 adds performance optimization, wind system, weather transition, and weather forecast on top of the production-grade water and sky shaders. All features are zero-texture, procedurally generated, and optimized for mobile devices.

中文
TCA Weather System 是 Godot 4.6+ 的完整环境系统，为你的游戏带来电影级天气效果。1.1.0 版本在原有生产级水体着色器基础上，新增性能优化、风场系统、天气平滑过渡和天气预报功能。所有功能零纹理、程序化生成，并针对移动设备优化。

---

What's New in v1.1.0

Performance Optimization System

Module Class Description
Performance Controller PerformanceController Auto-adjusts graphics quality based on FPS. 4 quality levels (Low/Medium/High/Ultra).
Quality Preset QualityPreset Save/load quality presets as .tres files for different devices.

Wind and Cloud System

Module Class Description
Wind Controller WindController Global wind system with gust, turbulence, and direction smoothing.
Cloud Driver CloudDriver Cloud movement driven by wind direction. Smooth cloud offset animation.

Weather Transition System

Module Class Description
Weather Transition WeatherTransition Smooth weather transitions with custom curves and callbacks.
Weather Forecast WeatherForecast Probability-based weather prediction with auto-change timer.

---

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 and 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 and 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.
· Performance Controller: Auto-adjust graphics quality based on FPS (New in v1.1.0)
· Weather Transition: Smooth weather transitions with custom curves (New in v1.1.0)
· Weather Forecast: Probability-based weather prediction (New in v1.1.0)

中文

· 风控制器：全局风系统，支持阵风、湍流
· 天气控制器：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.

中文

· 雨粒子：动态雨滴
· 雪粒子：动态雪花
· 雨滴涟漪：雨滴触发的水面涟漪

---

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")
env.set_weather("snow")
env.set_weather("clear")

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

# Control time
env.set_time(14.5)
env.auto_time = true
env.time_speed = 0.1

# Control season
env.set_season("autumn")
env.season_progress = 0.5

# Performance Control (New in v1.1.0)
var perf = $PerformanceController
perf.apply_quality(PerformanceController.Quality.LOW)
perf.auto_adjust = true

# Wind Control (New in v1.1.0)
var wind = $WindController
wind.set_wind(Vector2(1, 0), 8.0)
wind.add_affected_node($CloudDriver)

# Weather Forecast (New in v1.1.0)
var forecast = $WeatherForecast
forecast.auto_change = true
forecast.change_interval = 300.0
forecast.weather_changed.connect(func(from, to):
print("Weather changing from ", from, " to ", to)
)

# Weather Transition (New in v1.1.0)
var transition = $WeatherTransition
transition.start_transition("clear", "rain", 3.0)

# Get current state
print(env.get_weather_description())
print(env.get_wind_description())
print(env.get_current_time_string())

# 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)
```

---

Performance Tuning

Quality Levels

Setting Low Medium High Ultra
Wave Layers 1 2 3 3
Cloud Layers 1 2 3 3
God Rays Off On On On
Spectral Highlights Off Off On On
Particle Count 30% 60% 100% 100%
Shadow Quality Off Low Medium High
Anti-Aliasing Off FXAA FXAA MSAA 2x

Mobile Devices (Low Quality)

· 1-layer waves
· No god rays
· No spectral highlights
· 30% particle count

Desktop (Ultra Quality)

· 3-layer waves
· Full god rays
· Spectral highlights
· 100% particle count

---

File Structure

```
TCA_Weather_System/
├── materials/
│ ├── water_material.tres
│ └── water_material.tscn
├── nodes/
│ └── world_environment.tscn
├── particles/
│ ├── rain_particles.tscn
│ └── snow_particles.tscn
├── precipitation/
│ ├── heavy_rain.tres
│ ├── heavy_snow.tres
│ ├── rain.tres
│ └── snow.tres
├── presets/ # New in v1.1.0
│ ├── low_quality.tres
│ ├── medium_quality.tres
│ └── high_quality.tres
├── scripts/
│ ├── EnvironmentManager.gd
│ ├── PerformanceController.gd # New
│ ├── WindController.gd # New
│ ├── CloudDriver.gd # New
│ ├── WeatherTransition.gd # New
│ ├── WeatherForecast.gd # New
│ ├── QualityPreset.gd # New
│ ├── PrecipitationResource.gd
│ ├── SeasonResource.gd
│ ├── SkyColourResource.gd
│ ├── WeatherController.gd
│ ├── WeatherOccurrenceResource.gd
│ └── WeatherResource.gd
├── seasons/
│ ├── summer.tres
│ └── winter.tres
├── shaders/
│ ├── tca_water_shader.gdshader
│ └── weather_system_sky.gdshader
├── textures/
├── weather/
│ ├── clouded.tres
│ ├── fine.tres
│ ├── heavy_rain.tres
│ ├── heavy_snow.tres
│ ├── rain.tres
│ └── snow.tres
└── weather_controller.tscn
```

---

Changelog

Version 1.1.0

English

· Added Performance Controller with 4 quality levels and auto-adjust
· Added Wind Controller with gust, turbulence, and smoothing
· Added Cloud Driver for wind-driven cloud movement
· Added Weather Transition with custom curves and callbacks
· Added Weather Forecast with probability-based prediction
· Added Quality Preset resource system
· Added low/medium/high quality preset files
· Updated main scene with all new modules
· Performance optimized for mobile devices

中文

· 新增性能控制器，支持 4 级画质和自动调节
· 新增风场控制器，支持阵风、湍流和平滑过渡
· 新增云层驱动器，云层随风移动
· 新增天气过渡系统，支持自定义曲线
· 新增天气预报系统，基于概率预测天气
· 新增画质预设资源系统
· 新增低/中/高画质预设文件
· 更新主场景，集成所有新模块
· 移动端性能优化

Version 1.0.0

English

· Initial release
· 3-layer Gerstner wave system
· 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
· 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
· Mobile-optimized, zero external textures

中文

· 首次发布
· 3 层 Gerstner 波系统
· 4 层程序化法线生成
· 实时焦散
· 泡沫系统
· 光柱效果
· 光谱高光
· 水下效果
· 天空着色器
· 环境管理器
· 10+ 种天气预设
· 雨和雪粒子系统
· 移动端优化，零外部纹理

---

License

MIT License - Free for personal and commercial use.
Category Shaders
License MIT
Repository Provider GitHub
Repository Url https://github.com/kS222138/TCA_Weather_System/
Issues Url https://github.com/kS222138/TCA_Weather_System/issues
Godot version Godot 4.6
Version String 1.3.0 1.1.0
Download Commit 7a75bf7b77d93620f131943a484e7536bb25383e 589ffa6cea76b5798bdfaff26821f6100849ad1e
Download Url (Computed) https://github.com/kS222138/TCA_Weather_System/archive/7a75bf7b77d93620f131943a484e7536bb25383e.zip https://github.com/kS222138/TCA_Weather_System/archive/589ffa6cea76b5798bdfaff26821f6100849ad1e.zip
Icon Url https://raw.githubusercontent.com/kS222138/1/main/icon(1).png