ModernHDV Configuration Guide (YAML & GUI Admin)

Configuration rapide

Serveur unique (Free)

Configuration minimale pour démarrer rapidement sur un serveur unique.

language
bstats

Serveur uniquePro — SQLite (par défaut)

Configuration Pro en mode local, sans activer le multi-serveur.

language
storage.type=SQLITE
bstats

Réseau multi-serveur Pro

Configuration réseau avec base commune et identification unique de chaque serveur.

multiserver.enabled=true
multiserver.server-name=... (unique)
storage.type=MYSQL

Warning

En réseau, l’économie doit être partagée / synchronisée entre serveurs. Voir la page Multi-Server.

Fichier config.yml (Free)

language: fr_FR # fr_FR / en_US / es_ES / de_DE / it_IT / pt_BR / ru_RU / zh_CN / ja_JP

bstats: true # If you don't know what it is, leave it on "true".

language

Définit la langue active du plugin. Les valeurs disponibles sont celles listées dans le commentaire du fichier : fr_FR, en_US, es_ES, de_DE, it_IT, pt_BR, ru_RU, zh_CN, ja_JP.

bstats

Active ou désactive l’intégration bStats (métriques de base anonymisées). La recommandation du fichier est explicite : laissez true si vous ne savez pas à quoi cela correspond.

Free = configuration simple

La version Free se concentre sur une configuration minimale : langue + bStats. Le plugin reste utilisable immédiatement avec ses réglages par défaut.

Fichier config.yml (Pro)

language: fr_FR # fr_FR / en_US / es_ES / de_DE / it_IT / pt_BR / ru_RU / zh_CN / ja_JP

multiserver:
  enabled: false # true / false
  server-name: "your-server-name" # Required to differentiate the servers. Give each server a different name.
  bridge-warning: true # true / false — Show warning about economy bridge requirement

storage:
  type: "SQLITE" # Change with 'MYSQL' or 'SQLITE' (local)
  mysql:
    # Replace with your value (only if you are using the MySQL storage type)
    host: 127.0.0.1
    port: 3306
    database: yourdatabasename
    user: youruserid
    password: yourpassword
    ssl:
      # Defaults chosen for broad compatibility.
      # If your provider requires strict SSL, set require=true and verify-certificate=true.
      enabled: true
      require: false
      verify-certificate: false

bstats: true # If you don't know what it is, leave it on "true".

A) language

Même rôle qu’en version Free : sélection de la langue active parmi les valeurs listées dans le fichier.

B) multiserver.enabled

Active ou désactive le mode multi-serveur. Laissez false pour un serveur unique. Passez à true uniquement pour un déploiement réseau.

Warning

Le mode multi-serveur nécessite MySQL et une économie partagée / synchronisée (Vault + solution de synchronisation économique).

C) multiserver.server-name

Identifiant unique du serveur dans un réseau. Ce champ devient indispensable si multiserver.enabled=true.

Chaque serveur doit avoir un nom différent. Ex :

hub
survival-1
survival-2

D) multiserver.bridge-warning

Affiche (ou non) l’avertissement console concernant le besoin d’un bridge / d’une solution d’économie réseau.

Conservez true pendant la mise en place. Désactivez-le seulement si votre architecture économique réseau est déjà validée.

E) storage.type

SQLITE pour un stockage local (serveur unique), MYSQL pour un stockage partagé réseau.

Le support MySQL est une fonctionnalité Pro.

F) storage.mysql.*

host : adresse du serveur MySQL
port : port MySQL (ex. 3306)
database : nom de la base
user : utilisateur MySQL
password : mot de passe de l’utilisateur

Astuce

Créez une base dédiée et un utilisateur dédié pour ModernHDV afin de simplifier la maintenance et limiter les risques d’erreur.

G) storage.mysql.ssl.*

enabled : active la couche SSL
require : force une connexion SSL
verify-certificate : vérifie strictement le certificat

Warning

N’activez pas verify-certificate=true si vous ne maîtrisez pas la configuration SSL de votre hébergeur MySQL. Certains providers imposent un mode strict, mais une vérification mal configurée peut empêcher la connexion.

Le commentaire du fichier précise que les valeurs par défaut sont choisies pour une compatibilité large, et qu’un provider strict peut nécessiter require=true et verify-certificate=true.

Erreurs fréquentes

Multi-serveur activé sans server-name correct : les serveurs ne sont pas correctement différenciés. Donnez un nom unique à chaque instance.
storage.type=MYSQL avec identifiants invalides : vérifiez host, port, database, user, password.
SSL mal configuré (provider strict) : ajustez require / verify-certificate selon les exigences de votre hébergeur MySQL.
Économie non partagée en réseau : les balances deviennent incohérentes entre serveurs, même si le HDV est synchronisé via MySQL.

Next Steps

Commandes Personnalisation Multi-Server (Pro) FAQ