GroupeZ Docs
Effects

Hammer

Mine in a 3x3 (or larger) area

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

The HAMMER effect allows players to mine multiple blocks in a configurable area (like 3x3x1) with a single block break. The area is determined by the face of the block being mined.

Configuration

effects:
  - type: HAMMER
    # Required: Blocks that can be mined with hammer
    materials:
      - STONE
      - COBBLESTONE
      - GRANITE
    # OR use tags
    tags:
      - MINEABLE_PICKAXE

    # Required: Mining dimensions
    width: 3     # Horizontal size (must be odd)
    height: 3    # Vertical size (must be odd)
    depth: 1     # Depth (blocks forward)

    # Optional: Damage to apply to the tool
    # -1 = damage per block mined (default)
    damage: -1

    # Optional: Blacklist mode for materials/tags
    blacklisted: false

    # Optional: Restrict which items can have this effect
    applicable-materials:
      - DIAMOND_PICKAXE
      - NETHERITE_PICKAXE
    applicable-tags:
      - PICKAXES

Parameters

ParameterTypeRequiredDefaultDescription
materialsListYes*-Specific blocks that can be mined
tagsListYes*-Block tags that can be mined
widthIntegerYes-Horizontal width (odd number)
heightIntegerYes-Vertical height (odd number)
depthIntegerYes-Depth forward
damageIntegerNo-1Tool damage (-1 = per block)
blacklistedBooleanNofalseInvert material/tag filter
applicable-materialsListNo-Items that can have this effect
applicable-tagsListNo-Item tags that can have this effect
applicability-blacklistedBooleanNofalseInvert applicability filter

*Either materials or tags must be provided.

Area Calculation

The hammer effect mines blocks based on which face you're looking at:

Looking AtWidthHeightDepth
North/South faceLeft-RightUp-DownForward
East/West faceForward-BackUp-DownLeft-Right
Top/Bottom faceLeft-RightForward-BackUp-Down

For a 3x3x1 configuration:

  • width: 3 = 1 block left + center + 1 block right
  • height: 3 = 1 block up + center + 1 block down
  • depth: 1 = only the surface layer

Examples

Basic 3x3 Hammer

hammer_3x3:
  material: DIAMOND_PICKAXE
  display-name: "<gray>Mining Hammer</gray>"
  lore:
    - ""
    - "<gray>Mines in a 3x3 area!</gray>"
    - ""
    - "<yellow>Area: <white>3x3x1</white></yellow>"

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

  effects:
    - type: HAMMER
      tags:
        - MINEABLE_PICKAXE
      width: 3
      height: 3
      depth: 1
      damage: 1

5x5 Excavator

excavator_5x5:
  material: NETHERITE_PICKAXE
  display-name: "<gradient:#888888:#444444>Excavator</gradient>"
  lore:
    - ""
    - "<gray>Massive 5x5 mining area!</gray>"
    - ""
    - "<yellow>Area: <white>5x5x1</white></yellow>"
    - ""
    - "<red>Warning: High durability cost!</red>"

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

  effects:
    - type: HAMMER
      tags:
        - MINEABLE_PICKAXE
      width: 5
      height: 5
      depth: 1
      damage: -1  # Damage per block

  custom-model-data: 2001

Tunnel Bore (3x3x3)

tunnel_bore:
  material: NETHERITE_PICKAXE
  display-name: "<gradient:#ff6b6b:#feca57>Tunnel Bore</gradient>"
  lore:
    - ""
    - "<gray>Creates 3x3 tunnels!</gray>"
    - ""
    - "<yellow>Area: <white>3x3x3</white></yellow>"
    - "<gray>Mines 27 blocks at once</gray>"

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

  effects:
    - type: HAMMER
      tags:
        - MINEABLE_PICKAXE
      width: 3
      height: 3
      depth: 3
      damage: 5  # Fixed damage (less than 27)

  unbreakable: false
  max-damage: 10000

Shovel Excavator

shovel_excavator:
  material: NETHERITE_SHOVEL
  display-name: "<gradient:#daa520:#cd853f>Earth Mover</gradient>"
  lore:
    - ""
    - "<gray>Digs in a 3x3 area!</gray>"

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

  effects:
    - type: HAMMER
      tags:
        - MINEABLE_SHOVEL
      width: 3
      height: 3
      depth: 1
      damage: 1

Hammer with Auto-Smelt

smelting_hammer:
  material: NETHERITE_PICKAXE
  display-name: "<gradient:#ff4500:#ff8c00>Smelting Hammer</gradient>"
  lore:
    - ""
    - "<gray>3x3 mining with auto-smelt!</gray>"
    - ""
    - "<yellow>Features:</yellow>"
    - "<gray>- 3x3 Area Mining</gray>"
    - "<gray>- Auto Smelt</gray>"

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

  effects:
    - type: HAMMER
      tags:
        - MINEABLE_PICKAXE
      width: 3
      height: 3
      depth: 1
      damage: 1

    - type: MELT_MINING

Hammer Rune (Applicable Item)

hammer_rune:
  material: IRON_BLOCK
  display-name: "<gray>Hammer Rune</gray>"
  lore:
    - ""
    - "<gray>Apply to a pickaxe to add</gray>"
    - "<gray>3x3 mining capability.</gray>"

  effects:
    - type: HAMMER
      tags:
        - MINEABLE_PICKAXE
      width: 3
      height: 3
      depth: 1
      damage: 1

      applicable-tags:
        - PICKAXES

      representation:
        material: IRON_BLOCK
        display-name: "<gray>Hammer Rune</gray>"
        lore:
          - ""
          - "<gray>Use in a smithing table</gray>"

        applicator-type: SMITHING_TABLE
        template:
          item: NETHERITE_UPGRADE_SMITHING_TEMPLATE

Behavior

  1. When a player breaks a block:

    • The effect determines which face was hit
    • Calculates the mining area based on width/height/depth
    • Filters blocks by materials/tags configuration
    • Checks permissions for each block
    • Mines all valid blocks in the area
    • Applies tool damage based on configuration

  2. The effect respects:

    • WorldGuard regions
    • Other protection plugins
    • Fortune/Silk Touch enchantments
    • Custom block providers

Incompatibilities

HAMMER is incompatible with:

  • VEIN_MINING - Both effects modify block breaking behavior

If both are applied, only one will function.

Tips

  • Always use odd numbers for width and height for centered mining
  • Combine with MELT_MINING for auto-smelting
  • Combine with ABSORPTION to send items to inventory
  • Use damage: 1 for balanced durability (one damage regardless of blocks)
  • Use damage: -1 for realistic durability (damage per block)
  • Consider adding MENDING enchantment for sustainability

Vein Mining

Mine entire ore veins at once

Farming Hoe

Harvest, till, and plant crops in an area

Sur cette page

ConfigurationParametersArea CalculationExamplesBasic 3x3 Hammer5x5 ExcavatorTunnel Bore (3x3x3)Shovel ExcavatorHammer with Auto-SmeltHammer Rune (Applicable Item)BehaviorIncompatibilitiesTips
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.