GroupeZ Docs
Configurations

Commandes personnalisees

Creer des commandes personnalisees pour ouvrir vos inventaires

zMenu vous permet de creer des commandes personnalisees qui ouvrent vos inventaires. Au lieu d'utiliser /zm open shop, les joueurs peuvent simplement taper /shop.

Fichier de configuration

Les commandes personnalisees sont definies dans plugins/zMenu/commands/commands.yml.

Structure de base

commands:
  shop:
    command: /shop
    inventory: shop_menu

Ceci cree la commande /shop qui ouvre l'inventaire shop_menu.

Options de configuration

command

Requis. La commande que les joueurs taperont.

command: /shop

inventory

Requis. L'inventaire a ouvrir lorsque la commande est utilisee.

inventory: "shop"  # Ouvre inventories/shop.yml

permission

Permission optionnelle requise pour utiliser la commande.

permission: "monserveur.shop"

aliases

Noms de commande alternatifs.

aliases:
  - boutique
  - magasin
  - acheter

Cela permet a /boutique, /magasin et /acheter de fonctionner comme /shop.

actions

Actions a executer lorsque la commande est utilisee (avant d'ouvrir l'inventaire).

actions:
  - type: message
    messages:
      - "&aOuverture de la boutique..."
  - type: sound
    sound: BLOCK_CHEST_OPEN

arguments

Definir des arguments de commande.

arguments:
  - name: "category"
    required: false
    auto-completion:
      - "armes"
      - "armures"
      - "outils"

Exemples

Commande boutique simple

commands:
  shop:
    command: /shop
    inventory: shop
    permission: "server.shop"
    aliases:
      - boutique
      - magasin

Commande warps

commands:
  warps:
    command: /warps
    inventory: warps_menu
    permission: "server.warps"
    aliases:
      - warp
      - teleport
    actions:
      - type: message
        messages:
          - "&7Ouverture du menu warps..."
commands:
  adminmenu:
    command: /adminmenu
    inventory: admin_panel
    permission: "server.admin.menu"
    aliases:
      - admin
      - apanel
commands:
  menu:
    command: /menu
    inventory: main_menu
    aliases:
      - gui
      - m

  help:
    command: /help
    inventory: help_menu
    permission: "server.help"

  rules:
    command: /rules
    inventory: rules_menu

Informations serveur

commands:
  info:
    command: /info
    inventory: server_info
    aliases:
      - serverinfo
      - apropos
    actions:
      - type: sound
        sound: ENTITY_EXPERIENCE_ORB_PICKUP

Fichiers de commandes multiples

Vous pouvez organiser les commandes dans plusieurs fichiers :

plugins/zMenu/commands/
├── commands.yml
├── shop/
│   └── shop_commands.yml
├── admin/
│   └── admin_commands.yml
└── social/
    └── social_commands.yml

Chaque fichier suit le meme format :

# commands/shop/shop_commands.yml
commands:
  shop:
    command: /shop
    inventory: shop_main

  buyweapons:
    command: /buyweapons
    inventory: shop_weapons

Arguments de commande

Arguments basiques

commands:
  give-menu:
    command: /givemenu
    inventory: give_menu
    permission: "server.admin"
    arguments:
      - name: "player"
        required: true
        auto-completion: "@players"  # Auto-completion avec les joueurs en ligne

Arguments multiples

commands:
  category:
    command: /category
    inventory: category_menu
    arguments:
      - name: "type"
        required: true
        auto-completion:
          - "armes"
          - "armures"
          - "outils"
          - "nourriture"
      - name: "page"
        required: false

Commandes en conflit

Si votre commande entre en conflit avec un autre plugin :

  1. Changez le nom de la commande pour quelque chose d'unique
  2. Utilisez des alias comme point d'entree principal
  3. Verifiez l'ordre de chargement des plugins dans la configuration du serveur

Si une commande comme /shop est prise par un autre plugin, utilisez une commande unique comme /zmshop et ajoutez /shop comme alias. zMenu essaiera d'enregistrer l'alias.

Exemples de permissions

Avec LuckPerms

# Donner la permission d'utiliser shop
/lp group default permission set server.shop true

# Menu admin pour les admins uniquement
/lp group admin permission set server.admin.menu true

Message de refus

Les joueurs sans permission voient le message "pas de permission" par defaut. Personnalisez-le dans votre configuration des messages.

Recharger les commandes

Apres avoir modifie les fichiers de commandes :

/zm reload command           # Recharger toutes les commandes
/zm reload command shop      # Recharger une commande specifique

Exemple complet

# commands/commands.yml
commands:
  # Menu principal du serveur
  menu:
    command: /menu
    inventory: main_menu
    aliases:
      - gui
      - serveur
    actions:
      - type: sound
        sound: BLOCK_CHEST_OPEN

  # Boutique avec permission
  shop:
    command: /shop
    inventory: shop_main
    permission: "server.shop"
    aliases:
      - boutique
      - magasin
      - acheter

  # Boutique VIP
  vipshop:
    command: /vipshop
    inventory: vip_shop
    permission: "server.vip.shop"
    aliases:
      - vs

  # Menu warps
  warps:
    command: /warps
    inventory: warps_menu
    permission: "server.warps"
    aliases:
      - warp
      - w

  # Profil joueur
  profile:
    command: /profile
    inventory: player_profile
    aliases:
      - stats
      - me

  # Menu aide
  help:
    command: /serverhelp
    inventory: help_menu
    aliases:
      - faq
      - info

  # Panel admin
  admin:
    command: /adminpanel
    inventory: admin_menu
    permission: "server.admin"
    aliases:
      - ap
      - adminmenu

Bonnes pratiques

  1. Utilisez des noms intuitifs : /shop et non /spm
  2. Ajoutez des alias utiles : Variations courantes et raccourcis
  3. Definissez des permissions appropriees : Restreignez les menus sensibles
  4. Restez organise : Utilisez des sous-dossiers pour les grandes configurations
  5. Documentez les commandes : Commentez vos fichiers YAML
  6. Testez minutieusement : Verifiez que les commandes fonctionnent comme prevu

Prochaines etapes

Formulaires Bedrock

Creer des formulaires natifs Bedrock Edition pour les joueurs connectes via Geyser/Floodgate

Config.yml

Reference du fichier de configuration principal

Sur cette page

Fichier de configurationStructure de baseOptions de configurationcommandinventorypermissionaliasesactionsargumentsExemplesCommande boutique simpleCommande warpsMenu adminMenu avec categoriesInformations serveurFichiers de commandes multiplesArguments de commandeArguments basiquesArguments multiplesCommandes en conflitExemples de permissionsAvec LuckPermsMessage de refusRecharger les commandesExemple completBonnes pratiquesProchaines etapes
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.