> For the complete documentation index, see [llms.txt](https://docs.world-creator.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.world-creator.com/reference/terrain/biome/filters/effect/crater.md).

# Crater

## **Overview**

The Crater filter enables you to add either a single crater or several random craters to your landscape.

## **Parameters**

<table><thead><tr><th width="179.699951171875">Properties</th><th>Description</th></tr></thead><tbody><tr><td><strong>Single Crater</strong></td><td>This toggle allows you to prevent the scattering of multiple craters. If enabled, only one crater will be created.</td></tr><tr><td><strong>Offset X/Y</strong></td><td>Shifts all crater locations in the specified direction.</td></tr><tr><td><strong>Seed</strong></td><td>The seed of the randomized crater positions and parameters.</td></tr><tr><td><strong>Radius</strong></td><td>Controls the minimum and maximum limits for the randomized size of the craters.</td></tr><tr><td><strong>Edge Height</strong></td><td>Controls the minimum and maximum limits for the randomized edge height of the craters.</td></tr><tr><td><strong>Crater Depth</strong></td><td>Controls the minimum and maximum limits for the randomized crater depth of the craters.</td></tr><tr><td><strong>Width/Length Ratio</strong></td><td>Controls the minimum and maximum limits for the randomized aspect ratio of the craters, enabling the creation of stretched craters.</td></tr><tr><td><strong>Rotation Range</strong></td><td>Controls the minimum and maximum limits for the randomized rotation of the craters.</td></tr><tr><td><strong>Inner Size</strong></td><td>Controls the size of the crater itself.</td></tr><tr><td><strong>Outer Size</strong></td><td>Controls the size of the falloff of the crater walls.</td></tr><tr><td><strong>Crater Scale</strong></td><td>Scales all craters uniformly from the origin.</td></tr><tr><td><strong>Crater Probability</strong></td><td>Controls the density of craters the filter produces.</td></tr></tbody></table>

## **Results**

<div><figure><img src="https://2837684122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM6zsxw2jbMYEZbKqEwpa%2Fuploads%2FYzYNDaNZWgrdhCGTnHO8%2Freference_filters_effect_crater_01.webp?alt=media&amp;token=817b6c4b-d29d-4416-8ba5-271dd607d53a" alt=""><figcaption></figcaption></figure> <figure><img src="https://2837684122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM6zsxw2jbMYEZbKqEwpa%2Fuploads%2FT0MMyA0dF1ZNP5lj5Qbb%2Freference_filters_effect_crater_02.webp?alt=media&amp;token=9427f03f-2eeb-42ff-a581-6b9c65b51566" alt=""><figcaption></figcaption></figure></div>


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.world-creator.com/reference/terrain/biome/filters/effect/crater.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.