The general syntax is:

[tag]

key="value"

key="value,value,..."

[/tag]

Global keys:

allow_remote_shutdown

If set to no (default), shut_down and restart requests are ignored unless they come from the fifo. Set it to yes to allow remote shutdown via a /query by an administrator.

ban_save_file

Full or relative path to a (gzip compressed) file that the server can read and write. Bans will be saved to this file and read again on server start.

compress_stored_rooms

Determines whether the rooms file should be read and written to in compressed form. Defaults to yes.

connections_allowed

The number of allowed connections from the same IP. 0 means infinite. (default: 5)

deny_unregistered_login

Whether to prevent users who are not registered with the user_handler being used from logging in. (default: false)

disallow_names

Names/nicks that are not accepted by the server. * and ? from wildcard patterns are supported. See glob(7) for more details. Default values (used if nothing is specified) are: *admin*,*admln*,*server*,ai,ai?,computer,human,network,player.

fifo_path

The path to the fifo you can echo server commands into (same as /query ... from wesnoth). If not specified defaults to the compile-time path (default: /var/run/wesnothd/socket).

max_messages

The number of allowed messages in messages_time_period. (default: 4)

messages_time_period

The time period (in seconds) message flooding is detected in. (default: 10 seconds)

motd

The message of the day.

new_room_policy

Determines who can create new rooms on the server. Available values are everyone, registered, admin and nobody, and give the permission respectively to everyone, registered users, admin users or disables new room creation. Default value is everyone.

passwd

The password used to gain admin privileges (via /query admin password).

replay_save_path

The directory where the server stores game replays. (Don't forget the trailing /!) Defaults to `' which means the directory wesnothd was started in.

restart_command

The command that the server uses to start a new server process via the restart command. (Can only be issued via the fifo. See the allow_remote_shutdown setting.)

room_save_file

Path to a file where the room info should be stored. This file is read on server startup and written to later. If empty or not set, rooms are not loaded and not saved.

save_replays

Defines whether the server will automatically save replays of games. (default: false)

tls_enabled

Enable use of TLS. If true, requires 3 following options to be set too.

tls_fullchain

TLS full certificate chain in .pem format

tls_private_key

private key for TLS in .pem format

tls_dh

TLS DH parameters, as .pem file. Generate with openssl dhparam -out filename.pem 4096

versions_accepted

A comma separated list of version strings to be accepted by the server. * and ? from wildcard patterns are supported. (defaults to the corresponding wesnoth version)
Example: versions_accepted="*" accepts any version string.

id

The ID of the server when using the database functionality to store game information. Generally is the major.minor version of accepted clients, such as 1.16 or 1.17.

Global tags:

[redirect] A tag to specify a server to redirect certain client versions to. Is not used if versions_accepted is not set.

[ban_time] A tag to define convenient keywords for temporary ban time lengths.

[proxy] A tag to tell the server to act as a proxy and forward the connected client's requests to the specified server. Accepts the same keys as [redirect].

[user_handler] Configures the user handler. If no [user_handler] section is present in the configuration the server will run without any nick registration service. All additional tables that are needed for the forum_user_handler to function can be found in table_definitions.sql in the Wesnoth source repository. Requires mysql support enabled. For cmake this is ENABLE_MYSQL and for scons this is forum_user_handler.