> 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/custom-crops.md).

# Custom crops

ManticHoes can turn extra blocks into harvestable crops. Edit `plugins/ManticHoes/custom-crops.yml` or use `/mantichoes editor` and open **Custom Crops**.

The feature and every example are disabled by default. Set enabled: true at the top and inside each crop entry you want to use. Five coral block types turn into their dead versions. Red mushrooms, brown mushrooms and dandelions leave air when harvested. When enabled, these examples regrow after 100 ticks (five seconds).

Custom crops harvest instantly with a single left-click of a supported Mantic hoe. You do not need to hold the mouse button or finish mining the block. Normal break protection, rewards and regrowth checks still apply.

Normal crops keep their existing settings. Servers from 1.8 through 26.3 can use this feature; each server skips materials it does not have. Coral needs Minecraft 1.13 or newer. Dandelion also works with the old YELLOW\_FLOWER material name.

## Coral example

```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
```

Keep the other generated entries to use the other examples too. Add another entry to make another block harvestable. Use block material names that exist on your server. Each source block needs its own entry.

| Setting                 | What it does                                                                                                   |
| ----------------------- | -------------------------------------------------------------------------------------------------------------- |
| enabled at the top      | Turns all custom crops on or off.                                                                              |
| enabled inside an entry | Turns that crop on or off.                                                                                     |
| block                   | The block players harvest with their Mantic hoe.                                                               |
| harvested-block         | What remains after harvesting. Use a different block or AIR.                                                   |
| drop-material           | The item players receive. Normal harvest enchantments can increase its amount.                                 |
| sell-price              | Optional price per item for Autosell. Default 0 uses the existing material/shop price.                         |
| required-prestige       | Optional minimum prestige. Default 0 allows everyone.                                                          |
| regrow-ticks            | Optional time before the original block returns. Default 100 ticks. Set 0 to keep the replacement permanently. |

Entries with invalid material or numeric settings are skipped with a message in the server log. Turning an entry off makes that material behave like an ordinary block again.

## Keep coral alive outside water

Set `prevent-coral-death: true` in custom-crops.yml to stop natural coral death outside water. It covers living coral blocks, plants, fans and wall fans. The setting defaults to false and works even when custom crops are disabled.

Custom harvesting still changes coral into its configured harvested-block, including dead coral. This setting affects natural coral death only.

## Allow crops on a hoe

Use `supported-blocks: [ALL]` to allow every crop. For a restricted hoe, add `CUSTOM` to allow all enabled custom crops, or add individual source materials such as `TUBE_CORAL_BLOCK` or `RED_MUSHROOM`.

Custom crops use normal hoe ownership, allowed-world, protection, placement cooldown and reward checks. Set their individual prestige requirements in custom-crops.yml. Their harvest counts contribute to the shared CUSTOM crop count.

## Drops and prices

Custom crops give their configured item through the normal pickup/drop system. Autosell uses sell-price when it is positive, otherwise the existing material/shop price. An unpriced custom crop item stays as an item when Autosell is on.

In the crop-price menu, `{tube_coral_block_sell}` shows that coral entry's sell price. Replace tube\_coral\_block with another configured source name.

## Regrowth

A harvested custom crop uses its own regrowth setting, independently of the normal AutoGrow timer and auto-replant switch. The original block state is restored, including its orientation and water settings where applicable.

Changing or breaking the replacement cancels its pending regrowth. Pending crops return early when their chunk unloads, or when ManticHoes reloads or shuts down. This keeps a reload from leaving temporary harvested blocks behind.

Use `/mantichoes reload` after editing the file.
