GroupeZ Docs
Inventories

Boutons

Tous les types de boutons disponibles pour les inventaires de zAuctionHouse

Cette page liste tous les types de boutons disponibles dans zAuctionHouse. Chaque type de bouton possède des fonctionnalités et des options de configuration spécifiques.

Tous les inventaires de zAuctionHouse sont propulsés par zMenu. Pour la configuration générale des boutons zMenu (objets, emplacements, lore, etc.), consultez la documentation zMenu.

Boutons d'Affichage des Objets

Ces boutons affichent et gèrent les objets de l'hôtel des ventes.

TypeDescriptionUtilisé dans
ZAUCTIONHOUSE_LISTED_ITEMSAffiche tous les objets en vente avec paginationEnchères
ZAUCTIONHOUSE_EXPIRED_ITEMSAffiche les objets expirés du joueurObjets Expirés
ZAUCTIONHOUSE_PURCHASED_ITEMSAffiche les objets achetés du joueurObjets Achetés
ZAUCTIONHOUSE_SELLING_ITEMSAffiche les objets en vente du joueurObjets en Vente
ZAUCTIONHOUSE_COMBINED_ITEMSCombine les objets en vente, expirés et achetés dans une seule vueItems Combinés
ZAUCTIONHOUSE_HISTORY_ITEMSAffiche l'historique des ventes du joueurHistorique

ZAUCTIONHOUSE_LISTED_ITEMS

Affiche tous les objets actuellement en vente dans l'hôtel des ventes. Supporte la pagination, le filtrage par catégorie et le tri.

Configuration :

PropriétéTypeDescription
slotsListeEmplacements où les objets sont affichés (ex. 9-17, 18-26)
empty-slotNombreEmplacement pour le placeholder "aucun objet"
itemItemPlaceholder affiché quand aucun objet n'existe

Exemple :

displayItems:
  type: ZAUCTIONHOUSE_LISTED_ITEMS
  empty-slot: 22
  slots:
    - 9-17
    - 18-26
    - 27-35
    - 36-44
  item:
    material: BARRIER
    name: '#ff0000&nNo items found'

Actions au clic :

ClicAction
Q (jeter) ou clic molette sur une annonce, avec la permission zauctionhouse.admin.remove.inventoryOuvre la confirmation de retrait admin. Vérifié avant l'aperçu du conteneur et avant les actions d'achat / de retrait
Clic droit (action.container-preview.click) sur une annonce contenant un conteneurOuvre l'aperçu du contenu sans vérifier l'argent
N'importe quel clic sur l'annonce d'un autre joueurOuvre la confirmation d'achat (si le joueur a assez d'argent)
N'importe quel clic sur sa propre annonceRetire l'annonce (via une confirmation avec remove-listed-item.open-confirm-inventory)

Voir Aperçu des conteneurs pour changer ou désactiver le clic d'aperçu.


ZAUCTIONHOUSE_EXPIRED_ITEMS

Affiche les objets expirés que le joueur peut récupérer. Cliquez sur un objet pour le récupérer.

Configuration :

PropriétéTypeDescription
slotsListeEmplacements où les objets sont affichés
empty-slotNombreEmplacement pour le placeholder "aucun objet"
itemItemPlaceholder affiché quand aucun objet n'existe

Exemple :

items:
  type: ZAUCTIONHOUSE_EXPIRED_ITEMS
  empty-slot: 22
  slots:
    - 9-17
    - 18-26
    - 27-35
    - 36-44
  item:
    material: BARRIER
    name: '#ff0000&nNo items found'

ZAUCTIONHOUSE_PURCHASED_ITEMS

Affiche les objets que le joueur a achetés mais pas encore récupérés.

Configuration :

PropriétéTypeDescription
slotsListeEmplacements où les objets sont affichés
empty-slotNombreEmplacement pour le placeholder "aucun objet"
itemItemPlaceholder affiché quand aucun objet n'existe

Exemple :

items:
  type: ZAUCTIONHOUSE_PURCHASED_ITEMS
  empty-slot: 22
  slots:
    - 9-17
    - 18-26
    - 27-35
    - 36-44
  item:
    material: BARRIER
    name: '#ff0000&nNo items found'

ZAUCTIONHOUSE_SELLING_ITEMS

Affiche les objets que le joueur a actuellement en vente. Cliquez pour retirer un objet de la vente.

Configuration :

PropriétéTypeDescription
slotsListeEmplacements où les objets sont affichés
empty-slotNombreEmplacement pour le placeholder "aucun objet"
itemItemPlaceholder affiché quand aucun objet n'existe

Exemple :

items:
  type: ZAUCTIONHOUSE_SELLING_ITEMS
  empty-slot: 22
  slots:
    - 9-17
    - 18-26
    - 27-35
    - 36-44
  item:
    material: BARRIER
    name: '#ff0000&nNo items found'

ZAUCTIONHOUSE_COMBINED_ITEMS

Combine les objets en vente, expirés et achetés dans une seule vue paginée. L'action au clic s'adapte automatiquement au type de stockage de l'objet.

Configuration :

PropriétéTypeDescription
slotsListeEmplacements où les objets sont affichés (ex. 9-17, 18-26)
empty-slotNombreEmplacement pour le placeholder "aucun objet" (-1 pour désactiver)
include-sellingBooléenInclure les objets actuellement en vente (défaut : true)
include-expiredBooléenInclure les objets expirés (défaut : true)
include-purchasedBooléenInclure les objets achetés (défaut : true)
itemItemPlaceholder affiché quand aucun objet n'existe

Exemple :

items:
  type: ZAUCTIONHOUSE_COMBINED_ITEMS
  empty-slot: 22
  include-selling: true
  include-expired: true
  include-purchased: true
  slots:
    - 9-17
    - 18-26
    - 27-35
    - 36-44
  item:
    material: BARRIER
    name: '#ff0000&nAucun objet trouvé'

Comportement au clic :

  • Objets en vente (statut AVAILABLE) : Retire/annule la mise en vente
  • Objets expirés (statut REMOVED) : Récupère l'objet
  • Objets achetés (statut PURCHASED) : Récupère l'objet acheté

Chaque type d'objet utilise automatiquement sa lore correspondante depuis config.yml (selling-item, expired-item, purchased-item, being-purchased-item).


ZAUCTIONHOUSE_HISTORY_ITEMS

Affiche l'historique des ventes du joueur (objets qu'il a vendus).

Configuration :

PropriétéTypeDescription
slotsListeEmplacements où les objets sont affichés
loading-slotNombreEmplacement pour l'indicateur de chargement
itemItemPlaceholder de chargement
elseObjetConfiguration quand aucun historique n'existe

Exemple :

items:
  type: ZAUCTIONHOUSE_HISTORY_ITEMS
  loading-slot: 22
  slots:
    - 9-17
    - 18-26
    - 27-35
    - 36-44
  item:
    material: BARRIER
    name: "#ff0000Loading..."
  else:
    slots:
      - 22
    item:
      material: BARRIER
      name: '#ff0000&nNo Sales Found'

Boutons de Navigation

Ces boutons ouvrent d'autres inventaires.

TypeDescriptionUtilisé dans
ZAUCTIONHOUSE_EXPIRED_INVENTORYOuvre l'inventaire des objets expirésEnchères
ZAUCTIONHOUSE_PURCHASED_INVENTORYOuvre l'inventaire des objets achetésEnchères
ZAUCTIONHOUSE_SELLING_INVENTORYOuvre l'inventaire des objets en venteEnchères
ZAUCTIONHOUSE_HISTORY_INVENTORYOuvre l'inventaire de l'historique des ventesEnchères
ZAUCTIONHOUSE_CATEGORYOuvre les enchères filtrées par catégorieCatégories
ZAUCTIONHOUSE_CATEGORY_SWITCHERParcourt les catégories avec clic gauche/droitEnchères
ZAUCTIONHOUSE_SEARCHOuvre la saisie de recherche (chat ou dialog)Enchères
ZAUCTIONHOUSE_CLEAR_SEARCHEfface le filtre de recherche actifEnchères

