GroupeZ Docs
Configuration

Messages

Personnalisez tous les messages dans zAuctionHouse

Tous les messages affichés par zAuctionHouse peuvent être personnalisés dans le fichier messages.yml.

Format des Messages

Les messages supportent :

  • Format MiniMessage (serveurs Paper) - <green>, <bold>, <gradient:green:blue>
  • Codes de couleur legacy - &a, &l, &6
  • PlaceholderAPI - %player_name%, %zauctionhouse_*%

Types de Messages

Chaque message peut être configuré avec un type d'affichage spécifique en utilisant le champ type. Si aucun type n'est spécifié, TCHAT est utilisé par défaut.

TypeDescription
TCHATAffiche le message dans le chat (par défaut)
ACTIONAffiche le message dans la barre d'action au-dessus de la hotbar
TITLEAffiche le message en titre à l'écran
CENTERAffiche le message centré dans le chat
WITHOUT_PREFIXAffiche le message dans le chat sans le préfixe du plugin
BOSSBARAffiche le message en barre de boss en haut de l'écran
NONEN'affiche pas le message

Utilisation Basique

Vous pouvez définir le type de n'importe quel message en utilisant le format objet :

# Format simple (TCHAT par défaut)
item-sold: "#e6fff3Vous venez de vendre %items% #e6fff3pour #92bed8%price%#e6fff3."

# Avec type explicite
item-sold:
  type: ACTION
  message: "#e6fff3Vous venez de vendre %items% #e6fff3pour #92bed8%price%#e6fff3."

Plusieurs Parties de Message

Une seule clé de message peut déclencher plusieurs types d'affichage à la fois en utilisant une liste :

item-sold:
  - type: TCHAT
    messages:
      - "#e6fff3Vous venez de vendre %items% #e6fff3pour #92bed8%price%#e6fff3."
  - type: ACTION
    message: "#e6fff3Vendu pour #92bed8%price%#e6fff3 !"

Type Title

Le type TITLE prend en charge des champs supplémentaires pour contrôler l'affichage du titre :

item-sold:
  type: TITLE
  title: "<success>Objet Vendu !"
  subtitle: "#e6fff3Vous avez vendu %items% #e6fff3pour #92bed8%price%"
  start: 100    # Durée du fondu d'entrée en millisecondes (défaut : 100)
  time: 2800    # Durée d'affichage en millisecondes (défaut : 2800)
  end: 100      # Durée du fondu de sortie en millisecondes (défaut : 100)

Type BossBar

Le type BOSSBAR affiche une barre de boss en haut de l'écran avec une apparence personnalisable :

item-sold:
  type: BOSSBAR
  text: "#e6fff3Vous venez de vendre %items% #e6fff3pour #92bed8%price%#e6fff3."
  color: WHITE       # Couleur de la barre : PINK, BLUE, RED, GREEN, YELLOW, PURPLE, WHITE (défaut : WHITE)
  overlay: PROGRESS  # Style de la barre : PROGRESS, NOTCHED_6, NOTCHED_10, NOTCHED_12, NOTCHED_20 (défaut : PROGRESS)
  flags: []          # Flags optionnels : DARKEN_SKY, PLAY_BOSS_MUSIC, CREATE_FOG
  duration: 60       # Durée d'affichage en ticks (défaut : 60)
  static: false      # Si true, la barre ne s'anime pas (défaut : false)

Combiner Plusieurs Types

Vous pouvez combiner différents types pour créer des notifications riches :

item-bought-buyer:
  - type: TCHAT
    messages:
      - "#e6fff3Vous venez d'acheter %items% #e6fff3pour #92bed8%price%#e6fff3."
  - type: TITLE
    title: "<success>Achat Terminé !"
    subtitle: "#92bed8%price%"
    start: 100
    time: 2800
    end: 100
  - type: BOSSBAR
    text: "#e6fff3Achat de %items% pour #92bed8%price%"
    color: GREEN
    duration: 100

Structure des Messages

