ModernHDV Configuration Guide (YAML & GUI Admin)

Quick Configuration

Single Server (Free)

Minimum configuration to get started quickly on a single server.

language
bstats

Single ServerPro — SQLite (default)

Pro configuration in local mode, without enabling multi-server.

language
storage.type=SQLITE
bstats

Multi-Server Network Pro

Network configuration with a shared database and a unique identifier for each server.

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

Warning

On a network, the economy must be shared / synchronized between servers. See the Multi-Server page.

config.yml File (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

Defines the active plugin language. The available values are those listed in the file comment: fr_FR, en_US, es_ES, de_DE, it_IT, pt_BR, ru_RU, zh_CN, ja_JP.

bstats

Enables or disables the bStats integration (basic anonymized metrics). The file recommendation is explicit: leave true if you are not sure what it is.

Free = simple configuration

The Free version focuses on minimal configuration: language + bStats. The plugin remains usable immediately with its default settings.

config.yml File (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

Same role as in the Free version: selects the active language from the values listed in the file.

B) multiserver.enabled

Enables or disables multi-server mode. Leave false for a single server. Switch to true only for a network deployment.

Warning

Multi-server mode requires MySQL and a shared / synchronized economy (Vault + an economy synchronization solution).

C) multiserver.server-name

Unique server identifier within a network. This field becomes mandatory if multiserver.enabled=true.

Each server must have a different name. Example:

hub
survival-1
survival-2

D) multiserver.bridge-warning

Shows or hides the console warning about the need for a bridge / network economy solution.

Keep true during setup. Disable it only if your network economy architecture is already validated.

E) storage.type

SQLITE for local storage (single server), MYSQL for shared network storage.

MySQL support is a Pro feature.

F) storage.mysql.*

host : MySQL server address
port : MySQL port (e.g. 3306)
database : database name
user : MySQL user
password : user password

Tip

Create a dedicated database and dedicated user for ModernHDV to simplify maintenance and reduce the risk of errors.

G) storage.mysql.ssl.*

enabled : enables the SSL layer
require : forces an SSL connection
verify-certificate : strictly verifies the certificate

Warning

Do not enable verify-certificate=true if you are not comfortable with your MySQL host’s SSL configuration. Some providers enforce strict mode, but a misconfigured verification can prevent the connection.

The file comment explains that the default values are chosen for broad compatibility, and that a strict provider may require require=true and verify-certificate=true.

Common Errors

Multi-server enabled without a valid server-name: the servers are not properly differentiated. Give each instance a unique name.
storage.type=MYSQL with invalid credentials: check host, port, database, user, password.
Misconfigured SSL (strict provider): adjust require / verify-certificate according to your MySQL host’s requirements.
Economy not shared across the network: balances become inconsistent between servers, even if the auction house is synchronized through MySQL.

Next Steps

Commands Customization Multi-Server (Pro) FAQ