Introduction -> Server Files

When running in the dedicated server mode there are various files that can be used to customize the server settings.
These settings files can be found in:-
- Windows - c:\documents and settings\<username>\.scorched3d
- Unix - ~/.scorched3d
If a filename contains <port> then this should be subsituted with the port number the server is running on (generally 27270). This is to allow different settings to be used when muliple servers are running on the same machine.

File name | Description | File format

server.xml

The main server game settings file. This file contains all the server settings relating to the game play (number of rounds, number players etc). This file can be edited by clicking the "Edit Advanced Settings" button on the start server dialog.
For a full list of the available options see the comments in the file.

`<options source='Scorched3D'>
<option>
<name>OptionName</name>
<value>OptionValue</value>
</option>
...
</options>
`

adminpassword-<port>.xml | A xml file containing the names and passwords of the server admins. These admins can then login and manage the scorched3d server from either the client's console or the remote web admin. | `<users> <user> <name>username</name> <password>password</password> </user> ... </users>`
icon-<port>.gif | A gif file containing an icon that will be sent to the clients and displayed on the clients rule page. Note: This file is sent everytime a client connects, so it should be made a small as possible. | `Any valid (non-animated) gif file. Width and height must be either 2, 4, 8, 16, 32, 64, 128 or 256.`
filter-<port>.txt | A text file containing a newline seperated list of swear words. These words will be filtered out of any message text. Filtered out words will be replaced by * characters. | `BadWord1 BadWord2 ...`
messages-<port>.txt | A xml file containing a set of messages that will be periodically sent to connected clients. Multiple sets of messages each with different repeat times and several texts can be specified. | `<messages> <message> <repeattime>message time in seconds</repeattime> <text>Message 1</text> <text>Message 2</text> ... </message> ... </messages>`

preferedplayers-<port>.txt

A xml file containing a set of players. Depending on the PreferedPlayers and RegisteredUserNames settings in the server.xml file this will will either:-
1) Specify which users can connect to this server.
2) Specify which names are resevered and can only be used by certain players

`<players>
<player>
<name>player name</name>
<uniqueid>player's stats id</uniqueid>
</player>
...
</players>
`