La syntaxe générale est :

[tag]

clé="valeur"

clé="valeur,valeur,..."

[/tag]

Clés globales :

allow_remote_shutdown

Si vous choisissez no (par défaut), shut_down et restart sont ignorées à moins qu'ils ne proviennent de la fifo. Réglez yes pour permettre l'arrêt à distance via /query par un administrateur.

ban_save_file

Chemin complet ou relatif vers un fichier compressé (au format gzip) que le serveur peut lire et écrire. Les bannissements seront sauvegardés dans ce fichier et relu à chaque démarrage du serveur.

compress_stored_rooms

Détermine si les salles de discussion doivent être lues et écrites en format compressé. Par défaut yes.

connections_allowed

Nombre maximum de connexions ayant la même adresse IP. 0 pour infini (par défaut : 5).

deny_unregistered_login

Spécifie si les joueurs non-enregistrés avec le user_handler utilisé peuvent se connecter (défaut : non).

disallow_names

Noms/surnoms non acceptés par le serveur. Les caractères génériques * et ? sont acceptés. Voir glob(7) pour plus d'informations. Les valeurs par défaut (utilisées si rien n'est précisé) sont : *admin*,*admln*,*server*,ai,ai?,computer,human,network,player.

fifo_path

Chemin de la fifo dans laquelle vous pouvez envoyer des commandes au serveur (comme les /query depuis wesnoth). Si elle n'est pas précisée, le chemin est celui prédéfini lors de la compilation (valeur par défaut : /var/run/wesnothd/socket).

max_messages

Nombre maximum de messages permis en messages_time_period (par défaut : 4).

messages_time_period

Période, en secondes, après laquelle un surnombre de messages est détecté (par défaut : 10 secondes).

motd

Le message du jour.

new_room_policy

Détermine qui peut créer des salles de discussion sur le serveur. Les valeurs disponibles sont everyone, registered, admin et nobody, et donne la permission respectivement à tout le monde, les utilisateurs inscrits, les administrateurs ou désactive la création de nouvelles salles. La valeur par défaut est everyone.

passwd

Mot de passe pour obtenir des droits d'administrateur.(via /query admin password).

replay_save_path

Répertoire où le serveur sauvegarde les films des parties (n'oubliez pas le / final). La valeur par défaut `' indique que ce répertoire est celui où a été démarré wesnothd.

restart_command

Ligne de commande avec laquelle le serveur relance un processus depuis la commande restart. (seulement possible depuis la fifo. Voir le paramètre allow_remote_shutdown.)

room_save_file

Chemin du fichier où les informations sur les salles de discussion doivent être conservées. S’il est vide ou non spécifié, les salles ne sont pas chargées et non enregistrées.

save_replays

Définit si le serveur va automatiquement sauvegarder les films des parties (par défaut : false).

tls_enabled

Utilise TLS. Si activée, les trois options suivantes doivent être spécifiées.

tls_fullchain

La chaîne du certificat TLS au format .pem

tls_private_key

La clé privée TLS au format .pem

tls_dh

Le paramètre DH de TLS au format .pem. À générer par openssl dhparam -out nom_de_fichier.pem 4096

versions_accepted

Liste des versions acceptées par le serveur, séparées par des virgules. Les caractères génériques * et ? sont acceptés (par défaut : version correspondant à celle de wesnoth).
Exemple : versions_accepted="*" autorise tout type de version.

id

L'identifiant ID du serveur quand la sauvegarde en base de données des informations des parties est activée. Souvent les nombres majeur et mineur de la version des clients qui est acceptée : 1.18, 1.16...

Balises globales :

[redirect] Balise pour permettre au serveur de rediriger certaines versions du client. N'est pas utilisé si versions_accepted ne l'est pas.

[ban_time] Balise pour définir des mots clés utilisables pour des durées temporaires de bannissement.

[proxy] Balise pour demander au serveur de se comporter comme un proxy et de rediriger les requêtes des clients vers le serveur spécifié. Fonctionne comme [redirect].

[user_handler] Configure l'identifiant utilisateur. S'il n'y a aucune section [user_handler] dans la configuration, le serveur fonctionnera sans aucun service d'enregistrement d'alias. Toutes les tables complémentaires qui sont nécessaire pour que le forum_user_handler fonctionne, se trouvent dans le fichier table_definition.sql du dépôt des sources de Wesnoth. Nécessite l'activation du support mysql. Pour cmake, c'est le paramètre ENABLE_MYSQL et pour scons c'est forum_user_handler.