Mon compte Lancer un projet

Installation de ModernHDV

Cette page détaille le fonctionnement technique de l’installation de ModernHDV et ce qui se produit lors du premier démarrage du plugin.

Compatibilité

Composant Compatibilité / statut
Paper 1.14 → 1.21.11
Spigot 1.14 → 1.21.11
Java 8+ recommandé
Vault Requis
Plugin d’économie Requis

Note

Vault sert de couche d’abstraction économique. ModernHDV s’intègre ainsi avec différents plugins d’économie compatibles sans dépendre d’une implémentation unique.

Dépendances expliquées

Vault

ModernHDV utilise Vault pour communiquer avec les plugins d’économie compatibles. Cela permet de conserver une compatibilité large et d’éviter un couplage direct avec un plugin spécifique.

Plugin d’économie

ModernHDV ne gère pas l’argent directement. Les soldes, débits et crédits passent par votre plugin d’économie via Vault. Sans plugin d’économie actif, les transactions HDV ne peuvent pas fonctionner.

Processus de premier démarrage

  1. Création du dossier plugin et de l’arborescence de base.
  2. Génération des fichiers YAML par défaut (configuration, GUI, catégories, langue).
  3. Chargement de la langue active et des valeurs de configuration.
  4. Détection de Vault et du provider d’économie disponible.
  5. Initialisation du backend de stockage (SQLite par défaut).

Astuce

ModernHDV fonctionne immédiatement après installation grâce à une configuration par défaut optimisée (mode mono-serveur + SQLite).

Contexte

La page Première configuration couvre le démarrage rapide. Cette page se concentre sur les détails techniques et les modes d’installation.

Structure des fichiers générés

plugins/
└── ModernHDV/
    ├── config.yml
    ├── items-gui.yml
    ├── items-categories.yml
    ├── lang/
    └── modernhdv.db

config.yml

Configuration principale du plugin (langue, stockage, options système).

items-gui.yml

Configuration des interfaces (GUI) : item et custom-model-data. En YAML pour la version Free, via GUI Admin pour la version Pro.

items-categories.yml

Affectation des items et configuration des catégories du HDV en YAML pour la version Free, via GUI Admin pour la version Pro.

lang/

Fichiers de langue et messages utilisateur/console.

modernhdv.db

Base SQLite locale créée par défaut au premier démarrage (mode mono-serveur).

Modes de stockage

SQLite

  • Stockage local sur le serveur
  • Recommandé pour un serveur unique
  • Aucune configuration supplémentaire nécessaire pour démarrer

Usage conseillé : démarrage rapide, test, production mono-serveur.

MySQLPro requis

  • Synchronisation des enchères entre serveurs
  • Partage des données HDV sur un réseau
  • Recommandé pour les infrastructures multi-serveurs

Usage conseillé : réseaux / proxies / serveurs liés.

Note

En mode multi-serveur, une économie partagée / synchronisée est nécessaire pour garantir la cohérence des transactions. Consultez la section Mode Multi-Server.

Mode Multi-Server Pro requis

ModernHDV peut fonctionner sur plusieurs serveurs Minecraft en partageant les mêmes enchères et données joueurs via une base de données commune. Ce mode est conçu pour les infrastructures réseau qui souhaitent proposer un HDV global cohérent entre plusieurs instances.

  • Réseaux multi-serveurs
  • Architecture hub + survival
  • Économie partagée
  • HDV global accessible depuis plusieurs serveurs

Fonctionnement

Les serveurs utilisent une base MySQL commune, ce qui permet la synchronisation automatique des enchères entre instances.

Les joueurs voient le même hôtel des ventes quel que soit le serveur depuis lequel ils accèdent à ModernHDV.

La configuration technique détaillée (structure, paramètres, bonnes pratiques réseau) est documentée dans la page dédiée Multi-Server.

Warning

ModernHDV utilise Vault comme interface économique et ne synchronise pas lui-même les balances joueurs.

Dans un environnement multi-serveur, une solution de synchronisation économique est nécessaire afin de garantir la cohérence des transactions entre serveurs.

ModernHDV reste volontairement compatible avec toute solution économique compatible Vault.

Exemples de solutions possibles

  • EssentialsX avec synchronisation MySQL
  • EcoBridge, MySQL Economy Bridge...
  • Systèmes économiques réseau personnalisés
  • Toute économie compatible Vault avec partage de données

Pourquoi cette étape est importante

Sans synchronisation économique entre serveurs :

  • les balances peuvent différer entre serveurs ;
  • les achats peuvent devenir incohérents ;
  • des pertes économiques peuvent apparaître.

Astuce

Configuration complète disponible dans la page dédiée Multi-Server.

Vérification console

✅ Démarrage correct

[ModernHDV] Vault hook detected
[ModernHDV] Storage backend: SQLite
[ModernHDV] ModernHDV is ready

❌ Exemple erreur dépendance

[ModernHDV] Vault not found
Disabling plugin...

Bonnes pratiques d’installation

  • Éviter /reload (préférez un redémarrage complet du serveur)
  • Redémarrer complètement le serveur après ajout de dépendances
  • Vérifier les logs au premier lancement
  • Effectuer une sauvegarde avant migration SQLite → MySQL

IMPORTANT — Fonctionnalités Premium

Certaines options avancées décrites dans la documentation (multi-serveur, stockage MySQL, configuration avancée en jeu) nécessitent ModernHDV Pro.

Next Steps

Configuration Commandes Personnalisation Multi-Server (Pro)

ModernHDV — Installation (documentation technique)