Ogólna składnia jest następująca:¶

[tag]

klucz="wartość"

klucz="wartość,wartość,..."

[/tag]

Klawisze globalne:¶

allow_remote_shutdown

Wartość no (nie - wartość domyślna) oznacza, że żądania shut_down i restart będą ignorowane, jeśli nie zostaną przesłane poprzez kolejkę. Ustawienie wartości yes (tak) umożliwi administratorowi zdalne wyłączanie poprzez polecenie /query.

ban_save_file

Pełna lub względna ścieżka do pliku (archiwum gzip), do którego serwer ma dostęp do odczytu i zapisu. Blokady będą zapisywane w tym pliku i wczytywane ponownie podczas uruchamiania serwera.

compress_stored_rooms

Określa, czy odczyty i zapisy pliku pokoi powinny być dokonywane w postaci skompresowanej. Wartość domyślna: yes (tak).

connections_allowed

Dozwolona liczba połączeń z tego samego adresu IP. 0 oznacza brak ograniczeń. (domyślnie: 5)

disallow_names

Nazwy/pseudonimy, które nie są akceptowane przez serwer. Obsługiwane są symbole * i ? z wzorców wieloznacznych. Zobacz stronę glob(7), aby uzyskać szczegółowe informacje. Wartości domyślne (używane, gdy żadne inne wartości nie zostaną podane):*admin*,*admln*,*server*,ai,ai?,computer,human,network,player.

fifo_path

Ścieżka do kolejki, do której można przesyłać echem polecenia serwera (działanie równoważne do polecenia /query ... z wesnoth). Jeśli nie zostanie podana, przyjmowana jest ścieżka określona podczas kompilacji (domyślnie: /var/run/socket/wesnothd/socket).

max_messages

Liczba wiadomości dopuszczanych w przedziale czasowym messages_time_period (domyślnie: 4).

messages_time_period

Przedział czasowy (w sekundach), na przestrzeni którego wykrywane jest zalewanie komunikatami (domyślnie: 10 sekund).

motd

Wiadomość dnia.

new_room_policy

Określa, kto ma uprawnienia do tworzenia nowych pokoi na serwerze. Możliwe wartości: everyone (wszyscy użytkownicy), registered (tylko zarejestrowani użytkownicy), admin (tylko administratorzy) i nobody (nikt). Wartość domyślna: everyone.

passwd

Hasło używane do uzyskania uprawnień administratora (poprzez /query admin hasło).

replay_save_path

Katalog na serwerze, w którym są zapisywane powtórki gier, koniecznie z ukośnikiem (/) na końcu. Domyślnie jest to katalog, w którym uruchomiono wesnothd.

restart_command

Polecenie używane przez serwer do uruchomienia nowego procesu serwera poleceniem restart. (Może zostać wydane wyłącznie poprzez kolejkę - patrz ustawienie allow_remote_shutdown).

room_save_file

Ścieżka do pliku, w którym należy zapisać dane pokoju. Plik jest odczytywany przy uruchamianiu serwera i zapisywany podczas jego pracy. Jeśli parametr jest pusty lub zostanie pominięty, pokoje nie będą ładowane ani zapisywane.

save_replays

Określa, czy serwer będzie automatycznie zapisywać powtórki gier. Domyślnie wyłączone (wartość false).

versions_accepted

Oddzielana przecinkami lista łańcuchów wersji akceptowanych przez serwer. Obsługiwane są symbole * i ? ze wzorców wieloznacznych. (Domyślnie: odpowiednia wersja wesnoth).
Przykład: versions_accepted="*" odpowiada akceptowaniu dowolnego numeru wersji.

user_handler

Nazwa obiektu obsługi użytkowników, który ma być używany. Obecnie dostępne obiekty to forum (aby podłączyć wesnothd do bazy danych forum phpbb) i sample (przykładowa implementacja interfejsu obiektu obsługi użytkowników, której nikt przy zdrowych zmysłach nie powinien używać w poważnych zastosowaniach). Wartość domyślna to forum. Należy też dodać sekcję [user_handler] (patrz poniżej).

Globalne etykiety:¶

[redirect] Etykieta określająca serwer, na który przekierowywane są okreslone wersje klientów.

[ban_time] Znacznik do definiowania wygodnych słów kluczowych, określających przedziały czasu tymczasowych blokad.

[proxy] Etykieta instruująca serwer, by działał jak serwer proxy i przekierowywał żądanie klienta do określonego serwera. Akceptuje takie same klucze, jak [redirect].

[user_handler] Konfiguruje obiekt obsługi użytkowników. Dostępne parametry zależą od obiektu ustawionego za pomocą parametru user_handler. W przypadku braku sekcji [user_handler] w konfiguracji serwer zostanie uruchomiony bez żadnej usługi rejestrowania pseudonimów.

[mail] Konfiguruje serwer SMTP, za pośrednictwem którego obiekt obsługi użytkowników może wysyłać pocztę elektroniczną. Obecnie używane tylko przez obiekt 'sample'.