2023-05-24 23:52:07 +08:00
# Nishita Sky With Volumetric Clouds
2023-07-01 05:47:28 +08:00
This is a Nishita sky shader for Godot 4.0, with [Clay John's volumetric clouds ](https://github.com/clayjohn/godot-volumetric-cloud-demo ) based on [a tutorial by scratch pixel ](https://www.scratchapixel.com/lessons/procedural-generation-virtual-worlds/simulating-sky/simulating-colors-of-the-sky.html ).
2023-07-01 05:38:17 +08:00
## Screenshots
2023-07-01 05:53:54 +08:00
|  |  |
| --- | --- |
| Day | Sunset |
|  |  |
| --- | --- |
| Cloudy Sky | Partial Eclipse |
|  |  |
| --- | --- |
| Full Eclipse | Blood Moon |
|  |  |
| --- | --- |
| Night Sky | Night Sky Without Clouds |
|  |  |
| --- | --- |
| Earth From Above | Earth From Above Sunset |
2023-05-24 23:52:07 +08:00
## Features
2023-07-01 05:38:17 +08:00
* Game-ready asset
2023-05-24 23:52:07 +08:00
* Raymarched sky
* Raymarched clouds that move with the camera
* Different times of day by rotating the "NishitaSky" node
* Realistic lighting at different altitudes
2023-07-01 05:38:17 +08:00
* A night sky, with Milky Way texture
2023-05-24 23:52:07 +08:00
* A directional light that takes on the color of the sun in the shader
* All elements interact with each other: the night sky is blocked by the clouds and attenuated by the atmosphere
* Ability to configure quality of the shader and turn the clouds on/off
2023-07-01 05:38:17 +08:00
* Moon
* Realistically lit moon influenced by the sun, resulting in different moon phases, including Earth blocking moon (new moon phase, and blood moon)
* Support for moon and ground textures, accurate textures included
2023-05-24 23:52:07 +08:00
* Performance optimizations
2023-07-01 05:38:17 +08:00
## Bonus Features
* Raising the camera high on the Y axis brings the moon closer
* Moving the camera on the XZ axis (very far) changes the sky and ground texture position
2023-05-24 23:52:07 +08:00
## Limitations
* Performance heavy, especially with clouds on
2023-07-01 05:38:17 +08:00
* The camera must remain below the clouds (but is clamped to cloud height if it goes higher), since the clouds do not actually exist
2023-05-24 23:52:07 +08:00
## Improvements
* For the sky precompute the optical depth between the sun and an arbitrary point along the ray (from Nishita's paper)
* Add multiple scattering to clouds and sky
2023-07-01 05:38:17 +08:00
* Physical raytraced clouds, with better lighting (currently the clouds are evenly lit)
2023-05-24 23:52:07 +08:00
* Better cloud density textures
* Use cloud sample distance for cloud fog (currently uses distance to clouds)
* Physically accurate ground material (currently the brightness is just a dot product to the sun)
2023-07-01 05:38:17 +08:00
* Better sun color saturation (currently some hacks are necessary to get the expected sun brightness and saturation)
2023-05-24 23:52:07 +08:00
## How to Use
To implement this sky into a project
2023-07-01 05:38:17 +08:00
1. Copy the "NishitaSky" node from the main scene into the project
2023-05-24 23:52:07 +08:00
2. In the "NishitaSky" node set "sun_object_path" variable to the desired directional light, do not make this directional light a child of the "NishitaSky" node
3. Create an "WorldEnvironment" node, set the sky material to the "nishita_sky" material
4. Click copy on the sky section of the "WorldEnvironment" node, and paste it into the "sky_material" section of the "NishitaSky" node. **THE MATERIALS MUST BE LINKED FOR THE SKY PARAMETERS TO BE THE SAME ON THE SCRIPT AND THE SHADER**
5. Set the correct "sun_ground_height" on the "NishitaSky" node, this is the height of objects on the ground
6. After adjusting all settings as needed click the "Compute Gradient Toggle" to precompute the sun color gradient
7. It may be necessary to reload the scene to make the sky work in the editor
8. If the sky is very slow try changing the process mode to "High-Quality Incremental" in the Sky settings in the WorldEnvironment
2023-07-01 06:09:14 +08:00
To understand what the shader settings do, read the comments in the `nishita_sky.gdshader` file.
The variables prefixed with `precomputed_` are set by the `NishitaSky.gd` script, they cannot be modified.
2023-05-24 23:52:07 +08:00
## Todo
* Fix clouds "jumping" after some time
2023-07-01 05:38:17 +08:00
* Clean up code
2023-05-24 23:52:07 +08:00
* Rework sun saturation
* Set WorldEnvironment fog color based on sky color
2023-07-01 05:38:17 +08:00
* Make stars move with the sun
* Position sun, stars, and moon using a real world date/time
## Images
2023-07-01 06:12:25 +08:00
* Moon albedo was rendered from [NASA ](https://svs.gsfc.nasa.gov/cgi-bin/details.cgi?aid=4720 )
2023-07-01 05:38:17 +08:00
* Night sky HDRI was underexposed and compressed to webp from [NASA ](https://svs.gsfc.nasa.gov/4851#media_group_5169 )
2023-07-01 06:12:25 +08:00
* Earth image was color corrected and compressed to webp from [NASA ](https://visibleearth.nasa.gov/images/74142/september-blue-marble-next-generation/74159l )
