| title | layout |
|---|---|
serverlist.xml |
wiki |
{% include toc.md %}
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. | |