wesnothd - Battle for Wesnoth multiplayer network daemon
wesnothd [-dv] [-c path] [-p port] [-t number] [-T number]
Manages Battle for Wesnoth multiplayer games. See
http://www.wesnoth.org/wiki/ServerAdministration on what commands the
server accepts via the wesnoth client (/query ...) or the fifo.
-c path, --config path
tells wesnothd where to find the config file to use. See the
section SERVER CONFIG below for the syntax. You can reload the
config with sending SIGHUP to the server process.
runs wesnothd as a daemon.
tells you what the command line options do.
sets the severity level of the log domains. all can be used to
match any log domain. Available levels:
error, warning, info, debug. By default the error level is used
and the info level for the server domain.
-p port, --port port
binds the server to the specified port. If no port is specified,
port 15000 will be used.
-t number, --threads number
sets the maximum number of waiting worker threads for network
I/O to n (default: 5, max: 30).
-T number, --max-threads number
sets the maximum number of worker threads that will be created.
If set to 0 there will be no limit (default: 0).
shows version number and exits.
turns debug logging on.
The general syntax is:
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.
The number of allowed connections from the same IP. 0 means
infinite. (default: 5)
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:
The path to the fifo you can echo server commands into (same as
/query ... from wesnoth). If not specified defaults to the
compile-time specified path (default:
The number of allowed messages in messages_time_period.
The time period (in seconds) message flooding is detected in.
(default: 10 seconds)
motd The message of the day.
passwd The password used to gain admin privileges. Usually it starts
with ‘admin ’.
The directory where the server stores game replays. (Don’t
forget the trailing /!) Defaults to ‘’ which means the directory
wesnothd was started in.
The command that the server uses to start a new server process
via the ‘restart’ command. (Can only be issued via the fifo.)
Defines whether the server will automatically save replays of
games. (default: false)
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.
The name of the user handler to use. Currently available user
handlers are ’forum’ (to connect wesnothd to a phpbb forum
database) and ’sample’ (a sample implementation of the user
handler interface, if you use this on anything real you are
insane). The default value is ’forum’. You must also add a
[user_handler] section, see below.
[redirect] A tag to specify a server to redirect certain client
host The address of the server to redirect to.
port The port to connect to.
A comma separated list of versions to redirect. Behaves
the same way as versions_accepted in regard to wildcard
[ban_time] A tag to define convenient keywords for temporary ban time
name The name used to reference the ban time.
time The time length definition. The format is:
%d[%s[%d%s[...]]] where %s is s (seconds), m (minutes), h
(hours), D (days), M (months) or Y (years) and %d is a
number. If no time modifier is given minutes (m) are
assumed. Example: time="1D12h30m" results in a ban time
of 1 day, 12 hours and 30 minutes.
[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. Available keys vary
depending on which user handler is set with the user_handler key. If no
[user_handler] section is present in the configuration the server will
run without any nick registration service.
(for user_handler=forum) The hostname of the database
(for user_handler=forum) The name of the database
(for user_handler=forum) The name of the user under which
to log into the database
(for user_handler=forum) This user’s password
(for user_handler=forum) The name of the table in which
your phpbb forums saves its user data. Most likely this
will be <table-prefix>_users (e.g. phpbb3_users).
(for user_handler=forum) The name of the table in which
wesnothd will save its own data about users. You will
have to create this table manually, e.g.: CREATE TABLE
<table-name>(username VARCHAR(255) PRIMARY KEY,
user_lastvisit INT UNSIGNED NOT NULL DEFAULT 0,
user_is_moderator TINYINT(4) NOT NULL DEFAULT 0);
(for user_handler=sample) The time after which a
registered nick expires (in days).
[mail] Configures an SMTP server through which the user handler can
send mail. Currently only used by the sample user handler.
server The hostname of the mail server
The user name under which to log into the mail server.
This user’s password.
The reply-to address of you mail.
The port on which your mail server is running. Default is
Written by David White <firstname.lastname@example.org>. Edited by Nils
Kneuper <email@example.com>, ott <firstname.lastname@example.org>, Soliton
<email@example.com> and Thomas Baumhauer
<firstname.lastname@example.org>. This manual page was originally written
by Cyril Bouthors <email@example.com>.
Visit the official homepage: http://www.wesnoth.org/
Copyright © 2003-2007 David White <firstname.lastname@example.org>
This is Free Software; this software is licensed under the GPL version
2, as published by the Free Software Foundation. There is NO warranty;
not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.