GroupeZ Docs
AddonszAuctionHouseStats

zAuctionHouseStats

Statistiques de ventes, classements, historique des prix des objets et statistiques joueurs pour zAuctionHouse V4

zAuctionHouseStats est l'addon officiel de statistiques pour zAuctionHouse V4. Il enregistre chaque mise en vente, vente et achat effectué sur votre hôtel des ventes, puis transforme ces données en classements, statistiques par joueur, références de prix des objets, interfaces zMenu et placeholders PlaceholderAPI.

Il est conçu pour ne jamais ralentir votre serveur. Chaque affichage (commandes, menus, placeholders) est servi depuis un cache, et tout le travail en base de données s'exécute sur un unique thread dédié en arrière-plan. Il est également sûr en réseau : plusieurs serveurs peuvent partager une même base MySQL/MariaDB sans compter une vente deux fois.

Ce qu'il fait

Classements

Classez vos joueurs selon 6 métriques, chacune disponible sur 4 périodes et filtrable par économie :

MétriqueClasse les joueurs selon
TOP_SELLERS_MONEYL'argent réellement reçu en tant que vendeur, après taxes
TOP_BUYERS_MONEYL'argent réellement payé en tant qu'acheteur, taxes incluses
TOP_SELLERS_COUNTLe nombre de ventes réalisées
TOP_BUYERS_COUNTLe nombre d'achats réalisés
TOP_TAX_PAIDLe total des taxes payées (part de taxe à l'achat et taxe de mise en vente)
BIGGEST_SALELa plus grosse vente unique reçue en tant que vendeur
PériodeFenêtre
DAYAujourd'hui, depuis minuit
WEEKCette semaine, depuis lundi
MONTHCe mois-ci, depuis le 1er
ALLDepuis toujours

Les périodes sont des fenêtres calendaires, calculées dans le fuseau horaire défini dans statistics.timezone (ou celui du serveur). Les classements d'argent sont toujours calculés par économie : les montants de différentes économies ne sont jamais additionnés.

Statistiques joueur

Chaque joueur dispose d'un profil complet : objets mis en vente, vendus, achetés, expirés et retirés, argent gagné et dépensé, taxes payées, plus grosse vente, ainsi que les dates de sa première et dernière vente et de son premier et dernier achat. Les joueurs peuvent consulter leur propre profil, et l'équipe peut consulter celui de n'importe quel joueur, y compris hors ligne.

Historique des prix des objets

L'addon enregistre le matériau (et le custom model data) de chaque objet vendu, ce qui lui permet d'afficher le nombre de ventes, le prix moyen et le prix médian de n'importe quel objet. Les joueurs peuvent consulter l'objet qu'ils tiennent en main avec /ah price, ou parcourir les objets les plus vendus dans le menu d'exploration des prix.

Statistiques globales du serveur

Des compteurs globaux pour tout l'hôtel des ventes : objets mis en vente, vendus, expirés et retirés, volume d'argent total, taxes collectées, nombre d'ouvertures de l'hôtel des ventes, et la plus grosse vente jamais réalisée.

Interfaces prêtes à l'emploi

Cinq inventaires zMenu sont inclus et entièrement personnalisables : un hub de statistiques avec un podium du top 3, les classements, le profil de statistiques du joueur, l'explorateur de prix des objets et un menu de statut administrateur. Ils sont générés en anglais, français, espagnol ou italien.

Placeholders

Chaque statistique est disponible sous forme de placeholder %zahstats_...% (familles top_, player_, global_ et material_). Les placeholders n'interrogent jamais la base de données lorsqu'ils sont affichés : ils montrent un texte de chargement jusqu'à ce que la valeur soit prête, puis la lisent depuis le cache.

Compatibilité V1

Vous venez de l'ancien zAuctionHouseStats V1 ? Les noms de placeholders V1 continuent de fonctionner grâce à une couche de compatibilité (désactivable avec placeholders.enable-v1-aliases), et votre historique V1 peut être importé avec /zahstats import v1. L'historique existant de zAuctionHouse V4 peut aussi être importé depuis ses logs avec /zahstats import v4logs.

Fonctionnalités clés

FonctionnalitéDescription
6 classements x 4 périodesClassements journaliers, hebdomadaires, mensuels et depuis toujours, par économie
Profils joueurs13 statistiques par joueur, consultables dans le chat, en GUI ou via les placeholders
Prix des objetsNombre de ventes, prix moyen et prix médian par objet
Commandes intégrées/zahstats ainsi que /ah stats et /ah price ajoutées à la commande de zAuctionHouse
Interfaces zMenu5 inventaires, 11 types de boutons personnalisés, 2 patterns
PlaceholderAPIPlaceholders %zahstats_*%, ainsi que les noms de placeholders V1
Conception sans lagLectures en cache, écritures groupées sur un thread dédié, aucune requête SQL sur le thread principal ou les threads de région
Compatible multi-serveursLes compteurs sont écrits sous forme d'incréments atomiques, plusieurs serveurs peuvent donc partager une même base de données
Base de données propreStockage SQLite, MySQL ou MariaDB séparé (tables préfixées par zahstats_ par défaut), jamais les tables de zAuctionHouse
Import d'historiqueImport depuis zAuctionHouseStats V1 ou depuis les logs de zAuctionHouse V4
RétentionPurge quotidienne optionnelle des anciennes lignes de ventes et de mises en vente, tout en conservant les agrégats journaliers, les classements et les totaux depuis toujours
FoliaEntièrement supporté
API publiqueUn service StatsManager pour les autres plugins

Prérequis

PrérequisVersion
Java21 ou supérieur
Minecraft1.21+
zAuctionHouseV4, 4.0.1.5 ou plus récent recommandé
zMenuRequis (l'addon se désactive si zMenu ne fonctionne pas)
PlaceholderAPIOptionnel, nécessaire uniquement pour utiliser les placeholders %zahstats_*% dans d'autres plugins (ils fonctionnent toujours dans les inventaires zMenu de l'addon)

Logiciels serveur supportés

LogicielStatut
PaperRecommandé
FoliaEntièrement supporté
Forks de Paper (Purpur, Pufferfish, ...)Supportés
SpigotNon supporté (l'addon utilise l'API Paper)

zAuctionHouse V4 uniquement

Cet addon ne fonctionne pas avec zAuctionHouse V3. Si zAuctionHouse est absent, désactivé ou n'est pas en V4, l'addon s'arrête au démarrage et en explique la raison dans la console.

Collecte des données

zAuctionHouseStats propose deux façons de collecter les données. Une seule d'entre elles est active sur un serveur à un instant donné, une vente ne peut donc jamais être comptée deux fois.

SourceQuand elle est utiliséePrécision
Événements zAuctionHouse (par défaut)zAuctionHouse 4.0.1.5 ou plus récentExacte : montants réellement payés et reçus, taxes, détails de l'objet
Lecture des logs (solution de repli)Anciennes versions de zAuctionHouse V4, uniquement si collection.polling.enabled vaut truePrix approximatifs
  • Mode événements : l'addon écoute les événements déclenchés par zAuctionHouse après une mise en vente, un achat, une récupération d'argent ou une ouverture de l'hôtel des ventes, ainsi que les expirations et retraits d'objets. Les événements sont mis en file d'attente en mémoire et écrits en base de données par lots (toutes les 2 secondes par défaut, ou plus tôt lors des pics d'activité).
  • Mode lecture des logs : si la version installée de zAuctionHouse ne déclenche pas ces événements, l'addon peut à la place lire la table des logs de zAuctionHouse à intervalle régulier. Ce mode n'est jamais activé par défaut. En réseau, activez-le sur un seul serveur.

