GroupeZ Docs
Configuration

Économies

Configurer les systèmes économiques dans zAuctionHouse

zAuctionHouse supporte plusieurs systèmes économiques. Configurez-les dans le dossier economies/.

Économie Vault

L'intégration économique la plus courante. Créez economies/vault.yml :

# Activer cette économie
enabled: true

# Nom d'affichage pour cette économie
name: "Argent"

# Icône pour l'affichage dans l'inventaire
icon:
  material: GOLD_INGOT
  name: "&6Argent"

# Restrictions de prix
price:
  # Prix minimum pour tout objet
  min: 1
  # Prix maximum pour tout objet (0 pour pas de limite)
  max: 1000000000

# Nécessite une permission pour utiliser cette économie
permission: ""  # Laisser vide pour tout le monde

# Configuration des taxes
tax:
  # Activer les taxes sur les ventes
  enabled: true
  # Pourcentage de taxe (10 = 10%)
  percentage: 10
  # Qui paie la taxe : SELLER ou BUYER
  payer: SELLER

# Paramètres de réclamation automatique
auto-claim:
  # Donner automatiquement l'argent au vendeur lors de l'achat
  enabled: true
  # Si false, le vendeur doit récupérer depuis les objets achetés

Économie PlayerPoints

Pour les serveurs utilisant PlayerPoints. Créez economies/playerpoints.yml :

enabled: true
name: "Points"

icon:
  material: EMERALD
  name: "&aPoints"

price:
  min: 1
  max: 10000000

tax:
  enabled: false

auto-claim:
  enabled: true

Économie Expérience

Utilisez l'expérience du joueur comme monnaie. Créez economies/experience.yml :

enabled: true
name: "Expérience"

icon:
  material: EXPERIENCE_BOTTLE
  name: "&aExpérience"

price:
  min: 10
  max: 100000

tax:
  enabled: false

auto-claim:
  enabled: true

Économie Niveaux

Utilisez les niveaux du joueur comme monnaie. Créez economies/levels.yml :

enabled: true
name: "Niveaux"

icon:
  material: ENCHANTED_BOOK
  name: "&bNiveaux"

price:
  min: 1
  max: 1000

tax:
  enabled: false

auto-claim:
  enabled: true

Économie basée sur les Objets

Utilisez un objet spécifique comme monnaie. Les joueurs paient avec des objets de leur inventaire :

economies:
  - type: ITEM
    is-enable: true
    name: item
    display-name: "Diamants"
    format: "%price%d"
    symbol: "d"

    # Définir l'objet de monnaie (supporte toutes les propriétés d'item zMenu)
    item:
      material: DIAMOND
      # Optionnel : nécessite un nom spécifique
      # name: "&bDiamant Monnaie"
      # Optionnel : nécessite un lore spécifique
      # lore:
      #   - "&7Monnaie officielle"
      # Optionnel : nécessite un custom model data
      # model-data: 1001

    # Dépôt automatique des objets au vendeur immédiatement
    auto-claim: true

    # Raisons de transaction
    withdraw-reason: "Purchase of %items% (zAuctionHouse)"
    deposit-reason: "Sale of %items% (zAuctionHouse)"

    # Si true, le vendeur doit être en ligne pour recevoir les objets
    # Sinon, il doit utiliser /ah claim pour récupérer ses objets
    must-be-online: true

    # Mode de formatage des prix
    # PRICE_WITH_DECIMAL_FORMAT : Utilise le format 'price-decimal-format'
    # PRICE_WITHOUT_DECIMAL     : Pas de décimales, nombres entiers uniquement (ex : 10000.50 -> 10000)
    # PRICE_WITH_REDUCTION      : Utilise les réductions 'price-reductions'
    price-format: PRICE_WITH_REDUCTION

    # Limites de prix
    min-prices: 1
    max-prices: 64

Configuration de l'Objet

La section item supporte toutes les propriétés d'item disponibles dans zMenu :

item:
  material: DIAMOND
  name: "&b&lDiamant Premium"
  lore:
    - "&7Monnaie du serveur"
    - "&7Ne peut pas être jeté"
  model-data: 1001
  glow: true
  # ... toute autre propriété d'item zMenu

Cela vous permet de créer des objets de monnaie personnalisés qui doivent correspondre à des critères spécifiques.

Économie avec Nom de Currency

Pour les plugins qui supportent plusieurs monnaies (zEssentials, EcoBits, CoinsEngine, ExcellentEconomy, RedisEconomy), vous pouvez spécifier quelle monnaie utiliser :

economies:
  - type: ZESSENTIALS  # Fonctionne aussi avec : ECOBITS, COINSENGINE, EXCELLENTECONOMY, REDISECONOMY
    currency-name: "coins"  # Le nom de la monnaie du plugin
    is-enable: true
    name: coins
    display-name: "Coins"
    format: "%price%c"
    symbol: "c"

    # Dépôt automatique au vendeur immédiatement
    auto-claim: true

    # Le joueur n'a pas besoin d'être en ligne
    must-be-online: false

    # Raisons de transaction
    withdraw-reason: "Purchase of %items% (zAuctionHouse)"
    deposit-reason: "Sale of %items% (zAuctionHouse)"

    # Mode de formatage des prix
    # PRICE_WITH_DECIMAL_FORMAT : Utilise le format 'price-decimal-format'
    # PRICE_WITHOUT_DECIMAL     : Pas de décimales, nombres entiers uniquement (ex : 10000.50 -> 10000)
    # PRICE_WITH_REDUCTION      : Utilise les réductions 'price-reductions'
    price-format: PRICE_WITH_REDUCTION

    # Limites de prix
    min-prices: 1
    max-prices: 99999