ZAUCTIONHOUSE_EXPIRED_INVENTORY

Ouvre l'inventaire des objets expirés. Affiche des objets différents selon que le joueur possède ou non des objets expirés.

Configuration :

PropriétéTypeDescription
slotNombrePosition du bouton
itemItemAffiché quand le joueur A des objets expirés
else.itemItemAffiché quand le joueur N'A PAS d'objets expirés
open-when-emptyBooléenOuvre l'inventaire même quand la liste est vide (défaut : false). À mettre sur le bouton else, avec le même type, pour que le bouton « aucun objet » reste cliquable

Placeholders :

  • %expired-items% - Nombre d'objets expirés
  • %s% - Suffixe de pluralisation ("" pour 1, "s" pour 2+)

Exemple :

expired-items:
  type: ZAUCTIONHOUSE_EXPIRED_INVENTORY
  slot: 45
  item:
    url: "eyJ0ZXh0dXJlcy..."
    name: "#2CCED2<bold>ᴇxᴘɪʀᴇᴅ ɪᴛᴇᴍs"
    lore:
      - "#92ffffYou have #2CCED2%expired-items% #92ffffexpired item%s%."
      - ""
      - "#8c8c8c• #2CCED2Click #92ffffto open"
  else:
    type: ZAUCTIONHOUSE_EXPIRED_INVENTORY
    open-when-empty: true
    item:
      url: "eyJ0ZXh0dXJlcy..."
      name: "#2CCED2<bold>ᴇxᴘɪʀᴇᴅ ɪᴛᴇᴍs"
      lore:
        - "#ff3535You have no expired items."

ZAUCTIONHOUSE_PURCHASED_INVENTORY

Ouvre l'inventaire des objets achetés.

Configuration :

PropriétéTypeDescription
slotNombrePosition du bouton
itemItemAffiché quand le joueur A des objets achetés
else.itemItemAffiché quand le joueur N'A PAS d'objets achetés
open-when-emptyBooléenOuvre l'inventaire même quand la liste est vide (défaut : false). À mettre sur le bouton else, avec le même type, pour que le bouton « aucun objet » reste cliquable

Placeholders :

  • %purchased-items% - Nombre d'objets achetés
  • %s% - Suffixe de pluralisation

Exemple :

purchased-items:
  type: ZAUCTIONHOUSE_PURCHASED_INVENTORY
  slot: 46
  item:
    url: "eyJ0ZXh0dXJlcy..."
    name: "#2CCED2<bold>ᴘᴜʀᴄʜᴀsᴇᴅ ɪᴛᴇᴍs"
    lore:
      - "#92ffffYou have #2CCED2%purchased-items% #92ffffbought item%s%."
      - ""
      - "#8c8c8c• #2CCED2Click #92ffffto open"
  else:
    type: ZAUCTIONHOUSE_PURCHASED_INVENTORY
    open-when-empty: true
    item:
      url: "eyJ0ZXh0dXJlcy..."
      name: "#2CCED2<bold>ᴘᴜʀᴄʜᴀsᴇᴅ ɪᴛᴇᴍs"
      lore:
        - "#ff3535You have no purchased items."

ZAUCTIONHOUSE_SELLING_INVENTORY

Ouvre l'inventaire affichant les objets que le joueur a actuellement en vente.

Configuration :

PropriétéTypeDescription
slotNombrePosition du bouton
itemItemAffiché quand le joueur A des objets en vente
else.itemItemAffiché quand le joueur N'A PAS d'objets en vente
open-when-emptyBooléenOuvre l'inventaire même quand la liste est vide (défaut : false). À mettre sur le bouton else, avec le même type, pour que le bouton « aucun objet » reste cliquable

Placeholders :

  • %selling-items% - Nombre d'objets en vente
  • %s% - Suffixe de pluralisation

Exemple :

selling-items:
  type: ZAUCTIONHOUSE_SELLING_INVENTORY
  slot: 53
  item:
    url: "eyJ0ZXh0dXJlcy..."
    name: "#2CCED2<bold>ʏᴏᴜʀ ɪᴛᴇᴍs"
    lore:
      - "#92ffffYou have #2CCED2%selling-items% #92ffffitem%s% on sale."
      - ""
      - "#8c8c8c• #2CCED2Click #92ffffto open"
  else:
    type: ZAUCTIONHOUSE_SELLING_INVENTORY
    open-when-empty: true
    item:
      url: "eyJ0ZXh0dXJlcy..."
      name: "#2CCED2<bold>ʏᴏᴜʀ ɪᴛᴇᴍs"
      lore:
        - "#ff3535You have no items for sale."

ZAUCTIONHOUSE_HISTORY_INVENTORY

Ouvre l'inventaire de l'historique des ventes.

Configuration :

PropriétéTypeDescription
slotNombrePosition du bouton
itemItemApparence du bouton

Exemple :

history:
  type: ZAUCTIONHOUSE_HISTORY_INVENTORY
  slot: 47
  item:
    material: BOOK
    name: "#2CCED2<bold>sᴀʟᴇs ʜɪsᴛᴏʀʏ"
    lore:
      - "#92ffffView your sales history."
      - ""
      - "#8c8c8c• #2CCED2Click #92ffffto open"

ZAUCTIONHOUSE_CATEGORY

Ouvre l'hôtel des ventes filtré par une catégorie spécifique.

Configuration :

PropriétéTypeDescription
slotNombrePosition du bouton
categoryChaîneNom de la catégorie (doit correspondre à categories.yml)
itemItemApparence du bouton

Catégories spéciales :

  • all - Affiche tous les objets (sans filtrage)

Placeholders :

  • %zauctionhouse_category_count_<name>% - Nombre d'objets dans la catégorie

Exemple :

weapons:
  type: ZAUCTIONHOUSE_CATEGORY
  category: weapons
  slot: 20
  item:
    material: DIAMOND_SWORD
    name: "#ff5555<bold>ᴡᴇᴀᴘᴏɴs"
    lore:
      - "#92ffffCombat equipment"
      - ""
      - "#92ffffItems#8c8c8c: #2CCED2%zauctionhouse_category_count_weapons%"
      - ""
      - "#8c8c8c• #2CCED2Click #92ffffto browse"

ZAUCTIONHOUSE_CATEGORY_SWITCHER

Parcourt les catégories en utilisant le clic gauche/droit. Affiche un lore dynamique montrant l'état activé/désactivé de chaque catégorie.

Configuration :

PropriétéTypeDescription
slotNombrePosition du bouton
enable-textChaîneFormat pour la catégorie actuellement sélectionnée
disable-textChaîneFormat pour les catégories non sélectionnées
categoriesListeListe des identifiants de catégories à parcourir
itemItemApparence du bouton

Placeholders :

  • %category% - Nom d'affichage de la catégorie actuelle
  • %<category-id>% - Remplacé par enable-text ou disable-text pour chaque catégorie

Exemple :

category-switcher:
  type: ZAUCTIONHOUSE_CATEGORY_SWITCHER
  slot: 49
  enable-text: "&a● %category%"
  disable-text: "&7○ %category%"
  categories:
    - "main"
    - "weapons"
    - "armor"
    - "tools"
    - "blocks"
    - "consumables"
    - "resources"
    - "enchanted-books"
    - "misc"
  item:
    material: COMPASS
    name: "&6Categories &7(&f%category%&7)"
    lore:
      - ""
      - "%main%"
      - "%weapons%"
      - "%armor%"
      - "%tools%"
      - "%blocks%"
      - "%consumables%"
      - "%resources%"
      - "%enchanted-books%"
      - "%misc%"
      - ""
      - "&7Left-click &8» &fNext"
      - "&7Right-click &8» &fPrevious"

