Documentation
Powered by

# 🏴‍☠️ Marché Noir

# 📝 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)
        quantity: 32                         # Quantité nécessaire pour la vente
        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:
        quantity: 6
        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:
        quantity: 32
        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

# 🔢 Système de quantités

# ⚙Configuration des quantités

Chaque item dans un marché noir peut avoir une quantité configurée qui détermine combien d'items sont vendus par transaction :

items:
  NETHERITE_INGOT:
    price: 1000
    stock: 3
    quantity: 5

# 🤖Fonctionnement des quantités

# 🖱️ Clic gauche (Vente de quantité configurée)

  • Vend exactement la quantité configurée d'items
  • Le prix affiché est pour la quantité complète
  • Exemple : avec quantity: 5 et un prix de vente à 1000, un clic gauche vend 5 items pour 1000 points

# 🖱️ Clic droit (Vente maximale)

  • Vend le maximum possible en multiples de la quantité configurée
  • Le prix est multiplié par le nombre de sets vendus
  • Exemple : avec 12 items, quantity: 4, et un prix de vente à 1000 → vend 3 sets (12 items) pour 3000 points

# ⚠️ 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

© Copyright 2026 Horizons