GroupeZ Docs
Effects

Infinite Bucket

Unlimited water and lava placement

The INFINITE_BUCKET effect allows water and lava buckets to be used infinitely without consuming the liquid.

Configuration

effects:
  - type: INFINITE_BUCKET
    # No additional configuration required

    # Optional: Restrict which items can have this effect
    applicable-materials:
      - WATER_BUCKET
      - LAVA_BUCKET
    applicability-blacklisted: false

Parameters

ParameterTypeRequiredDefaultDescription
applicable-materialsListNo-Items that can have this effect
applicable-tagsListNo-Item tags
applicability-blacklistedBooleanNofalseInvert applicability

Supported Buckets

BucketSupported
Water BucketYes
Lava BucketYes
Milk BucketNo
Powder Snow BucketNo

Milk and Powder Snow buckets are excluded because they have special behaviors that don't work well with infinite use.

Events

The effect handles:

  • PlayerBucketEmptyEvent - Placing liquids
  • PlayerBucketFillEvent - Picking up liquids

Behavior

  1. Placing liquid:

    • Liquid is placed normally
    • Bucket is NOT converted to empty bucket
    • Can be placed repeatedly without refilling

  2. Picking up liquid:

    • Liquid is removed from the world
    • Bucket remains as-is (not duplicated)

Examples

Infinite Water Bucket

infinite_water:
  material: WATER_BUCKET
  display-name: "<gradient:#00bfff:#1e90ff>Endless Spring</gradient>"
  lore:
    - ""
    - "<gray>An infinite source of water!</gray>"
    - ""
    - "<aqua>Never runs dry</aqua>"

  effects:
    - type: INFINITE_BUCKET

  # Prevent stacking issues
  max-stack-size: 1

Infinite Lava Bucket

infinite_lava:
  material: LAVA_BUCKET
  display-name: "<gradient:#ff4500:#ff8c00>Eternal Flame</gradient>"
  lore:
    - ""
    - "<gray>An infinite source of lava!</gray>"
    - ""
    - "<red>Burns eternally</red>"

  effects:
    - type: INFINITE_BUCKET

  max-stack-size: 1

Premium Infinite Bucket

premium_bucket:
  material: WATER_BUCKET
  display-name: "<gradient:#ffd700:#ffaa00>Divine Waters</gradient>"
  lore:
    - ""
    - "<gray>Blessed by the gods,</gray>"
    - "<gray>this bucket never empties.</gray>"
    - ""
    - "<yellow>VIP Item</yellow>"

  effects:
    - type: INFINITE_BUCKET

  max-stack-size: 1
  custom-model-data: 5001

  recipe:
    type: SHAPED
    pattern:
      - "DED"
      - "DWD"
      - "DDD"
    ingredients:
      - item: DIAMOND
        sign: D
      - item: EMERALD
        sign: E
      - item: WATER_BUCKET
        sign: W

Builder's Toolkit

builders_water:
  material: WATER_BUCKET
  display-name: "<aqua>Builder's Water</aqua>"
  lore:
    - ""
    - "<gray>Perfect for construction!</gray>"
    - "<gray>Infinite water placement.</gray>"

  effects:
    - type: INFINITE_BUCKET

  max-stack-size: 1

builders_lava:
  material: LAVA_BUCKET
  display-name: "<red>Builder's Lava</red>"
  lore:
    - ""
    - "<gray>For controlled demolition!</gray>"
    - "<gray>Infinite lava placement.</gray>"

  effects:
    - type: INFINITE_BUCKET

  max-stack-size: 1

Use Cases

  1. Building: Infinite water for large builds, farms, elevators
  2. Farming: Water source for crop irrigation
  3. Obsidian Farming: Infinite lava for obsidian generation
  4. Decorations: Water features, lava decorations
  5. Cobblestone Generators: Infinite lava supply

Tips

  • Always set max-stack-size: 1 to prevent stacking issues
  • Consider making this a rare/expensive item
  • Works well with building-focused servers
  • Great for skyblock/oneblock gamemodes
  • Can be restricted via permissions for balance

Absorption

Send dropped items directly to inventory

Unbreakable

Make items indestructible

On this page

ConfigurationParametersSupported BucketsEventsBehaviorExamplesInfinite Water BucketInfinite Lava BucketPremium Infinite BucketBuilder's ToolkitUse CasesTips
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.