GroupeZ Docs

Premiers pas

Introduction a zMenu - Le plugin d'inventaire le plus puissant pour Minecraft

zMenu est le plugin d'inventaire (GUI) le plus puissant et flexible pour les serveurs Minecraft. Il vous permet de creer de beaux menus interactifs avec un systeme de configuration extensif qui vous donne un controle total sur chaque aspect de vos inventaires.

Qu'est-ce que zMenu ?

zMenu est un plugin d'inventaire de qualite premium qui permet aux administrateurs de serveurs de creer des GUIs (Interfaces Graphiques Utilisateur) personnalisees pour leurs serveurs Minecraft. Que vous ayez besoin d'un simple selecteur de serveur, d'un systeme de boutique complexe ou d'un menu de quetes interactif, zMenu fournit tous les outils necessaires.

Vous venez de DeluxeMenus ? Changez en une commande

Vous n'avez pas a reecrire vos menus. zMenu convertit automatiquement vos menus DeluxeMenus : items, slots, commandes de clic, prerequis et commandes d'ouverture sont traduits en inventaires zMenu en quelques secondes.

/zm convert deluxemenus

Tout ce qui ne peut pas etre converti a l'identique est liste en haut de chaque fichier converti, et vos fichiers DeluxeMenus ne sont jamais modifies. Lire le guide de migration →

Modifiez en direct avec le hot reload

Enregistrez un fichier, le menu est a jour en jeu. Pas de /zm reload, pas de redemarrage. Avec le hot reload active, zMenu surveille votre dossier inventories/ et recharge, charge ou decharge les inventaires des que leurs fichiers changent. Les joueurs qui ont le menu ouvert voient la nouvelle version instantanement, sur la meme page, et un fichier contenant une erreur ne remplace jamais la version fonctionnelle.

# config.yml
hot-reload:
  enable: true

Fonctionnalites cles

Migration et workflow

Inventaires hautement personnalisables

  • Creez des inventaires de toutes tailles (9 a 54 emplacements)
  • Support multi-pages avec pagination automatique
  • Titres personnalises avec support des placeholders
  • Items de remplissage pour les emplacements vides
  • Systeme de mise en page base sur une matrice pour un design facile

Systeme de boutons puissant

  • 9 types de boutons integres : NONE, INVENTORY, BACK, NEXT, PREVIOUS, HOME, JUMP, MAIN_MENU, SWITCH
  • Actions de clic personnalisees pour chaque bouton de souris
  • Exigences de vue et de clic
  • Support des tetes de joueurs avec textures personnalisees
  • Mises a jour dynamiques des items

Systeme d'actions extensif

  • Plus de 28 types d'actions incluant messages, sons, commandes, teleportation et plus
  • Executez des actions en tant que joueur, console ou avec permissions OP
  • Enchainez plusieurs actions ensemble
  • Actions conditionnelles avec exigences

Fonctionnalites avancees

  • Systeme de patterns : Creez des modeles de boutons reutilisables
  • Donnees joueur : Stockez et recuperez des donnees specifiques aux joueurs
  • Placeholders globaux : Definissez des valeurs utilisees dans tous les inventaires
  • Support PlaceholderAPI : Integration complete avec PAPI
  • Support MiniMessage : Formatage de texte moderne pour les serveurs Paper
  • Systeme anti-duplication : Protection integree contre les exploits de duplication d'items
  • Support base de donnees : MySQL, MariaDB et SQLite pour la persistance des donnees

Convivial pour les developpeurs

  • API propre et bien documentee
  • Enregistrement de types de boutons personnalises
  • Enregistrement de types d'actions personnalises
  • Systeme d'evenements pour les interactions d'inventaire

Pourquoi choisir zMenu ?

FonctionnalitezMenuAutres plugins
Import des menus DeluxeMenusUne commandeReecriture a la main
Hot reloadAutomatique, sans commandeRechargement manuel
Types de boutons9+ integresLimite
Types d'actions28+Basique
Support multi-pagesNatifNecessite souvent des contournements
Systeme de patternsOuiNon
Stockage donnees joueurOuiRarement
Support MiniMessageOuiRarement
Support base de donneesMySQL/MariaDB/SQLiteGeneralement fichiers uniquement
Qualite APICompleteSouvent minimale
Developpement actifOuiVariable
GratuitOuiSouvent payant

Comment ca fonctionne

zMenu utilise des fichiers de configuration YAML pour definir vos inventaires. Voici un apercu simplifie :

  1. Les inventaires sont definis dans le dossier inventories/
  2. Chaque inventaire contient des boutons (items avec lesquels les joueurs peuvent interagir)
  3. Les boutons peuvent avoir des actions qui s'executent au clic
  4. Les exigences controlent qui peut voir ou cliquer sur les boutons
  5. Les patterns permettent de reutiliser des configurations de boutons

Exemple simple

# inventories/mon_menu.yml
name: "&6Mon premier menu"
size: 27

items:
  bouton-bienvenue:
    slot: 13
    item:
      material: DIAMOND
      name: "&bBienvenue !"
      lore:
        - "&7Cliquez-moi pour recevoir un message"
    actions:
      - type: message
        messages:
          - "&aBonjour, %player% !"
          - "&7Merci d'utiliser zMenu !"

Ceci cree un inventaire simple de 27 emplacements avec un diamant au centre qui envoie un message au clic.

Versions Minecraft supportees

zMenu supporte les versions Minecraft 1.20.6 et plus recentes et fonctionne avec :

  • Paper (requis)
  • Purpur
  • Pufferfish
  • Folia

Paper requis

Depuis la version 1.1.1.6, zMenu fonctionne uniquement sur Paper — vous devez utiliser Paper, un fork de Paper (Purpur, Pufferfish) ou Folia. Sur Spigot, le plugin se charge quand meme, mais uniquement pour afficher un avertissement expliquant que Paper est requis : aucune fonctionnalite de zMenu n'y fonctionne.

Prochaines etapes

Pret a commencer ? Suivez ces etapes :

  1. Installez zMenu sur votre serveur
  2. Vous utilisez DeluxeMenus ? Convertissez vos menus en une commande
  3. Activez le hot reload pour voir vos modifications instantanement
  4. Apprenez le systeme de configuration
  5. Creez votre premier inventaire
  6. Explorez les types de boutons et les actions

Obtenir de l'aide

Sur cette page

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.