# Grass Generation

## Introduction

`generators.json` contains a list of 'Generator' which generates grass in the world periodically.

## Grammar

{% code title="generators.json" %}

```
[
  biome_and_generator,
  biome_and_generator,
  ...
]
```

{% endcode %}

{% code title="biome\_and\_generator " %}

```
{
  "types" : [biome_type, ...],
  "generator" : generator
}
|
{
  "biome" : string,
  "generator" : generator
}
|
{
  "generator" : generator
}
```

{% endcode %}

{% code title="biome\_type " %}

```
"HOT" |
"COLD" |
"SPARSE" |
"DENSE" |
"WET" |
"DRY" |
"SAVANNA" |
"CONIFEROUS" |
"JUNGLE" |
"SPOOKY" |
"DEAD" |
"LUSH" |
"NETHER" |
"END" |
"MUSHROOM" |
"MAGICAL" |
"RARE" |
"OCEAN" |
"RIVER" |
"WATER" |
"MESA" |
"FOREST" |
"PLAINS" |
"MOUNTAIN" |
"HILLS" |
"SWAMP" |
"SANDY" |
"SNOWY" |
"WASTELAND" |
"BEACH" |
"VOID"
```

{% endcode %}

{% code title="generator " %}

```
{
  "condition" : condition,
  "grass" : block_state | [block_state, ...]
}
```

{% endcode %}

{% code title="condition " %}

```
{
  "below" : block_state | [block_state, ...],
  "chance" : double,
  "not_adjacent" : block_state | [block_state, ...]
}
```

{% endcode %}

{% hint style="info" %}
For *block state*, follow this page
{% endhint %}

## Usage

There are 3 variants of biome\_and\_generator. First variant which has `"types"` field, applies corresponding generator to every biome wihch has all `"types"`. Second variant which has `"biome"` field, applies corresponding generator to the `"biome"` only. Last one applies the generator to every biome without any other generator. In other words, this is a default generator.

generator has two fields `"condition"` and `"grass"`. When `"condition"` meets, generates `"grass"`. `"grass"` can be a single block\_state or a list of block\_states. When `"grass"` is given as a list, one block\_state is randomly selected and generated.

condition has three fields, and each field can be ommited. Each field represents a condition, and every field must be satisfied. Ommited field is simply considered satisfied. `"below"` is met when block below target position is one of listed block\_state.`"chance"` is met purely by chance. `"1.0"` means always, `"0.0"`means never. Using this field you can specify speed or frequency of grass growth. `"not_adjacent"` is met when there's no block\_state listed nearby target position (8 blocks).

## Examples

```
{
    "biome" : "minecraft:jungle",
    "generator" : {
        "condition" : {
            "below" : {"name" : "minecraft:grass"},
            "chance" : 0.25,
            "not_adjacent" : {
                "name": "minecraft:tallgrass",
                "type": "fern"
            }
        },
        "grass" : {
            "name": "minecraft:tallgrass",
            "type": "fern"
        }
    }
}
```

Grass grows rapidly in jungle.

```
{
    "biome" : "minecraft:plains",
    "generator" : {
        "condition" : {
            "below" : {"name" : "minecraft:grass"},
            "chance" : 0.1,
            "not_adjacent" : {"name": "minecraft:yellow_flower"}
        },
        "grass" : {
            "name": "minecraft:yellow_flower",
            "type": "dandelion"
        }
    }
}
```

Dandelion is growing in plains.

```
{
    "types" : ["COLD", "MOUNTAIN"],
    "generator" : {
        "condition" : {
            "below" : {"name" : "minecraft:grass"},
            "chance" : 0.05,
            "not_adjacent" : {"name": "minecraft:tallgrass"}
        },
        "grass" : {
            "name": "minecraft:tallgrass",
            "type": "fern"
        }
    }
}
```

Grass grows very slowly in every "COLD" "MOUNTAIN".


---

# Agent Instructions: 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:

```
GET https://a3626a.gitbook.io/hungryanimals/5.4/basics/grass-generation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.