> For the complete documentation index, see [llms.txt](https://ezedits.gitbook.io/ezedits/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ezedits.gitbook.io/ezedits/commands/noisegen.md).

# Noisegen

All sub-commands are under `//eznoisegen` (`//noisegen`, `//ng`)\
e.g `//ng heightmap`

## `//eznoisegen ...`

### heightmap

<details>

<summary>Heightmap (2D)</summary>

**`//eznoisegen heightmap <palette> <noise> [height] [-z <zoom>] [-s <seed>] [-o <offset>] [-m <mask>] [-cty]`**

* **Palette**: Specifies the palette of blocks to use.
* **Noise**: Defines the noise preset to use.
* **Height** (Default: 0): Controls the height from the bottom of your selection. A value of 0 will take the selection's height. *Can place blocks above the selection if the height is great enough*
* **-z** (Default: 1): Adjusts the zoom level of the noise.
* **-s** (Default: -1): Sets the noise seed.
* **-o** (Default: (0,0,0)): Offsets the noise generation coordinates by a given vector (X,Y,Z).
* **-m**: Only generate above blocks matching this mask. Falloff settings treat masked blocks as the edge.
* **-c**: When used, centres the noise generation on the world coordinates of the selection.
* **-t**: Enables smooth mode, specifically for snow, water, and lava blocks in the palette. *\[Applicable only in heightmap mode]*
* **-y**: Forces use of 3D noise. Impacted by Offset parameter. *\[Applicable only in heightmap mode]*

</details>

### terrain

<details>

<summary>Terrain (3D)</summary>

**`//eznoisegen terrain <palette> <noise> [height] [strength] [-z <scale>] [-s <seed>] [-l <smear>] [-o <offset>] [-c]`**

* **Palette**: Specifies the palette of blocks to use.
* **Noise**: Defines the noise preset to use.
* **Height** (Default: 0): Controls the height from the bottom of your selection. A value of 0 will take the selection's height. *Can place blocks above the selection if the height is great enough*
* **Strength** (Default: 1,0.5,0): Takes up to 3 comma-separated values which controls the strength of noise at various heights:
  * *`0.5` would be 50% strength everywhere*
  * *`0.7,0` would be 70% strength at the very bottom and 0% at the top, with everything in-between being a smooth transition*
  * *`0,1,0` would be 0% strength at the bottom, 100% in the middle, and 0% at the top*
* **-z** (Default: 1): Adjusts the zoom level of the noise.
* **-s** (Default: -1): Sets the noise seed.
* **-l** (Default: 0): Applies a vertical smear to 3D noise.
* **-o** (Default: (0,0,0)): Offsets the noise generation coordinates by a given vector (X,Y,Z).
* **-c**: When used, centres the noise generation on the world coordinates of the selection.

</details>

### advanced

<details>

<summary>Advanced</summary>

**`//eznoisegen <palette> <noise> [lowerThreshold] [upperThreshold] [-z <scale>] [-s <seed>] [-l <smear>] [-o <offset>] [-m <mask>] [-chnty]`**

* **Palette**: Specifies the palette of blocks to use.
* **Noise**: Defines the noise preset to use.
* **Lower Threshold** (Default: 0): Sets the lower threshold for noise generation, with support for WorldEdit expressions (range: 0-1.0).
* **Upper Threshold** (Default: 0.5): Sets the upper threshold for noise generation, with support for WorldEdit expressions (range: 0-1.0).
* **-z** (Default: 1): Adjusts the zoom level of the noise.
* **-s** (Default: -1): Sets the noise seed.
* **-l** (Default: 0): Applies a vertical smear to 3D noise.
* **-o** (Default: (0,0,0)): Offsets the noise generation coordinates by a given vector (X,Y,Z).
* **-m**: Only generate above blocks matching this mask. Falloff settings treat masked blocks as the edge.
* **-c**: When used, centres the noise generation on the world coordinates of the selection.
* **-h**: Activates heightmap mode using 2D noise. *Heightmap mode is only compatible with Cuboid, Cylinder, or Polygon region types*
* **-n**: Uses normalized (-1 to 1) selection-centred coordinates for noise generation.
* **-t**: Enables smooth mode, specifically for snow, water, and lava blocks in the palette. *\[Applicable only in heightmap mode]*
* **-y**: Forces use of 3D noise. Impacted by Offset parameter. *\[Applicable only in heightmap mode]*

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://ezedits.gitbook.io/ezedits/commands/noisegen.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
