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).

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/socket/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).

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.

user_handler

Nom de l'identifiant utilisateur à utiliser. Les identifiants disponibles sont forum (pour connecter wesnothd à une base de données pour forum phpbb) et sample (une implémentation minimale de l'interface utilisateur ; courrez vous faire soigner si vous l'utilisez). La valeur par défaut est forum. Vous devrez aussi ajouter une section [user_handler] comme indiqué ci-dessous.

Balises globales : ¶

[redirect] Balise pour permettre au serveur de rediriger certaines versions du client.

[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. Les options disponibles dépendent de la configuration de la clé user_handler. S'il n'y a aucune section [user_handler] dans la configuration, le serveur fonctionnera sans aucun service d'enregistrement d'alias.

[mail] Configure un serveur SMTP pour permettre à l'utilisateur d'envoyer des mails. Actuellement uniquement utilisé pour l'identifiant 'sample'.