> ## Documentation Index
> Fetch the complete documentation index at: https://items.lodemc.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Crops that grow on farmland and are picked when ripe

> Make crops with flora: seeds that grow stage by stage on farmland like wheat, take bone meal, pop off when trampled, and are picked with a right-click.

A crop is a [flora](https://items.lodemc.net/flora.md) entry with a `crop:` section. Players plant its seed on farmland, it grows by itself one stage at a time, and they pick it when it's ripe, just like wheat.

```yaml items/flora/tomato/tomato.yml theme={null}
tomato_seeds:
  type: flora
  name: "<#E8D9B0>Tomato Seeds"
  texture: tomato_seeds.png       # the seed's icon
  crop:
    stages: [tomato_stage0.png, tomato_stage1.png, tomato_stage2.png, tomato_stage3.png]
    drops:                        # when ripe; before that it drops its seed
      - tomato 2..4
      - tomato_seeds 0..2

tomato:
  name: "<#E05A3A>Tomato"
  texture: tomato.png
  food:
    nutrition: 3
    saturation: 1.8
```

This is the tomato that Lode Items installs on first start, in `items/flora/tomato/`. Run `/lodeitems give tomato_seeds` and plant them on farmland.

The entry's id is the **seed**: its item plants the crop, and the crop drops it back while it's still growing. The produce (`tomato` above) is a normal [item](https://items.lodemc.net/items.md).

## What a crop does

Crops behave like vanilla wheat:

* **They grow by themselves**, one stage at a time, at wheat's speed by default. Wet farmland under and around a crop speeds it up, and crops planted in rows grow faster than ones packed in a square. Below `min-light` they don't grow at all.
* **Bone meal** grows a crop 2 to 5 stages for an 8-stage crop like wheat, fewer for crops with fewer stages, and always at least one. Dispensers with bone meal work too.
* **They pop off with their drops** when they can't stay: the farmland under them is trampled or turns back into dirt, the block under them is broken, water flows into them or a piston pushes them.
* **Farmland under a crop doesn't turn back into dirt** when it dries out, the same as under wheat.
* **Right-click a ripe crop to pick it.** Its drops pop out and it starts again from the first stage. If the drops include its seed, one seed fewer drops, because that one goes back in the ground. Breaking it works too.
* They break instantly, you walk through them, and they sound like wheat when planted and broken.

Planting fires a normal block place and picking is a right-click on a block, so protection plugins apply to both.

## Options

**crop** `section` *required*

| Key | Default | Does |
| - | - | - |
| `stages` | required | 2 to 16 looks, from just planted to ripe. A `.png` is drawn like a vanilla crop (see `style`), a `.json` is used as the stage's model, and a `namespace:path` is read as a texture. |
| `style` | `crop` | How a `.png` stage is drawn: `crop` (four planes in a `#`, like wheat) or `cross` (an X, like flowers and saplings). |
| `speed` | `1` | How fast it grows. `1` is wheat's speed, `2` twice as fast, `0.5` half. |
| `min-light` | `9` | The light it needs to grow, `0` to `15`. Vanilla crops need 9. |
| `on` | farmland | Blocks or `#tags` it can be planted on and stays on: `[farmland]`, `[dirt, "#minecraft:sand"]`. |
| `bone-meal` | `true` | Whether bone meal grows it. |
| `harvest` | `true` | Whether right-clicking a ripe crop picks it. |
| `drops` | its seed | What a ripe crop drops, one entry per line as `item [amount] [chance]`: `tomato 2..4`, `tomato_seeds 1 0.5`. A bare name means a Lode Items item first, then a vanilla one. Growing crops always drop their seed. |

The rest of the entry sets up the seed item and the plant as a block:

* `texture` is the seed's icon. Without it, the ripe stage's picture is used, so a crop whose stages are all models needs a `texture`.
* `name`, `lore` and every other [item option](https://items.lodemc.net/items.md) apply to the seed.
* `sounds` and `tags` work as for [blocks](https://items.lodemc.net/blocks/mining-and-drops.md), and [events](https://items.lodemc.net/events.md) like `interact` and `break` work on the planted crop.

Each stage uses a walk-through block slot and look, so the number of crops is limited. See [How many crops and saplings](https://items.lodemc.net/flora.md#how-many-crops-and-saplings).

> [!NOTE]
>
> Props used to grow with `grows:`. Growing is now crop behaviour: make the stages one `type: flora` entry with a `crop:` section. A prop that still has `grows:` loads with a warning and doesn't grow.

## Not yet supported

* Fortune doesn't add to crop drops.
* The [`harvest` item option](https://items.lodemc.net/item-mechanics#harvesting) (a hoe that harvests around it) only harvests vanilla crops. Pick Lode Items crops by right-clicking them.
* Crops don't appear in newly generated worlds.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.