Server mtaserver.conf

From Multi Theft Auto: Wiki
Revision as of 16:41, 12 January 2012 by Winky- (talk | contribs) (Added to category support)
Jump to navigation Jump to search

This page lists the settings that can be set in the settings file. Setting from the default mtaserver.conf settings file is in italics


servername

<servername>Default MTA Server</servername>
This parameter specifies the name the server will be visible as in the ingame server browser and on Game-Monitor. It is a required parameter.

serverip

<serverip></serverip>
ONLY USE THIS PARAMETER IF YOU ARE SURE OF WHAT YOU ARE DOING
It is generally only needed for professional servers and should be left blank otherwise. This parameter specifies the IP to use for servers that have multiple IP addresses. If left blank, it will default to server's standard local IP address.
SERVERIP SHOULD BE LEFT BLANK UNLESS YOU ARE SURE OF WHAT YOU ARE DOING
People who set this and then ask for support will be the first ones against the wall when the revolution comes

serverport

<serverport>22003</serverport>
This parameter specifies the UDP port on which the server will be accepting incoming player connections;
default value: 22003. It is a required parameter.

maxplayers

<maxplayers>32</maxplayers>
This parameter specifies the number of maximum player slots available on the server;
default value: 32. It is a required parameter.

httpserver

<httpserver>1</httpserver>
This parameter specifies whether the builtin http server will be used.
Values: 0 - disabled , 1 - enabled ; default value: 1. Optional parameter.
More information: Using the web interface

httpport

<httpport>22005</httpport>
This parameter specifies the TCP port on which the server will be accepting incoming http connections. It can be set to the same value as <serverport>. It is a required parameter if <httpserver> is set to 1.
More information: Using the web interface

httpdownloadurl

<httpdownloadurl></httpdownloadurl>
If set, this parameter specifies the external URL from which clients will be able to download needed resources ingame. Otherwise they will download them directly from the server.
More information: Configuring an external web server

httpautoclientfiles

<httpautoclientfiles>1</httpautoclientfiles>
This parameter specifies whether the client files for hosting on an external web server should be automatically copied into mods/deathmatch/resource-cache/http-client-files/ Only relevant if <httpdownloadurl> is set.
Values: 0 - disabled , 1 - enabled ; default value: 1. Optional parameter.
More information: Configuring an external web server

httpmaxconnectionsperclient

<httpmaxconnectionsperclient>5</httpmaxconnectionsperclient>
This parameter limits the number of http connections each client can make. Depending on the type of http server that is used, a lower figure may reduce download timeouts.
Available range: 1 to 8.

httpdosthreshold

<httpdosthreshold>20</httpdosthreshold>
This parameter limits the number http connections that an IP can initiate over a short period of time.
Available range: 1 to 100. default value: 20

client_file

<!-- <client_file name="data/handling.cfg" verify="false" /> -->
By default, the server will block the use of customized GTA:SA data files.
To allow specific client files, add one or more of the above lines.
More information: Anti-cheat guide

disableac

<disableac></disableac>
Comma seperated list of disabled anti-cheats.
e.g. To disable anti-cheat #2 and #3, use: 2,3
More information: Anti-cheat guide

enablesd

<enablesd></enablesd>
Comma seperated list of enabled special detections. A special detection is a type of anti-cheat for (usually) harmless game modifications. Competitive servers may wish to enable special detections, but most servers should leave this setting blank.
e.g. To enable special detection #12 (disallow custom D3D9.DLL) use: 12

networkencryption

<networkencryption>1</networkencryption>
This parameter specifies whether communications between the server and client is encrypted. Encryption can help prevent network data being viewed and modified.
Values: 0 - disabled , 1 - enabled ; default value: 1. Optional parameter.
This parameter can changed and saved while the server is running with setServerConfigSetting

minclientversion

<minclientversion></minclientversion>
Minimum client version. Clients with a lower version will not be allowed to connect. After disconnection, clients will be given an opportunity to download an update. If left blank, this setting is disabled and there are no restrictions on who can connect. Version numbers are described in getPlayerVersion and look like this: 1.1.0-9.03100.0
This parameter can changed and saved while the server is running with setServerConfigSetting

recommendedclientversion

<recommendedclientversion></recommendedclientversion>
Recommended client version. When connecting, if clients have a lower version, they will be given the option to download an update. If left blank, this setting is disabled.
This parameter can changed and saved while the server is running with setServerConfigSetting

ase

<ase>1</ase>
This parameter can be used to make the server report to Game-Monitor master servers, allowing it to be visible in the ingame server browser. An additional UDP port needs to be available for this to work (value from <serverport> + 123 , so on a default <serverport> value 22003 the right port will be 22126 ).
Available values: 0 - disabled , 1 - enabled. Optional parameter, defaults to 0.

donotbroadcastlan

<donotbroadcastlan>0</donotbroadcastlan>
This parameter allows you to disable LAN broadcasting.

password

