GroupeZ Docs
InventoriesAdmin

Admin Principal

Configuration de l'inventaire annuaire des joueurs admin

L'inventaire admin principal est l'annuaire des joueurs de l'interface d'administration. Il liste tous les joueurs ayant une activité d'enchères et permet aux administrateurs d'accéder directement à l'historique d'un joueur sans devoir taper son nom.

Fichier : plugins/zAuctionHouse/inventories/admin/admin-main.yml

Accès :

Permission : zauctionhouse.admin.items (/ah admin nécessite aussi zauctionhouse.admin)

Fonctionnalités

  • Une entrée par joueur ayant une activité d'enchères (annonces, achats, logs ou transactions)
  • Nombre d'annonces actuellement en vente, de ventes et d'achats pour chaque joueur
  • Quatre modes de tri : nom, en vente, vendus, achetés
  • Cliquer sur un joueur ouvre son inventaire admin historique principal
  • Bouton d'actualisation pour recharger les données

Les données sont chargées de manière asynchrone avec une seule requête SQL, sans charger le contenu des objets. À chaque ouverture de l'inventaire (commande ou bouton ZAUCTIONHOUSE_ADMIN_MAIN), les données sont rechargées depuis la base de données.

Configuration par Défaut

# Admin player directory. Counts are auction listings/lots, including historical purchases.
name: "#0c1719Administration des joueurs"
size: 54
patterns:
  - zauctionhouse-pagination
items:
  players:
    type: ZAUCTIONHOUSE_ADMIN_PLAYERS
    slots:
      - 0-44
    item:
      material: PLAYER_HEAD
      player-head: "%target%"
      name: "#2CCED2%target%"
      lore:
        - "#92ffffEn vente: #2CCED2%listed%"
        - "#92ffffVendus: #2CCED2%sold%"
        - "#92ffffAchetés: #2CCED2%purchased%"
        - ""
        - "#92ffffCliquez pour consulter son historique"
    else:
      item:
        material: BARRIER
        name: "#ff5555Aucun historique"
      slot: 22
  sort:
    type: ZAUCTIONHOUSE_ADMIN_PLAYERS_SORT
    slot: 49
    item:
      material: HOPPER
      name: "#2CCED2Trier les joueurs"
      lore:
        - "%name-color%• Nom"
        - "%listed-color%• En vente (décroissant)"
        - "%sold-color%• Vendus (décroissant)"
        - "%purchased-color%• Achetés (décroissant)"
        - "#8c8c8cClic gauche / droit pour changer"
  refresh:
    type: ZAUCTIONHOUSE_ADMIN_MAIN
    slot: 45
    item:
      material: SUNFLOWER
      name: "#2CCED2Actualiser"

Boutons Utilisés

BoutonTypeDescription
playersZAUCTIONHOUSE_ADMIN_PLAYERSListe paginée des joueurs ayant une activité d'enchères. Un clic ouvre l'historique admin du joueur
sortZAUCTIONHOUSE_ADMIN_PLAYERS_SORTChange l'ordre de tri de la liste des joueurs
refreshZAUCTIONHOUSE_ADMIN_MAINRecharge les données et rouvre l'annuaire

ZAUCTIONHOUSE_ADMIN_PLAYERS

Bouton paginé qui affiche un objet par joueur (utilisez PLAYER_HEAD avec player-head: "%target%" pour afficher la tête du joueur). Les contrôles de pagination proviennent du pattern zauctionhouse-pagination.

Lorsqu'aucun joueur n'a d'activité d'enchères, le bouton else est affiché à la place (par défaut une BARRIER au slot 22).

Cliquer sur une entrée ouvre l'inventaire admin historique principal de ce joueur, comme /ah admin history <joueur>.

ZAUCTIONHOUSE_ADMIN_PLAYERS_SORT

Fait défiler les modes de tri :

ClicAction
Clic gaucheMode de tri suivant
Clic droitMode de tri précédent
Mode de triOrdre
NomAlphabétique (A-Z, insensible à la casse)
En venteNombre d'annonces en vente, décroissant
VendusNombre de ventes, décroissant
AchetésNombre d'achats, décroissant

Les joueurs ayant la même valeur sont triés par nom. Le mode de tri par défaut est Nom.

ZAUCTIONHOUSE_ADMIN_MAIN

Ouvre l'inventaire admin principal et recharge ses données. Dans admin-main.yml, il sert de bouton Actualiser ; dans admin-history-main.yml, il sert de bouton Tous les joueurs pour revenir à l'annuaire :

  players:
    type: ZAUCTIONHOUSE_ADMIN_MAIN
    slot: 49
    item:
      material: BOOK
      name: "#2CCED2Tous les joueurs"

Placeholders

Entrée joueur (ZAUCTIONHOUSE_ADMIN_PLAYERS)

PlaceholderDescription
%target%Nom du joueur
%listed%Nombre d'annonces actuellement en vente et non expirées
%sold%Nombre de logs PURCHASE où le joueur est le vendeur
%purchased%Nombre de logs PURCHASE où le joueur est l'acheteur (inclut les achats historiques)

Bouton de tri (ZAUCTIONHOUSE_ADMIN_PLAYERS_SORT)

PlaceholderDescription
%name-color%#2CCED2 si le tri par nom est actif, #8c8c8c sinon
%listed-color%#2CCED2 si le tri par objets en vente est actif, #8c8c8c sinon
%sold-color%#2CCED2 si le tri par objets vendus est actif, #8c8c8c sinon
%purchased-color%#2CCED2 si le tri par objets achetés est actif, #8c8c8c sinon

Ce fichier est créé automatiquement au démarrage s'il n'existe pas encore : les installations existantes le reçoivent sans devoir régénérer leurs inventaires.

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.