messages:
  prefix: "<gray>[<gold>HôtelDesVentes</gold>]</gray> "

  # Messages de commande
  commands:
    sell:
      success: "<green>Vous avez mis en vente <item> pour <price> !"
      no-item: "<red>Vous devez tenir un objet pour vendre !"
      blacklisted: "<red>Cet objet ne peut pas être vendu !"
      limit-reached: "<red>Vous avez atteint votre limite de mise en vente (<limit>) !"
      price-too-low: "<red>Le prix minimum est <min> !"
      price-too-high: "<red>Le prix maximum est <max> !"

    buy:
      success: "<green>Vous avez acheté <item> pour <price> !"
      not-enough-money: "<red>Vous avez besoin de <price> pour acheter cet objet !"
      own-item: "<red>Vous ne pouvez pas acheter votre propre objet !"
      item-sold: "<red>Cet objet a déjà été vendu !"

    remove:
      success: "<green>Vous avez retiré <item> de l'hôtel des ventes."
      not-owner: "<red>Cet objet ne vous appartient pas !"

Variables Disponibles

Les variables sont automatiquement remplacées dans les messages :

Variables d'Objet

VariableDescription
<item>Nom de l'objet
<amount>Quantité
<price>Prix (formaté)
<seller>Nom du vendeur
<buyer>Nom de l'acheteur
<economy>Nom de l'économie
<category>Nom de la catégorie

Variables Joueur

VariableDescription
<player>Nom du joueur
<limit>Limite de mise en vente
<current>Nombre actuel de mises en vente
<remaining>Emplacements restants

Variables de Prix

VariableDescription
<min>Prix minimum
<max>Prix maximum
<tax>Montant de la taxe
<final>Prix final après taxe

Variables de Temps

VariableDescription
<time>Temps restant
<expire>Temps d'expiration
<duration>Durée

Exemple Complet de Messages

messages:
  # Préfixe global pour tous les messages
  prefix: "<gray>[<gold>HDV</gold>]</gray> "

  # Messages généraux
  general:
    no-permission: "<red>Vous n'avez pas la permission de faire cela !"
    player-only: "<red>Cette commande ne peut être utilisée que par les joueurs !"
    reload: "<green>Configuration rechargée avec succès !"
    invalid-number: "<red>Veuillez entrer un nombre valide !"
    cooldown: "<red>Veuillez attendre <time> avant de refaire cela !"
    banned-world: "<red>Vous ne pouvez pas utiliser l'hôtel des ventes dans ce monde !"

  # Messages de vente
  sell:
    success: "<green>Vous avez mis en vente <white><item></white> pour <gold><price></gold> !"
    holding-air: "<red>Vous devez tenir un objet pour vendre !"
    blacklisted: "<red>Cet objet est en liste noire et ne peut pas être vendu !"
    not-whitelisted: "<red>Cet objet n'est pas autorisé dans l'hôtel des ventes !"
    limit-reached: "<red>Vous avez atteint votre limite de mise en vente ! (<current>/<limit>)"
    price-too-low: "<red>Le prix minimum pour cet objet est <gold><min></gold> !"
    price-too-high: "<red>Le prix maximum pour cet objet est <gold><max></gold> !"
    no-economy-permission: "<red>Vous n'avez pas la permission d'utiliser l'économie <economy> !"
    creative-item: "<red>Vous ne pouvez pas vendre d'objets obtenus en mode créatif !"

  # Messages d'achat
  purchase:
    success: "<green>Vous avez acheté <white><item></white> pour <gold><price></gold> !"
    not-enough-money: "<red>Vous avez besoin de <gold><price></gold> pour acheter cet objet !"
    own-item: "<red>Vous ne pouvez pas acheter votre propre objet !"
    already-sold: "<red>Cet objet a déjà été vendu !"
    inventory-full: "<red>Votre inventaire est plein ! L'objet a été sauvegardé pour plus tard."
    seller-notification: "<green><buyer> a acheté votre <white><item></white> pour <gold><price></gold> !"

  # Messages de retrait
  remove:
    success: "<green>Vous avez retiré <white><item></white> de l'hôtel des ventes."
    not-owner: "<red>Cet objet ne vous appartient pas !"
    expired-claimed: "<green>Vous avez récupéré votre objet expiré : <white><item></white> !"
    purchased-claimed: "<green>Vous avez récupéré : <white><item></white> !"

  # Messages d'expiration
  expire:
    notification: "<yellow>Votre objet <white><item></white> a expiré !"
    warning: "<yellow>Votre objet <white><item></white> va expirer dans <time> !"

  # Messages admin
  admin:
    clear-all: "<green>Supprimé <amount> objets de l'hôtel des ventes."
    clear-player: "<green>Supprimé <amount> objets de <player>."
    expire-player: "<green>Expiré <amount> objets de <player>."

  # Messages d'aide
  help:
    header: "<gold>===== Aide Hôtel des Ventes ====="
    commands:
      - "<yellow>/ah</yellow> - Ouvrir l'hôtel des ventes"
      - "<yellow>/ah sell <prix></yellow> - Vendre l'objet dans votre main"
      - "<yellow>/ah selling</yellow> - Voir vos objets en vente"
      - "<yellow>/ah expired</yellow> - Voir vos objets expirés"
      - "<yellow>/ah purchased</yellow> - Voir les objets achetés à récupérer"
    footer: "<gold>=============================="

  # Format du temps
  time:
    seconds: "<seconds>s"
    minutes: "<minutes>m <seconds>s"
    hours: "<hours>h <minutes>m"
    days: "<days>j <hours>h"

