Repo ↗ · Source README ↗ · Markdown & license bundle

Image reference (original game): Horizon Zero Dawn · original-game artwork, provided by IGDB. Image rights remain with their respective owners. This illustrates the referenced original game, not the actual visuals of this rewrite or mod.

Source maintainer: evroon · Revision: ad4422ff95c0 · Catalogued: 2026-10-12

Source license: MIT · LICENSE · Article: Source README (format adapted)

The source README follows, with formatting adapted for this site and images replaced by source links. Feature, completion and testing claims belong to its authors and have not been independently playtested here. The Traditional Chinese translation was prepared with AI assistance.


Bevy Volumetric Clouds

README link
README link
README link

README image:clouds

This is a plugin for Bevy that renders volumetric clouds
using the method of Horizon Zero Dawn by Guerilla Games (see credits).

Usage

Run cargo add bevy-volumetric-clouds and simply add CloudsPlugin to your Bevy App like this:

use bevy_volumetric_clouds::CloudsPlugin;

app.add_plugins(CloudsPlugin);

Look at the minimal example for a working example.

The the demo example features a usable demo where you can move the camera around
and use a UI to change the configuration of the cloud rendering
(if you run it with the fly_camera and debug features):

cargo run --example demo --features fly_camera,debug

The configuration of the clouds rendering can be changed using the CloudsConfig resource.
See its docs for more information.

Limitations

A few limitations apply for now and hopefully get fixed in the future:

  • There is no integration with Bevy’s internal atmosphere rendering yet, this plugin uses a simple
    sky rendering function.
  • The clouds are drawn on a skybox that does not take the depth buffer into account yet. Therefore,
    it’s not yet possible to “fly” into the clouds, the clouds are only visible from ground-level.
  • For now the clouds render resolution is set to 1920x1080 and can’t be changed.
    Usually clouds are rendered at a lower resolution than screen resolution so you likely won’t need
    a higher resolution anyway but changing the resolution should be possible in the future.

Crate features

There are a few features:

  • debug: enables an egui UI that allows you to tweak shader uniforms (parameters) in-game.
  • fly_camera: adds a fly_camera module that controls the camera using keyboard and mouse.

Bevy version compatibility

bevy bevy-volumetric-clouds
0.18 0.2.*
0.17 0.1.*

Credits

  1. “The real-time volumetric cloudscapes of Horizon Zero Dawn” by Andrew Schneider and Nathan Vos (article)
  2. “Physically Based Sky, Atmosphere and Cloud Rendering in Frostbite” by Sébastien Hillaire (pdf)

License

Licensed under MIT, see LICENSE.


License and provenance

The README and its translation retain MIT terms. Changes comprise translation, links and formatting. Editable Markdown, the original README, LICENSE and NOTICE files are included in the linked bundle. This grants no rights to the original games, their assets or trademarks.

LICENSE

MIT License

Copyright (c) 2025 evroon

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.