GroupeZ Docs
Effects

Farming Hoe

Harvest, till, and plant crops in an area

The FARMING_HOE effect allows players to harvest mature crops, till soil, and plant seeds in a configurable area.

Configuration

effects:
  - type: FARMING_HOE
    # Required: Area size (must be odd number)
    size: 5

    # Optional: Auto-replant harvested crops
    auto-replant: true

    # Optional: Where drops appear
    drop-location: BLOCK  # BLOCK, CENTER, or PLAYER

    # Optional: Send drops to inventory
    drop-in-inventory: false

    # Optional: Enable harvesting
    harvest: true

    # Optional: Enable seed planting
    plant-seeds: true

    # Optional: Items to exclude from drops
    drop-blacklist:
      - WHEAT_SEEDS  # Don't drop seeds

    # Optional: Restrict which crops can be harvested
    allowed-crops:
      - WHEAT
      - CARROTS
      - POTATOES
      - BEETROOTS

    # Optional: Restrict which seeds can be planted
    allowed-seeds:
      - WHEAT_SEEDS
      - CARROT
      - POTATO
      - BEETROOT_SEEDS

    # Optional: Damage per harvest operation
    harvest-damage: 1

    # Optional: Damage per tilling operation
    till-damage: 1

    # Optional: Restrict which items can have this effect
    applicable-materials:
      - DIAMOND_HOE
      - NETHERITE_HOE
    applicable-tags:
      - HOES

Parameters

ParameterTypeRequiredDefaultDescription
sizeIntegerYes-Area size (must be odd)
auto-replantBooleanNotrueAuto-replant after harvest
drop-locationEnumNoBLOCKWhere drops appear
drop-in-inventoryBooleanNofalseSend to inventory
harvestBooleanNotrueEnable harvesting
plant-seedsBooleanNotrueEnable planting
drop-blacklistListNo-Items to not drop
allowed-cropsListNoAllCrops that can be harvested
allowed-seedsListNoAllSeeds that can be planted
harvest-damageIntegerNo1Damage per harvest
till-damageIntegerNo1Damage per till
applicable-materialsListNo-Items that can have this effect
applicable-tagsListNo-Item tags
applicability-blacklistedBooleanNofalseInvert applicability

Drop Locations

LocationDescription
BLOCKDrops appear at each harvested block
CENTERDrops appear at the center block
PLAYERDrops appear at player's location

Supported Crops

CropSeedFarmland
WHEATWHEAT_SEEDSFarmland
CARROTSCARROTFarmland
POTATOESPOTATOFarmland
BEETROOTSBEETROOT_SEEDSFarmland
PUMPKIN_STEMPUMPKIN_SEEDSFarmland
MELON_STEMMELON_SEEDSFarmland
NETHER_WARTNETHER_WARTSoul Sand

Functionality

Harvesting (Left-Click / Break)

  • Triggers when breaking a mature crop
  • Harvests all mature crops in the area
  • Auto-replants if enabled
  • Drops can go to ground or inventory

Tilling (Right-Click)

  • Triggers when right-clicking dirt/grass
  • Converts soil to farmland in the area
  • Works on: Dirt, Grass, Podzol, Mycelium, Rooted Dirt, Dirt Path

Planting (Right-Click on Farmland)

  • Triggers when right-clicking farmland/soul sand
  • Plants seeds from player's inventory
  • Plants in the entire area

Examples

Basic Farming Hoe

farming_hoe:
  material: DIAMOND_HOE
  display-name: "<green>Farmer's Hoe</green>"
  lore:
    - ""
    - "<gray>Harvest and plant in a</gray>"
    - "<gray>3x3 area!</gray>"

  enchantments:
    - enchantment: EFFICIENCY
      level: 5
    - enchantment: UNBREAKING
      level: 3

  effects:
    - type: FARMING_HOE
      size: 3
      auto-replant: true
      harvest: true
      plant-seeds: true

Advanced 5x5 Farming Hoe

advanced_farming_hoe:
  material: NETHERITE_HOE
  display-name: "<gradient:#7cfc00:#228b22>Master Farmer</gradient>"
  lore:
    - ""
    - "<gray>The ultimate farming tool!</gray>"
    - ""
    - "<yellow>Features:</yellow>"
    - "<gray>- 5x5 Area</gray>"
    - "<gray>- Auto Replant</gray>"
    - "<gray>- Direct to Inventory</gray>"
    - ""
    - "<gold>Crops: <white>All</white></gold>"

  enchantments:
    - enchantment: EFFICIENCY
      level: 5
    - enchantment: FORTUNE
      level: 3
    - enchantment: UNBREAKING
      level: 3
    - enchantment: MENDING
      level: 1

  effects:
    - type: FARMING_HOE
      size: 5
      auto-replant: true
      drop-in-inventory: true
      drop-location: PLAYER
      harvest: true
      plant-seeds: true
      harvest-damage: 1
      till-damage: 1

Wheat-Only Harvester

wheat_harvester:
  material: GOLDEN_HOE
  display-name: "<yellow>Wheat Harvester</yellow>"
  lore:
    - ""
    - "<gray>Specialized for wheat farming</gray>"
    - "<gray>No seed drops!</gray>"

  enchantments:
    - enchantment: FORTUNE
      level: 3

  effects:
    - type: FARMING_HOE
      size: 5
      auto-replant: true
      harvest: true
      plant-seeds: false
      allowed-crops:
        - WHEAT
      drop-blacklist:
        - WHEAT_SEEDS

