https://github.com/theemptynessproject/forgenoise
The best noise library!
https://github.com/theemptynessproject/forgenoise
library node node-library nodejs noise noise-generator noise-library
Last synced: about 2 months ago
JSON representation
The best noise library!
- Host: GitHub
- URL: https://github.com/theemptynessproject/forgenoise
- Owner: TheEmptynessProject
- License: mit
- Created: 2025-02-08T13:52:08.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-10T18:19:32.000Z (about 1 year ago)
- Last Synced: 2026-02-07T20:42:57.850Z (3 months ago)
- Topics: library, node, node-library, nodejs, noise, noise-generator, noise-library
- Language: JavaScript
- Homepage: https://theemptynessproject.github.io/repos/ForgeNoise/index.html
- Size: 408 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# ForgeNoise 🔥🗣
[](https://opensource.org/licenses/MIT)
A high-performance JavaScript library for procedural noise generation, featuring multiple algorithms and fractal patterns. Perfect for games, visualizations, and creative coding projects.
## Examples
## Features
- 🌪 Multiple noise algorithms: Perlin, Simplex, Worley, and Voronoi
- 🌀 Fractal noise generation (fBm, Ridged Multifractal)
- 🌐 Domain warping and turbulence effects
- 🧮 Seamless tiling patterns
- ⚡ Web-optimized performance
- 🌈 Customizable parameters for all noise types
- 🔢 Seedable randomness
## Installation
### CDN
```html
```
### Local
```html
```
## Quick Start
```javascript
// Initialize generator
const noise = new ForgeNoise(seedNumber);
// Generate basic Perlin noise
const perlinValue = noise.generate2D(x, y);
// Create fractal noise
const fbmValue = noise.generateFractal2D(x, y, {
octaves: 6,
lacunarity: 2.0,
persistence: 0.5
});
// Generate Worley cellular pattern
const worleyValue = noise.generateWorley2D01(x, y);
// Create domain-warped noise
const warped = noise.warp2D(x, y, {
warpStrength: 2,
warpScale: 1.5
});
```
## API Highlights
### Core Methods
- `new ForgeNoise([seed])` - Create new noise generator
- `generate2D(x, y)` - Classic Perlin noise (range: [-1, 1])
- `generateSimplex2D(x, y)` - Simplex noise implementation
- `generateWorley2D(x, y)` - Cellular/Worley noise
### Advanced Features
- `generateFractal2D()` - Fractional Brownian Motion
- `warp2D()` - Domain distortion effects
- `generateTiling2D()` - Seamless tiling patterns
- `generateVoronoi2D()` - Voronoi diagram generation
### Utility Methods
- `generate*01()` versions - Output mapped to [0, 1] range
- `setSeed(seed)` - Update generator seed
- `configure()` - Global noise parameters
## Examples
### Basic Perlin Noise
```javascript
const value = noise.generate2D01(x/20, y/20);
```
### Turbulent Terrain
```javascript
const height = noise.generateFractal2D(x/50, y/50, {
octaves: 8,
persistence: 0.65,
turbulence: true
});
```
### Cellular Texturing
```javascript
const pattern = noise.generateWorley2D01(x/15, y/15) *
noise.generateSimplex2D01(x/30, y/30);
```
## Documentation
- [Interactive Examples](https://theemptynessproject.github.io/repos/ForgeNoise/examples.html)
- [API Reference](https://theemptynessproject.github.io/repos/ForgeNoise/api.html)
- [Benchmarks](https://theemptynessproject.github.io/repos/ForgeNoise/benchmark.html)
## Contributing
Contributions are welcome! Please read our
[Contribution Guidelines](CONTRIBUTING.md) before submitting PRs.
## License
[MIT](LICENSE) © [TheEmptynessProject]