Server Configuration
Summary
The default server configuration file is named server.xml, and is located in the same folder as the file named Server.exe on Windows x86, Server_x64.exe on Windows x64, or Server on Linux.
You can use a custom server configuration file with the -config option. Example: Server.exe -config my-config.xml. See the server command arguments page for more info on accepted command arguments.
The file uses the XML syntax, with a root node named server.
Official XML Specification
Settings
| Server Property Name | Default Value | Description |
|---|---|---|
| compresspackets | false | The status of whether packets are compressed. This is only available in GTAC versions 1.0.66 and newer. |
| duplicatenames | false | The status of whether to allow players with duplicate names. |
| game | gta:iii (required) | The identifier of the game that the server should run for. See game identifiers for more information. |
| gamemode | n/a (required) | The name of the game mode, which appears in the server browser. |
| httpport | 22000 | The port for the server to transfer HTTP data on, between 0 and 65,535. |
| httpserver | true | Whether or not to run the HTTP server. If you don't run it, you'll need to host the HTTP server elsewhere, with the port found in httpport. |
| httpurl | "" (empty string) | A URL (like a CDN) containing the server's client resource files and scripts. Clients will download them from that URL instead of the server. |
| logpath | "" (empty string) | The path to store the server logs. Leave blank to not use server logs. |
| logtimestamp | "" (empty string) | The timestamp format to use in the log files. Based on the strftime format from C++. Some examples:
|
| maxplayers | 32 | The maximum amount of players that can connect to the server, between 0 and 256. |
| minclientversion | 1.0.0 | The minimum version that clients can connect with. |
| modules | (empty node) | The modules to load. Use the <module> tag inside the <modules> tag, for each module to load, including the src attribute for the directory path.
|
| packetcompressionlevel | default | The compression level for compressed packets, between 0 and 9, or the word default. Default is 6 (ZLib's Z_DEFAULT_COMPRESSION) |
| password | "" (empty string) | The password to connect to the server. |
| pickupstreamindistance | 50.0 | The distance that a pickup is sent to the client, recommended to be about 50.0. |
| pickupstreamoutdistance | 100.0 | The distance that a pickup is removed from the client, recommended to be about 100.0. |
| port | 22000 | The port for the server to listen on, between 0 and 65,535. Players only need to know the port if using the /connect command in-game, not when using the server browser. |
| processinterval | 50 | The interval, in milliseconds, of each process-once occurrence, between 0 and 65,535. |
| rcon | false | The status of whether the server will host the remote console service, use true or false. |
| rconpassword | "" (empty string) | The password to connect to the remote console service. |
| resources | (empty node) | The resources to load. Use the <resource> tag inside the <resources> tag, for each resource to load, including the src attribute for the directory path.
|
| serverbrowser | false | The status of whether to show the server in the server browser, use true or false. |
| servername | n/a (required) | The name of the server, which appears in the server browser. |
| streamindistance | 100.0 | The distance that an entity is sent to the client, recommended to be about 100.0. |
| streamoutdistance | 200.0 | The distance that an entity is removed from the client, recommended to be about 200.0. |
| syncinterval | 30 | The interval, in milliseconds, of each sync occurrence for the regularly sync'd data, between 0 and 65,535. |
| syncmethod | interval | The sync type for regularly sync'd data. Use none, interval, replay, or peer2peer. (See sync methods section below) |
| cvar | null | Sets a server's cvar value (See cvars section for accepted cvars) |
| bindip | true | Forces the server to use a specific IP. Only for hosts that have multiple IP addresses. |
| iv_gamemode | 30 | Sets the built-in gamemode for IV. See IV Gamemodes for more information. |
| iv_episode | 0 | Sets the DLC to use for IV. See IV Episodes for more information |
| timesync | false | Enables/disables syncing the time set by server to all clients |
| weathersync | false | Enables/disables syncing the weather set by server to all clients |
| rule | "" (empty string) | Adds a server rule. See server rules for more info. |
| multithreadednetworking | false | Enables/disables using multiple threads for managing network peers. Useful on multi-core systems. |
CVars
See the CVars page for info.
Sync Methods
There are a few different config options for server sync. Here is the list of them and a brief description of each.
| Name | Description |
|---|---|
| none | Disables element sync entirely. Not recommended for multiplayer environments. |
| replay | This will sync elements as soon as they're processed. If CPU usage is too busy and processing is slow, sync will be too. |
| interval | Default. This forces sync of elements at a specified interval. Use <syncinterval> in server config to set the interval time in milliseconds (ms) |
Sync Priority
There are a few different config options for sync packet priority. Here is the list of them and a brief description of each.
| Name | Description |
|---|---|
| immediate | Sends sync immediately without delay |
| high | Sends sync twice as much as medium (if both levels are waiting to be sent) |
| medium | Sends sync twice as much as low (if both levels are waiting to be sent) |
| low | Sends sync with the lowest priority |