GroupeZ Docs
Modules

Module Objets

Définitions d'objets personnalisés utilisables dans l'ensemble du plugin

Fichier : modules/items/config.yml

Le module Objets vous permet de définir des objets personnalisés qui peuvent être référencés et utilisés dans l'ensemble du plugin. Les objets personnalisés sont définis en utilisant le format d'objet zMenu et prennent en charge les noms personnalisés, les matériaux, les enchantements, le lore et toutes les autres propriétés d'objet. Ces objets peuvent ensuite être donnés aux joueurs via la commande /give ou référencés dans d'autres modules.

Contrairement à la plupart des modules, le module Objets ne dispose pas d'un bouton enable. Les définitions d'objets personnalisés sont toujours disponibles lorsqu'elles sont configurées. Le module sert de registre d'objets partagé pour l'ensemble du plugin.

Configuration

# Custom item definitions using the zMenu item format
# Each key is a unique item identifier that can be referenced across the plugin
custom-items:
  master_sword:
    name: "<gradient:#e88d1e:#e8511e>\u1d0d\u1d00s\u1d1b\u1d07\u0280 s\u1d21\u1d0f\u0280\u1d05</gradient>"
    material: DIAMOND_SWORD
    enchants:
      - SHARPNESS,10
      - UNBREAKING,10
      - LOOTING,10
      - MENDING,1

Options

Propriétés des Objets Personnalisés

Chaque objet dans la map custom-items est identifié par une clé unique (par exemple, master_sword) et prend en charge les propriétés suivantes :

PropriétéTypePar DéfautDescription
nameString-Le nom d'affichage personnalisé de l'objet. Prend en charge le formatage MiniMessage, les dégradés et les codes couleur
materialString-Le type de matériau Minecraft (par exemple, DIAMOND_SWORD, GOLDEN_APPLE, NETHERITE_PICKAXE)
enchantsListe de Strings[]Liste des enchantements au format ENCHANTMENT_NAME,LEVEL
loreListe de Strings[]Liste des lignes de lore affichées sur l'objet. Prend en charge les codes couleur et MiniMessage
amountInteger1Taille de la pile d'objets
durabilityInteger0Valeur de dégâts appliquée à l'objet (pour les outils et armures)
unbreakableBooleanfalseSi true, l'objet ne peut pas perdre de durabilité
modelIdInteger0Valeur de custom model data pour l'intégration des packs de ressources

Les objets personnalisés utilisent le format d'objet zMenu, ce qui signifie que toute propriété prise en charge par les objets zMenu peut être utilisée ici. Cela inclut les données NBT, les flags d'objet, les textures de crâne, les couleurs d'armure en cuir, les effets de potion, et plus encore. Consultez la documentation zMenu pour la liste complète des propriétés d'objet prises en charge.

Format des Enchantements

Les enchantements sont spécifiés sous forme de chaîne séparée par des virgules NAME,LEVEL :

enchants:
  - SHARPNESS,10
  - UNBREAKING,10
  - LOOTING,10
  - MENDING,1

Tous les noms d'enchantement standard de Minecraft sont pris en charge (par exemple, SHARPNESS, EFFICIENCY, PROTECTION, FIRE_ASPECT, SILK_TOUCH, FORTUNE, MENDING, UNBREAKING).

Les niveaux d'enchantement supérieurs au maximum vanilla (par exemple, SHARPNESS,10) sont pris en charge mais peuvent se comporter différemment selon votre logiciel serveur et sa version. Certains plugins anti-triche peuvent signaler les objets avec des niveaux d'enchantement non standard.

Définir Plusieurs Objets

Vous pouvez définir autant d'objets personnalisés que nécessaire. Chacun doit avoir une clé unique :

custom-items:
  master_sword:
    name: "<gradient:#e88d1e:#e8511e>Master Sword</gradient>"
    material: DIAMOND_SWORD
    enchants:
      - SHARPNESS,10
      - UNBREAKING,10
      - LOOTING,10
      - MENDING,1

  healing_potion:
    name: "&d&lSuper Healing Potion"
    material: POTION
    amount: 3
    lore:
      - "&7A powerful healing potion"
      - "&7that restores full health."

  builders_pickaxe:
    name: "&b&lBuilder's Pickaxe"
    material: NETHERITE_PICKAXE
    unbreakable: true
    enchants:
      - EFFICIENCY,5
      - SILK_TOUCH,1

  trophy_head:
    name: "&6&lChampion Trophy"
    material: PLAYER_HEAD
    lore:
      - "&7Awarded to the champion"
      - "&7of the tournament."

