Server Config File – Arma 3

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "\[ *(https?\:\/\/[^\[ ]+\.arma3\.com[^\[]+) ([^ ]+) *\]" to "{{ExternalLink|link= $1|text= $2}}")
m (→‎Server Options: Fixed verifySignatures default value to 0)
(19 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{TOC|side}}
{{TOC|side}}
{{Table/A3ServerSetup}}
{{Table/A3ServerSetup}}
<br clear="all"/>
 
 
{{Feature|arma2oa|This page is about '''{{arma3}}''' server configuration. For previous titles, see [[Arma 2: Server Config File]].}}
 


This article deals with the '''server.cfg''', a configuration file which one can use to configure various game server settings such as the difficulty level, how many votes are needed, and welcome messages.
This article deals with the '''server.cfg''', a configuration file which one can use to configure various game server settings such as the difficulty level, how many votes are needed, and welcome messages.
The name ''server.cfg'' means nothing, and this file can be called anything. The real name is determined by the <tt>[[Arma 3: Startup Parameters|-config]]</tt> command line option when launching the dedicated server. There is no default name - when you do not specify the filename, no server configuration file is loaded.
The name ''server.cfg'' means nothing, and this file can be called anything. The real name is determined by the {{hl|[[Arma 3: Startup Parameters|-config]]}} command line option when launching the dedicated server. There is no default name: when no filename is specified, no server configuration file is loaded.
{{Feature|Informative|For games prior to {{arma3}} see [[server.cfg]].}}
 
= Server Options =
 
