🏴‍☠️Marché Noir

Ce document détaille la configuration du système de marché noir dans le plugin Horizons.

📌 Note: Pour utiliser le marché noir, assurez-vous que le plugin Citizens soit installé sur le serveur. 🛠️

📝 Introduction

Le marché noir est un système de marchands spéciaux qui se déplacent périodiquement dans le monde et offrent des items à vendre. Contrairement aux marchands normaux, ces vendeurs ont un stock limité et changent d'emplacement régulièrement.

⚙️ Configuration

La configuration du marché noir se fait dans des fichiers YAML séparés situés dans le dossier plugins/Horizons/blackmarket/:

blackmarket:
  # Identifiant unique du marchand
  Dark_Trader:
    # Propriétés du marchand
    display_name: "&8Marchand Clandestin"    # Nom d'affichage (avec codes couleur)
    entity_type: "PLAYER"                    # Type d'entité (PLAYER, VILLAGER, etc.)
    skin_name: "Robber"                      # Skin à utiliser (seulement pour type PLAYER)
    gui_title: "&8Marché Noir"               # Titre de l'interface
    teleport_interval: "1h"                  # Intervalle entre les téléportations
    
    # Liste des emplacements possibles où le marchand peut apparaître
    locations:
      - world: "world"                       # Nom du monde
        x: 100                               # Coordonnée X
        y: 64                                # Coordonnée Y
        z: 100                               # Coordonnée Z
      - world: "world_nether"
        x: 200
        y: 64
        z: 200
    
    # Items disponibles à la vente
    items:
      DIAMOND:                               # ID du matériau (format Minecraft)
        stock: 5                             # Nombre d'items disponibles
        price: 150                           # Prix de vente en émeraudes
      NETHERITE_INGOT:
        stock: 2
        price: 500

🎮 Fonctionnalités

🧍 Marchand mobile

• Téléportation automatique: Le marchand se déplace automatiquement entre les emplacements définis selon l'intervalle configuré

• Apparence personnalisable: Les marchands peuvent être de n'importe quel type d'entité, avec des skins personnalisés pour les joueurs

🛒 Système de vente

• Stocks limités: Chaque item a un stock limité qui diminue à chaque vente

• Tarifs personnalisés: Les prix peuvent être configurés individuellement pour chaque item

• Réapprovisionnement: Les stocks sont réinitialisés à chaque téléportation du

📦 Gestion des inventaires

• Interface intuitive: Interface graphique claire montrant les items, leurs prix et les stocks disponibles

• Vente facilitée: Options pour vendre un item ou tous les items du même type

💡 Exemples d'utilisation

Marchand clandestin basique

blackmarket:
  Smuggler:
    display_name: "&8&lContrebandier"
    entity_type: "PLAYER"
    skin_name: "Bandit"
    gui_title: "&8Marchandises illicites"
    teleport_interval: "2h"
    locations:
      - world: "world"
        x: 100
        y: 64
        z: 100
      - world: "world"
        x: -150
        y: 70
        z: 200
    items:
      DRAGON_EGG:
        stock: 1
        price: 5000
      ELYTRA:
        stock: 2
        price: 2000

Marchand d'armes rare

blackmarket:
  ArmsDealer:
    display_name: "&4&lMarchand d'armes"
    entity_type: "VILLAGER"
    gui_title: "&4Armes Spéciales"
    teleport_interval: "30m"
    locations:
      - world: "world"
        x: 500
        y: 64
        z: -100
      - world: "world_nether"
        x: 50
        y: 70
        z: 50
    items:
      NETHERITE_SWORD:
        stock: 1
        price: 3000
      ENCHANTED_GOLDEN_APPLE:
        stock: 3
        price: 1500

Marchand EVOKER

blackmarket:
  Mercure:
    display_name: '&8&lMercure'
    entity_type: EVOKER
    gui_title: '&8&lMarché Noir'
    teleport_interval: 10m
    locations:
    - world: world
      x: -193.5
      y: 64.5
      z: -165.5
    - world: world
      x: -194.5
      y: 64.5
      z: -163.5
    - world: world
      x: -192.5
      y: 64.5
      z: -163.5
    items:
      NETHERITE_INGOT:
        price: 1000
        stock: 3
      DRAGON_BREATH:
        price: 500
        stock: 5
      ENCHANTED_GOLDEN_APPLE:
        price: 800
        stock: 2
      ELYTRA:
        price: 2000
        stock: 1
      BEACON:
        price: 1500
        stock: 2
      TOTEM_OF_UNDYING:
        price: 2000
        stock: 5

⚠️ Remarques

• Les marchands du marché noir sont indépendants du système d'économie normal

• Si un joueur a l'inventaire ouvert lors de la téléportation du marchand, il sera automatiquement fermé

• Les emplacements de téléportation doivent être accessibles (non bloqués par des blocs)

• Après un redémarrage du serveur, les marchands apparaîtront à l'un des emplacements configurés