Commandes Associées

CommandeAliasPermissionDescription
/give-essentials.giveDonner des objets (y compris des objets personnalisés) à un joueur
/giveall-essentials.give.allDonner des objets à tous les joueurs en ligne
/itemnameiname, itemrename, irenameessentials.item.nameRenommer l'objet tenu en main
/itemloreilore, loreessentials.item.loreAjouter, définir ou effacer le lore de l'objet tenu

Sous-commandes du Lore d'Objet

Sous-commandeDescription
addAjouter une nouvelle ligne de lore à l'objet tenu
setDéfinir une ligne de lore spécifique par index
clearSupprimer tout le lore de l'objet tenu

Permissions Associées

PermissionDescription
essentials.givePermet de donner des objets à un joueur avec /give
essentials.give.allPermet de donner des objets à tous les joueurs avec /giveall
essentials.item.namePermet de renommer l'objet tenu
essentials.item.lorePermet de modifier le lore de l'objet tenu

Placeholders Associés

Les placeholders suivants renvoient des informations sur l'objet que le joueur tient actuellement dans sa main principale :

PlaceholderDescriptionType de Retour
%zessentials_iteminhand_type%Nom du type de matériau (par exemple, DIAMOND_SWORD)String
%zessentials_iteminhand_realname%Nom formaté du matériau (par exemple, Diamond Sword)String
%zessentials_iteminhand_displayname%Nom d'affichage personnalisé, ou nom du matériau si aucun n'est définiString
%zessentials_iteminhand_custommodeldata%Valeur de custom model data (0 si aucune)Integer
%zessentials_iteminhand_maxdurability%Durabilité maximale de l'objetInteger
%zessentials_iteminhand_durability%Valeur de dégâts actuelle de l'objetInteger
%zessentials_iteminhand_amount%Nombre d'objets dans la pileInteger
%zessentials_iteminhand_lore%Texte du lore de l'objetString
%zessentials_iteminhand_enchantments%Tous les enchantements avec leurs niveauxString
%zessentials_iteminhand_hasenchantment_{enchantment}%Renvoie true si l'objet possède l'enchantement spécifiéBoolean
%zessentials_iteminhand_enchantmentlevel_{enchantment}%Niveau de l'enchantement spécifiéInteger
%zessentials_iteminhand_itemflags%Tous les flags d'objet appliqués à l'objetString
%zessentials_iteminhand_hasitemflag_{flag}%Renvoie true si l'objet possède le flag spécifiéBoolean

Placeholders Minecraft 1.21+

Ces placeholders sont uniquement disponibles sur Minecraft 1.21 et versions ultérieures :

PlaceholderDescriptionType de Retour
%zessentials_iteminhand_rarity%Rareté de l'objet (COMMON, UNCOMMON, RARE, EPIC)String
%zessentials_iteminhand_repaircost%Coût de réparation à l'enclume de l'objetInteger
%zessentials_iteminhand_maxstacksize%Taille maximale de la pile pour l'objetInteger
%zessentials_iteminhand_hide_tooltip%Renvoie true si l'infobulle de l'objet est masquéeBoolean
%zessentials_iteminhand_glint%Renvoie true si l'objet a un éclat d'enchantementBoolean
%zessentials_iteminhand_fire_resistant%Renvoie true si l'objet est résistant au feuBoolean
%zessentials_iteminhand_unbreakable%Renvoie true si l'objet est incassableBoolean

Exemple : Vérifier si l'objet tenu possède Sharpness :

%zessentials_iteminhand_hasenchantment_sharpness%

Module Homes

Système de homes des joueurs avec limites basées sur les permissions

Module Connexion & Déconnexion

Messages de connexion, déconnexion et première connexion personnalisables avec prise en charge du MOTD

Sur cette page

ConfigurationOptionsPropriétés des Objets PersonnalisésFormat des EnchantementsDéfinir Plusieurs ObjetsCommandes AssociéesSous-commandes du Lore d'ObjetPermissions AssociéesPlaceholders AssociésPlaceholders Minecraft 1.21+
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.