GroupeZ Docs

Introduction

Create custom items with powerful effects for Minecraft 1.21+

zItems is a powerful Minecraft plugin that allows you to create custom items with unique effects, metadata, and properties. From enchanted armor to magical tools, zItems gives you complete control over item creation.

Requirements

RequirementVersion
Minecraft1.21+
JavaJava 21
Server SoftwarePaper, Purpur, or Folia

Key Features

Custom Items

Create items with extensive customization:

  • Materials & Display: Use any Minecraft material with custom names, lores, and custom model data
  • Enchantments: Add vanilla or custom enchantments with any level
  • Attributes: Modify damage, speed, armor, health, and more
  • Item Flags: Hide enchantments, attributes, or other item properties
  • Recipes: Define crafting recipes (shaped, shapeless, furnace, etc.)

Effects System

Add powerful abilities to your items:

EffectDescription
VEIN_MININGMines entire ore veins at once
HAMMERMines in a 3x3 (or larger) area
AUTO_SELLAutomatically sells mined/killed drops
SILK_SPAWNERAllows picking up spawners with silk touch
MELT_MININGAuto-smelts mined ores (fortune compatible)
XP_BOOSTMultiplies XP drops from mining
FARMING_HOEHarvest, till, and plant in area
SELL_STICKSell container contents by clicking
INFINITE_BUCKETUnlimited water/lava placement
ABSORPTIONItems go directly to inventory
ENCHANTS_APPLICATORModifies enchantment levels
ATTRIBUTES_APPLICATORAdds/modifies attributes
UNBREAKABLEPrevents durability loss

Metadata System

Configure special item properties:

MetadataDescription
foodMake any item edible with nutrition, saturation, and effects
potionAdd potion effects to items
leather-armorSet leather armor color
trimApply armor trims
bannerAdd banner patterns
toolCustom mining speeds and rules
commandsExecute commands on item interaction

Plugin Integrations

PluginFeatures
Jobs RebornMoney/XP boost effects for jobs
PlaceholderAPIDynamic placeholders in item names/lore
WorldGuardRegion-based effect restrictions
ItemsAdderCustom block support
OraxenCustom block support
NexoCustom block support
ShopGUI+Auto-sell and sell stick support
EconomyShopGUIAuto-sell and sell stick support
ZShopAuto-sell and sell stick support

Quick Start

Basic Item

# plugins/zItems/items/legendary_sword.yml
legendary_sword:
  material: DIAMOND_SWORD
  display-name: "<gradient:#ff6b6b:#feca57>Legendary Sword</gradient>"
  lore:
    - ""
    - "<gray>A powerful weapon forged</gray>"
    - "<gray>in the depths of the nether.</gray>"
    - ""
    - "<yellow>Damage: <red>+15</red></yellow>"

  enchantments:
    - enchantment: SHARPNESS
      level: 5
    - enchantment: FIRE_ASPECT
      level: 2

  attributes:
    - attribute: ATTACK_DAMAGE
      operation: ADD_NUMBER
      amount: 15
      slot: MAINHAND

  unbreakable: true

Item with Effects

# plugins/zItems/items/vein_pickaxe.yml
vein_pickaxe:
  material: NETHERITE_PICKAXE
  display-name: "<gold>Vein Miner Pickaxe</gold>"
  lore:
    - ""
    - "<gray>Mines entire ore veins!</gray>"
    - "<yellow>Max blocks: <white>32</white></yellow>"

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

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

    - type: MELT_MINING

Commands

CommandDescription
/zitems give <item> [player] [amount]Give a custom item
/zitems giveeffect <effect> [player]Give an effect item
/zitems applyeffect <effect>Apply effect to held item
/zitems vieweffectView effects on held item
/zitems guiOpen item browser GUI
/zitems reloadReload configuration

Next Steps

Installation

Next Page

On this page

RequirementsKey FeaturesCustom ItemsEffects SystemMetadata SystemPlugin IntegrationsQuick StartBasic ItemItem with EffectsCommandsNext Steps
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.