Plugins Supportés avec Plusieurs Monnaies

PluginTypeConfiguration de la Monnaie
zEssentialsZESSENTIALSUtilise le nom de monnaie du module économie zEssentials
EcoBitsECOBITSUtilise l'identifiant de monnaie EcoBits
CoinsEngineCOINSENGINEUtilise le nom de monnaie CoinsEngine
RedisEconomyREDISECONOMYUtilise le nom de monnaie RedisEconomy
ExcellentEconomyEXCELLENTECONOMYUtilise le nom de monnaie ExcellentEconomy

Exemple : Plusieurs Monnaies du Même Plugin

economies:
  # zEssentials - Coins principaux
  - type: ZESSENTIALS
    currency-name: "coins"
    is-enable: true
    name: coins
    display-name: "Coins"
    format: "%price% coins"
    symbol: "c"
    auto-claim: true
    must-be-online: false
    price-format: PRICE_WITH_REDUCTION
    min-prices: 1
    max-prices: 999999

  # zEssentials - Gems premium
  - type: ZESSENTIALS
    currency-name: "gems"
    is-enable: true
    name: gems
    display-name: "Gems"
    format: "%price% gems"
    symbol: "g"
    auto-claim: true
    must-be-online: false
    price-format: PRICE_WITH_REDUCTION
    min-prices: 1
    max-prices: 10000

Réduction de Prix

Configurez la réduction automatique des prix au fil du temps :

price-reduction:
  # Activer la réduction de prix
  enabled: true

  # Calendrier de réduction
  schedule:
    # Après 1 jour, réduire de 5%
    - after: 1d
      reduction: 5
    # Après 3 jours, réduire de 10%
    - after: 3d
      reduction: 10
    # Après 7 jours, réduire de 20%
    - after: 7d
      reduction: 20

  # Prix minimum (pourcentage du prix original)
  minimum-percentage: 50

Avec ces paramètres :

  • Jour 1-2 : 100% du prix original
  • Jour 2-3 : 95% du prix original
  • Jour 3-7 : 90% du prix original
  • Jour 7+ : 80% du prix original (minimum 50%)

Détails de Configuration des Taxes

tax:
  enabled: true

  # Pourcentage de taxe de base
  percentage: 10

  # Qui paie : SELLER ou BUYER
  payer: SELLER

  # Permission pour contourner la taxe
  bypass-permission: "zauctionhouse.bypass.tax"

  # Taux de taxe différents selon les permissions
  rates:
    - permission: zauctionhouse.tax.vip
      percentage: 5
    - permission: zauctionhouse.tax.mvp
      percentage: 2
    - permission: zauctionhouse.tax.exempt
      percentage: 0

Exemple d'Économies Multiples

Vous pouvez avoir plusieurs économies actives simultanément. Les joueurs choisissent laquelle utiliser lors de la mise en vente.

Structure du répertoire :

economies/
├── vault.yml        # Argent standard
├── points.yml       # PlayerPoints
├── diamonds.yml     # Monnaie en diamants
└── tokens.yml       # Objet de jeton personnalisé

Dans les inventaires, affichez le sélecteur d'économie :

# Dans sell.yml
items:
  economy-selector:
    slot: 4
    item:
      material: GOLD_INGOT
      name: "&6Sélectionner la Monnaie"
      lore:
        - "&7Cliquez pour changer de monnaie"
        - ""
        - "&7Actuelle : &f%economy%"

Exemple Complet d'Économie Vault

economies/vault.yml complet :

enabled: true
name: "Argent"

icon:
  material: GOLD_INGOT
  name: "&6Argent"
  lore:
    - "&7Monnaie standard du serveur"
    - "&7Alimentée par Vault"

price:
  min: 1
  max: 1000000000

  # Limites de prix par catégorie
  category-limits:
    weapons:
      min: 100
      max: 100000
    armor:
      min: 100
      max: 100000
    blocks:
      min: 1
      max: 10000
    misc:
      min: 1
      max: 50000

permission: ""

tax:
  enabled: true
  percentage: 10
  payer: SELLER
  bypass-permission: "zauctionhouse.bypass.tax"
  rates:
    - permission: zauctionhouse.tax.vip
      percentage: 5

price-reduction:
  enabled: true
  schedule:
    - after: 3d
      reduction: 10
    - after: 7d
      reduction: 20
  minimum-percentage: 50

auto-claim:
  enabled: true

# Format pour l'affichage des prix
format: "%amount%$"

Messages

Personnalisez tous les messages dans zAuctionHouse

Catégories

Configurer les catégories d'objets dans zAuctionHouse

Sur cette page

Économie VaultÉconomie PlayerPointsÉconomie ExpérienceÉconomie NiveauxÉconomie basée sur les ObjetsConfiguration de l'ObjetÉconomie avec Nom de CurrencyPlugins Supportés avec Plusieurs MonnaiesExemple : Plusieurs Monnaies du Même PluginRéduction de PrixDétails de Configuration des TaxesExemple d'Économies MultiplesExemple Complet d'Économie Vault
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.