9 breaking releases
Uses new Rust 2024
new 0.10.0 | May 4, 2025 |
---|---|
0.8.0 | Dec 6, 2024 |
0.7.0 | Jul 10, 2024 |
0.6.0 | Feb 23, 2024 |
0.2.0 | Nov 15, 2022 |
#237 in Game dev
1,074 downloads per month
Used in 2 crates
320KB
458 lines
noisy_bevy
Simple stupid noise primitives for glam (Vec2
, Vec3
) and WGSL.
- Integrates with Bevy seamlessly
- Same results on the CPU and GPU (not bit-level perfect, though)
Features
simplex_noise_2d
simplex_noise_2d_seeded
simplex_noise_3d
simplex_noise_3d_seeded
fbm_simplex_2d
fbm_simplex_2d_seeded
fbm_simplex_3d
fbm_simplex_3d_seeded
worley_2d
Usage
From Rust
Zero initialization, just call the noise functions:
use bevy::prelude::*;
use noisy_bevy::simplex_noise_2d;
let p = Vec2::new(12.3, 45.6);
let value = simplex_noise_2d(p);
From WGSL shaders
First add the plugin to the Bevy app:
App::new()
.add_plugins(NoisyShaderPlugin)
Then use it in your shaders:
#import noisy_bevy::simplex_noise_2d
// ...
let p = vec2(12.3, 45.6);
let value = simplex_noise_2d(p);
See the asteroids example
, for an example that uses noise to procedurally generate a tilemap on the CPU and a matching background in a wgsl shader.
Bevy Version Support
The main
branch targets the latest bevy release.
bevy | noisy_bevy |
---|---|
0.16 | 0.9, 0.10, main |
0.15 | 0.8 |
0.14 | 0.7 |
0.13 | 0.6 |
0.12 | 0.5 |
0.11 | 0.4 |
0.10 | 0.3 |
0.9 | 0.2 |
0.8 | 0.1 |
License
MIT
The original simplex noise source is MIT-only, however all changes made by me or PRs to this repo are also available under Apache-2.0.
Acknowledgments
The noise primitives are ports/copies of these
- https://github.com/stegu/psrdnoise
- https://gist.github.com/munrocket/236ed5ba7e409b8bdf1ff6eca5dcdc39
- https://github.com/bevy-interstellar/wgsl_noise
Contributions
PRs welcome!
Dependencies
~40–71MB
~1M SLoC