La source est choisie avec collection.mode (AUTO, EVENTS ou LOGS_POLLING). Avec la valeur par défaut AUTO, l'addon utilise les événements lorsqu'ils existent. Sinon, et si la lecture des logs n'est pas autorisée, l'addon se désactive et vous demande de mettre à jour zAuctionHouse.

Vous gérez un réseau ?

Utilisez le stockage MYSQL ou MARIADB et faites pointer tous les serveurs vers la même base de données. Si l'addon détecte zAuctionHouseRedis alors que vous utilisez SQLite, il vous avertit que chaque serveur ne verra que ses propres statistiques. Voir aussi la page de l'addon zAuctionHouse Redis.

Étapes suivantes

  • Installation - Installer l'addon et configurer sa base de données
  • Commandes & Permissions - Toutes les commandes /zahstats, /ah stats et /ah price
  • Placeholders - La référence complète des %zahstats_*% et les noms V1
  • Configuration - Chaque option de config.yml expliquée
  • Inventaires - Personnaliser les interfaces et les types de boutons personnalisés
  • Migration - Importer votre historique V1 ou zAuctionHouse V4
  • API - Utiliser les statistiques depuis votre propre plugin

Installer zAuctionHouse

Comment télécharger, installer et configurer zAuctionHouse sur votre serveur Minecraft

Installer zAuctionHouseStats

Comment installer zAuctionHouseStats, configurer sa base de données et vérifier que les statistiques sont collectées

Sur cette page

Ce qu'il faitClassementsStatistiques joueurHistorique des prix des objetsStatistiques globales du serveurInterfaces prêtes à l'emploiPlaceholdersCompatibilité V1Fonctionnalités clésPrérequisLogiciels serveur supportésCollecte des donnéesÉtapes suivantes
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.