Exemples MiniMessage

Utilisation du formatage MiniMessage (Paper uniquement) :

messages:
  # Texte en dégradé
  sell:
    success: "<gradient:green:yellow>Objet mis en vente avec succès !</gradient>"

  # Texte au survol
  help:
    sell: "<hover:show_text:'<gray>Cliquez pour vendre un objet'><yellow>/ah sell</yellow></hover>"

  # Actions au clic
  expired:
    notification: "<click:run_command:'/ah expired'><yellow>Cliquez pour voir les objets expirés !</yellow></click>"

  # Formatage combiné
  purchase:
    seller-notification: |
      <gradient:gold:yellow><bold>OBJET VENDU !</bold></gradient>
      <gray>Acheteur :</gray> <white><buyer></white>
      <gray>Objet :</gray> <white><item></white>
      <gray>Prix :</gray> <gold><price></gold>

Messages par Économie

Configurez les messages par type d'économie :

messages:
  economies:
    vault:
      format: "<gold><amount>$</gold>"
      not-enough: "<red>Vous avez besoin de <gold><price>$</gold> !"

    playerpoints:
      format: "<aqua><amount> Points</aqua>"
      not-enough: "<red>Vous avez besoin de <aqua><price> Points</aqua> !"

    experience:
      format: "<green><amount> XP</green>"
      not-enough: "<red>Vous avez besoin de <green><price> XP</green> !"

Désactiver des Messages

Pour désactiver un message, définissez-le comme vide :

# Aucun message envoyé lors d'une mise en vente
item-sold: ""

Rien n'est envoyé, pas même le préfixe. Les lignes vides d'un message sur plusieurs lignes sont conservées, elles servent d'espacement.

Par exemple, pour afficher la taxe de vente dans le message item-sold plutôt que dans un message séparé (item-sold reçoit %tax% et %percentage%, à 0 sans taxe) :

tax-sell-applied: ""
item-sold: "#e6fff3Vous venez de mettre en vente %items% #e6fff3pour #92bed8%price% #e6fff3(taxe : %tax%)."

Recharger les Messages

Après avoir modifié messages.yml, rechargez avec :

/ah admin reload

Configuration Principale

Options de configuration principales pour zAuctionHouse V4

Économies

Configurer les systèmes économiques dans zAuctionHouse

Sur cette page

Format des MessagesTypes de MessagesUtilisation BasiquePlusieurs Parties de MessageType TitleType BossBarCombiner Plusieurs TypesStructure des MessagesVariables DisponiblesVariables d'ObjetVariables JoueurVariables de PrixVariables de TempsExemple Complet de MessagesExemples MiniMessageMessages par ÉconomieDésactiver des MessagesRecharger les Messages
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.