Server Configuration File

From GT-MP
Jump to: navigation, search

Server Configuration File

  • settings.xml - is a configuration file which allows you to change the settings of your server, like hostname, password or resources to load, etc..

Settings

The following table will explain the use of the following settings:

Setting Default value Description
servername Server Name goes here Server name that will be displayed to the master server.
serverport 4499 The port that the server will use. Server uses both UDP and TCP protocols.
maxplayers 50 Maximum number of players your server will hold.
minclientversion 0.0.0.0 Clients with an older client version will not be able to connect.
minclientversion_auto_update true Auto update Client's files before connecting to the server
announce true Announce to the master server so people can see you in their server browser.
password [empty or null] Your server password. Leave blank for no password.
masterserver Masterserver Master server address. There is absolutely no need to touch this if we're still alive.
acl_enabled true Sets whether the Access Control List is enabled.
loglevel 0 Log level for debugging (between 0 and 3, where 1 is error, 2 is debug, 3 is verbose) (Deprecated)
log true Used to log all the console output to a file. (Deprecated)
global_stream_range 175 The global streaming range. Aka, how far things will "load" or "sync" globally.
player_stream_range 325 How far away players will be streamed or synced.
vehicle_stream_range 700 This is the range for unmanned vehicle sync.
marker_stream_range 500 This is the streaming range for Marker. (Next Update)
label_stream_range 50 This is the streaming range for Labels.(Next Update)
vehicle_lagcomp true Vehicle lag compensation switch. Disabling may result in smoother sync, but delayed data.
onfoot_lagcomp true On-foot lag compensation switch. Disabling may result in smoother sync, but delayed data.
shooting_lagcomp true Player shooting lag compensation switch. Disabling may result in smoother sync, but delayed data. (Next Update)
refresh_rate 120 Server refresh rate
resource src= "admin", "freeroam", "speedometer" Resources to automatically start after the server starts.
announce_lan true Announce to your LAN network.
upnp false Use Universal Plug & Play protocol to automatically port forward.
fqdn [empty or null] The ability to use FQDNs instead of IP addresses, if the IP matches the resolved domain name, then the IP gets replaced by the FQDN.
conntimeout true Enables or disables the 60 second reconnect timer.
allow_client_devtools false Enables the use of the dev tools on the client.
local_address [not included by default] 0.0.0.0 The local IP address to bind the server to.
player_update_timeout default 10 Sets the time in seconds, that the server waits for receiving packets by a player, it times the player out after that time
trust_client_entity_properties [not included by default] false To either allow client-side entity properties to be accepted by the server
exploit_blacklist true If true, server blacklists connections that might be abusing exploits (Blacklist gets wiped / resetted every server restart) (Next Update)
no_hwid_duplicate false If true checks on connection if theres anybody with that unique hardware id already connected, if yes the player is not able to connect. (Next Update)
no_socialclub_duplicate true If true checks on connection if theres anybody with that social club name already connected, if yes the player is not able to connect. (Next Update)
connections_slow_mode false If true the server will only accept max 5 player connections every second. (Next Update)
httpserver false Uses a HTTP server for file download to the client (Next Update)
smoother_less_accurate_onfoot_sync false Uses a smoother onfoot-sync for peds, but can cause desyncs - HIGHLY EXPERIMENTAL! (Next Update)
smoother_less_accurate_vehicle_sync false Uses a smoother vehicle-sync, but can cause desyncs - HIGHLY EXPERIMENTAL! (Next Update)

Sample file

<?xml version="1.0"?>
<config xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <servername>Simple Grand Theft Multiplayer Server</servername>
  <serverport>4499</serverport>
  <maxplayers>50</maxplayers>
  <minclientversion>0.0.0.0</minclientversion>
  <minclientversion_auto_update>true</minclientversion_auto_update>
  <announce>true</announce>
  <password></password>
  <masterserver>http://master.mta-v.net/api/</masterserver>
  <acl_enabled>true</acl_enabled>
  <global_streaming_range>175</global_streaming_range>
  <player_streaming_range>325</player_streaming_range>
  <vehicle_streaming_range>700</vehicle_streaming_range>
  <marker_stream_range>500</marker_stream_range>
  <label_stream_range>50</label_stream_range>
  <vehicle_lagcomp>true</vehicle_lagcomp>
  <onfoot_lagcomp>true</onfoot_lagcomp>
  <shooting_lagcomp>true</shooting_lagcomp>
  <refresh_rate>120</refresh_rate>
  <announce_lan>true</announce_lan>
  <upnp>false</upnp>
  <fqdn></fqdn>
  <conntimeout>false</conntimeout>
  <allow_client_devtools>false</allow_client_devtools>
  <player_update_timeout>10</player_update_timeout>
  <exploit_blacklist>true</exploit_blacklist>
  <no_hwid_duplicate>false</no_hwid_duplicate>
  <no_socialclub_duplicate>true</no_socialclub_duplicate>
  <connections_slow_mode>false</connections_slow_mode>
  
  <resource src="admin" />
  <resource src="freeroam" />
  <resource src="speedometer" />
  
</config>