Skip to content
This repository has been archived by the owner on Sep 25, 2018. It is now read-only.

Latest commit

 

History

History
121 lines (112 loc) · 4.69 KB

serverlist.xml.md

File metadata and controls

121 lines (112 loc) · 4.69 KB
title layout
serverlist.xml
wiki

{% include toc.md %}

serverlist.xml

The serverlist.xml file is used to advertised available servers, giving information about them like their name, type, address, port, and minimum client version supported.

The server list is specified in the branding file. If a server isn't given on the command-line, the file is downloaded (or used from disk if it can't be) and the user presented with the servers it lists, along with the X most recent servers the client has connected (identical type, address, and port are shown as a single entry instead of multiple, with the latest name, minimum version, etc, used). The last used servers are listed first, with the most recent on top, then the remaining servers from the downloaded list.

Here is an example, taken from http://manasource.org/serverlist.xml.

{% highlight xml %} PRODUCTION http://themanaworld.org/

DEVELOPMENT http://germantmw.ath.cx/ PRODUCTION http://www.themanaworld.com.br/ TEST http://www.invertika.org/ This is the Mana test server. TEST http://manasource.org/ {% endhighlight %}
`serverlist` node
Parameter name Description
version Tells the XML format version, used by the client to handle potential backward compatibility and/or feedback in case of errors.
`server` child node
Parameter name Description
name The server name is displayed as the first element in the client server selection list.
type The server protocol type supported by the server. Currently, tmwAthena (and eAthena for backwards compatibility) and the Mana server are supported. If the type is unknown (or not specified), the client will ignore the entry.
minimumVersion The minimum support client version. Clients older than the minimum will show "requires v*X*" (where *X* is the minimum version specified) in red with the entry.
`connection` child node
Parameter name Description
hostname The server hostname or IP used to connect to.
port The server port used to connect to.
protocol The base protocol used to handle connection. Should be TCP for tmwAthena, and UDP for the Mana server.
`description` child node
Gives a short description of the given server.
`state` child node
Gives one of the three defined values: PRODUCTION, TEST, DEVELOPMENT. These values determine the server use and state the quality and bug-free content the user will find there. Currently not used.
`support` child node
Gives the main website supporting the given server.