Minecraft Multi-Server Auction House Setup (ModernHDV Pro)

Introduction

Le mode multi-serveur permet à plusieurs serveurs de votre réseau de partager les mêmes enchères et les mêmes données HDV. L’objectif est de proposer une expérience cohérente aux joueurs, quel que soit le serveur depuis lequel ils ouvrent le menu.

Cette page explique le fonctionnement global, les prérequis réseau et les points de vigilance. La configuration détaillée des options reste documentée sur la page Configuration.

Fonctionnement global

Base MySQL partagée

Tous les serveurs ModernHDV du réseau utilisent une base MySQL commune. Cette base centralise les données d’enchères et permet à chaque instance de travailler sur la même source de données.

Synchronisation des enchères

Les enchères créées, consultées et traitées sur un serveur deviennent visibles sur les autres serveurs connectés au même stockage. Les joueurs voient ainsi un HDV global à l’échelle du réseau.

Routage des paiements

ModernHDV gère le traitement des paiements différés liés aux ventes et achats via son système de payout sécurisé, afin de conserver la cohérence des transactions HDV sur l’ensemble du réseau.

Architecture simplifiée

Joueurs
   │
   ├── Hub (ModernHDV Pro)
   ├── Survival-1 (ModernHDV Pro)
   └── Survival-2 (ModernHDV Pro)
          │
          └── Base MySQL partagée (enchères / données HDV)

Économie : doit être partagée ou synchronisée séparément (via Vault + votre solution réseau)

Prérequis

ModernHDV Pro sur chaque serveur concerné
Base MySQL accessible depuis les serveurs du réseau
Configuration storage.type=MYSQL
multiserver.enabled=true
multiserver.server-name unique sur chaque serveur
Vault installé sur chaque serveur
Solution d’économie partagée ou synchronisée entre serveurs

Warning

ModernHDV ne synchronise pas lui-même les balances économiques. En réseau, vous devez utiliser une solution d’économie partagée ou synchronisée entre serveurs pour garantir la cohérence des transactions.

Configuration minimale

Exemple minimal de configuration pour activer le mode multi-serveur (les détails complets des options restent documentés sur la page Configuration).

multiserver:
  enabled: true
  server-name: "survival-1"

storage:
  type: "MYSQL"

Identifiant serveur

Chaque serveur doit utiliser une valeur server-name différente (ex. hub, survival-1, survival-2).

Paiements différés

ModernHDV intègre un système de payout sécurisé pour gérer les paiements liés aux ventes de manière robuste dans des contextes où les joueurs ne sont pas toujours connectés au même serveur.

L’objectif est de fiabiliser le traitement des transactions HDV à l’échelle du réseau, tout en conservant la compatibilité avec votre économie via Vault.

Problèmes fréquents

HDV non partagé entre serveurs : vérifiez que tous les serveurs utilisent la même base MySQL et que multiserver.enabled=true.
Données incohérentes entre serveurs : contrôlez les valeurs server-name (elles doivent être uniques).
Transactions incohérentes : vérifiez votre solution d’économie réseau (balances partagées/synchronisées).
Connexion base échouée : validez les paramètres MySQL et l’accès réseau entre serveurs et base.

Bonnes pratiques réseau

Nommez clairement chaque serveur via multiserver.server-name (ex. rôles / instances).
Utilisez une base MySQL dédiée à ModernHDV pour simplifier maintenance et diagnostics.
Testez le flux achat/vente sur un environnement de préproduction avant déploiement réseau.
Surveillez les logs au premier démarrage de chaque serveur du cluster.
Validez la cohérence de l’économie réseau avant ouverture aux joueurs.

Next Steps

Configuration FAQ Upgrade to Pro