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

deny_unregistered_login

Impedisce agli utenti che non si sono registrati con user_handler di accedere. (default: falso)

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)

tls_enabled

Abilita l’utilizzo di TLS. Se impostato a vero, è necessario impostare anche le seguenti 3 opzioni.

tls_fullchain

Catena completa di certificati TLS in formato .pem

tls_private_key

chiave privata per TLS in formato .pem

tls_dh

Parametri DH TLS, come file .pem. Generati con openssl dhparam -out nomefile.pem 4096

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.

id

L’ID del server quando viene usata la funzionalità database per memorizzare le informazioni di una partita. Generalmente è la versione maggiore.minore dei client accettati, tipo 1.16 o 1.17.

Tag globali:¶

[redirect] Un tag per specificare un server a cui redirigere determinate versioni di client. Non viene usato se versions_accepted non viene impostato.

[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. 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. Necessita che sia abilitato il supporto mysql. Per cmake occore utilizzare il flag ENABLE_MYSQL e per scons forum_user_handler.