GroupeZ Docs

Absorption

Send dropped items directly to inventory

The ABSORPTION effect sends all dropped items directly to the player's inventory instead of dropping them on the ground.

Configuration

effects:
  - type: ABSORPTION
    # No additional configuration required

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

Parameters

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

Events

The absorption effect triggers on:

  • BlockBreakEvent - Mining blocks
  • BlockDropItemEvent - Block drops
  • EntityDropItemEvent - Entity drops (mob kills)

Behavior

  1. When items would drop:

    • Items are added to the player's inventory
    • Items that don't fit drop normally
    • Works with Fortune, Looting, etc.
  2. Overflow handling:

    • If inventory is full, items drop at the player's location
    • Partial stacks are split (what fits goes to inventory)

Examples

Basic Absorption Pickaxe

magnet_pickaxe:
  material: DIAMOND_PICKAXE
  display-name: "<gradient:#ff69b4:#da70d6>Magnet Pick</gradient>"
  lore:
    - ""
    - "<gray>Items go directly to</gray>"
    - "<gray>your inventory!</gray>"

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

  effects:
    - type: ABSORPTION

Combined with Vein Mining

vein_magnet:
  material: NETHERITE_PICKAXE
  display-name: "<gradient:#00ff00:#00aaff>Vein Magnet</gradient>"
  lore:
    - ""
    - "<gray>Mine veins directly to inventory!</gray>"
    - ""
    - "<yellow>Features:</yellow>"
    - "<gray>- Vein Mining (32 blocks)</gray>"
    - "<gray>- Items to Inventory</gray>"

  enchantments:
    - enchantment: EFFICIENCY
      level: 10
    - enchantment: FORTUNE
      level: 5

  effects:
    - type: VEIN_MINING
      tags:
        - MINEABLE_PICKAXE
      block-limit: 32

    - type: ABSORPTION

Absorption Sword (Mob Drops)

looter_sword:
  material: NETHERITE_SWORD
  display-name: "<gradient:#ffd700:#ff8c00>Looter's Blade</gradient>"
  lore:
    - ""
    - "<gray>Mob drops go to inventory!</gray>"
    - ""
    - "<yellow>Looting: <white>V</white></yellow>"

  enchantments:
    - enchantment: SHARPNESS
      level: 5
    - enchantment: LOOTING
      level: 5
    - enchantment: UNBREAKING
      level: 3

  effects:
    - type: ABSORPTION

Absorption Rune

absorption_rune:
  material: ENDER_PEARL
  display-name: "<light_purple>Absorption Rune</light_purple>"
  lore:
    - ""
    - "<gray>Apply to any tool to send</gray>"
    - "<gray>drops to your inventory.</gray>"

  effects:
    - type: ABSORPTION

      applicable-tags:
        - PICKAXES
        - SHOVELS
        - AXES
        - HOES
        - SWORDS

      representation:
        material: ENDER_PEARL
        display-name: "<light_purple>Absorption Rune</light_purple>"
        lore:
          - ""
          - "<gray>Use in a smithing table</gray>"

        applicator-type: SMITHING_TABLE
        template:
          item: NETHERITE_UPGRADE_SMITHING_TEMPLATE

Incompatibilities

ABSORPTION is incompatible with:

  • AUTO_SELL - Both effects process drops differently

If both are applied, only one will function.

Processing Order

Block Break / Entity Death
    ↓
VEIN_MINING / HAMMER (collect blocks)
    ↓
MELT_MINING (smelt drops)
    ↓
ABSORPTION (items to inventory) ← Priority: -1

The absorption effect has priority -1, meaning it processes last (after smelting but would conflict with auto-sell).

Tips

  • Great for mining operations to reduce pickup time
  • Combine with large inventory or backpack plugins
  • Works perfectly with VEIN_MINING for efficient mining
  • Use on swords for mob grinding without item pickup
  • Consider not using with MELT_MINING if you want to keep raw ores

On this page

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.