> For the complete documentation index, see [llms.txt](https://docs.mantic.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mantic.dev/mantichoes/config-files/custom-crops.yml.md).

# custom-crops.yml

Custom crops turn extra blocks into harvestable crops. The file is generated at `plugins/ManticHoes/custom-crops.yml`. The feature and every example entry are **disabled by default** — turn on the feature, then each crop you want.

| Field                 | Purpose                                                                                            |
| --------------------- | -------------------------------------------------------------------------------------------------- |
| `enabled` (top level) | Turns all custom crops on or off. Default `false`.                                                 |
| `prevent-coral-death` | Keeps living coral alive outside water. Default `false`, and works even when custom crops are off. |
| `crops`               | List of crop entries.                                                                              |

Each entry accepts:

| Field               | Purpose                                                                                                            |
| ------------------- | ------------------------------------------------------------------------------------------------------------------ |
| `enabled`           | Turns this crop on. Default `false`.                                                                               |
| `block`             | The block a player harvests.                                                                                       |
| `harvested-block`   | What remains afterwards; use `AIR` to leave nothing.                                                               |
| `drop-material`     | The item the player receives. Harvest enchantments can increase the amount.                                        |
| `sell-price`        | Optional price per item for Autosell. `0` falls back to the existing material or shop price.                       |
| `required-prestige` | Optional minimum prestige. `0` allows everyone.                                                                    |
| `regrow-ticks`      | Time before the original block returns. Default `100` ticks (five seconds); `0` keeps the replacement permanently. |

```yaml
enabled: true
prevent-coral-death: false
crops:
  - enabled: true
    block: TUBE_CORAL_BLOCK
    harvested-block: DEAD_TUBE_CORAL_BLOCK
    drop-material: TUBE_CORAL_BLOCK
    sell-price: 0.0
    required-prestige: 0
    regrow-ticks: 100
```

Custom crops harvest instantly with a single left-click of a supported hoe, without holding the mouse button. Normal protection, reward and regrowth checks still apply. Their harvests add to the shared `CUSTOM` crop total.

To allow them on a specific hoe, add `CUSTOM` (all enabled custom crops) or the source material itself, such as `TUBE_CORAL_BLOCK`, to that hoe's `supported-blocks`. Entries with invalid materials or numbers are skipped with a console message. Changing or breaking the replacement cancels its pending regrowth, and pending crops return early on chunk unload, reload or shutdown.

See Custom crops for the worked coral, mushroom and dandelion examples.