{| class="wikitable sortable" style="width: 100%"
{{Clear}}
! Parameter !! width="10%" | Default!! Description !! Since
== Server Options ==
 
{| class="wikitable sortable align-center-col-2 align-center-col-4" style="width: 100%"
! Parameter
! width="10%" | Default
! Description
! Since
|-
| {{hl|c= passwordAdmin = "xyzxyz";}} || {{hl|""}} || Password to protect admin access. || {{n/a}}
|-
|-
| <tt>passwordAdmin = "xyzxyz";</tt> || <tt>""</tt> || Password to protect admin access. || -
| {{hl|c= password = "xyz";}} || {{hl|""}} || Password required to connect to server. || {{n/a}}
|-
|-
| <tt>password = "xyz";</tt> || <tt>""</tt> || Password required to connect to server. || -
| {{hl|c= serverCommandPassword = "xyzxyz";}} || {{hl|""}} || Password required by alternate syntax of [[serverCommand]] server-side scripting (Case-Sensitive). || {{n/a}}
|-
|-
| <tt>serverCommandPassword = "xyzxyz";</tt> || <tt>""</tt> || Password required by alternate syntax of [[serverCommand]] server-side scripting. || -
| {{hl|c= hostname="My Server";}} || {{hl|UNKNOWN}} || Servername visible in the game browser. || {{n/a}}
|-
|-
| <tt>hostname="My Server";</tt> || <tt>UNKNOWN</tt> || Servername visible in the game browser. || -
| {{hl|c= maxPlayers = 10;}} || {{hl|64}} (DS) || The maximum number of players that can connect to server. The final number will be lesser between number given here and number of mission slots. || {{n/a}}
|-
|-
| <tt>maxPlayers = 10;</tt> || <tt>64</tt>(DS) || The maximum number of players that can connect to server. The final number will be lesser between number given here and number of mission slots. || -
| {{hl|c= motd[]= {"Welcome to my server.", "Hosted in the net."};}} || {{hl|<nowiki>{}</nowiki>}} || Two lines welcome message. Comma is the 'new line' separator. || {{n/a}}
|-
|-
| <tt>motd[]= {"Welcome to my server.", "Hosted in the net."};</tt> || <tt>{}</tt> || Two lines welcome message. Comma is the 'new line' separator. || -
| {{hl|c= admins[] = {"<UID>"};}} || {{hl|{}<nowiki/>}} || Whitelisted clients can use {{hl|#login}} without password. See {{Link|#Logged In Admin}}. || {{GVI|arma3|1.70}}
|-
|-
| <tt>admins[] = {"<UID>"};</tt> || <tt>{}</tt> || Whitelisted clients can use #login w/o password. See [[server.cfg#Logged_In_Admin|Logged In Admin]] || {{GVI|arma3|1.70}}
| {{hl|c= headlessClients[] = {"<IP>"};}} || {{hl|<nowiki>{}</nowiki>}} || Headless Client IPs. Multiple connections and addresses are allowed in case of multiple Headless Clients. See [[Arma 3: Headless Client]]. || {{n/a}}
|-
|-
| <tt>headlessClients[] = {"<IP>"};</tt> || <tt>{}</tt> || Headless clients IPs. Multiple connections and addresses are allowed in the case of more than one Headless Client. See [[Arma 3: Headless Client]] || -
| {{hl|c= localClient[] = {"<IP>"};}} || {{hl|<nowiki>{}</nowiki>}} || Indicates clients with ''unlimited'' bandwidth and ''nearly no latency''. See [[Arma 3: Headless Client]]. || {{n/a}}
|-
|-
| <tt>localClient[] = {"<IP>"};</tt> || <tt>{}</tt> || Indicates clients with ''unlimited'' bandwidth and ''nearly no latency''. See [[Arma 3: Headless Client]] || -
| {{hl|c= filePatchingExceptions[] = {"<UID>"};}} || {{hl|<nowiki>{}</nowiki>}} || Whitelisted clients ignore the rules defined by {{hl|allowedFilePatching}} and {{hl|verifySignatures}}, allowing them to join the server with any mods of their choice. Signature errors are still logged by the server upon connection.  {{Feature|warning|Signature errors may still kick the user if the error happens before the server knows the clients SteamID, for example when trying to join with completely unsigned pbo's.}} || ''This entry has existed since 2016, but only became fully operational in'' {{GVI|arma3|2.10}}
|-
|-
! colspan="4" | Server Behaviour
! colspan="4" | Server Behaviour
|-
|-
| <tt>voteThreshold = 0.33;</tt> || <tt>UNKNOWN</tt> || Percentage of votes needed to confirm a vote. <tt>33%</tt> in this example. || -
| {{hl|c= voteThreshold = 0.33;}} || {{hl|UNKNOWN}} || Percentage of votes needed to confirm a vote. {{hl|33%}} in this example. || {{n/a}}
|-
|-
| <tt>voteMissionPlayers = 3;</tt> || <tt>UNKNOWN</tt> || Start mission-voting when ''X'' numberOfPlayers connect. || -
| {{hl|c= voteMissionPlayers = 3;}} || {{hl|UNKNOWN}} || Start mission-voting when ''X'' numberOfPlayers connect. || {{n/a}}
|-
|-
| <tt>allowedVoteCmds[] = { {"kick", false, false, 0.75} };</tt> || <tt>{}</tt> || See [[Arma 3: Mission voting]] || -
| {{hl|c= allowedVoteCmds[] = { {"kick", false, false, 0.75} };}} || {{hl|<nowiki>{}</nowiki>}} || See [[Arma 3: Mission voting]]. || {{n/a}}
|-
|-
| <tt>allowedVotedAdminCmds[] = { { "mission", true, true } }; || <tt>{}</tt> || </tt> See [[Arma 3: Mission voting]] || -
| {{hl|c= allowedVotedAdminCmds[] = <nowiki>{ { "mission", true, true } }</nowiki>;}} || {{hl|<nowiki>{}</nowiki>}} || See [[Arma 3: Mission voting]]. || {{n/a}}
|-
|-
| <tt>kickduplicate = 1;</tt> || <tt>UNKNOWN</tt> || Do not allow duplicate ''game IDs''. Second player with an existing ID will be kicked automatically. <tt>1</tt> means active, <tt>0</tt> disabled. || -
| {{hl|c= kickduplicate = 1;}} || {{hl|UNKNOWN}} || Do not allow duplicate ''game IDs''. Second player with an existing ID will be kicked automatically. {{hl|1}} means active, {{hl|0}} disabled. || {{n/a}}
|-
|-
| <tt>loopback = true;</tt> || <tt>false</tt> || Adding this option will force server into LAN mode. This will allow multiple local instances of the game to connect to the server for testing purposes. At the same time it will prevent all non-local instances from connecting. || -
| {{hl|c= loopback = true;}} || {{hl|false}} || Adding this option will force server into LAN mode. This will allow multiple local instances of the game to connect to the server for testing purposes. At the same time it will prevent all non-local instances from connecting. || {{n/a}}
|-
|-
| <tt>upnp = true;</tt> || <tt>false</tt> || Automatically creates port mapping on UPNP/IGD enabled router. This option allows you to create a server behind NAT (your router must have public IP and support UPNP/IGD protocol). Read more {{Wikipedia|Internet_Gateway_Device_Protocol|Internet Gateway Device (IGD) Standardized Device Control Protocol}}. {{Feature|warning|When enabled then this setting may delay server start-up by 600s (standard UDP timeout of 10 minutes) if blocked on firewall or bad routing etc. Thus in such case is recommended to disable it.}} || -
| {{hl|c= upnp = true;}} || {{hl|false}} || Automatically creates port mapping on UPNP/IGD enabled router. This option allows to create a server behind NAT (the router must have public IP and support UPNP/IGD protocol). Read more {{Wikipedia|Internet_Gateway_Device_Protocol|Internet Gateway Device (IGD) Standardized Device Control Protocol}}. {{Feature|warning|When enabled then this setting may delay server start-up by 600s (standard UDP timeout of 10 minutes) if blocked on firewall or bad routing etc. Thus in such case is recommended to disable it.}} || {{n/a}}
|-
|-
| <tt>allowedFilePatching = 0;</tt> || <tt>0</tt> || Prevent or allow file patching for the clients (including the HC)
| {{hl|c= allowedFilePatching = 0;}} || {{hl|0}} || Prevent or allow file patching for the clients (including the HC)
* 0 is no clients
* 0 is no clients
* 1 is Headless Clients only
* 1 is Headless Clients only
Line 50: Line 61:
| {{GVI|arma3|1.50}}
| {{GVI|arma3|1.50}}
|-
|-
| <tt>allowedLoadFileExtensions[] = {"sqf","txt"};</tt> || <tt>UNKNOWN</tt> || Only allow files with listed extensions to be loaded via [[loadFile]] command. Not listing any extension means everything is allowed. Defining the setting as empty arrays means nothing is allowed. || {{GVI|arma3|1.20}}
| {{hl|c= allowedLoadFileExtensions[] = {"sqf","txt"};}} || {{hl|UNKNOWN}} || Only allow files with listed extensions to be loaded via [[loadFile]] command. Not listing any extension means everything is allowed. Defining the setting as empty arrays means nothing is allowed. || {{GVI|arma3|1.20}}
|-
|-
| <tt>allowedPreprocessFileExtensions[] = {"sqf","sqs"};</tt> || <tt>UNKNOWN</tt> || Only allow files with listed extensions to be loaded via [[preprocessFile]] / [[preprocessFileLineNumbers]] commands. Not listing any extension means everything is allowed. Defining the setting as empty arrays means nothing is allowed. || {{GVI|arma3|1.20}}
| {{hl|c= allowedPreprocessFileExtensions[] = {"sqf","sqs"};}} || {{hl|UNKNOWN}} || Only allow files with listed extensions to be loaded via [[preprocessFile]] / [[preprocessFileLineNumbers]] commands. Not listing any extension means everything is allowed. Defining the setting as empty arrays means nothing is allowed. || {{GVI|arma3|1.20}}
|-
|-
| <tt>allowedHTMLLoadExtensions[] = {"htm","html"};</tt> || <tt>UNKNOWN</tt> || Only allow files and URLs with listed extensions to be loaded via [[htmlLoad]] command. Not listing any extension means everything is allowed. Defining the setting as empty arrays means nothing is allowed. || {{GVI|arma3|1.28}}
| {{hl|c= allowedHTMLLoadExtensions[] = {"htm","html"};}} || {{hl|UNKNOWN}} || Only allow files and URLs with listed extensions to be loaded via [[htmlLoad]] command. Not listing any extension means everything is allowed. Defining the setting as empty arrays means nothing is allowed. || {{GVI|arma3|1.28}}
|-
|-
| <tt>allowedHTMLLoadURIs[] = {"http://arma3.com"};</tt> || <tt>UNKNOWN</tt> || Only allow files from listed URIs and URLs to be loaded via [[htmlLoad]] command. Comment out if not used. Can use += to add to the existing list. Not listing any extension means everything is allowed. Defining the setting as empty arrays means nothing is allowed. || -
| {{hl|c= allowedHTMLLoadURIs[] = {"http://arma3.com"};}} || {{hl|UNKNOWN}} || Only allow files from listed URIs and URLs to be loaded via [[htmlLoad]] command. Comment out if not used. Can use += to add to the existing list. Not listing any extension means everything is allowed. Defining the setting as empty arrays means nothing is allowed. || {{n/a}}
|-
|-
| <tt>filePatchingExceptions[] = {"123456789","987654321"};</tt> || <tt>{}</tt> || Whitelisted Steam IDs allowed filePatching || -
| {{hl|c= disconnectTimeout = 5;}} || {{hl|90}} || Server wait time before disconnecting client after loss of active traffic connection, range 5 to 90 seconds. || {{GVI|arma3|1.56}}
|-
|-
| <tt>disconnectTimeout = 5;</tt> || <tt>90</tt> || Server wait time before disconnecting client after loss of active traffic connection, range 5 to 90 seconds. || {{GVI|arma3|1.56}}
| {{hl|c= maxdesync = 150;}} || {{hl|UNKNOWN}} || Max desync value until server kick the user || {{GVI|arma3|1.56}}
|-
|-
| <tt>maxdesync = 150;</tt> || <tt>UNKNOWN</tt> || Max desync value until server kick the user || {{GVI|arma3|1.56}}
| {{hl|c= maxping= 200;}} || {{hl|UNKNOWN}} || Max ping value until server kick the user || {{GVI|arma3|1.56}}
|-
|-
| <tt>maxping= 200;</tt> || <tt>UNKNOWN</tt> || Max ping value until server kick the user || {{GVI|arma3|1.56}}
| {{hl|c= maxpacketloss= 50;}} || {{hl|UNKNOWN}} || Max packetloss value until server kick the user || {{GVI|arma3|1.56}}
|-
|-
| <tt>maxpacketloss= 50;</tt> || <tt>UNKNOWN</tt> || Max packetloss value until server kick the user || {{GVI|arma3|1.56}}
| {{hl|c= kickClientsOnSlowNetwork[] = { 0, 0, 0, 0 };}} || {{hl|UNKNOWN}} || Defines if {{hl|{<MaxPing>, <MaxPacketLoss>, <MaxDesync>, <DisconnectTimeout>}}} will be logged (0) or kicked (1) || {{GVI|arma3|1.56}}
|-
|-
| <tt>kickClientsOnSlowNetwork[] = { 0, 0, 0, 0 };</tt> || <tt>UNKNOWN</tt> || Defines if <tt>{<MaxPing>, <MaxPacketLoss>, <MaxDesync>, <DisconnectTimeout>}</tt> will be logged (0) or kicked (1) || {{GVI|arma3|1.56}}
| {{hl|c= enablePlayerDiag = 1}} || {{hl|0}} || Logs players' bandwidth and desync info every 60 seconds, as well as "network message is pending" owner identity. || {{n/a}}
|-
|-
| <tt>enablePlayerDiag = 1</tt> || <tt>0</tt> || Logs players' bandwidth and desync info every 60 seconds, as well as "network message is pending" owner identity. || -
| {{hl|c= callExtReportLimit = 1000;}} || {{hl|1000}} || If server initiated [[callExtension]] takes longer than specified limit in milliseconds, the warning will be logged into server {{hl|.rpt}} file as well as reflected in the extension return result. || {{n/a}}
|-
|-
| <tt>callExtReportLimit = 1000;</tt> || <tt>1000</tt> || If server initiated [[callExtension]] takes longer than specified limit in milliseconds, the warning will be logged into server <tt>.rpt</tt> file as well as reflected in the extension return result. || -
| {{hl|c= kickTimeout[] = { {0, -1},{1, 180},{2, 180},{3, 180} };}} || {{hl|UNKNOWN}} ||
|-
{{hl|c= kickTimeout[] = { {kickID, timeout}, ... };}}<br>
| <tt>kickTimeout[] = { {0, -1},{1, 180},{2, 180},{3, 180} };</tt> || <tt>UNKNOWN</tt> ||
<tt>kickTimeout[] = { {kickID, timeout}, ... };</tt><br>
kickID (type to determine from where the kick originated e.g. admin or votekick etc.)
kickID (type to determine from where the kick originated e.g. admin or votekick etc.)
* 0 - manual kick (vote kick, admin kick, bruteforce detection etc.)
* 0 - manual kick (vote kick, admin kick, bruteforce detection etc.)
Line 85: Line 94:
* -1 until missionEnd
* -1 until missionEnd
* -2 until serverRestart<br>
* -2 until serverRestart<br>
| {{GVI|arma3|1.90}} Profil. Branch
| {{GVI|arma3|1.90}}
|-
|-
| <tt>votingTimeOut = 60;</tt> || <tt>60</tt> || Voting timeout || -
| {{hl|c= votingTimeOut = 60;}} || {{hl|60}} || Voting timeout || {{n/a}}
|-
|-
| <tt>votingTimeOut[] = {60, 90};</tt>  || <tt>{60, 90}</tt> || Voteing timeout {ready, notReady} || {{GVI|arma3|1.90}} Profil. Branch
| {{hl|c= votingTimeOut[] = {60, 90};}} || {{hl|<nowiki>{60, 90}</nowiki>}} || Voteing timeout {{hl|<nowiki>{ready, notReady}</nowiki>}} || {{GVI|arma3|1.90}}
|-
|-
| <tt>roleTimeOut = 90;</tt> || <tt>90</tt> || Role seleciton timout || -
| {{hl|c= roleTimeOut = 90;}} || {{hl|90}} || Role seleciton timout || {{n/a}}
|-
|-
| <tt>roleTimeOut[] = {90, 120};</tt> || <tt>{90, 120}</tt> || Role selection timeout <tt>{ready, notReady}</tt> || {{GVI|arma3|1.90}} Profil. Branch
| {{hl|c= roleTimeOut[] = {90, 120};}} || {{hl|<nowiki>{90, 120}</nowiki>}} || Role selection timeout {{hl|<nowiki>{ready, notReady}</nowiki>}} || {{GVI|arma3|1.90}}
|-
|-
| <tt>briefingTimeOut = 60;</tt> || <tt>60</tt> || Briefing timeout || -
| {{hl|c= briefingTimeOut = 60;}} || {{hl|60}} || Briefing timeout || {{n/a}}
|-
|-
| <tt>briefingTimeOut[] = {60, 90};</tt> || <tt>{90, 120}</tt> || Briefing timeout <tt>{ready, notReady}</tt> || {{GVI|arma3|1.90}} Profil. Branch
| {{hl|c= briefingTimeOut[] = {60, 90};}} || {{hl|<nowiki>{90, 120}</nowiki>}} || Briefing timeout {{hl|<nowiki>{ready, notReady}</nowiki>}} || {{GVI|arma3|1.90}}
|-
|-
| <tt>debriefingTimeOut = 45;</tt> || <tt>45</tt> || Briefing timeout || -
| {{hl|c= debriefingTimeOut = 45;}} || {{hl|45}} || Briefing timeout || {{n/a}}
|-
|-
| <tt>debriefingTimeOut [] = {60, 60};</tt> || <tt>{90, 120}</tt> || Debriefing timeout <tt>{ready, notReady}</tt> || {{GVI|arma3|1.90}} Profil. Branch
| {{hl|c= debriefingTimeOut[] = {60, 60};}} || {{hl|<nowiki>{90, 120}</nowiki>}} || Debriefing timeout {{hl|<nowiki>{ready, notReady}</nowiki>}} || {{GVI|arma3|1.90}}
|-
|-
| <tt>lobbyIdleTimeout = 300;</tt> || <tt>300</tt> || Lobby idle timeout
| {{hl|c= lobbyIdleTimeout = 300;}} || {{hl|300}} || Lobby idle timeout
Independent of set ''lobbyIdleTimeout'' in the config file, it will be at least<br>
Independent of set ''lobbyIdleTimeout'' in the config file, it will be at least<br>
<tt>MAX(votingTimeout, lobbyTimeout, briefingTimeout, debriefingTimeout) + 5 seconds</tt>
{{hl|MAX(votingTimeout, lobbyTimeout, briefingTimeout, debriefingTimeout) + 5 seconds}}
by default, this makes it 300 seconds of time for people in lobby and 95 in roleTimeout or briefing screen<br>
by default, this makes it 300 seconds of time for people in lobby and 95 in roleTimeout or briefing screen<br>
| {{GVI|arma3|1.90}} Profil. Branch
| {{GVI|arma3|1.90}}
|-
|-
| <tt>missionsToServerRestart = 8;</tt> || <tt>UNKNOWN</tt> || Number of times missionEnd happens before server initiate process restart (uses actual session startup command-line parameters, not possible to combine with `missionsToShutdown` ) || -
| {{hl|c= missionsToServerRestart = 8;}} || {{hl|UNKNOWN}} || Number of times missionEnd happens before server initiate process restart (uses actual session startup command-line parameters, not possible to combine with `missionsToShutdown` ) || {{n/a}}
|-
|-
| <tt>missionsToShutdown = 8;</tt> || <tt>UNKNOWN</tt> || Number of times missionEnd happens before server initiate process shutdown (has same behavior as setting named `missionsToHardRestart`) || -
| {{hl|c= missionsToShutdown = 8;}} || {{hl|UNKNOWN}} || Number of times missionEnd happens before server initiate process shutdown (has same behavior as setting named `missionsToHardRestart`) || {{n/a}}
|-
|-
| <tt>autoSelectMission = true;</tt> || <tt>false</tt> || When enabled, the server auto-starts next mission in mission cycle and waits for players in the role selection. This allows full mission information in server browser and then results in proper filtering of the servers. This is lesser-variant (trimmed) of server startup command-line parameter <tt>-autoInit</tt>. Might collide with campaign linked missions / need mission cycle etc. || -
| {{hl|c= autoSelectMission = true;}} || {{hl|false}} || When enabled, the server auto-starts next mission in mission cycle and waits for players in the role selection. This allows full mission information in server browser and then results in proper filtering of the servers. This is lesser-variant (trimmed) of server startup command-line parameter {{hl|-autoInit}}. Might collide with campaign linked missions / need mission cycle etc. || {{n/a}}
|-
|-
| <tt>randomMissionOrder = true;</tt> || <tt>UNKNOWN</tt> || When enabled, the server random start / next selection with one of missions from mission rotation list. ( setting goes outside(before) Mission class {}; ) || -
| {{hl|c= randomMissionOrder = true;}} || {{hl|UNKNOWN}} || When enabled, the server random start / next selection with one of missions from mission rotation list. ( setting goes outside(before) Mission class {}; ) || {{n/a}}
|-
|-
| <tt>disableChannels[] = { {0,false,true} };</tt> || <tt>{}</tt> ||
| {{hl|c= disableChannels[] = { {0,false,true} };}} || {{hl|<nowiki>{}</nowiki>}} ||
<tt>disableChannels[] = { {channelID, text, voice}, ... }>;</tt><br>
{{hl|c= disableChannels[] = { {channelID, text, voice}, ... }>;}}<br>
* ''ChannelID'' : [[Number]] - use single digit of (0 to 6) to define channelID. Default: No restriction to any channels, with text/von chat set to false.<br>
* ''ChannelID'' : [[Number]] - use single digit of (0 to 6) to define channelID. Default: No restriction to any channels, with text/von chat set to false.<br>
* ''text'' : [[Boolean]] - use [[true]] to disable usage of text-chat for defined channelID. Default: '''[[false]]'''<br>
* ''text'' : [[Boolean]] - use [[true]] to disable usage of text-chat for defined channelID. Default: '''[[false]]'''<br>
* ''voice'' : [[Boolean]] - use [[true]] to disable usage of voice-chat (VON) for defined channelID. Default: '''[[false]]'''<br>
* ''voice'' : [[Boolean]] - use [[true]] to disable usage of voice-chat (VON) for defined channelID. Default: '''[[false]]'''<br>
List of channels ID:
List of channels ID:
{{Columns|3|
{{Columns|4|2=<nowiki/>
* 0 {{=}} Global
* 0 = Global
* 1 {{=}} Side
* 1 = Side
* 2 {{=}} Command
* 2 = Command
* 3 {{=}} Group
* 3 = Group
* 4 {{=}} Vehicle
* 4 = Vehicle
* 5 {{=}} Direct
* 5 = Direct
* 6 {{=}} System
* 6 = System
}}
}}
{{Feature|Informative|Missions which use [[Description.ext#disableChannels|Description.ext#disableChannels]] will override any setting of ''disableChannels[]'' in the '''server.cfg'''.}}
{{Feature|Informative|Missions which use [[Description.ext#disableChannels|Description.ext#disableChannels]] will override any setting of ''disableChannels[]'' in the '''server.cfg'''.}}
Line 137: Line 146:
! colspan="4" | Other Options
! colspan="4" | Other Options
|-
|-
| <tt>verifySignatures = 2;</tt> || <tt>2</tt>|| Enables or disables the [[ArmA: Addon Signatures|signature verification]] for addons.
| {{hl|c= verifySignatures = 2;}} || {{hl|0}}|| Enables or disables the [[ArmA: Addon Signatures|signature verification]] for addons.
* Verification disabled = <tt>0</tt>.
* Verification disabled = {{hl|0}}.
*<tt>1</tt> Will default back to <tt>2</tt>
*{{hl|1}} Will default back to {{hl|2}}
| -
| -
|-
|-
| <tt>drawingInMap = false;</tt> || <tt>true</tt> || Enables or disables the ability to place markers and draw lines in map. || {{GVI|arma3|1.64}}
| {{hl|c= drawingInMap = false;}} || {{hl|true}} || Enables or disables the ability to place markers and draw lines in map. || {{GVI|arma3|1.64}}
|-
|-
| <tt>disableVoN = 1;</tt> || <tt>0</tt> || Enables or disables the '''''V'''oice '''o'''ver '''N'''et''. || -
| {{hl|c= disableVoN = 1;}} || {{hl|0}} || Enables or disables the '''''V'''oice '''o'''ver '''N'''et''. || {{n/a}}
|-
|-
| <tt>vonCodecQuality = 10;</tt> || <tt>3</tt> || Defines ''VoN'' codec quality. Value range is from <tt>1</tt> to <tt>20</tt>.
| {{hl|c= vonCodecQuality = 10;}} || {{hl|3}} || Defines ''VoN'' codec quality. Value range is from {{hl|1}} to {{hl|20}}.
* Since 1.62 supports range <tt>1-20</tt>
* Since 1.62 supports range {{hl|1-20}}
* Since 1.64 will support range <tt>1-30</tt>
* Since 1.64 will support range {{hl|1-30}}
* 8kHz is <tt>0-10</tt>, 16kHz is <tt>11-20</tt>, for <tt>21-30</tt> it is 32kHz for SPEEX codec and 48kHz for OPUS codec.
* 8kHz is {{hl|0-10}}, 16kHz is {{hl|11-20}}, for {{hl|21-30}} it is 32kHz for SPEEX codec and 48kHz for OPUS codec.
| -
| -
|-
|-
| <tt>vonCodec = 1;</tt> || <tt>0</tt> || Defines ''VoN'' codec type. Value range is from <tt>0</tt> to <tt>1</tt>.
| {{hl|c= vonCodec = 1;}} || {{hl|0}} || Defines ''VoN'' codec type. Value range is from {{hl|0}} to {{hl|1}}.
* Since Arma 3 update 1.58 supports value <tt>1</tt>
* Since Arma 3 update 1.58 supports value {{hl|1}}
* Value <tt>0</tt> uses older {{Wikipedia|Speex|SPEEX codec}}, while <tt>1</tt> switches to new IETF standard {{Wikipedia|Opus_(audio_format)|OPUS codec}}.
* Value {{hl|0}} uses older {{Wikipedia|Speex|SPEEX codec}}, while {{hl|1}} switches to new IETF standard {{Wikipedia|Opus_(audio_format)|OPUS codec}}.
| -
| -
|-
|-
| <tt>skipLobby = false;</tt> || <tt>false</tt> || If true, joining player will skip role selection. This is only used if no Mission, Campaign or Config setting <tt>skipLobby</tt> is defined (See [[Description.ext#skipLobby]]). || -
| {{hl|c= skipLobby = false;}} || {{hl|false}} || If true, joining player will skip role selection. This is only used if no Mission, Campaign or Config setting {{hl|skipLobby}} is defined (See [[Description.ext#skipLobby]]). || {{n/a}}
|-
|-
| <tt>allowProfileGlasses = false;</tt>
| {{hl|c= allowProfileGlasses = false;}}
| <tt>true</tt>
| {{hl|true}}
| If false, glasses set in player profile will be ignored. This is only used if no Mission, Campaign or Config setting <tt>allowProfileGlasses</tt> is defined (See {{HashLink|Description.ext#allowProfileGlasses}})
| If false, glasses set in player profile will be ignored. This is only used if no Mission, Campaign or Config setting {{hl|allowProfileGlasses}} is defined (See {{Link|Description.ext#allowProfileGlasses}})
| {{GVI|arma3|2.06}}
| {{GVI|arma3|2.06}}
|-
|-
| <tt>zeusCompositionScriptLevel = 0;</tt>
| {{hl|c= zeusCompositionScriptLevel = 0;}}
| <tt>1</tt>
| {{hl|1}}
|
|
* 0: all scripts are forbidden
* 0: all scripts are forbidden
* 1: only attributes are allowed (including custom attributes added by mods)
* 1: only attributes are allowed (including custom attributes added by mods)
* 2: all scripts are allowed including init scripts
* 2: all scripts are allowed including init scripts
This is only used if no Mission, Campaign or Config setting <tt>zeusCompositionScriptLevel</tt> is defined (See {{HashLink|Description.ext#zeusCompositionScriptLevel}}).<br>
This is only used if no Mission, Campaign or Config setting {{hl|zeusCompositionScriptLevel}} is defined (See {{Link|Description.ext#zeusCompositionScriptLevel}}).<br>
| {{GVI|arma3|2.06}}
| {{GVI|arma3|2.06}}
|-
|-
| <tt>logFile = "server_console.log";</tt> || <tt>UNKNOWN</tt> || Enables output of dedicated server console into ''textfile''. Default location of log is same as ''crash dumps'' and other logs. (Local settings) Note that this does not change the location of the "''net.log''" file, which you enable with the <tt>-netlog</tt> command line option. || -
| {{hl|c= logFile = "server_console.log";}} || {{hl|UNKNOWN}} || Enables output of dedicated server console into ''textfile''. Default location of log is same as ''crash dumps'' and other logs. (Local settings) Note that this does not change the location of the "''net.log''" file, which is enabled with the {{hl|-netlog}} command line option. || {{n/a}}
|-
|-
| <tt>doubleIdDetected = "command";</tt> || <tt>""</tt> || rowspan="8" align="center" | See [[ArmA: Server Side Scripting|Server Side Scripting]]
| {{hl|c= doubleIdDetected = "command";}} || {{hl|""}} || rowspan="8" align="center" | See [[Arma 3: Server Side Scripting|Server Side Scripting]]
|-
|-
| <tt>onUserConnected = "command";</tt> || <tt>""</tt> || -
| {{hl|c= onUserConnected = "command";}} || {{hl|""}} || {{n/a}}
|-
|-
| <tt>onUserDisconnected = "command";</tt> || <tt>""</tt> || -
| {{hl|c= onUserDisconnected = "command";}} || {{hl|""}} || {{n/a}}
|-
|-
| <tt>onHackedData = "command";</tt> || <tt>""</tt> || -
| {{hl|c= onHackedData = "command";}} || {{hl|""}} || {{n/a}}
|-
|-
| <tt>onDifferentData = "command";</tt> || <tt>""</tt> || -
| {{hl|c= onDifferentData = "command";}} || {{hl|""}} || {{n/a}}
|-
|-
| <tt>onUnsignedData = "command";</tt> || <tt>""</tt> || -
| {{hl|c= onUnsignedData = "command";}} || {{hl|""}} || {{n/a}}
|-
|-
| <tt>onUserKicked = "command";</tt> || <tt>""</tt> || -
| {{hl|c= onUserKicked = "command";}} || {{hl|""}} || {{n/a}}
|-
|-
| <tt>regularCheck = "command";</tt> || <tt>""</tt> || -
| {{hl|c= regularCheck = "command";}} || {{hl|""}} || {{n/a}}
|-
|-
| <tt>BattlEye = 1;</tt> || <tt>1</tt> || Enables or disables the [[BattlEye]] anti-cheat engine. Requires installed [[BattlEye]] on server and clients joining the server || -
| {{hl|c= BattlEye = 1;}} || {{hl|1}} || Enables or disables the [[BattlEye]] anti-cheat engine. Requires installed [[BattlEye]] on server and clients joining the server || {{n/a}}
|-
|-
| <tt>timeStampFormat = "none";</tt> || <tt>""</tt> || Set the timestamp format used on each report line in server-side [[Crash Files|RPT file]]. Possible values are "none", "short", "full". || -
| {{hl|c= timeStampFormat = "none";}} || {{hl|""}} || Set the timestamp format used on each report line in server-side [[Crash Files|RPT file]]. Possible values are "none", "short", "full". || {{n/a}}
|-
|-
| <tt>forceRotorLibSimulation = 0;</tt> || <tt>0</tt> || Enforces the Advanced Flight Model on the server. <tt>0</tt> (up to the player). <tt>1</tt> - forced AFM, <tt>2</tt> - forced SFM. || {{GVI|arma3|1.34}}
| {{hl|c= forceRotorLibSimulation = 0;}} || {{hl|0}} || Enforces the Advanced Flight Model on the server. {{hl|0}} (up to the player). {{hl|1}} - forced AFM, {{hl|2}} - forced SFM. || {{GVI|arma3|1.34}}
|-
|-
| <tt>persistent = 1;</tt> || <tt>0</tt> || Mission keeps running when all clients disconnect. Enabling the persistence option will make missions that have either ''base'' or ''instant'' respawn keep on running after all players have disconnected. The other respawn types will not make a mission persistent. The kind of respawn a certain mission uses is set in its [[Description.ext]]. || -
| {{hl|c= persistent = 1;}} || {{hl|0}} || Mission keeps running when all clients disconnect. Enabling the persistence option will make missions that have either ''base'' or ''instant'' respawn keep on running after all players have disconnected. The other respawn types will not make a mission persistent. The kind of respawn a certain mission uses is set in its [[Description.ext]]. || {{n/a}}
|-
|-
| <tt>requiredBuild = xxxxx;</tt> || <tt>UNKNOWN</tt> || Minimum required client version. Clients with version lower than <tt>requiredBuild</tt> will not be able to connect. If <tt>requiredBuild</tt> is set to a large number, like <tt>requiredBuild = 999999999;</tt> for example, it will automatically be lowered to the current server version. || -
| {{hl|c= requiredBuild = xxxxx;}} || {{hl|UNKNOWN}} || Minimum required client version. Clients with version lower than {{hl|requiredBuild}} will not be able to connect. If {{hl|requiredBuild}} is set to a large number, like {{hl|c= requiredBuild = 999999999;}} for example, it will automatically be lowered to the current server version. || {{n/a}}
|-
|-
| <tt>statisticsEnabled = 1;</tt> || <tt>1</tt> || Allows to opt-out of [[Arma 3: Analytics|Arma 3 analytics]] for the server by using 0 || {{GVI|arma3|1.56}}
| {{hl|c= statisticsEnabled = 1;}} || {{hl|1}} || Allows to opt-out of [[Arma 3: Analytics|Arma 3 analytics]] for the server by using 0 || {{GVI|arma3|1.56}}
|-
|-
| <tt>forcedDifficulty = "regular";</tt> || <tt>""</tt> || Enforces the selected difficulty on the server. <tt>'''forcedDifficulty''' = "<difficultyClass>";</tt>
| {{hl|c= forcedDifficulty = "regular";}} || {{hl|""}} || Enforces the selected difficulty on the server. {{hl|c= '''forcedDifficulty''' = "<difficultyClass>";}}
* If Recruit, Regular or Veteran is passed as the parameter, the particular difficulty options will be taken from data config, from the class CfgDifficultyPresets.
* If Recruit, Regular or Veteran is passed as the parameter, the particular difficulty options will be taken from data config, from the class CfgDifficultyPresets.
* If Custom will be passed as the parameter, the particular flags will be taken from CustomDifficulty class from server's profile (only Custom is saved to the profile).
* If Custom will be passed as the parameter, the particular flags will be taken from CustomDifficulty class from server's profile (only Custom is saved to the profile).
* If mission cycle is defined in the [[server.cfg]], the difficulty set in the mission cycle overrides the difficulty set by '''forcedDifficulty''' parameter.
* If mission cycle is defined in the '''server.cfg''', the difficulty set in the mission cycle overrides the difficulty set by '''forcedDifficulty''' parameter.
| {{GVI|arma3|1.56}}
| {{GVI|arma3|1.56}}
|-
|-
| <tt>missionWhitelist[] = {"intro.altis"};</tt> || <tt>{}</tt> || Limit the available missions for the admin for the mission change. See [[Arma 3: MP Mission Names]] for a full list. || {{GVI|arma3|1.56}}
| {{hl|c= missionWhitelist[] = {"intro.altis"};}} || {{hl|<nowiki>{}</nowiki>}} || Limit the available missions for the admin for the mission change. See [[Arma 3: MP Mission Names]] for a full list. || {{GVI|arma3|1.56}}
|-
|-
| <tt>steamProtocolMaxDataSize = 1024;</tt> || <tt>UNKNOWN</tt> || Limit for maximum Steam Query packet length. Increasing this value is dangerous as it can cause {{arma3}} server to send UDP packets of a size larger than the MTU. This will cause UDP packets to be fragmented which is not supported by some older routers. But increasing this will fix the modlist length limit in [[Arma 3: Launcher]]. || {{GVI|arma3|2.00}}
| {{hl|c= steamProtocolMaxDataSize = 1024;}} || {{hl|1024}} || Limit for maximum Steam Query packet length. Increasing this value is dangerous as it can cause {{arma3}} server to send UDP packets of a size larger than the MTU. This will cause UDP packets to be fragmented which is not supported by some older routers. But increasing this will fix the modlist length limit in [[Arma 3: Launcher]]. || {{GVI|arma3|2.00}}
|-
|-
|
|
Line 217: Line 226:
class AdvancedOptions
class AdvancedOptions
{
{
    LogObjectNotFound = true; // Logging enabled
LogObjectNotFound = true; // logging enabled
    SkipDescriptionParsing = false; // Parse description.ext
SkipDescriptionParsing = false; // parse description.ext
    ignoreMissionLoadErrors = false; // Do not ingore errors
ignoreMissionLoadErrors = false; // do not ingore errors
queueSizeLogG = 1000000; // if a specific players message queue
// is larger than 1MB and #monitor is running,
// dump his messages to a logfile for analysis
};
};
</syntaxhighlight>
</syntaxhighlight>
| <tt>true/false/false</tt>
| {{n/a}}
|
|
{{GVI|arma3|2.02}}
{{GVI|arma3|2.02}}
* LogObjectNotFound - [[false|False]] to skip logging "Server: Object not found" messages
* LogObjectNotFound - [[false]] to skip logging "Server: Object not found" messages
* SkipDescriptionParsing - [[true|True]] to skip parsing of description.ext/mission.sqm. Will show pbo filename instead of configured missionName. OverviewText and such won't work, but loading the mission list is a lot faster when you have many missions
* SkipDescriptionParsing - [[true]] to skip parsing of description.ext/mission.sqm. Will show pbo filename instead of configured missionName. OverviewText and such won't work, but loading the mission list is a lot faster when there are many missions
{{GVI|arma3|2.04}}
{{GVI|arma3|2.04}}
* ignoreMissionLoadErrors - When server log gets filled with  too many logs entries the mission loading will be aborted and jump bad to mission selection, this forces the server to continue loading mission {{Clarify}}
* ignoreMissionLoadErrors - when set to [[true]], the mission will load no matter the amount of loading errors. If set to [[false]], the server will abort mission's loading and return to mission selection
| {{GVI|arma3|2.02}}{{GVI|arma3|2.04}}
{{GVI|arma3|2.08}}
* queueSizeLogG - if {{hl|#monitor}} is running and a player's Guaranteed Message Queue size (Listed as G: in {{hl|#monitor}}) goes above the threshold, all that player's message types and sizes are dumped to a logfile in the RPT directory (see [[Crash Files]]); the dumping itself is logged server-side.
| {{GVI|arma3|2.02}}{{GVI|arma3|2.04}}{{GVI|arma3|2.08}}
|-
|-
| <tt>armaUnitsTimeout = 30;</tt> || <tt>30</tt> || Defines how long the player will be stuck connecting and wait for {{ExternalLink|link= https://units.arma3.com/|text= armaUnits data}}. Player will be notified if timeout elapsed and no units data was received || {{GVI|arma3|2.06}}
| {{hl|c= armaUnitsTimeout = 30;}}
| {{hl|30}}
| Defines how long the player will be stuck connecting and wait for {{Link|https://units.arma3.com/|armaUnits data}}. Player will be notified if timeout elapsed and no units data was received
| {{GVI|arma3|2.06}}
|-
|-
|}
|}


= Server Administration =
== Server Administration ==
If you are not using BattlEye RCon, there could only be 1 server admin at any given time. There are two ways of becoming admin, through a vote or through login with authenticated credentials.
 
If BattlEye RCon is not in use, there can only be 1 server admin at any given time. There are two ways of becoming admin, through a vote or through login with authenticated credentials.
 
=== Voted In Admin ===


== Voted In Admin ==
It is possible to become a server administrator through player voting process. Such admin has less abilities than logged in admin.<br>
It is possible to become a server administrator through player voting process. Such admin has less abilities than logged in admin.<br>
For example, voted in admin would be able to kick a player, but only logged in admin would be able to ban a player.<br>
For example, voted in admin would be able to kick a player, but only logged in admin would be able to ban a player.<br>
For more information on voting and voting configuration see page [[Arma_3:_Mission_voting|'''Server Voting''']].
For more information on voting and voting configuration see page [[Arma_3:_Mission_voting|'''Server Voting''']].


== Logged In Admin ==
=== Logged In Admin ===
To log in as admin, one is required to type in<tt>#login</tt> command followed by server password, which matches password defined in '''passwordAdmin''' param.<br>
 
Since Arma2OA it is possible to add one or several user ids [[getPlayerUID|UIDs]] into '''admins[]''' server config parameter, which would allow listed users to log in as admin by simply typing <tt>#login</tt> without a password.<br>
To log in as admin, one is required to type in{{hl|#login}} command followed by server password, which matches password defined in '''passwordAdmin''' param.<br>
Since Arma2OA it is possible to add one or several user ids [[getPlayerUID|UIDs]] into '''admins[]''' server config parameter, which would allow listed users to log in as admin by simply typing {{hl|#login}} without a password.<br>
This presents several advantages for managing the servers. The server owner can have multiple admins selected from the community and doesn't have to provide each one with server admin password.<br>
This presents several advantages for managing the servers. The server owner can have multiple admins selected from the community and doesn't have to provide each one with server admin password.<br>
The adding and removing of UIDs is done on the server side which makes it easy to add and to remove admins if necessary. On the server, admins are handled on first come first served basis.<br>
The adding and removing of UIDs is done on the server side which makes it easy to add and to remove admins if necessary. On the server, admins are handled on first come first served basis.<br>
Line 255: Line 275:
The logged in and voted in admins have different set of '''[[Multiplayer Server Commands]]''' available to them. See '''[[serverCommandAvailable]]''' for more information.
The logged in and voted in admins have different set of '''[[Multiplayer Server Commands]]''' available to them. See '''[[serverCommandAvailable]]''' for more information.


= Server Security =
 
== Server Security ==
 
Several of these settings directly contribute to the security of the server and have been highlighted as important, particularly for running public - no password - servers.
Several of these settings directly contribute to the security of the server and have been highlighted as important, particularly for running public - no password - servers.


;The most updated ones that give a good protection (and are, ''de facto'', the standard for public servers) are:
; The most updated ones that give a good protection (and are, ''de facto'', the standard for public servers) are:
<syntaxhighlight lang="cpp">
<syntaxhighlight lang="cpp">
battlEye = 1;
battlEye = 1;
verifySignatures = 2;
verifySignatures = 2;
allowedFilePatching = 0;
allowedFilePatching = 0;
allowedLoadFileExtensions[] = {"hpp","sqs","sqf","fsm","cpp","paa","txt","xml","inc","ext","sqm","ods","fxy","lip","csv","kb","bik","bikb","html","htm","biedi"};
allowedLoadFileExtensions[] = { "hpp","sqs","sqf","fsm","cpp","paa","txt","xml","inc","ext","sqm","ods","fxy","lip","csv","kb","bik","bikb","html","htm","biedi" };
allowedPreprocessFileExtensions[] = {"hpp","sqs","sqf","fsm","cpp","paa","txt","xml","inc","ext","sqm","ods","fxy","lip","csv","kb","bik","bikb","html","htm","biedi"};
allowedPreprocessFileExtensions[] = { "hpp","sqs","sqf","fsm","cpp","paa","txt","xml","inc","ext","sqm","ods","fxy","lip","csv","kb","bik","bikb","html","htm","biedi" };
allowedHTMLLoadExtensions[] = {"htm","html","xml","txt"};
allowedHTMLLoadExtensions[] = { "htm","html","xml","txt" };
//allowedHTMLLoadURIs[] = {};
// allowedHTMLLoadURIs[] = {};
passwordAdmin = "xyzxyz123";
passwordAdmin = "xyzxyz123";
serverCommandPassword = "xyzxyz456";
serverCommandPassword = "xyzxyz456";
</syntaxhighlight>
</syntaxhighlight>


== Notes ==
=== Notes ===
 
The properties allowedLoad*/allowedPreprocess*/allowedHTML* are server.cfg settings with array list of extensions for server-side use only. The above listed examples are for basic game multiplayer modes. Server admins may attempt to make it stricter for their servers. However, if too strict then server's log file will contain warning entries about unable read.
The properties allowedLoad*/allowedPreprocess*/allowedHTML* are server.cfg settings with array list of extensions for server-side use only. The above listed examples are for basic game multiplayer modes. Server admins may attempt to make it stricter for their servers. However, if too strict then server's log file will contain warning entries about unable read.
: With the exception of allowedHTMLLoadURIs those arrays covers both files inside and outside PBOs so don't change the above defaults w/o testing first as there's a chance you'll break the game.
: With the exception of allowedHTMLLoadURIs those arrays covers both files inside and outside PBOs so don't change the above defaults w/o testing first as there is a chance it will break the game.


* To read [[loadFile]] , [[preprocessFile]] , [[preprocessFileLineNumbers]] and to remember, those works on files only-within {{arma3}} server directory and its sub-directories!
* To read [[loadFile]] , [[preprocessFile]] , [[preprocessFileLineNumbers]] and to remember, those works on files only-within {{arma3}} server directory and its sub-directories!
* Refer to [[ArmA: Addon Signatures]] for current best practices in server mod signing and the use of key signature files.<br>
* Refer to [[ArmA: Addon Signatures]] for current best practices in server mod signing and the use of key signature files.
* To further increase security of your servers remember [[BattlEye]] has ability to utilize server-side (including preventing remote execution) and client-side script check filters.
* To further increase servers security, remember that [[BattlEye]] has the ability to use server-side (including preventing remote execution) and client-side script check filters.
** These BattlEye filters needs to be written specifically for each mission and mod as the scripting differs in each of them.<br>
** These BattlEye filters needs to be written specifically for each mission and mod as the scripting differs in each of them.
 
=== Safe Folder Structure ===


== Safe Folder Structure ==
Engine supports absolute outside Arma 3 server folder for command-line parameters {{hl|c= -servermod=, -mod=}} and same for profile directories and config locations.
Engine supports absolute outside Arma 3 server folder for command-line parameters <tt>-servermod=, -mod=</tt> and same for profile directories and config locations.
This puts those out of reach by various load script command features which are limited only within {{arma3}} folder and it is sub-directories for security reason.
This puts those out of reach by various load script command features which are limited only within {{arma3}} folder and it is sub-directories for security reason.
thus e.g. safe folder-structure looks like:
thus e.g. safe folder-structure looks like:
* <tt>\arma3server\</tt>
* {{hl|\arma3server\}}
* <tt>\arma3server\@publicmods\</tt>
* {{hl|\arma3server\@publicmods\}}
* <tt>\arma3server_servermods_secrethash\</tt>
* {{hl|\arma3server_servermods_secrethash\}}
* <tt>\arma3server_profiles_and_configs_secrethash\</tt>
* {{hl|\arma3server_profiles_and_configs_secrethash\}}


Note that [[callExtension]]s are loaded only from {{arma3}} server root / sub-folders
Note that [[callExtension]]s are loaded only from {{arma3}} server root / sub-folders


= Example Configuration File =
 
== Example Configuration File ==
 
<spoiler><syntaxhighlight lang="cpp">
<spoiler><syntaxhighlight lang="cpp">
// server.cfg
// server.cfg
Line 298: Line 324:
hostname = "Fun and Test Server"; // The name of the server that shall be displayed in the public server list
hostname = "Fun and Test Server"; // The name of the server that shall be displayed in the public server list
password = ""; // Password for joining, eg connecting to the server
password = ""; // Password for joining, eg connecting to the server
passwordAdmin = "xyz"; // Password to become server admin. When you're in Arma MP and connected to the server, type '#login xyz'
passwordAdmin = "xyz"; // Password to become server admin. When in Arma MP and connected to the server, type '#login xyz'
serverCommandPassword = "xyzxyz"; // Password required by alternate syntax of [[serverCommand]] server-side scripting.
serverCommandPassword = "xyzxyz"; // Password required by alternate syntax of [[serverCommand]] server-side scripting.


Line 379: Line 405:
missionWhitelist[] = {}; // An empty whitelist means there is no restriction on what missions' available</syntaxhighlight></spoiler>
missionWhitelist[] = {}; // An empty whitelist means there is no restriction on what missions' available</syntaxhighlight></spoiler>


= Mission rotation =
 
== Mission rotation ==
 
One can set an automatic mission rotation. Without an admin, the server will automatically select a mission when at least one player is connected. Once the mission is done and if there are still players on the server, it will automatically switch to the next in the cycle.
One can set an automatic mission rotation. Without an admin, the server will automatically select a mission when at least one player is connected. Once the mission is done and if there are still players on the server, it will automatically switch to the next in the cycle.


Example:<br>
Example:<br>


{{Feature | Informative | When difficulty is set to <tt>difficulty {{=}} "Custom";</tt> the server will look into <tt>USERNAME.Arma3Profile</tt> file for the definition of custom difficulty, which should look like this: [[server.armaprofile#Server_Difficulty_Example | click to see example]]}}
{{Feature | Informative | When difficulty is set to {{hl|c= difficulty {{=}} "Custom";}} the server will look into {{hl|USERNAME.Arma3Profile}} file for the definition of custom difficulty, which should look like this: [[server.armaprofile#Server_Difficulty_Example | click to see example]]}}


<syntaxhighlight lang="cpp">
<syntaxhighlight lang="cpp">
Line 395: Line 423:
class Params {};
class Params {};
};
};
class TestMission02
class TestMission02
{
{
Line 401: Line 430:
class Params {};
class Params {};
};
};
class TestMission03
class TestMission03
{
{
Line 407: Line 437:
class Params {};
class Params {};
};
};
class TestMission04
class TestMission04
{
{
Line 416: Line 447:
</syntaxhighlight>
</syntaxhighlight>


= Arma 3: Apex - Mission collection =
 
== Arma 3 Apex - Mission collection ==
 
Mainly intended for MP campaigns. If the progress is defined in the MPMissions class, server administrator can simply add the whole campaign by adding ''campaign class'' into the ''server.cfg''. See the example below.
Mainly intended for MP campaigns. If the progress is defined in the MPMissions class, server administrator can simply add the whole campaign by adding ''campaign class'' into the ''server.cfg''. See the example below.


Line 473: Line 506:
</syntaxhighlight>
</syntaxhighlight>


= Additional details =
 
== Additional details ==
 
For hosting server behind NAT or firewall, please ensure gameport and STEAMports are forwarded and open!<br>
For hosting server behind NAT or firewall, please ensure gameport and STEAMports are forwarded and open!<br>
Set the ICMP "echo reply" as allowed so the server is able return ping delay properly.<br>
Set the ICMP "echo reply" as allowed so the server is able return ping delay properly.<br>
It's recommended to enable the NAT traversal (so called "Edge traversal" in Windows Firewall) for '''arma3server.exe''', '''arma3.exe''' to better support clients/servers behind NAT.
It's recommended to enable the NAT traversal (so called "Edge traversal" in Windows Firewall) for '''arma3server.exe''', '''arma3.exe''' to better support clients/servers behind NAT.


= Overriding Mission Parameters =
 
On dedicated server unless you are an admin you cannot set mission options provided by mission maker via class Params. However as a server owner you can override default setting with your own. See [[Mission Parameters]] for more info
== Overriding Mission Parameters ==
 
On dedicated server, only an admin can set mission options provided by mission maker via class Params. However as a server owner it is possible to override default setting with your own. See [[Mission Parameters]] for more info.
 


{{GameCategory|arma3|Multiplayer}}
{{GameCategory|arma3|Multiplayer}}

Revision as of 17:28, 11 January 2023

Arma 3 Server Configuration Overview
Setup Arma 3: Dedicated ServerArma 3: Dedicated Server (Chinese Simplified)Arma 3: Dedicated Server (Chinese Traditional)
Files Arma 3: Server Config FileArma 3: Basic Server Config FileArma 3: Server Profile
Other Multiplayer Server CommandsArma 3: Mission votingArma 3: Headless ClientBattlEye


Arma 2: Operation Arrowhead
This page is about Arma 3 server configuration. For previous titles, see Arma 2: Server Config File.


This article deals with the server.cfg, a configuration file which one can use to configure various game server settings such as the difficulty level, how many votes are needed, and welcome messages. The name server.cfg means nothing, and this file can be called anything. The real name is determined by the -config command line option when launching the dedicated server. There is no default name: when no filename is specified, no server configuration file is loaded.


Server Options

Parameter Default Description Since
passwordAdmin = "xyzxyz"; "" Password to protect admin access. N/A
password = "xyz"; "" Password required to connect to server. N/A
serverCommandPassword = "xyzxyz"; "" Password required by alternate syntax of serverCommand server-side scripting (Case-Sensitive). N/A
hostname="My Server"; UNKNOWN Servername visible in the game browser. N/A
maxPlayers = 10; 64 (DS) The maximum number of players that can connect to server. The final number will be lesser between number given here and number of mission slots. N/A
motd[]= {"Welcome to my server.", "Hosted in the net."}; {} Two lines welcome message. Comma is the 'new line' separator. N/A
admins[] = {"<UID>"}; {} Whitelisted clients can use #login without password. See Logged In Admin. Arma 3 logo black.png1.70
headlessClients[] = {"<IP>"}; {} Headless Client IPs. Multiple connections and addresses are allowed in case of multiple Headless Clients. See Arma 3: Headless Client. N/A
localClient[] = {"<IP>"}; {} Indicates clients with unlimited bandwidth and nearly no latency. See Arma 3: Headless Client. N/A
filePatchingExceptions[] = {"<UID>"}; {} Whitelisted clients ignore the rules defined by allowedFilePatching and verifySignatures, allowing them to join the server with any mods of their choice. Signature errors are still logged by the server upon connection.
Signature errors may still kick the user if the error happens before the server knows the clients SteamID, for example when trying to join with completely unsigned pbo's.
This entry has existed since 2016, but only became fully operational in Arma 3 logo black.png2.10
Server Behaviour
voteThreshold = 0.33; UNKNOWN Percentage of votes needed to confirm a vote. 33% in this example. N/A
voteMissionPlayers = 3; UNKNOWN Start mission-voting when X numberOfPlayers connect. N/A
allowedVoteCmds[] = { {"kick", false, false, 0.75} }; {} See Arma 3: Mission voting. N/A
allowedVotedAdminCmds[] = { { "mission", true, true } }; {} See Arma 3: Mission voting. N/A
kickduplicate = 1; UNKNOWN Do not allow duplicate game IDs. Second player with an existing ID will be kicked automatically. 1 means active, 0 disabled. N/A
loopback = true; false Adding this option will force server into LAN mode. This will allow multiple local instances of the game to connect to the server for testing purposes. At the same time it will prevent all non-local instances from connecting. N/A
upnp = true; false Automatically creates port mapping on UPNP/IGD enabled router. This option allows to create a server behind NAT (the router must have public IP and support UPNP/IGD protocol). Read more Internet Gateway Device (IGD) Standardized Device Control Protocol.
When enabled then this setting may delay server start-up by 600s (standard UDP timeout of 10 minutes) if blocked on firewall or bad routing etc. Thus in such case is recommended to disable it.
N/A
allowedFilePatching = 0; 0 Prevent or allow file patching for the clients (including the HC)
  • 0 is no clients
  • 1 is Headless Clients only
  • 2 is all clients
Arma 3 logo black.png1.50
allowedLoadFileExtensions[] = {"sqf","txt"}; UNKNOWN Only allow files with listed extensions to be loaded via loadFile command. Not listing any extension means everything is allowed. Defining the setting as empty arrays means nothing is allowed. Arma 3 logo black.png1.20
allowedPreprocessFileExtensions[] = {"sqf","sqs"}; UNKNOWN Only allow files with listed extensions to be loaded via preprocessFile / preprocessFileLineNumbers commands. Not listing any extension means everything is allowed. Defining the setting as empty arrays means nothing is allowed. Arma 3 logo black.png1.20
allowedHTMLLoadExtensions[] = {"htm","html"}; UNKNOWN Only allow files and URLs with listed extensions to be loaded via htmlLoad command. Not listing any extension means everything is allowed. Defining the setting as empty arrays means nothing is allowed. Arma 3 logo black.png1.28
allowedHTMLLoadURIs[] = {"http://arma3.com"}; UNKNOWN Only allow files from listed URIs and URLs to be loaded via htmlLoad command. Comment out if not used. Can use += to add to the existing list. Not listing any extension means everything is allowed. Defining the setting as empty arrays means nothing is allowed. N/A
disconnectTimeout = 5; 90 Server wait time before disconnecting client after loss of active traffic connection, range 5 to 90 seconds. Arma 3 logo black.png1.56
maxdesync = 150; UNKNOWN Max desync value until server kick the user Arma 3 logo black.png1.56
maxping= 200; UNKNOWN Max ping value until server kick the user Arma 3 logo black.png1.56
maxpacketloss= 50; UNKNOWN Max packetloss value until server kick the user Arma 3 logo black.png1.56
kickClientsOnSlowNetwork[] = { 0, 0, 0, 0 }; UNKNOWN Defines if {<MaxPing>, <MaxPacketLoss>, <MaxDesync>, <DisconnectTimeout>} will be logged (0) or kicked (1) Arma 3 logo black.png1.56
enablePlayerDiag = 1 0 Logs players' bandwidth and desync info every 60 seconds, as well as "network message is pending" owner identity. N/A
callExtReportLimit = 1000; 1000 If server initiated callExtension takes longer than specified limit in milliseconds, the warning will be logged into server .rpt file as well as reflected in the extension return result. N/A
kickTimeout[] = { {0, -1},{1, 180},{2, 180},{3, 180} }; UNKNOWN

kickTimeout[] = { {kickID, timeout}, ... };
kickID (type to determine from where the kick originated e.g. admin or votekick etc.)

  • 0 - manual kick (vote kick, admin kick, bruteforce detection etc.)
  • 1 - connectivity kick (ping, timeout, packetloss, desync)
  • 2 - BattlEye kick
  • 3 - harmless kick (wrong addons, steam timeout or checks, signatures, content etc.)

timeout = in seconds how long until kicked player can return

  • >0 seconds
  • -1 until missionEnd
  • -2 until serverRestart
Arma 3 logo black.png1.90
votingTimeOut = 60; 60 Voting timeout N/A
votingTimeOut[] = {60, 90}; {60, 90} Voteing timeout {ready, notReady} Arma 3 logo black.png1.90
roleTimeOut = 90; 90 Role seleciton timout N/A
roleTimeOut[] = {90, 120}; {90, 120} Role selection timeout {ready, notReady} Arma 3 logo black.png1.90
briefingTimeOut = 60; 60 Briefing timeout N/A
briefingTimeOut[] = {60, 90}; {90, 120} Briefing timeout {ready, notReady} Arma 3 logo black.png1.90
debriefingTimeOut = 45; 45 Briefing timeout N/A
debriefingTimeOut[] = {60, 60}; {90, 120} Debriefing timeout {ready, notReady} Arma 3 logo black.png1.90
lobbyIdleTimeout = 300; 300 Lobby idle timeout

Independent of set lobbyIdleTimeout in the config file, it will be at least
MAX(votingTimeout, lobbyTimeout, briefingTimeout, debriefingTimeout) + 5 seconds by default, this makes it 300 seconds of time for people in lobby and 95 in roleTimeout or briefing screen

Arma 3 logo black.png1.90
missionsToServerRestart = 8; UNKNOWN Number of times missionEnd happens before server initiate process restart (uses actual session startup command-line parameters, not possible to combine with `missionsToShutdown` ) N/A
missionsToShutdown = 8; UNKNOWN Number of times missionEnd happens before server initiate process shutdown (has same behavior as setting named `missionsToHardRestart`) N/A
autoSelectMission = true; false When enabled, the server auto-starts next mission in mission cycle and waits for players in the role selection. This allows full mission information in server browser and then results in proper filtering of the servers. This is lesser-variant (trimmed) of server startup command-line parameter -autoInit. Might collide with campaign linked missions / need mission cycle etc. N/A
randomMissionOrder = true; UNKNOWN When enabled, the server random start / next selection with one of missions from mission rotation list. ( setting goes outside(before) Mission class {}; ) N/A
disableChannels[] = { {0,false,true} }; {}

disableChannels[] = { {channelID, text, voice}, ... }>;

  • ChannelID : Number - use single digit of (0 to 6) to define channelID. Default: No restriction to any channels, with text/von chat set to false.
  • text : Boolean - use true to disable usage of text-chat for defined channelID. Default: false
  • voice : Boolean - use true to disable usage of voice-chat (VON) for defined channelID. Default: false

List of channels ID:

  • 0 = Global
  • 1 = Side
  • 2 = Command
  • 3 = Group
  • 4 = Vehicle
  • 5 = Direct
  • 6 = System
Missions which use Description.ext#disableChannels will override any setting of disableChannels[] in the server.cfg.
-
Other Options
verifySignatures = 2; 0 Enables or disables the signature verification for addons.
  • Verification disabled = 0.
  • 1 Will default back to 2
-
drawingInMap = false; true Enables or disables the ability to place markers and draw lines in map. Arma 3 logo black.png1.64
disableVoN = 1; 0 Enables or disables the Voice over Net. N/A
vonCodecQuality = 10; 3 Defines VoN codec quality. Value range is from 1 to 20.
  • Since 1.62 supports range 1-20
  • Since 1.64 will support range 1-30
  • 8kHz is 0-10, 16kHz is 11-20, for 21-30 it is 32kHz for SPEEX codec and 48kHz for OPUS codec.
-
vonCodec = 1; 0 Defines VoN codec type. Value range is from 0 to 1.
  • Since Arma 3 update 1.58 supports value 1
  • Value 0 uses older SPEEX codec, while 1 switches to new IETF standard OPUS codec.
-
skipLobby = false; false If true, joining player will skip role selection. This is only used if no Mission, Campaign or Config setting skipLobby is defined (See Description.ext#skipLobby). N/A
allowProfileGlasses = false; true If false, glasses set in player profile will be ignored. This is only used if no Mission, Campaign or Config setting allowProfileGlasses is defined (See Description.ext - allowProfileGlasses) Arma 3 logo black.png2.06
zeusCompositionScriptLevel = 0; 1
  • 0: all scripts are forbidden
  • 1: only attributes are allowed (including custom attributes added by mods)
  • 2: all scripts are allowed including init scripts

This is only used if no Mission, Campaign or Config setting zeusCompositionScriptLevel is defined (See Description.ext - zeusCompositionScriptLevel).

Arma 3 logo black.png2.06
logFile = "server_console.log"; UNKNOWN Enables output of dedicated server console into textfile. Default location of log is same as crash dumps and other logs. (Local settings) Note that this does not change the location of the "net.log" file, which is enabled with the -netlog command line option. N/A
doubleIdDetected = "command"; "" See Server Side Scripting
onUserConnected = "command"; "" N/A
onUserDisconnected = "command"; "" N/A
onHackedData = "command"; "" N/A
onDifferentData = "command"; "" N/A
onUnsignedData = "command"; "" N/A
onUserKicked = "command"; "" N/A
regularCheck = "command"; "" N/A
BattlEye = 1; 1 Enables or disables the BattlEye anti-cheat engine. Requires installed BattlEye on server and clients joining the server N/A
timeStampFormat = "none"; "" Set the timestamp format used on each report line in server-side RPT file. Possible values are "none", "short", "full". N/A
forceRotorLibSimulation = 0; 0 Enforces the Advanced Flight Model on the server. 0 (up to the player). 1 - forced AFM, 2 - forced SFM. Arma 3 logo black.png1.34
persistent = 1; 0 Mission keeps running when all clients disconnect. Enabling the persistence option will make missions that have either base or instant respawn keep on running after all players have disconnected. The other respawn types will not make a mission persistent. The kind of respawn a certain mission uses is set in its Description.ext. N/A
requiredBuild = xxxxx; UNKNOWN Minimum required client version. Clients with version lower than requiredBuild will not be able to connect. If requiredBuild is set to a large number, like requiredBuild = 999999999; for example, it will automatically be lowered to the current server version. N/A
statisticsEnabled = 1; 1 Allows to opt-out of Arma 3 analytics for the server by using 0 Arma 3 logo black.png1.56
forcedDifficulty = "regular"; "" Enforces the selected difficulty on the server. forcedDifficulty = "<difficultyClass>";
  • If Recruit, Regular or Veteran is passed as the parameter, the particular difficulty options will be taken from data config, from the class CfgDifficultyPresets.
  • If Custom will be passed as the parameter, the particular flags will be taken from CustomDifficulty class from server's profile (only Custom is saved to the profile).
  • If mission cycle is defined in the server.cfg, the difficulty set in the mission cycle overrides the difficulty set by forcedDifficulty parameter.
Arma 3 logo black.png1.56
missionWhitelist[] = {"intro.altis"}; {} Limit the available missions for the admin for the mission change. See Arma 3: MP Mission Names for a full list. Arma 3 logo black.png1.56
steamProtocolMaxDataSize = 1024; 1024 Limit for maximum Steam Query packet length. Increasing this value is dangerous as it can cause Arma 3 server to send UDP packets of a size larger than the MTU. This will cause UDP packets to be fragmented which is not supported by some older routers. But increasing this will fix the modlist length limit in Arma 3: Launcher. Arma 3 logo black.png2.00
class AdvancedOptions
{
	LogObjectNotFound = true;			// logging enabled
	SkipDescriptionParsing = false;		// parse description.ext
	ignoreMissionLoadErrors = false;	// do not ingore errors
	queueSizeLogG = 1000000;			// if a specific players message queue
										// is larger than 1MB and #monitor is running,
										// dump his messages to a logfile for analysis
};
N/A

Arma 3 logo black.png2.02

  • LogObjectNotFound - false to skip logging "Server: Object not found" messages
  • SkipDescriptionParsing - true to skip parsing of description.ext/mission.sqm. Will show pbo filename instead of configured missionName. OverviewText and such won't work, but loading the mission list is a lot faster when there are many missions

Arma 3 logo black.png2.04

  • ignoreMissionLoadErrors - when set to true, the mission will load no matter the amount of loading errors. If set to false, the server will abort mission's loading and return to mission selection

Arma 3 logo black.png2.08

  • queueSizeLogG - if #monitor is running and a player's Guaranteed Message Queue size (Listed as G: in #monitor) goes above the threshold, all that player's message types and sizes are dumped to a logfile in the RPT directory (see Crash Files); the dumping itself is logged server-side.
Arma 3 logo black.png2.02Arma 3 logo black.png2.04Arma 3 logo black.png2.08
armaUnitsTimeout = 30; 30 Defines how long the player will be stuck connecting and wait for armaUnits data. Player will be notified if timeout elapsed and no units data was received Arma 3 logo black.png2.06

Server Administration

If BattlEye RCon is not in use, there can only be 1 server admin at any given time. There are two ways of becoming admin, through a vote or through login with authenticated credentials.

Voted In Admin

It is possible to become a server administrator through player voting process. Such admin has less abilities than logged in admin.
For example, voted in admin would be able to kick a player, but only logged in admin would be able to ban a player.
For more information on voting and voting configuration see page Server Voting.

Logged In Admin

To log in as admin, one is required to type in#login command followed by server password, which matches password defined in passwordAdmin param.
Since Arma2OA it is possible to add one or several user ids UIDs into admins[] server config parameter, which would allow listed users to log in as admin by simply typing #login without a password.
This presents several advantages for managing the servers. The server owner can have multiple admins selected from the community and doesn't have to provide each one with server admin password.
The adding and removing of UIDs is done on the server side which makes it easy to add and to remove admins if necessary. On the server, admins are handled on first come first served basis.
Here are the rules:

  • If there is already a logged in admin on the server, the new admin will not be able to log in until previously logged in admin logs out
  • If there is a voted in admin on the server, the logged in admin will override voted in admin and take admin role
  • There is no difference between logged in admin that used admin password or logged in admin that was whitelisted with admins[] param


The logged in and voted in admins have different set of Multiplayer Server Commands available to them. See serverCommandAvailable for more information.


Server Security

Several of these settings directly contribute to the security of the server and have been highlighted as important, particularly for running public - no password - servers.

The most updated ones that give a good protection (and are, de facto, the standard for public servers) are
battlEye = 1;
verifySignatures = 2;
allowedFilePatching = 0;
allowedLoadFileExtensions[] = { "hpp","sqs","sqf","fsm","cpp","paa","txt","xml","inc","ext","sqm","ods","fxy","lip","csv","kb","bik","bikb","html","htm","biedi" };
allowedPreprocessFileExtensions[] = { "hpp","sqs","sqf","fsm","cpp","paa","txt","xml","inc","ext","sqm","ods","fxy","lip","csv","kb","bik","bikb","html","htm","biedi" };
allowedHTMLLoadExtensions[] = { "htm","html","xml","txt" };
// allowedHTMLLoadURIs[] = {};
passwordAdmin = "xyzxyz123";
serverCommandPassword = "xyzxyz456";

Notes

The properties allowedLoad*/allowedPreprocess*/allowedHTML* are server.cfg settings with array list of extensions for server-side use only. The above listed examples are for basic game multiplayer modes. Server admins may attempt to make it stricter for their servers. However, if too strict then server's log file will contain warning entries about unable read.

With the exception of allowedHTMLLoadURIs those arrays covers both files inside and outside PBOs so don't change the above defaults w/o testing first as there is a chance it will break the game.
  • To read loadFile , preprocessFile , preprocessFileLineNumbers and to remember, those works on files only-within Arma 3 server directory and its sub-directories!
  • Refer to ArmA: Addon Signatures for current best practices in server mod signing and the use of key signature files.
  • To further increase servers security, remember that BattlEye has the ability to use server-side (including preventing remote execution) and client-side script check filters.
    • These BattlEye filters needs to be written specifically for each mission and mod as the scripting differs in each of them.

Safe Folder Structure

Engine supports absolute outside Arma 3 server folder for command-line parameters -servermod=, -mod= and same for profile directories and config locations. This puts those out of reach by various load script command features which are limited only within Arma 3 folder and it is sub-directories for security reason. thus e.g. safe folder-structure looks like:

  • \arma3server\
  • \arma3server\@publicmods\
  • \arma3server_servermods_secrethash\
  • \arma3server_profiles_and_configs_secrethash\

Note that callExtensions are loaded only from Arma 3 server root / sub-folders


Example Configuration File

// server.cfg

// GLOBAL SETTINGS
hostname = "Fun and Test Server";		// The name of the server that shall be displayed in the public server list
password = "";							// Password for joining, eg connecting to the server
passwordAdmin = "xyz";					// Password to become server admin. When in Arma MP and connected to the server, type '#login xyz'
serverCommandPassword = "xyzxyz";		// Password required by alternate syntax of [[serverCommand]] server-side scripting.

logFile = "server_console.log";			// Where the logfile should go and what it should be called

// WELCOME MESSAGE ("message of the day")
// It can be several lines, separated by comma
// Empty messages "" will not be displayed at all but are only for increasing the interval
motd[] = {
	"", "",
	"Two empty lines above for increasing interval",
	"Welcome to our server",
	"", "",
	"We are looking for fun - Join us Now !",
	"http://www.example.com",
	"One more empty line below for increasing interval",
	""
};
motdInterval = 5;					// Time interval (in seconds) between each message


// JOINING RULES
maxPlayers = 64;					// Maximum amount of players. Civilians and watchers, beholder, bystanders and so on also count as player.
kickDuplicate = 1;					// Each ArmA version has its own ID. If kickDuplicate is set to 1, a player will be kicked when he joins a server where another player with the same ID is playing.
verifySignatures = 2;				// Verifies .pbos against .bisign files. Valid values 0 (disabled), 1 (prefer v2 sigs but accept v1 too) and 2 (only v2 sigs are allowed).
equalModRequired = 0;				// Outdated. If set to 1, player has to use exactly the same -mod= startup parameter as the server.
allowedFilePatching = 0;			// Allow or prevent client using -filePatching to join the server. 0, is disallow, 1 is allow HC, 2 is allow all clients (since Arma 3 v1.50)
filePatchingExceptions[] = {"123456789","987654321"}; // Whitelisted Steam IDs allowed to join with -filePatching enabled
//requiredBuild = 12345;			// Require clients joining to have at least build 12345 of game, preventing obsolete clients to connect


// VOTING
voteMissionPlayers = 1;				// Tells the server how many people must connect so that it displays the mission selection screen.
voteThreshold = 0.33;				// 33% or more players need to vote for something, for example an admin or a new map, to become effective


// INGAME SETTINGS
disableVoN = 0;					// If set to 1, Voice over Net will not be available
vonCodec = 1; 					// If set to 1 then it uses IETF standard OPUS codec, if to 0 then it uses SPEEX codec (since Arma 3 update 1.58+)
vonCodecQuality = 30;			// since 1.62.95417 supports range 1-20 //since 1.63.x will supports range 1-30 //8kHz is 0-10, 16kHz is 11-20, 32kHz(48kHz) is 21-30
persistent = 1;					// If 1, missions still run on even after the last player disconnected.
timeStampFormat = "short";		// Set the timestamp format used on each report line in server-side RPT file. Possible values are "none" (default),"short","full".
BattlEye = 1;					// Server to use BattlEye system
allowedLoadFileExtensions[] = {"hpp","sqs","sqf","fsm","cpp","paa","txt","xml","inc","ext","sqm","ods","fxy","lip","csv","kb","bik","bikb","html","htm","biedi"}; //only allow files with those extensions to be loaded via loadFile command (since Arma 3 build 1.19.124216)
allowedPreprocessFileExtensions[] = {"hpp","sqs","sqf","fsm","cpp","paa","txt","xml","inc","ext","sqm","ods","fxy","lip","csv","kb","bik","bikb","html","htm","biedi"}; //only allow files with those extensions to be loaded via preprocessFile/preprocessFileLineNumber commands (since Arma 3 build 1.19.124323)
allowedHTMLLoadExtensions[] = {"htm","html","xml","txt"}; //only allow files with those extensions to be loaded via HTMLLoad command (since Arma 3 build 1.27.126715)
//allowedHTMLLoadURIs[] = {}; // Leave commented to let missions/campaigns/addons decide what URIs are supported. Uncomment to define server-level restrictions for URIs

// TIMEOUTS
disconnectTimeout = 5;			// Time to wait before disconnecting a user which temporarly lost connection. Range is 5 to 90 seconds.
maxDesync = 150;				// Max desync value until server kick the user
maxPing= 200;					// Max ping value until server kick the user
maxPacketLoss= 50;				// Max packetloss value until server kick the user
kickClientsOnSlowNetwork[] = { 0, 0, 0, 0 }; // Defines if {<MaxPing>, <MaxPacketLoss>, <MaxDesync>, <DisconnectTimeout>} will be logged (0) or kicked (1)
kickTimeout[] = { {0, -1}, {1, 180}, {2, 180}, {3, 180} };
votingTimeOut[] = {60, 90};		// Kicks users from server if they spend too much time in mission voting
roleTimeOut[] = {90, 120};		// Kicks users from server if they spend too much time in role selection
briefingTimeOut[] = {60, 90};	// Kicks users from server if they spend too much time in briefing (map) screen
debriefingTimeOut[] = {45, 60};	// Kicks users from server if they spend too much time in debriefing screen
lobbyIdleTimeout = 300;			// The amount of time the server will wait before force-starting a mission without a logged-in Admin.


// SCRIPTING ISSUES
onUserConnected = "";
onUserDisconnected = "";
doubleIdDetected = "";

// SIGNATURE VERIFICATION
onUnsignedData = "kick (_this select 0)";	// unsigned data detected
onHackedData = "kick (_this select 0)";		// tampering of the signature detected
onDifferentData = "";				// data with a valid signature, but different version than the one present on server detected


// MISSIONS CYCLE (see below)
randomMissionOrder = true;	// Randomly iterate through Missions list
autoSelectMission = true;	// Server auto selects next mission in cycle

class Missions {};			// An empty Missions class means there will be no mission rotation

missionWhitelist[] = {};	// An empty whitelist means there is no restriction on what missions' available
↑ Back to spoiler's top


Mission rotation

One can set an automatic mission rotation. Without an admin, the server will automatically select a mission when at least one player is connected. Once the mission is done and if there are still players on the server, it will automatically switch to the next in the cycle.

Example:

When difficulty is set to difficulty = "Custom"; the server will look into USERNAME.Arma3Profile file for the definition of custom difficulty, which should look like this: click to see example
class Missions
{
	class TestMission01
	{
		template = MP_Marksmen_01.Altis;
		difficulty = "veteran";
		class Params {};
	};

	class TestMission02
	{
		template = MP_End_Game_01.Altis;
		difficulty = "veteran";
		class Params {};
	};

	class TestMission03
	{
		template = MP_End_Game_02.Altis;
		difficulty = "veteran";
		class Params {};
	};

	class TestMission04
	{
		template = MP_End_Game_03.Altis;
		difficulty = "veteran";
		class Params {};
	};
};


Arma 3 Apex - Mission collection

Mainly intended for MP campaigns. If the progress is defined in the MPMissions class, server administrator can simply add the whole campaign by adding campaign class into the server.cfg. See the example below.

config.cpp:

class MPMissions
{
	class Apex
	{
		briefingName = $STR_A3_CoopCampaignName;

		class EXP_m01
		{
			briefingName = $STR_A3_exp_m01_missionname;
			directory = "a3\missions_f_exp\campaign\missions\exp_m01.tanoa";
		};

		class EXP_m02
		{
			briefingName = $STR_A3_exp_m02_missionname;
			directory = "a3\missions_f_exp\campaign\missions\exp_m02.tanoa";
		};

		class EXP_m03
		{
			briefingName = $STR_A3_exp_m03_missionname;
			directory = "a3\missions_f_exp\campaign\missions\exp_m03.tanoa";
		};
	};
};

server.cfg:

// MISSIONS CYCLE
class Missions
{
	class Apex{};
};

Also the difficulty of the each mission can be overridden

class Missions
{
	class Apex
	{
		class EXP_m01
		{
			difficulty = "veteran";
		};
	};
};


Additional details

For hosting server behind NAT or firewall, please ensure gameport and STEAMports are forwarded and open!
Set the ICMP "echo reply" as allowed so the server is able return ping delay properly.
It's recommended to enable the NAT traversal (so called "Edge traversal" in Windows Firewall) for arma3server.exe, arma3.exe to better support clients/servers behind NAT.


Overriding Mission Parameters

On dedicated server, only an admin can set mission options provided by mission maker via class Params. However as a server owner it is possible to override default setting with your own. See Mission Parameters for more info.