La sintassi generale è:

[tag]

chiave="valore"

chiave="valore,valore,..."

[/tag]

Chiavi globali:

allow_remote_shutdown

Se impostata su no (default), le richieste di spegnimento e ripartenza vengono ignorate a meno che non provengano dal socket. Impostala a yes per poter spegnere remotamente il server con una /query di un amministratore.

ban_save_file

Percorso completo o relativo ad un file (compresso con gzip) che il server possa scrivere e leggere. L’elenco degli utenti messi al bando sarà conservato in questo file e letto a tutti gli avvii del server.

compress_stored_rooms

Determina se i file delle stanze debbano essere letti e scritti in forma compressa. Normalmente vale yes.

connections_allowed

Il numero di connessioni permesse dallo stesso IP. 0 indica infinite connessioni (valore predefinito: 5).

disallow_names

I nomi o nick che non sono accettati dal server. Si possono usare i caratteri jolly * e ?. Vedi glob(7) per maggiori dettagli. I valori predefiniti (usati in mancanza di specifiche diverse) sono: *admin*,*admln*,*server*,ai,ai?,computer,human,network,player.

fifo_path

Il path del socket al quale inviare i comandi del server (come in /query ... per wesnoth). Se non diversamente specificato invia allo standard utilizzato come path al momento della compilazione del sorgente (default: /var/run/wesnothd/socket).

max_messages

Il numero di messaggi permessi in un periodo di messages_time_period (valore predefinito: 4).

messages_time_period

Il periodo di tempo (in secondi) entro il quale rilevare un’inondazione di messaggi (valore predefinito: 10 secondi).

motd

Il messaggio del giorno.

new_room_policy

Stabilisce chi possa creare nuove stanze sul server. Valori possibili sono everyone, registered, admin e nobody per concedere i permessi rispettivamente a tutti, ad utenti registrati, ad utenti amministratori o per disabilitare la creazione di nuove stanze. Il valore di default è everyone.

passwd

La password da usare per ottenere i privilegi di amministratore (con /query admin password).

percorso_salvataggio_replay

La directory in cui il server conserva i replay delle partite (Non dimenticare la barra «/» alla fine!). In assenza di modifiche, vale «», che significa la directory da cui è stato eseguito wesnothd.

restart_command

Il comando che il server utilizza per lanciare un muovo processo server tramite il comando restart. Può essere inviato soltanto tramite il socket. Per dettagli, vedi i setaggi di allow_remote_shutdown.

room_save_file

Percorso del file in cui memorizzare le informazioni sulle stanze. Questo file è letto all’avvio del server e vi viene scritto in seguito. Se è vuoto o non impostato, le stanze non saranno caricate o salvate.

salva_replays

Definisce se il server salverà automaticamente i replay delle partite. (normalmente: false)

versions_accepted

Un elenco separato da virgole delle stringhe di versione che il server deve accettare. I caratteri jolly * e ? sono ammessi (il valore predefinito è lo stesso della versione di wesnoth corrispondente).
Esempio: versions_accepted="*" accetta tutte le stringhe di versione.

user_handler

Il nome dello user handler da utilizzare. Attualmente gli user handler disponibili sono forum (per connettere wesnothd ad un forum con database phpbb) e sample (una implementazione di esempio di una interfaccia user handler; Usarla per qualcosa di real è semplicemente una cosa da pazzi). il valore di default è forum. Va anche aggiunto una sezione [user_handler], vedi sotto.

Tag globali:

[redirect] Un tag per specificare un server a cui redirigere certe versioni di client.

[ban_time] Un’etichetta per definire parole chiave comode per periodi di messa al bando temporanei.

[proxy] Un tag che indica al server di fare da proxy e di inoltrare le richieste dei client connessi al server specificato. Accetta le stesse parole chiave di [redirect].

[user_handler] Configura lo user handler. Sono disponibili diverse parole chiavi a seconda dello user handler selezionato con la chiave user_handler. Se non è presente una sezione [user_handler] nella configurazione il server verrà lanciato senza un servizio di registrazione del nick. Tutte le tabelle aggiuntive necessarie per il funzionamento di forum_user_handler possono essere reperite in table_definitions.sql nel repository del codice sorgente di Wesnoth.

[mail] Configura un server SMTP attraverso il quale l’utente può inviare e-mail. Attualmente utilizzato soltanto dallo user_handler sample.