Utilisez "main" comme identifiant de catégorie pour représenter "Tous les objets" (sans filtrage).


Boutons de Recherche

TypeDescriptionUtilisé dans
ZAUCTIONHOUSE_SEARCHOuvre la saisie de recherche (chat ou dialog)Enchères
ZAUCTIONHOUSE_CLEAR_SEARCHEfface le filtre de recherche actifEnchères

Ouvre une saisie de recherche par chat. Lorsque le joueur clique, son inventaire se ferme et il peut taper une requête de recherche dans le chat. Supporte des opérateurs de filtre avancés pour des recherches ciblées.

Configuration :

PropriétéTypeDescription
slotNombrePosition du bouton
none-valueTexteTexte affiché dans %search_query% quand aucune recherche n'est active. Par défaut None ; traduit selon la langue (FR Aucune, ES Ninguna, IT Nessuna, TH ไม่มี).
active-valueTexteTexte affiché dans %search_active% quand une recherche est active. Par défaut true.
inactive-valueTexteTexte affiché dans %search_active% quand aucune recherche n'est active. Par défaut false.
dialog.enabledBooléenOuvre un dialog de recherche au lieu de la saisie par chat (par défaut : false). Voir Dialog de recherche
itemItemApparence du bouton

Placeholders :

  • %search_query% - Requête de recherche actuelle (ou la valeur none-value configurable, par défaut None / traduite, quand aucune recherche n'est active)
  • %search_active% - Indique si une recherche est active (les valeurs active-value / inactive-value configurables, par défaut true / false)

Opérateurs de recherche :

OpérateurDescription
~Contient (sensible à la casse)
=Correspondance exacte (sensible à la casse)
~=Contient (insensible à la casse)
==Correspondance exacte (insensible à la casse)

Champs recherchables : name, material, lore, seller

Exemple :

search:
  type: ZAUCTIONHOUSE_SEARCH
  slot: 47
  is-permanent: true
  # Valeur affichée dans %search_query% lorsqu'aucune recherche n'est active.
  none-value: "Aucune"
  # Valeur affichée dans %search_active% lorsqu'une recherche est active.
  active-value: "true"
  # Valeur affichée dans %search_active% lorsqu'aucune recherche n'est active.
  inactive-value: "false"
  item:
    material: COMPASS
    name: "#2CCED2<bold>sᴇᴀʀᴄʜ"
    lore:
      - ""
      - "#92ffffCurrent search#8c8c8c: #2CCED2%search_query%"
      - ""
      - "#92ffffFilters#8c8c8c:"
      - "#8c8c8c  name #76CDCD~ #8c8c8cvalue    #555555(contains)"
      - "#8c8c8c  name #76CDCD= #8c8c8cvalue    #555555(exact)"
      - "#8c8c8c  name #76CDCD~= #8c8c8cvalue   #555555(contains, ignore case)"
      - "#8c8c8c  name #76CDCD== #8c8c8cvalue   #555555(exact, ignore case)"
      - ""
      - "#92ffffFields#8c8c8c: #76CDCDname#8c8c8c, #76CDCDmaterial#8c8c8c, #76CDCDlore#8c8c8c, #76CDCDseller"
      - ""
      - "#92ffffExamples#8c8c8c:"
      - "#8c8c8c  seller #76CDCD= #8c8c8cNotch"
      - "#8c8c8c  name #76CDCD~ #8c8c8cDiamond"
      - ""
      - "#8c8c8c• #2CCED2Click #92ffffto search"

Sans opérateur, la recherche effectue une correspondance de sous-chaîne insensible à la casse sur le nom de l'objet, le matériau, le lore et le nom du vendeur simultanément.

Dialog de recherche

Avec dialog.enabled: true, un clic sur le bouton ouvre un dialog natif de Paper (fourni par zMenu) au lieu de demander la recherche dans le chat. Le champ texte est pré-rempli avec la recherche actuelle (256 caractères maximum) et le dialog propose trois boutons : Rechercher, Effacer (supprime la recherche active) et Annuler (retour à l'hôtel des ventes). Si le dialog ne peut pas être chargé, la saisie par chat est utilisée.

search:
  type: ZAUCTIONHOUSE_SEARCH
  dialog:
    enabled: true

Le dialog se configure dans dialogs/search.yml, fourni dans chaque langue :

name: Recherche
type: multi_action
can-close-with-escape: true
pause: false
after-action: CLOSE
number-of-columns: 3
body:
  description:
    type: plain_message
    messages:
    - <gray>Saisissez un nom ou un filtre, par exemple seller = Notch.
    width: 350
query-label: Recherche
search-label: <aqua>Rechercher
clear-label: <yellow>Effacer
cancel-label: <red>Annuler
multi-actions:
  search:
    label: <aqua>Rechercher
  clear:
    label: <yellow>Effacer
  cancel:
    label: <red>Annuler

Efface le filtre de recherche actif. Ce bouton n'est visible que lorsque le joueur a une requête de recherche active.

Configuration :

PropriétéTypeDescription
slotNombrePosition du bouton
itemItemApparence du bouton

Placeholders :

  • %search_query% - Requête de recherche actuelle

Exemple :

clear-search:
  type: ZAUCTIONHOUSE_CLEAR_SEARCH
  slot: 48
  is-permanent: true
  item:
    material: BARRIER
    name: "#ff6b6b<bold>ᴄʟᴇᴀʀ sᴇᴀʀᴄʜ"
    lore:
      - ""
      - "#92ffffSearching for#8c8c8c: #2CCED2%search_query%"
      - ""
      - "#8c8c8c• #2CCED2Click #92ffffto clear search"

Bouton de Réclamation

TypeDescriptionUtilisé dans
ZAUCTIONHOUSE_CLAIMAffiche l'argent en attente et permet de le réclamerEnchères

ZAUCTIONHOUSE_CLAIM

Affiche l'argent en attente du joueur provenant des ventes et lui permet de le réclamer en un seul clic. Affiche les montants par économie en utilisant des placeholders dynamiques et supporte un état de chargement pendant la récupération des données.

Configuration :

PropriétéTypeDescription
slotNombrePosition du bouton
loading-itemItemAffiché pendant le chargement des données d'argent en attente
itemItemApparence normale du bouton avec les placeholders d'argent en attente

Placeholders :

PlaceholderDescription
%pending_total%Total de l'argent en attente pour toutes les économies (formaté)
%pending_<economy_name>%Argent en attente pour une économie spécifique (ex. %pending_vault%)
%has_pending%true ou false

Le nom de l'économie correspond au champ name défini dans votre configuration economies.yml. Par exemple, si vous avez une économie avec name: vault, utilisez %pending_vault%.

Exemple :

claim-money:
  type: ZAUCTIONHOUSE_CLAIM
  slot: 48
  loading-item:
    material: CLOCK
    name: "#2CCED2<bold>ᴄʟᴀɪᴍ ᴍᴏɴᴇʏ"
    lore:
      - "#8c8c8c• #ff3535Loading, please wait..."
  item:
    material: GOLD_INGOT
    name: "#2CCED2<bold>ᴄʟᴀɪᴍ ᴍᴏɴᴇʏ"
    lore:
      - ""
      - "#92ffffPending money#8c8c8c: #2CCED2%pending_total%"
      - ""
      - "#8c8c8c• #2CCED2Click #92ffffto claim your money"

Exemple multi-économie :

claim-money:
  type: ZAUCTIONHOUSE_CLAIM
  slot: 48
  loading-item:
    material: CLOCK
    name: "#2CCED2<bold>ᴄʟᴀɪᴍ ᴍᴏɴᴇʏ"
    lore:
      - "#8c8c8c• #ff3535Loading, please wait..."
  item:
    material: GOLD_INGOT
    name: "#2CCED2<bold>ᴄʟᴀɪᴍ ᴍᴏɴᴇʏ"
    lore:
      - ""
      - "#92ffffVault#8c8c8c: #2CCED2%pending_vault%"
      - "#92ffffTokens#8c8c8c: #2CCED2%pending_tokens%"
      - "#92ffffTotal#8c8c8c: #2CCED2%pending_total%"
      - ""
      - "#8c8c8c• #2CCED2Click #92ffffto claim your money"

Boutons de Tri

TypeDescriptionUtilisé dans
ZAUCTIONHOUSE_CHANGE_SORTChange l'ordre de tri des objets en venteEnchères
ZAUCTIONHOUSE_HISTORY_SORTChange l'ordre de tri de l'historiqueHistorique

ZAUCTIONHOUSE_CHANGE_SORT

Parcourt les options de tri disponibles pour l'hôtel des ventes.

Configuration :

PropriétéTypeDescription
slotNombrePosition du bouton
sortsListeOptions de tri disponibles
enable-textChaîneFormat pour l'option de tri sélectionnée
disable-textChaîneFormat pour les options de tri non sélectionnées
loading-itemItemAffiché pendant le tri
itemItemApparence du bouton

Options de tri :

  • DECREASING_DATE - Plus récent en premier
  • INCREASING_DATE - Plus ancien en premier
  • DECREASING_PRICE - Plus cher en premier
  • INCREASING_PRICE - Moins cher en premier

Exemple :

change-sort:
  type: ZAUCTIONHOUSE_CHANGE_SORT
  slot: 52
  sorts:
    - DECREASING_DATE
    - DECREASING_PRICE
    - ASCENDING_DATE
    - ASCENDING_PRICE
  enable-text: ' #F27438➜ %sorting%'
  disable-text: ' #76CDCD➜ %sorting%'
  loading-item:
    material: HOPPER
    name: "#2CCED2<bold>sᴏʀᴛ ᴛʏᴘᴇ"
    lore:
      - "#8c8c8c• #ff3535Loading, please wait"
  item:
    material: HOPPER
    name: "#2CCED2<bold>sᴏʀᴛ ᴛʏᴘᴇ"
    lore:
      - "#92ffffAvailable sort types:"
      - "%DECREASING_DATE%"
      - "%DECREASING_PRICE%"
      - "%ASCENDING_DATE%"
      - "%ASCENDING_PRICE%"
      - ""
      - "#8c8c8c• #2CCED2Click #92ffffto change the sort type"

ZAUCTIONHOUSE_HISTORY_SORT

Parcourt les options de tri pour l'historique des ventes.

Configuration :

PropriétéTypeDescription
slotNombrePosition du bouton
sortsListeOptions de tri disponibles
sort-namesMapNoms d'affichage pour les options de tri
enable-textChaîneFormat pour l'option de tri sélectionnée
disable-textChaîneFormat pour les options de tri non sélectionnées
itemItemApparence du bouton

Options de tri :

  • DATE_DESC - Plus récent en premier
  • DATE_ASC - Plus ancien en premier
  • PRICE_DESC - Prix le plus élevé en premier
  • PRICE_ASC - Prix le plus bas en premier
  • BUYER_ASC - Nom de l'acheteur A-Z
  • BUYER_DESC - Nom de l'acheteur Z-A

Exemple :

sort:
  type: ZAUCTIONHOUSE_HISTORY_SORT
  slot: 51
  enable-text: ' #F27438➜ %sorting%'
  disable-text: ' #76CDCD➜ %sorting%'
  sorts:
    - DATE_DESC
    - DATE_ASC
    - PRICE_DESC
    - PRICE_ASC
  sort-names:
    DATE_DESC: "Newest First"
    DATE_ASC: "Oldest First"
    PRICE_DESC: "Highest Price"
    PRICE_ASC: "Lowest Price"
  item:
    material: HOPPER
    name: "#2CCED2<bold>sᴏʀᴛ"
    lore:
      - "#92ffffAvailable sort types:"
      - "%DATE_DESC%"
      - "%DATE_ASC%"
      - "%PRICE_DESC%"
      - "%PRICE_ASC%"
      - ""
      - "#8c8c8c• #2CCED2Click #92ffffto change the sort type"

Boutons de l'Inventaire de Vente

Ces boutons sont utilisés dans l'inventaire de vente.

TypeDescriptionUtilisé dans
ZAUCTIONHOUSE_SELL_SHOW_ITEMAffiche les objets sélectionnésVente
ZAUCTIONHOUSE_SELL_PRICEAjuste le prix de mise en venteVente
ZAUCTIONHOUSE_SELL_ECONOMYSélectionne le type d'économieVente
ZAUCTIONHOUSE_SELL_CONFIRMConfirme la venteVente
ZAUCTIONHOUSE_SELL_CANCELAnnule la venteVente

ZAUCTIONHOUSE_SELL_SHOW_ITEM

Affiche les objets sélectionnés pour la vente.

Configuration :

PropriétéTypeDescription
slotsListeEmplacements pour l'affichage des objets
empty-slotNombreEmplacement pour le placeholder "aucun objet"
itemItemPlaceholder quand aucun objet n'est sélectionné

Exemple :

show-item:
  type: ZAUCTIONHOUSE_SELL_SHOW_ITEM
  slots:
    - 9-44
  empty-slot: 22
  item:
    material: BARRIER
    name: "#ff0000<bold>No Item Selected"
    lore:
      - ""
      - "#8c8c8cHold an item in your hand"
      - "#8c8c8cor select items from your inventory"

ZAUCTIONHOUSE_SELL_PRICE

Ajuste le prix de mise en vente avec différents montants par type de clic.

Configuration :

PropriétéTypeDescription
slotNombrePosition du bouton
amountsMapChangements de prix par type de clic
itemItemApparence du bouton

Types de clic :

  • left-click - Clic gauche classique
  • right-click - Clic droit classique
  • shift-left-click - Maj + clic gauche
  • shift-right-click - Maj + clic droit

Placeholders :

  • %price% - Prix de mise en vente actuel

Exemple (Diminuer) :

price-decrease:
  type: ZAUCTIONHOUSE_SELL_PRICE
  slot: 48
  amounts:
    left-click: -500
    right-click: -100
    shift-left-click: -1000
    shift-right-click: -2500
  item:
    url: eyJ0ZXh0dXJlcy...
    name: "#ff3333-1,000"
    lore:
      - ""
      - "<white>Current price#8c8c8c: #2CCED2%price%"
      - ""
      - "#8c8c8c• #92ffffLeft click#8c8c8c: -500"
      - "#8c8c8c• #92ffffRight click#8c8c8c: -100"
      - "#8c8c8c• #92ffffShift+Left#8c8c8c: -1,000"
      - "#8c8c8c• #92ffffShift+Right#8c8c8c: -2,500"

Exemple (Augmenter) :

price-increase:
  type: ZAUCTIONHOUSE_SELL_PRICE
  slot: 50
  amounts:
    left-click: 500
    right-click: 100
    shift-left-click: 1000
    shift-right-click: 2500
  item:
    url: eyJ0ZXh0dXJlcy...
    name: '#00cc00+1,000'
    lore:
      - '<white>Current price#8c8c8c: #2CCED2%price%'
      - ''
      - '#8c8c8c• #92ffffLeft click#8c8c8c: +500'
      - '#8c8c8c• #92ffffRight click#8c8c8c: +100'
      - '#8c8c8c• #92ffffShift+Left#8c8c8c: +1,000'
      - '#8c8c8c• #92ffffShift+Right#8c8c8c: +2,500'

ZAUCTIONHOUSE_SELL_ECONOMY

Parcourt les économies disponibles.

Avec l'option economy, le bouton ne fait plus défiler les économies : un clic sélectionne cette économie. Ajoutez un bouton par économie pour que le joueur choisisse directement.

Configuration :

PropriétéTypeDescription
slotNombrePosition du bouton
itemItemApparence du bouton
economyTexteOptionnel. Économie sélectionnée au clic au lieu de faire défiler (nom dans economies.yml)

Placeholders :

  • %economy% - Nom d'affichage de l'économie (celle du bouton avec economy, sinon celle sélectionnée)
  • %economy_name% - Nom interne de cette économie
  • %price% - Prix de mise en vente formaté dans cette économie
  • %selected% - true quand cette économie est celle sélectionnée

Exemple :

select-economy:
  type: ZAUCTIONHOUSE_SELL_ECONOMY
  slot: 49
  item:
    url: eyJ0ZXh0dXJlcy...
    name: "#ffd700<bold>Economy"
    lore:
      - ""
      - "<white>Current#8c8c8c: #2CCED2%economy%"
      - ""
      - "#8c8c8c• #92ffffLeft click#8c8c8c: Next economy"
      - "#8c8c8c• #92ffffRight click#8c8c8c: Previous economy"

Un bouton par économie :

select-money:
  type: ZAUCTIONHOUSE_SELL_ECONOMY
  economy: vault
  slot: 48
  item:
    material: GOLD_INGOT
    name: "#ffd700<bold>Argent"
    lore:
      - "<white>Prix#8c8c8c: #2CCED2%price%"
      - "<white>Sélectionnée#8c8c8c: #2CCED2%selected%"

select-levels:
  type: ZAUCTIONHOUSE_SELL_ECONOMY
  economy: level
  slot: 50
  item:
    material: EXPERIENCE_BOTTLE
    name: "#7cfc00<bold>Niveaux"
    lore:
      - "<white>Prix#8c8c8c: #2CCED2%price%"
      - "<white>Sélectionnée#8c8c8c: #2CCED2%selected%"

ZAUCTIONHOUSE_SELL_CONFIRM

Confirme la vente et met les objets en vente.

Avec l'option economy, le bouton vend toujours avec cette économie, quelle que soit l'économie sélectionnée : un bouton de confirmation par économie met l'objet en vente en un clic. Les limites de prix de cette économie s'appliquent : un prix hors limites est refusé. Si l'économie n'existe pas, un avertissement est affiché au chargement de l'inventaire et le clic envoie sell-error-economy.

Configuration :

PropriétéTypeDescription
slotNombrePosition du bouton
itemItemApparence du bouton
economyTexteOptionnel. Vend toujours avec cette économie (nom dans economies.yml)

Placeholders :

  • %economy% - Économie de la vente (celle du bouton avec economy, sinon celle sélectionnée)
  • %economy_name% - Nom interne de cette économie
  • %price% - Prix de mise en vente
  • %item_count% - Nombre d'objets

Exemple :

confirm:
  type: ZAUCTIONHOUSE_SELL_CONFIRM
  slot: 53
  item:
    material: LIME_STAINED_GLASS_PANE
    name: "#00ff00<bold>CONFIRM SALE"
    lore:
      - ""
      - "<white>Economy#8c8c8c: #2CCED2%economy%"
      - "<white>Price#8c8c8c: #2CCED2%price%"
      - "<white>Items#8c8c8c: #2CCED2%item_count%"
      - ""
      - "#8c8c8c• #2CCED2Click #92ffffto confirm the sale"

Un bouton de confirmation par économie :

sell-for-money:
  type: ZAUCTIONHOUSE_SELL_CONFIRM
  economy: vault
  slot: 52
  item:
    material: GOLD_INGOT
    name: "#00ff00<bold>Vendre pour %price%"

sell-for-levels:
  type: ZAUCTIONHOUSE_SELL_CONFIRM
  economy: level
  slot: 53
  item:
    material: EXPERIENCE_BOTTLE
    name: "#00ff00<bold>Vendre pour %price%"

ZAUCTIONHOUSE_SELL_CANCEL

Annule la vente et renvoie les objets au joueur.

Configuration :

PropriétéTypeDescription
slotNombrePosition du bouton
itemItemApparence du bouton

Exemple :

cancel:
  type: ZAUCTIONHOUSE_SELL_CANCEL
  slot: 45
  item:
    material: RED_STAINED_GLASS_PANE
    name: "#ff0000<bold>CANCEL"
    lore:
      - ""
      - "#8c8c8c• #2CCED2Click #92ffffto cancel and return items"

Boutons de Confirmation

TypeDescriptionUtilisé dans
ZAUCTIONHOUSE_CONFIRM_PURCHASEConfirme un achatConfirmation d'Achat
ZAUCTIONHOUSE_CONFIRM_REMOVE_LISTEDConfirme le retrait d'une annonceConfirmation de Retrait
ZAUCTIONHOUSE_SHOWAffiche l'objet de l'enchèreConfirmations

ZAUCTIONHOUSE_CONFIRM_PURCHASE

Confirme l'achat d'un objet.

Configuration :

PropriétéTypeDescription
slotsListeEmplacements du bouton (zone de clic plus grande)
itemItemApparence du bouton

Exemple :

confirm:
  type: ZAUCTIONHOUSE_CONFIRM_PURCHASE
  slots:
    - 0-2
    - 9-11
    - 18-20
  item:
    material: GREEN_STAINED_GLASS_PANE
    name: "#2CCED2<bold>ᴘᴜʀᴄʜᴀsᴇ"
    lore:
      - "#92ffffPurchase this item."
      - ""
      - "#8c8c8c• #2CCED2Click #92ffffto purchase"

ZAUCTIONHOUSE_CONFIRM_REMOVE_LISTED

Confirme le retrait d'un objet de la vente.

Configuration :

PropriétéTypeDescription
slotsListeEmplacements du bouton
itemItemApparence du bouton

Exemple :

remove:
  type: ZAUCTIONHOUSE_CONFIRM_REMOVE_LISTED
  slots:
    - 0-2
    - 9-11
    - 18-20
  item:
    material: GREEN_STAINED_GLASS_PANE
    name: "#2CCED2<bold>ʀᴇᴍᴏᴠᴇ"
    lore:
      - "#92ffffRemove this item."
      - ""
      - "#8c8c8c• #2CCED2Click #92ffffto remove"

ZAUCTIONHOUSE_SHOW

Affiche l'objet de l'enchère en cours de confirmation.

Configuration :

PropriétéTypeDescription
slotNombrePosition d'affichage

Exemple :

show:
  type: ZAUCTIONHOUSE_SHOW
  slot: 13

Boutons de Contenu de Conteneurs

Ces boutons affichent le contenu des objets conteneurs (boîtes de shulker, AxShulkers, etc.). Le système est extensible via l'API ItemContentProvider, permettant aux plugins d'enregistrer des types de conteneurs personnalisés.

TypeDescriptionUtilisé dans
ZAUCTIONHOUSE_SHULKER_OPENOuvre le visualiseur de contenu du conteneurConfirmations
ZAUCTIONHOUSE_SHULKER_CONTENTAffiche le contenu du conteneurContenu Shulker
ZAUCTIONHOUSE_SHULKER_INFOAffiche les informations du conteneurContenu Shulker
ZAUCTIONHOUSE_SHULKER_NAVIGATIONNavigue entre les conteneursContenu Shulker

Types de conteneurs supportés :

  • Boîtes de shulker vanilla - intégré, aucun plugin supplémentaire requis
  • AxShulkers - nécessite le plugin AxShulkers

Les plugins externes peuvent enregistrer des types de conteneurs supplémentaires via l'API :

AuctionPlugin api = getServer().getServicesManager().load(AuctionPlugin.class);
api.getItemContentManager().registerProvider(new MyCustomContentProvider());

ZAUCTIONHOUSE_SHULKER_OPEN

Ouvre l'aperçu du contenu du conteneur. Visible uniquement quand l'objet contient des objets conteneurs reconnus (boîtes de shulker, AxShulkers, etc.).

Le même aperçu peut aussi être ouvert directement depuis l'hôtel des ventes avec un clic droit sur l'annonce, sans passer par la confirmation d'achat : voir Aperçu des conteneurs.

Configuration :

PropriétéTypeDescription
slotNombrePosition du bouton
itemItemApparence du bouton

Exemple :

shulker:
  type: ZAUCTIONHOUSE_SHULKER_OPEN
  slot: 4
  item:
    material: SHULKER_BOX
    name: "#2CCED2<bold>ᴠɪᴇᴡ sʜᴜʟᴋᴇʀ ᴄᴏɴᴛᴇɴᴛ"
    lore:
      - "#92ffffView the content of shulker boxes."
      - ""
      - "#8c8c8c• #2CCED2Click #92ffffto view content"

ZAUCTIONHOUSE_SHULKER_CONTENT

Affiche le contenu de la boîte de shulker actuelle.

Configuration :

PropriétéTypeDescription
slotsListeEmplacements pour l'affichage du contenu

Exemple :

content:
  type: ZAUCTIONHOUSE_SHULKER_CONTENT
  slots:
    - 9-17
    - 18-26
    - 27-35
    - 36-44

ZAUCTIONHOUSE_SHULKER_INFO

Affiche des informations sur le shulker actuel.

Configuration :

PropriétéTypeDescription
slotNombrePosition du bouton
itemItemApparence du bouton

Placeholders :

  • %shulker_current% - Numéro du shulker actuel
  • %shulker_total% - Nombre total de shulkers

Exemple :

shulker-info:
  type: ZAUCTIONHOUSE_SHULKER_INFO
  slot: 4
  item:
    material: SHULKER_BOX
    name: "#2CCED2<bold>sʜᴜʟᴋᴇʀ ʙᴏx"
    lore:
      - "#92ffffViewing shulker #2CCED2%shulker_current% #92ffffof #2CCED2%shulker_total%"

ZAUCTIONHOUSE_SHULKER_NAVIGATION

Navigue entre les shulkers dans les ventes en lot.

Configuration :

PropriétéTypeDescription
slotNombrePosition du bouton
directionChaîneprevious ou next
itemItemApparence du bouton

Exemple :

previous:
  type: ZAUCTIONHOUSE_SHULKER_NAVIGATION
  direction: previous
  slot: 48
  item:
    material: ARROW
    name: "#2CCED2<bold>ᴘʀᴇᴠɪᴏᴜs sʜᴜʟᴋᴇʀ"
    lore:
      - "#92ffffView the previous shulker box."

next:
  type: ZAUCTIONHOUSE_SHULKER_NAVIGATION
  direction: next
  slot: 50
  item:
    material: ARROW
    name: "#2CCED2<bold>ɴᴇxᴛ sʜᴜʟᴋᴇʀ"
    lore:
      - "#92ffffView the next shulker box."

Boutons d'Objets en Lot

TypeDescriptionUtilisé dans
ZAUCTIONHOUSE_ITEM_CONTENTAffiche tous les objets d'une vente en lotConfirmation d'Achat d'Inventaire, Confirmation de Retrait d'Inventaire

ZAUCTIONHOUSE_ITEM_CONTENT

Affiche tous les objets d'une vente en lot. Utilisé dans les inventaires de confirmation pour les achats et retraits en lot.

Configuration :

PropriétéTypeDescription
slotsListeEmplacements pour l'affichage des objets

Exemple :

item-content:
  type: ZAUCTIONHOUSE_ITEM_CONTENT
  slots:
    - 9-44

Boutons Récupérer Tout

TypeDescriptionUtilisé dans
ZAUCTIONHOUSE_REMOVE_ALL_EXPIREDRécupère tous les objets expirés d'un coupObjets Expirés
ZAUCTIONHOUSE_REMOVE_ALL_SELLINGRécupère tous les objets en vente d'un coupObjets en Vente
ZAUCTIONHOUSE_REMOVE_ALL_PURCHASEDRécupère tous les objets achetés d'un coupObjets Achetés

ZAUCTIONHOUSE_REMOVE_ALL_EXPIRED

Récupère tous les objets expirés d'un coup. Les objets sont donnés un par un et le processus s'arrête lorsque l'inventaire du joueur est plein (si player-inventory-must-have-free-space est activé sous remove-expired-item dans config.yml).

Exemple :

remove-all:
  type: ZAUCTIONHOUSE_REMOVE_ALL_EXPIRED
  is-permanent: true
  slot: 47
  item:
    material: CHEST
    name: "#2CCED2<bold>Tout Récupérer"
    lore:
      - "#92ffffRécupérer tous les objets expirés."
      - ""
      - "#8c8c8c• #2CCED2Cliquez #92ffffpour tout récupérer"

ZAUCTIONHOUSE_REMOVE_ALL_SELLING

Récupère tous les objets en vente d'un coup. Annule les annonces et renvoie les objets au joueur. Les objets en cours d'achat par un autre joueur sont ignorés.

Exemple :

remove-all:
  type: ZAUCTIONHOUSE_REMOVE_ALL_SELLING
  is-permanent: true
  slot: 47
  item:
    material: CHEST
    name: "#2CCED2<bold>Tout Récupérer"
    lore:
      - "#92ffffRécupérer tous les objets en vente."
      - ""
      - "#8c8c8c• #2CCED2Cliquez #92ffffpour tout récupérer"

ZAUCTIONHOUSE_REMOVE_ALL_PURCHASED

Récupère tous les objets achetés d'un coup. Les objets sont donnés un par un et le processus s'arrête lorsque l'inventaire du joueur est plein (si player-inventory-must-have-free-space est activé sous purchased-item dans config.yml).

Exemple :

remove-all:
  type: ZAUCTIONHOUSE_REMOVE_ALL_PURCHASED
  is-permanent: true
  slot: 47
  item:
    material: CHEST
    name: "#2CCED2<bold>Tout Récupérer"
    lore:
      - "#92ffffRécupérer tous les objets achetés."
      - ""
      - "#8c8c8c• #2CCED2Cliquez #92ffffpour tout récupérer"

Boutons Administrateur

Boutons de Navigation

TypeDescriptionUtilisé dans
ZAUCTIONHOUSE_ADMIN_HISTORY_MAINAffiche les informations du joueur cibléHistorique Admin
ZAUCTIONHOUSE_ADMIN_HISTORY_EXPIREDOuvre les objets expirés de la cibleHistorique Admin
ZAUCTIONHOUSE_ADMIN_HISTORY_PURCHASEDOuvre les objets achetés de la cibleHistorique Admin
ZAUCTIONHOUSE_ADMIN_HISTORY_SELLINGOuvre les objets en vente de la cibleHistorique Admin
ZAUCTIONHOUSE_ADMIN_HISTORY_LOGSOuvre les journaux d'actions de la cibleHistorique Admin
ZAUCTIONHOUSE_ADMIN_HISTORY_TRANSACTIONSOuvre les transactions de la cibleHistorique Admin
ZAUCTIONHOUSE_ADMIN_MAINOuvre (et actualise) l'annuaire admin des joueursAnnuaire Admin des Joueurs, Historique Admin

Boutons de l'Annuaire des Joueurs

TypeDescriptionUtilisé dans
ZAUCTIONHOUSE_ADMIN_PLAYERSListe paginée des joueurs ayant une activitéAnnuaire Admin des Joueurs
ZAUCTIONHOUSE_ADMIN_PLAYERS_SORTChange le tri de la liste des joueursAnnuaire Admin des Joueurs

Boutons de Retrait Admin

TypeDescriptionUtilisé dans
ZAUCTIONHOUSE_ADMIN_REMOVE_CONFIRMConfirme le retrait d'une annonceConfirmation de Retrait Admin
ZAUCTIONHOUSE_ADMIN_REMOVE_NOTIFYActive/désactive la notification du vendeurConfirmation de Retrait Admin
ZAUCTIONHOUSE_ADMIN_REMOVE_EXPIREActive/désactive l'envoi de l'objet dans les expirés du vendeurConfirmation de Retrait Admin
ZAUCTIONHOUSE_ADMIN_REMOVE_COPYActive/désactive la remise de l'objet à l'administrateurConfirmation de Retrait Admin

Boutons d'Affichage des Objets

TypeDescriptionUtilisé dans
ZAUCTIONHOUSE_ADMIN_SELLING_ITEMSAffiche les objets en vente de la cibleObjets en Vente Admin
ZAUCTIONHOUSE_ADMIN_EXPIRED_ITEMSAffiche les objets expirés de la cibleObjets Expirés Admin
ZAUCTIONHOUSE_ADMIN_PURCHASED_ITEMSAffiche les objets achetés de la cibleObjets Achetés Admin
ZAUCTIONHOUSE_ADMIN_LOGSAffiche les journaux d'actionsJournaux Admin
ZAUCTIONHOUSE_ADMIN_TRANSACTIONSAffiche les transactionsTransactions Admin

Boutons de Filtre

TypeDescriptionUtilisé dans
ZAUCTIONHOUSE_ADMIN_LOGS_FILTER_TYPEFiltre les journaux par type d'actionJournaux Admin
ZAUCTIONHOUSE_ADMIN_LOGS_FILTER_DATEFiltre les journaux par périodeJournaux Admin
ZAUCTIONHOUSE_ADMIN_TRANSACTIONS_FILTER_STATUSFiltre les transactions par statutTransactions Admin
ZAUCTIONHOUSE_ADMIN_TRANSACTIONS_FILTER_DATEFiltre les transactions par dateTransactions Admin

ZAUCTIONHOUSE_ADMIN_HISTORY_MAIN

Affiche les informations du joueur ciblé (tête du joueur).

Configuration :

PropriétéTypeDescription
slotNombrePosition du bouton
itemItemApparence du bouton

Exemple :

target:
  type: ZAUCTIONHOUSE_ADMIN_HISTORY_MAIN
  slot: 13
  item:
    player-head: '%target%'
    name: '#2CCED2<bold>%target%'

ZAUCTIONHOUSE_ADMIN_HISTORY_EXPIRED

Ouvre l'inventaire admin des objets expirés pour le joueur ciblé.

Placeholders :

  • %target% - Nom du joueur ciblé
  • %expired-items% - Nombre d'objets expirés
  • %s% - Suffixe de pluralisation

ZAUCTIONHOUSE_ADMIN_HISTORY_PURCHASED

Ouvre l'inventaire admin des objets achetés pour le joueur ciblé.

Placeholders :

  • %target% - Nom du joueur ciblé
  • %purchased-items% - Nombre d'objets achetés
  • %s% - Suffixe de pluralisation

ZAUCTIONHOUSE_ADMIN_HISTORY_SELLING

Ouvre l'inventaire admin des objets en vente pour le joueur ciblé.

Placeholders :

  • %target% - Nom du joueur ciblé
  • %selling-items% - Nombre d'objets en vente
  • %s% - Suffixe de pluralisation

ZAUCTIONHOUSE_ADMIN_HISTORY_LOGS

Ouvre l'inventaire admin des journaux d'actions pour le joueur ciblé.


ZAUCTIONHOUSE_ADMIN_HISTORY_TRANSACTIONS

Ouvre l'inventaire admin des transactions pour le joueur ciblé.


ZAUCTIONHOUSE_ADMIN_LOGS_FILTER_TYPE

Parcourt les filtres de type de journal.

Configuration :

PropriétéTypeDescription
slotNombrePosition du bouton
typesListeTypes de journaux disponibles pour le filtre
type-namesMapNoms d'affichage pour chaque type
enable-textChaîneFormat pour le type sélectionné
disable-textChaîneFormat pour les types non sélectionnés
all-types-nameChaîneNom d'affichage pour l'option "tous"

Types de journaux :

  • SALE - L'objet a été mis en vente
  • PURCHASE - L'objet a été acheté
  • REMOVE_LISTED - L'objet a été retiré de la liste active
  • REMOVE_SELLING - L'objet a été récupéré de l'inventaire de vente
  • REMOVE_EXPIRED - L'objet a été récupéré de l'inventaire des expirés
  • REMOVE_PURCHASED - L'objet a été récupéré de l'inventaire des achats
  • ADMIN_REMOVE - Annonce retirée par un administrateur depuis la confirmation de retrait admin

Si types est vide ou absent, tous les types de logs sont disponibles. Le fichier admin-logs.yml par défaut ne liste pas ADMIN_REMOVE : ajoutez-le à types (et %ADMIN_REMOVE% au lore) pour pouvoir filtrer dessus.


ZAUCTIONHOUSE_ADMIN_LOGS_FILTER_DATE

Parcourt les filtres de période.

Configuration :

PropriétéTypeDescription
slotNombrePosition du bouton
filtersListeFiltres de date disponibles
filter-namesMapNoms d'affichage pour chaque filtre
enable-textChaîneFormat pour le filtre sélectionné
disable-textChaîneFormat pour les filtres non sélectionnés

Filtres de date :

  • ALL - Toute la période
  • TODAY - Aujourd'hui uniquement
  • THIS_WEEK - 7 derniers jours
  • THIS_MONTH - 30 derniers jours
  • THIS_YEAR - 365 derniers jours

ZAUCTIONHOUSE_ADMIN_TRANSACTIONS_FILTER_STATUS

Parcourt les filtres de statut de transaction.

Configuration :

PropriétéTypeDescription
slotNombrePosition du bouton
statusesListeStatuts disponibles
status-namesMapNoms d'affichage pour chaque statut
enable-textChaîneFormat pour le statut sélectionné
disable-textChaîneFormat pour les statuts non sélectionnés
all-statuses-nameChaîneNom d'affichage pour l'option "tous"

Statuts :

  • PENDING - Argent pas encore réclamé
  • RETRIEVED - Argent réclamé

ZAUCTIONHOUSE_ADMIN_TRANSACTIONS_FILTER_DATE

Parcourt les filtres de période pour les transactions.

Configuration :

Identique à ZAUCTIONHOUSE_ADMIN_LOGS_FILTER_DATE.


ZAUCTIONHOUSE_ADMIN_MAIN

Ouvre l'annuaire admin des joueurs (admin-main.yml). Les données des joueurs sont toujours rechargées au clic : le même bouton sert donc de bouton Actualiser dans l'annuaire et de bouton Tous les joueurs dans l'Historique Admin.

Nécessite la permission zauctionhouse.admin.items.

Configuration :

PropriétéTypeDescription
slotNombrePosition du bouton
itemItemApparence du bouton

Exemple :

refresh:
  type: ZAUCTIONHOUSE_ADMIN_MAIN
  slot: 45
  item:
    material: SUNFLOWER
    name: "#2CCED2Actualiser"

ZAUCTIONHOUSE_ADMIN_PLAYERS

Liste paginée de tous les joueurs ayant une activité dans l'hôtel des ventes (annonces, achats, logs ou transactions). Chaque entrée est construite à partir de l'item du bouton, avec les placeholders ci-dessous. Un clic sur une entrée ouvre l'Historique Admin de ce joueur.

Les données sont chargées de manière asynchrone par une seule requête SQL (le contenu des objets n'est pas chargé), puis l'inventaire se rafraîchit tout seul.

Nécessite la permission zauctionhouse.admin.items.

Configuration :

PropriétéTypeDescription
slotsListeEmplacements où les joueurs sont affichés
itemItemApparence de chaque entrée joueur
elseBoutonBouton affiché quand aucun joueur n'a d'activité

Placeholders :

  • %target% - Nom du joueur
  • %listed% - Nombre d'annonces du joueur actuellement en vente (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)

Exemple :

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

ZAUCTIONHOUSE_ADMIN_PLAYERS_SORT

Change l'ordre de tri de ZAUCTIONHOUSE_ADMIN_PLAYERS. Clic gauche pour le tri suivant, clic droit pour le tri précédent.

OrdreTri
1Nom (A-Z)
2En vente (décroissant)
3Vendus (décroissant)
4Achetés (décroissant)

Placeholders :

  • %name-color%, %listed-color%, %sold-color%, %purchased-color% - #2CCED2 pour le tri actif, #8c8c8c sinon

Exemple :

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"

ZAUCTIONHOUSE_ADMIN_REMOVE_CONFIRM

Confirme le retrait de l'annonce dans l'inventaire de confirmation de retrait admin, avec les options choisies grâce aux trois boutons bascule ci-dessous.

Le retrait est compatible cluster (vérification de disponibilité, verrou, puis revalidation). Si l'objet a été vendu ou retiré entre-temps, l'administrateur reçoit le message admin-item-not-available. Sinon, il reçoit admin-item-removed, un log ADMIN_REMOVE est enregistré (visible dans les Journaux Admin) et l'hôtel des ventes principal se rouvre.

Nécessite la permission zauctionhouse.admin.remove.inventory.

Exemple :

confirm:
  type: ZAUCTIONHOUSE_ADMIN_REMOVE_CONFIRM
  slot: 21
  item:
    material: LIME_CONCRETE
    name: "#2CCED2Confirmer le retrait"

ZAUCTIONHOUSE_ADMIN_REMOVE_NOTIFY

ZAUCTIONHOUSE_ADMIN_REMOVE_EXPIRE

ZAUCTIONHOUSE_ADMIN_REMOVE_COPY

Boutons bascule de l'inventaire de confirmation de retrait admin. Chaque clic active ou désactive l'option. Les options sont réinitialisées à chaque ouverture de l'inventaire.

TypePar défautQuand l'option est activée
ZAUCTIONHOUSE_ADMIN_REMOVE_NOTIFYActivéLe vendeur reçoit le message admin-listing-removed. S'il est hors ligne, le message lui est envoyé à sa prochaine connexion
ZAUCTIONHOUSE_ADMIN_REMOVE_EXPIREActivéL'objet est déplacé dans les objets expirés du vendeur (avec la durée normale expire-expiration) pour qu'il puisse le récupérer. Désactivée, l'annonce est supprimée
ZAUCTIONHOUSE_ADMIN_REMOVE_COPYDésactivéL'administrateur reçoit l'objet : une copie si l'expiration est activée (le vendeur garde le sien), l'objet lui-même sinon. Si l'objet ne peut pas être remis, il retourne dans les objets récupérables du vendeur au lieu d'être perdu

Configuration :

PropriétéTypeDescription
slotNombrePosition du bouton
enable-materialMatériauMatériau utilisé quand l'option est activée (par défaut : PAPER)
disable-materialMatériauMatériau utilisé quand l'option est désactivée (par défaut : BARRIER)
itemItemApparence du bouton

Placeholders :

  • %material% - enable-material ou disable-material selon l'état (à utiliser avec material: '%material%')
  • %state-color% - #55ff55 si activé, #ff5555 si désactivé
  • %enabled% - true ou false

Exemple :

notify:
  type: ZAUCTIONHOUSE_ADMIN_REMOVE_NOTIFY
  enable-material: BELL
  disable-material: BARRIER
  slot: 11
  item:
    material: '%material%'
    name: "%state-color%Avertir le joueur"
    lore:
      - "#8c8c8cCliquez pour changer"

Boutons intégrés zMenu

Ces boutons sont fournis par zMenu et fonctionnent dans tous les inventaires.

TypeDescription
PREVIOUSRetourne à la page précédente
NEXTPasse à la page suivante
BACKRetourne à l'inventaire précédent
inventoryOuvre un autre inventaire

Consultez la documentation zMenu pour plus de détails.

Sur cette page

Boutons d'Affichage des ObjetsZAUCTIONHOUSE_LISTED_ITEMSZAUCTIONHOUSE_EXPIRED_ITEMSZAUCTIONHOUSE_PURCHASED_ITEMSZAUCTIONHOUSE_SELLING_ITEMSZAUCTIONHOUSE_COMBINED_ITEMSZAUCTIONHOUSE_HISTORY_ITEMSBoutons de NavigationZAUCTIONHOUSE_EXPIRED_INVENTORYZAUCTIONHOUSE_PURCHASED_INVENTORYZAUCTIONHOUSE_SELLING_INVENTORYZAUCTIONHOUSE_HISTORY_INVENTORYZAUCTIONHOUSE_CATEGORYZAUCTIONHOUSE_CATEGORY_SWITCHERBoutons de RechercheZAUCTIONHOUSE_SEARCHDialog de rechercheZAUCTIONHOUSE_CLEAR_SEARCHBouton de RéclamationZAUCTIONHOUSE_CLAIMBoutons de TriZAUCTIONHOUSE_CHANGE_SORTZAUCTIONHOUSE_HISTORY_SORTBoutons de l'Inventaire de VenteZAUCTIONHOUSE_SELL_SHOW_ITEMZAUCTIONHOUSE_SELL_PRICEZAUCTIONHOUSE_SELL_ECONOMYZAUCTIONHOUSE_SELL_CONFIRMZAUCTIONHOUSE_SELL_CANCELBoutons de ConfirmationZAUCTIONHOUSE_CONFIRM_PURCHASEZAUCTIONHOUSE_CONFIRM_REMOVE_LISTEDZAUCTIONHOUSE_SHOWBoutons de Contenu de ConteneursZAUCTIONHOUSE_SHULKER_OPENZAUCTIONHOUSE_SHULKER_CONTENTZAUCTIONHOUSE_SHULKER_INFOZAUCTIONHOUSE_SHULKER_NAVIGATIONBoutons d'Objets en LotZAUCTIONHOUSE_ITEM_CONTENTBoutons Récupérer ToutZAUCTIONHOUSE_REMOVE_ALL_EXPIREDZAUCTIONHOUSE_REMOVE_ALL_SELLINGZAUCTIONHOUSE_REMOVE_ALL_PURCHASEDBoutons AdministrateurBoutons de NavigationBoutons de l'Annuaire des JoueursBoutons de Retrait AdminBoutons d'Affichage des ObjetsBoutons de FiltreZAUCTIONHOUSE_ADMIN_HISTORY_MAINZAUCTIONHOUSE_ADMIN_HISTORY_EXPIREDZAUCTIONHOUSE_ADMIN_HISTORY_PURCHASEDZAUCTIONHOUSE_ADMIN_HISTORY_SELLINGZAUCTIONHOUSE_ADMIN_HISTORY_LOGSZAUCTIONHOUSE_ADMIN_HISTORY_TRANSACTIONSZAUCTIONHOUSE_ADMIN_LOGS_FILTER_TYPEZAUCTIONHOUSE_ADMIN_LOGS_FILTER_DATEZAUCTIONHOUSE_ADMIN_TRANSACTIONS_FILTER_STATUSZAUCTIONHOUSE_ADMIN_TRANSACTIONS_FILTER_DATEZAUCTIONHOUSE_ADMIN_MAINZAUCTIONHOUSE_ADMIN_PLAYERSZAUCTIONHOUSE_ADMIN_PLAYERS_SORTZAUCTIONHOUSE_ADMIN_REMOVE_CONFIRMZAUCTIONHOUSE_ADMIN_REMOVE_NOTIFYZAUCTIONHOUSE_ADMIN_REMOVE_EXPIREZAUCTIONHOUSE_ADMIN_REMOVE_COPYBoutons intégrés zMenu
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.