Nether Wart Harvester

nether_wart_harvester:
  material: NETHERITE_HOE
  display-name: "<dark_red>Nether Harvester</dark_red>"
  lore:
    - ""
    - "<gray>Harvest nether warts</gray>"
    - "<gray>in a 5x5 area!</gray>"

  effects:
    - type: FARMING_HOE
      size: 5
      auto-replant: true
      allowed-crops:
        - NETHER_WART
      allowed-seeds:
        - NETHER_WART
      drop-in-inventory: true

Auto-Sell Farming Hoe

sell_farming_hoe:
  material: NETHERITE_HOE
  display-name: "<gradient:#ffd700:#ffaa00>Profit Farmer</gradient>"
  lore:
    - ""
    - "<gray>Harvest and auto-sell!</gray>"
    - ""
    - "<yellow>Features:</yellow>"
    - "<gray>- 5x5 Area</gray>"
    - "<gray>- Auto Replant</gray>"
    - "<gray>- Auto Sell (1.5x)</gray>"

  enchantments:
    - enchantment: FORTUNE
      level: 3
    - enchantment: UNBREAKING
      level: 3

  effects:
    - type: FARMING_HOE
      size: 5
      auto-replant: true
      harvest: true
      drop-blacklist:
        - WHEAT_SEEDS
        - BEETROOT_SEEDS

    - type: AUTO_SELL
      multiplier: 1.5

Full Configuration Example

ultimate_farmer:
  material: NETHERITE_HOE
  display-name: "<gradient:#00ff00:#00aa00>Ultimate Farmer</gradient>"
  lore:
    - ""
    - "<gray>The most advanced farming tool!</gray>"
    - ""
    - "<yellow>Area: <white>7x7</white></yellow>"
    - ""
    - "<yellow>Features:</yellow>"
    - "<gray>- Harvest all crops</gray>"
    - "<gray>- Auto replant</gray>"
    - "<gray>- Till soil</gray>"
    - "<gray>- Plant seeds</gray>"
    - "<gray>- Items to inventory</gray>"

  enchantments:
    - enchantment: EFFICIENCY
      level: 10
    - enchantment: FORTUNE
      level: 5
    - enchantment: UNBREAKING
      level: 5
    - enchantment: MENDING
      level: 1

  effects:
    - type: FARMING_HOE
      size: 7
      auto-replant: true
      drop-location: PLAYER
      drop-in-inventory: true
      harvest: true
      plant-seeds: true
      drop-blacklist:
        - WHEAT_SEEDS
        - BEETROOT_SEEDS
        - PUMPKIN_SEEDS
        - MELON_SEEDS
      harvest-damage: 1
      till-damage: 1

  unbreakable: false
  max-damage: 5000

Behavior

  1. Harvesting:

    • Only harvests fully grown crops
    • Respects Fortune enchantment for bonus drops
    • Auto-replants set crop age to 0
    • Drop blacklist filters unwanted items

  2. Tilling:

    • Converts compatible blocks to farmland
    • Respects protection plugins

  3. Planting:

    • Uses seeds from player's inventory
    • Matches seed type to soil (farmland vs soul sand)
    • Consumes seeds from inventory

Tips

  • Use odd numbers for size (3, 5, 7, etc.)
  • Enable drop-in-inventory for large farms
  • Add drop-blacklist for seeds you don't want
  • Combine with AUTO_SELL for profit farming
  • Use FORTUNE enchantment for more drops
  • Consider MENDING for long farming sessions

Hammer

Mine in a 3x3 (or larger) area

Auto Sell

Automatically sell drops from mining and killing

On this page

ConfigurationParametersDrop LocationsSupported CropsFunctionalityHarvesting (Left-Click / Break)Tilling (Right-Click)Planting (Right-Click on Farmland)ExamplesBasic Farming HoeAdvanced 5x5 Farming HoeWheat-Only HarvesterNether Wart HarvesterAuto-Sell Farming HoeFull Configuration ExampleBehaviorTips
GroupeZ MCP

Documentation in your AI

MCP lets your AI search GroupeZ documentation and read current examples to help you configure your plugins.

Read-only · No documentation API key needed

1. Copy the server URL

Transport: HTTP (Streamable HTTP). Authentication: none. Your tool uses its own model and subscription limits.

  1. Open Plugins in ChatGPT on the web, then + → Add custom MCP server.
  2. Name it ‘GroupeZ Documentation’, paste the URL above and choose ‘No authentication’. Create and install the plugin.
  3. In a conversation, type @ and select the plugin before asking. If needed, enable search, get_page and list_pages in its settings.
Official setup guide

3. Ask a question

Use GroupeZ MCP to help me create a zMenu inventory. Search relevant pages, read the examples and cite your sources.
Other clients and troubleshooting

For clients using mcpServers, adapt this example to their format:

{
  "mcpServers": {
    "groupez-docs": {
      "url": ""
    }
  }
}

Available tools are search, get_page and list_pages. Refresh the connector’s tools after updates. If your AI cannot access them, check that the connector is enabled in the conversation and your account allows custom MCP servers. Opening the URL in a browser is not an MCP test.