GroupeZ Docs
Effects

Farming Hoe

Harvest, till, and plant crops in an area

Cette page est affichée en anglais car sa traduction française n’est pas encore disponible.

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

Sur cette 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

La documentation dans ton IA

Le MCP permet à ton IA de chercher dans la documentation GroupeZ et de lire les exemples à jour pour t’aider à configurer tes plugins.

Lecture seule · Sans clé API côté documentation

1. Copie l’adresse du serveur

Transport : HTTP (Streamable HTTP). Authentification : aucune. Ton outil utilise son propre modèle et ses propres limites d’abonnement.

  1. Ouvre Plugins dans ChatGPT sur le web, puis + → Ajouter un serveur MCP personnalisé.
  2. Nomme-le « GroupeZ Documentation », colle l’URL ci-dessus et choisis « Aucune authentification ». Crée puis installe le plugin.
  3. Dans une conversation, tape @ et sélectionne ce plugin avant d’envoyer ta question. Si nécessaire, active search, get_page et list_pages dans ses paramètres.
Guide officiel de cet outil

3. Pose une question

Utilise le MCP GroupeZ pour m’aider à créer un inventaire zMenu. Recherche les pages pertinentes, lis les exemples et cite tes sources.
Autres clients et dépannage

Pour les clients utilisant mcpServers, adapte cet exemple à leur format :

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

Les outils disponibles sont search, get_page et list_pages. Après une mise à jour, actualise les outils du connecteur. Si ton IA n’y accède pas, vérifie que le connecteur est activé dans la conversation et que ton compte autorise les MCP personnalisés. Ouvrir l’URL dans un navigateur n’est pas un test MCP.