GroupeZ Docs

Introduction

Create custom items with powerful effects for Minecraft 1.21+

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

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

Suivant

Sur cette page

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