Configuration des Économies

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-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, RedisEconomy), vous pouvez spécifier quelle monnaie utiliser :

economies:
  - type: ZESSENTIALS  # Fonctionne aussi avec : ECOBITS, COINSENGINE, 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-format: PRICE_WITH_REDUCTION

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

Plugins Supportés avec Plusieurs Monnaies

Plugin	Type	Configuration de la Monnaie
zEssentials	ZESSENTIALS	Utilise le nom de monnaie du module économie zEssentials
EcoBits	ECOBITS	Utilise l'identifiant de monnaie EcoBits
CoinsEngine	COINSENGINE	Utilise le nom de monnaie CoinsEngine
RedisEconomy	REDISECONOMY	Utilise le nom de monnaie RedisEconomy

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%$"