<password></password>
If set, players will have to provide a password specified below, before they can connect to the server. If left blank, server doesn't require a password from them.
This parameter can changed and saved while the server is running with setServerPassword or setServerConfigSetting

bandwidth_reduction

<bandwidth_reduction>medium</bandwidth_reduction>
This parameter reduces the server's bandwidth usage by using various optimizations.
Values: none, medium or maximum ; default value: medium
This parameter can be changed and saved while the server is running with setServerConfigSetting

idfile

<idfile>server-id.keys</idfile>
Specifies the location and file name of this servers unique private key. This is used to prevent private files saved on the client from being read by other servers.
Keep a backup of this file in a safe place. Default value: server-id.keys
More information about client private files: Filepath

logfile

<logfile>logs/server.log</logfile>
Specifies the location and name of the main server log file. If left blank, server won't be saving this file.

authfile

<authfile>logs/server_auth.log</authfile>
As well as the main log file, login successes and failures are logged here for easy reviewing of security issues. If left blank, this file is not used

dbfile

<dbfile>logs/db.log</dbfile>
Specifies the location and name of the file used to log database queries. The server command debugdb sets the amount of logging.

acl

<acl>acl.xml</acl>
This parameter specifies the location and name of the Access Control List settings file. If left
blank, server will use acl.xml file, located in the same folder as this configuration file.

scriptdebuglogfile

<scriptdebuglogfile>logs/scripts.log</scriptdebuglogfile>
Specifies the location and name of the debugscript log file. If left blank, server won't be saving this file.

scriptdebugloglevel

<scriptdebugloglevel>0</scriptdebugloglevel>
Specifies the level of the debugscript log file. Available values: 0, 1, 2, 3. When not set, defaults to 0.

htmldebuglevel

<htmldebuglevel>0</htmldebuglevel>
Specifies the level of the html debug. Available values: 0, 1, 2, 3. When not set, defaults to 0.

fpslimit

<fpslimit>36</fpslimit>
Specifies the frame rate limit that will be applied to connecting clients.
Available range: 25 to 100. Default: 36.
This parameter can be changed and saved while the server is running with setServerConfigSetting

autologin

<autologin>0</autologin>
Specifies whether or not players should automatically be logged in based on their IP adresses

voice

<voice>0</voice>
This parameter specifies whether or not to enable player voice chat in-game
Values: 0 - disabled , 1 - enabled

voice_samplerate

<voice_samplerate>1</voice_samplerate>
This parameter specifies the sample rate for voice chat. 'voice' parameter must be set to 1 for this to be effective. Higher settings use more bandwidth and increase the sampling quality of voice chat
Values: 0 - Narrowband (8kHz), 1 - Wideband (16kHz), 2 - Ultrawideband (32kHz). Default - 1

voice_quality

<voice_quality>4</voice_quality>
This parameter specifies the voice quality for voice chat. 'voice' parameter must be set to 1 for this to be effective. Higher settings use more bandwidth and increase the the overall quality of voice chat
Available range: 0 to 10. Default - 4

voice_bitrate

<!-- <voice_bitrate>24600</voice_bitrate> -->
Specifies the voice bitrate, in bps. This optional parameter overrides the previous two settings. If not set, MTA handles this automatically. Use with care.

backup_path

<backup_path>backups</backup_path>
This parameter specifies the path to use for a basic backup of some server files. Note that basic backups are only made during server startup. Default value: backups

backup_interval

<backup_interval>3</backup_interval>
This parameter specifies the number of days between each basic backup. Backups are only made during server startup, so the actual interval maybe much longer. Setting backup_interval to 0 will disable backups
Available range: 0 to 30. Default - 3

backup_copies

<backup_copies>5</backup_copies>
This parameter specifies the maximum number of backup copies to keep. Setting backup_copies to 0 will disable backups
Available range: 0 to 100. Default - 5

module

<!-- <module src="sample_win32.dll"/> -->
<!-- <module src="sample_linux.so"/> -->
Specifies the module(s) which are loaded with the server. To load several modules, add more <module> parameter(s). Optional parameter.

resource

<resource src="admin" startup="1" protected="0"/>
<resource src="defaultstats" startup="1" protected="0"/>
<resource src="helpmanager" startup="1" protected="0"/>
<resource src="joinquit" startup="1" protected="0"/>
<resource src="mapcycler" startup="1" protected="0"/>
<resource src="mapmanager" startup="1" protected="0"/>
<resource src="parachute" startup="1" protected="0"/>
<resource src="resourcebrowser" startup="1" protected="1" default="true"/>
<resource src="resourcemanager" startup="1" protected="1"/>
<resource src="scoreboard" startup="1" protected="0"/>
<resource src="spawnmanager" startup="1" protected="0"/>
<resource src="voice" startup="1" protected="0" />
<resource src="votemanager" startup="1" protected="0"/>
<resource src="webadmin" startup="1" protected="0"/>
Specifies resources that are loaded when the server starts and/or which are protected from being stopped. To specify several resources, add more <resource> parameter(s).