Startup Parameters – Arma 3

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Page intro)
m (arma3.exe => arma3_x64.exe)
Line 1: Line 1:
{{TOC|side|0.8||y}}
{{TOC|side|0.8||y}}
Startup parameters are command line interface(CLI) arguments that go after the executable's name in order to set options; e.g {{hl|arma3.exe -window}} to start the game in {{Link|#window}}ed mode.
Startup parameters are command line interface(CLI) arguments that go after the executable's name in order to set options; e.g {{hl|arma3_x64.exe -window}} to start the game in {{Link|#window}}ed mode.
{{Feature|informative|
{{Feature|informative|
* Startup parameters' ''names'' are case-insensitive - e.g {{hl|-WINDOW}} and {{hl|-window}} are identical.
* Startup parameters' ''names'' are case-insensitive - e.g {{hl|-WINDOW}} and {{hl|-window}} are identical.
Line 42: Line 42:
|-
|-
|
|
  arma3.exe -par="D:\Arma 3 Startup Parameters.txt"
  arma3_x64.exe -par="D:\Arma 3 Startup Parameters.txt"
|
|
  -skipIntro
  -skipIntro
Line 81: Line 81:


; Example
; Example
  arma3.exe -window
  arma3_x64.exe -window


=== posX ===
=== posX ===
Line 88: Line 88:


; Example
; Example
  arma3.exe -posX=50
  arma3_x64.exe -posX=50


=== posY ===
=== posY ===
Line 95: Line 95:


; Example
; Example
  arma3.exe -posY=50
  arma3_x64.exe -posY=50


=== adapter ===
=== adapter ===
Line 101: Line 101:
Sets the default Video Adapter.
Sets the default Video Adapter.
; Example
; Example
  arma3.exe -adapter=MISSING_AN_EXAMPLE
  arma3_x64.exe -adapter=MISSING_AN_EXAMPLE




Line 113: Line 113:


; Example
; Example
  arma3.exe -noSplash
  arma3_x64.exe -noSplash


=== skipIntro ===
=== skipIntro ===
Line 122: Line 122:


; Example
; Example
  arma3.exe -skipIntro
  arma3_x64.exe -skipIntro


=== world ===
=== world ===
Line 130: Line 130:
; Example
; Example
For faster game loading (no default world loaded and world intro in the main menu, ''only at game start'', disabled)
For faster game loading (no default world loaded and world intro in the main menu, ''only at game start'', disabled)
  arma3.exe -world=empty
  arma3_x64.exe -world=empty
Load Altis
Load Altis
  arma3.exe -world=Altis
  arma3_x64.exe -world=Altis


=== worldCfg ===
=== worldCfg ===
Line 146: Line 146:


; Example
; Example
  arma3.exe -name=PlayerOne
  arma3_x64.exe -name=PlayerOne


=== profiles ===
=== profiles ===
Line 155: Line 155:


; Example 1
; Example 1
  arma3.exe -profiles=C:\arma3\Profiles
  arma3_x64.exe -profiles=C:\arma3\Profiles


; Example 2
; Example 2
  arma3.exe -profiles=Profiles
  arma3_x64.exe -profiles=Profiles


Example 2 create a folder called ''Profiles'' in the {{arma3}} root directory
Example 2 create a folder called ''Profiles'' in the {{arma3}} root directory
Line 169: Line 169:


; Example
; Example
  arma3.exe -unit=1337
  arma3_x64.exe -unit=1337




Line 179: Line 179:


; Example
; Example
  arma3.exe -buldozer
  arma3_x64.exe -buldozer


=== noLand ===
=== noLand ===
Line 186: Line 186:


; Example
; Example
  arma3.exe -noLand
  arma3_x64.exe -noLand


=== noSound ===
=== noSound ===
Line 193: Line 193:


; Example
; Example
  arma3.exe -noSound
  arma3_x64.exe -noSound


=== doNothing ===
=== doNothing ===
Line 200: Line 200:


; Example
; Example
  arma3.exe -doNothing
  arma3_x64.exe -doNothing


=== mod ===
=== mod ===
Line 207: Line 207:


; Example 1
; Example 1
  arma3.exe -mod=test;x\test;c:\arma3\test2
  arma3_x64.exe -mod=test;x\test;c:\arma3\test2


* '''"test"''' is located in the {{arma3}} installation folder ("Arma 3\test") (relative path)
* '''"test"''' is located in the {{arma3}} installation folder ("Arma 3\test") (relative path)
Line 215: Line 215:
; Example 2
; Example 2
On Windows
On Windows
  arma3.exe -mod=test;x\test;c:\arma3\test2
  arma3_x64.exe -mod=test;x\test;c:\arma3\test2


; Example 3
; Example 3
On Linux. Note the addtional backslash in front of the semicolon
On Linux. Note the addtional backslash in front of the semicolon
  arma3.exe -mod=test\;x\test\;c:\arma3\test2 #Linux,  
  arma3_x64.exe -mod=test\;x\test\;c:\arma3\test2 #Linux,  


{{Feature|informative|
{{Feature|informative|
Line 235: Line 235:


; Example
; Example
  arma3.exe -connect=168.152.15.147
  arma3_x64.exe -connect=168.152.15.147


=== port ===
=== port ===
Line 242: Line 242:


; Example
; Example
  arma3.exe -port=1337
  arma3_x64.exe -port=1337


=== password ===
=== password ===
Line 249: Line 249:


; Example
; Example
  arma3.exe -password=1337abc
  arma3_x64.exe -password=1337abc


=== host ===
=== host ===
Line 255: Line 255:


; Example
; Example
  arma3.exe -host
  arma3_x64.exe -host




Line 265: Line 265:


; Example
; Example
  arma3.exe -setUpHost
  arma3_x64.exe -setUpHost


=== server ===
=== server ===
Line 272: Line 272:


; Example
; Example
  arma3.exe -server
  arma3_x64.exe -server


=== port ===
=== port ===
Line 279: Line 279:


; Example
; Example
  arma3.exe -port=1337
  arma3_x64.exe -port=1337


=== pid ===
=== pid ===
Line 286: Line 286:


; Example
; Example
  arma3.exe -pid=C:\MyServer\PID.txt
  arma3_x64.exe -pid=C:\MyServer\PID.txt


=== ranking ===
=== ranking ===
Line 311: Line 311:


; Example
; Example
  arma3.exe -ranking=C:\arma3\ranking.log
  arma3_x64.exe -ranking=C:\arma3\ranking.log


=== netlog ===
=== netlog ===
Line 318: Line 318:


; Example
; Example
  arma3.exe -netlog
  arma3_x64.exe -netlog


=== cfg ===
=== cfg ===
Line 326: Line 326:


; Example
; Example
  arma3.exe -config=C:\MyServer\basic.cfg
  arma3_x64.exe -config=C:\MyServer\basic.cfg


=== config ===
=== config ===
Line 333: Line 333:


; Example
; Example
  arma3.exe -config=C:\MyServer\config.cfg
  arma3_x64.exe -config=C:\MyServer\config.cfg


=== profiles ===
=== profiles ===
Line 341: Line 341:


; Example
; Example
  arma3.exe -profiles=C:\MyServer\profiles
  arma3_x64.exe -profiles=C:\MyServer\profiles


=== bePath ===
=== bePath ===
Line 348: Line 348:


; Example
; Example
  arma3.exe -bePath=C:\MyBattlEyeFolder
  arma3_x64.exe -bePath=C:\MyBattlEyeFolder


=== ip ===
=== ip ===
Line 355: Line 355:


; Example
; Example
  arma3.exe -ip=145.412.123.12
  arma3_x64.exe -ip=145.412.123.12


=== par ===
=== par ===
Line 362: Line 362:


; Example
; Example
  arma3.exe -par="C:\Users\Player\Games\Arma 3\Arma 3 Parameter Files\par_common.txt"
  arma3_x64.exe -par="C:\Users\Player\Games\Arma 3\Arma 3 Parameter Files\par_common.txt"


=== client ===
=== client ===
Line 369: Line 369:


; Example
; Example
  arma3.exe -client
  arma3_x64.exe -client


=== loadMissionToMemory ===
=== loadMissionToMemory ===
Line 376: Line 376:


; Example
; Example
  arma3.exe -loadMissionToMemory
  arma3_x64.exe -loadMissionToMemory


=== autoInit ===
=== autoInit ===
Line 385: Line 385:


; Example
; Example
  arma3.exe -autoInit
  arma3_x64.exe -autoInit


=== serverMod ===
=== serverMod ===
Line 393: Line 393:


; Example
; Example
  arma3.exe -serverMod=myAwesomeMod;anotherAwesomeMod;
  arma3_x64.exe -serverMod=myAwesomeMod;anotherAwesomeMod;


=== disableServerThread ===
=== disableServerThread ===
Line 400: Line 400:


; Example
; Example
  arma3.exe -disableServerThread
  arma3_x64.exe -disableServerThread


=== bandwidthAlg ===
=== bandwidthAlg ===
Line 407: Line 407:


; Example
; Example
  arma3.exe -bandwidthAlg=2
  arma3_x64.exe -bandwidthAlg=2


{{ArgTitle|3|limitFPS|{{GVI|arma3|1.98}}}}
{{ArgTitle|3|limitFPS|{{GVI|arma3|1.98}}}}
Line 413: Line 413:


; Example
; Example
  arma3.exe -limitFPS=300
  arma3_x64.exe -limitFPS=300


{{ArgTitle|3|networkDiagInterval|{{GVI|arma3|1.30}}}}
{{ArgTitle|3|networkDiagInterval|{{GVI|arma3|1.30}}}}
Line 420: Line 420:


; Example
; Example
  arma3.exe networkDiagInterval=10
  arma3_x64.exe networkDiagInterval=10


== Performance ==
== Performance ==
Line 441: Line 441:


; Example
; Example
  arma3.exe -maxMem=4096
  arma3_x64.exe -maxMem=4096


=== maxVRAM ===
=== maxVRAM ===
Line 448: Line 448:


; Example
; Example
  arma3.exe -maxVRAM=4096
  arma3_x64.exe -maxVRAM=4096


=== maxFileCacheSize ===
=== maxFileCacheSize ===
Line 460: Line 460:


; Example
; Example
  arma3.exe -maxFileCacheSize=2048
  arma3_x64.exe -maxFileCacheSize=2048


=== noCB ===
=== noCB ===
Line 467: Line 467:


; Example
; Example
  arma3.exe -noCB
  arma3_x64.exe -noCB


=== CPUCount ===
=== CPUCount ===
Line 475: Line 475:


; Example
; Example
  arma3.exe -exThreads=8
  arma3_x64.exe -exThreads=8


=== exThreads ===
=== exThreads ===
Line 509: Line 509:


; Example
; Example
  arma3.exe -exThreads=7
  arma3_x64.exe -exThreads=7


=== malloc ===
=== malloc ===
Line 516: Line 516:


; Example
; Example
  arma3.exe -malloc=someMalloc
  arma3_x64.exe -malloc=someMalloc


=== hugePages ===
=== hugePages ===
Line 523: Line 523:


; Example
; Example
  arma3.exe -hugePages
  arma3_x64.exe -hugePages


=== enableHT ===
=== enableHT ===
Line 536: Line 536:


; Example
; Example
  arma3.exe -enableHT
  arma3_x64.exe -enableHT


{{ArgTitle|3|setThreadCharacteristics|{{GVI|arma3|2.10}}}}
{{ArgTitle|3|setThreadCharacteristics|{{GVI|arma3|2.10}}}}
Line 544: Line 544:


; Example
; Example
  arma3.exe -setThreadCharacteristics
  arma3_x64.exe -setThreadCharacteristics




Line 554: Line 554:


; Example
; Example
  arma3.exe -noPause
  arma3_x64.exe -noPause


{{ArgTitle|3|noPauseAudio|{{GVI|arma3|2.10}}}}
{{ArgTitle|3|noPauseAudio|{{GVI|arma3|2.10}}}}
Line 561: Line 561:


; Example
; Example
  arma3.exe -noPauseAudio
  arma3_x64.exe -noPauseAudio


=== showScriptErrors ===
=== showScriptErrors ===
Line 568: Line 568:


; Example
; Example
  arma3.exe -showScriptErrors
  arma3_x64.exe -showScriptErrors


=== debug ===
=== debug ===
Line 575: Line 575:


; Example
; Example
  arma3.exe -debug
  arma3_x64.exe -debug


=== noFreezeCheck ===
=== noFreezeCheck ===
Line 582: Line 582:


; Example
; Example
  arma3.exe -noFreezeCheck
  arma3_x64.exe -noFreezeCheck


=== noLogs ===
=== noLogs ===
Line 590: Line 590:


; Example
; Example
  arma3.exe -noLogs
  arma3_x64.exe -noLogs


{{ArgTitle|3|filePatching|{{GVI|arma3|1.50}}}}
{{ArgTitle|3|filePatching|{{GVI|arma3|1.50}}}}
Line 596: Line 596:


; Example
; Example
  arma3.exe -filePatching
  arma3_x64.exe -filePatching


=== init ===
=== init ===
Line 603: Line 603:


; Example
; Example
  arma3.exe -init=playMission["","M04Saboteur.Sara"]
  arma3_x64.exe -init=playMission["","M04Saboteur.Sara"]


=== <path>\mission.sqm ===
=== <path>\mission.sqm ===
Line 641: Line 641:


; Example
; Example
  arma3.exe -autotest=c:\arma3\autotest\autotest.cfg
  arma3_x64.exe -autotest=c:\arma3\autotest\autotest.cfg


; RPT entry:
; RPT entry:
Line 658: Line 658:


; Example
; Example
  arma3.exe -mod=betamod1\;betamod2\;betamod3
  arma3_x64.exe -mod=betamod1\;betamod2\;betamod3


This allows use of beta build w/o disabling in-game mod/extension management (in UI menu).
This allows use of beta build w/o disabling in-game mod/extension management (in UI menu).
Line 667: Line 667:


; Example
; Example
  arma3.exe -checkSignatures
  arma3_x64.exe -checkSignatures


=== d3dNoLock ===
=== d3dNoLock ===
Line 674: Line 674:


; Example
; Example
  arma3.exe -d3dNoLock
  arma3_x64.exe -d3dNoLock


=== d3dNoMultiCB ===
=== d3dNoMultiCB ===
Line 681: Line 681:


; Example
; Example
  arma3.exe -d3dNoMultiCB
  arma3_x64.exe -d3dNoMultiCB
<!--
<!--
=== crashDiag ===
=== crashDiag ===
Line 688: Line 688:


; Example
; Example
  arma3.exe -crashDiag
  arma3_x64.exe -crashDiag
-->
-->
=== noFilePatching ===
=== noFilePatching ===
Line 696: Line 696:


; Example
; Example
  arma3.exe -noFilePatching
  arma3_x64.exe -noFilePatching


=== debugCallExtension ===
=== debugCallExtension ===
Line 703: Line 703:


; Example
; Example
  arma3.exe -debugCallExtension
  arma3_x64.exe -debugCallExtension


=== command ===
=== command ===
Line 710: Line 710:


; Example
; Example
  arma3.exe -command=MyFancyPipeName
  arma3_x64.exe -command=MyFancyPipeName


{{ArgTitle|3|language|{{GVI|arma3|2.04}}}}
{{ArgTitle|3|language|{{GVI|arma3|2.04}}}}
Line 719: Line 719:


; Example
; Example
  arma3.exe -language=German
  arma3_x64.exe -language=German


{{ArgTitle|3|preprocDefine|{{GVI|arma3|2.06}}}}
{{ArgTitle|3|preprocDefine|{{GVI|arma3|2.06}}}}
Line 726: Line 726:


; Example 1
; Example 1
  arma3.exe -preprocDefine="CMD__MACRONAME=MACROVALUE"
  arma3_x64.exe -preprocDefine="CMD__MACRONAME=MACROVALUE"
  arma3.exe -preprocDefine=CMD__MACRONAME
  arma3_x64.exe -preprocDefine=CMD__MACRONAME
  arma3.exe -preprocDefine=CMD__MACRO1 -preprocDefine=CMD__MACRO2
  arma3_x64.exe -preprocDefine=CMD__MACRO1 -preprocDefine=CMD__MACRO2


; Example 2
; Example 2
arma3.exe -preprocDefine=MACRO
arma3_x64.exe -preprocDefine=MACRO


The macro name '''will''' start with {{hl|CMD__}}, the engine automatically adds the prefix if it is not present ({{hl|CMD__MACRO}}).
The macro name '''will''' start with {{hl|CMD__}}, the engine automatically adds the prefix if it is not present ({{hl|CMD__MACRO}}).
Line 740: Line 740:


; Example
; Example
  arma3.exe -dumpAddonDependencyGraph
  arma3_x64.exe -dumpAddonDependencyGraph




[[Category: Startup Parameters]]
[[Category: Startup Parameters]]

Revision as of 16:41, 20 October 2024

Startup parameters are command line interface(CLI) arguments that go after the executable's name in order to set options; e.g arma3_x64.exe -window to start the game in windowed mode.

  • Startup parameters' names are case-insensitive - e.g -WINDOW and -window are identical.
  • Spaces in parameter values must be wrapped in quotations - e.g. -profile "E:\Arma Profile"
  • Most of the following parameters can be set with the Arma 3: Launcher.

Steam

  1. Choose the game in Steam\Library
  2. Right click on the game
  3. Select properties
  4. Hit "Set launch options"
Example
-nosplash -mod=test;x\test;c:\arma3\test2


Windows

When working with shortcuts, cmd launch options: there is max characters limit for the executing line, use -par (see: Startup Parameters Config File) to avoid it.

Startup Command Line parameters file
arma3_x64.exe -par="D:\Arma 3 Startup Parameters.txt"
-skipIntro
-noSplash
-enableHT
-hugePages
-noLogs


Path Definition

There are a few basics to keep in mind when defining path as part of a parameter.

Spaces

The path and -profiles need to be enclosed with quotes if it contains spaces, e.g "-profiles=c:\arma 3\profiles".

Relative vs Absolute

You can define most, if not all path in both ways.

Relative
-profiles=profiles
Absolute
-profiles=C:\arma3\profiles

The relative path is normally based on the game main folder, where the exe resides in. Using beta patches does NOT change this! However when you use -profiles, some commands use this path defined there as base.


Display Options

window

Displays Arma 3 windowed instead of full screen. Screen resolution / window size are set in arma3.cfg.

Example
arma3_x64.exe -window

posX

Sets the default X Position of the Window.

Example
arma3_x64.exe -posX=50

posY

Sets the default Y Position of the Window.

Example
arma3_x64.exe -posY=50

adapter

Sets the default Video Adapter.

Example
arma3_x64.exe -adapter=MISSING_AN_EXAMPLE


Game Loading Speedup

noSplash

Tells the engine to bypass the splash screens on startup of Arma 3.

Real speed-up gained with this is likely to be negligible in Arma 3, as the loading screens are handled in parallel with the game data being loaded, and the loading itself takes quite long thanks to the amount of data needed.
Example
arma3_x64.exe -noSplash

skipIntro

Disables world intros in the main menu permanently.

Real speed-up gained with this is likely to be negligible in Arma 3, as the loading screens are handled in parallel with the game data being loaded, and the loading itself takes quite long thanks to the amount of data needed.
Example
arma3_x64.exe -skipIntro

world

Select a world loaded by default. For faster game loading (no default world loaded and world intro in the main menu, only at game start, disabled): -world=empty.

Example

For faster game loading (no default world loaded and world intro in the main menu, only at game start, disabled)

arma3_x64.exe -world=empty

Load Altis

arma3_x64.exe -world=Altis

worldCfg

Inits a landscape by the given world config.


Profile Options

name

Sets the profile name.

Example
arma3_x64.exe -name=PlayerOne

profiles

Location of user-profile folder. If a custom path is set, default files and folders (logFiles, AnimDataCache, DataCache, SteamPreviewCache....) located by default in %LocalAppData%/Arma 3 will be created in that new location. However, old files will stay in the old location and will not be copied.

Example 1
arma3_x64.exe -profiles=C:\arma3\Profiles
Example 2
arma3_x64.exe -profiles=Profiles

Example 2 create a folder called Profiles in the Arma 3 root directory

The Windows user account needs write access in the chosen location.

unit

Parameter passes a unit's ID number to the binary, translates to https://units.arma3.com/my-units#?unit=<number>

Example
arma3_x64.exe -unit=1337


Misc.

buldozer

Starts Buldozer mode.

Example
arma3_x64.exe -buldozer

noLand

Starts with no world loaded. (Used for Buldozer)

Example
arma3_x64.exe -noLand

noSound

Disables sound output.

Example
arma3_x64.exe -noSound

doNothing

Engine closes immediately after detecting this option.

Example
arma3_x64.exe -doNothing

mod

Loads the specified mod folders. Multiple folder need to be separated by a semicolon.

Example 1
arma3_x64.exe -mod=test;x\test;c:\arma3\test2
  • "test" is located in the Arma 3 installation folder ("Arma 3\test") (relative path)
  • "x\test" is in the installation folder ("Arma 3\x\test") (relative path; subfolder)
  • "c:\arma3\test2" is in "c:\arma3\test2" (absolute path)
Example 2

On Windows

arma3_x64.exe -mod=test;x\test;c:\arma3\test2
Example 3

On Linux. Note the addtional backslash in front of the semicolon

arma3_x64.exe -mod=test\;x\test\;c:\arma3\test2 #Linux, 
"Relative path" starts from, or is rooted at, the directory from where the Arma 3 executable has been started and is not always the same where the executable is, like in betas.

Usually this is the same as the installation path and the same as what is written in Windows registry, but if you copy or symlink the necessary file and folders, you may have different roots.

It is useful when having multiple dedicated servers.


Client Network Options

connect

Server IP to connect to.

Example
arma3_x64.exe -connect=168.152.15.147

port

Server port to connect to.

Example
arma3_x64.exe -port=1337

password

Server password to connect to.

Example
arma3_x64.exe -password=1337abc

host

Start a non-dedicated multiplayer host.

Example
arma3_x64.exe -host


Server Options

setUpHost

Start the game in the setup server display, works with the client exe. See reference image

Example
arma3_x64.exe -setUpHost

server

Start a dedicated server. Not needed for the dedicated server exe.

Example
arma3_x64.exe -server

port

Port to have dedicated server listen on.

Example
arma3_x64.exe -port=1337

pid

File to write the server's PID (process ID) to. The file is removed automatically when the exe is stopped. Only works for dedicated servers.

Example
arma3_x64.exe -pid=C:\MyServer\PID.txt

ranking

Allowing you to output ranking information or otherwise know as player stats to a file.

The windows user account would need permissions to write to the folder of choice.

Output sample:

class Player1
{
	name = "PlayerName";
	killsInfantry = 71;
	killsSoft = 3;
	killsArmor = 5;
	killsAir = 5;
	killsPlayers = 0;
	customScore = 0;
	killsTotal = 84;
	killed = 3;
};
Example
arma3_x64.exe -ranking=C:\arma3\ranking.log

netlog

Enables multiplayer network traffic logging. For more details see server configuration.

Example
arma3_x64.exe -netlog

cfg

Selects the Server Basic Config file. Config file for server specific settings like network performance tuning.

Using this parameter overrides the game config (Documents\Arma 3\Arma3.cfg); use at your own risk on clients.
Example
arma3_x64.exe -config=C:\MyServer\basic.cfg

config

Selects the Server Config File. Config file for server specific settings like admin password and mission selection.

Example
arma3_x64.exe -config=C:\MyServer\config.cfg

profiles

Path to the folder containing server profile. By default, server logs are written to server profile folder. If folder doesn't exist, it will be automatically created. Does not work on Linux, no profile will be created or used; instead, remove this parameter and the profile will be created in ~/.local/share/Arma 3 - Other Profiles

Example
arma3_x64.exe -profiles=C:\MyServer\profiles

bePath

By default BattlEye will create BattlEye folder inside server profile folder. With -bePath param it is possible to specify a custom folder.

Example
arma3_x64.exe -bePath=C:\MyBattlEyeFolder

ip

Command to enable support for Multihome servers. Allows server process to use defined available IP address. (b1.57.76934)

Example
arma3_x64.exe -ip=145.412.123.12

par

Command to read startup parameters from a file. For more details see Startup parameters config file.

Example
arma3_x64.exe -par="C:\Users\Player\Games\Arma 3\Arma 3 Parameter Files\par_common.txt"

client

Launch as client (console). Useful for headless clients.

Example
arma3_x64.exe -client

loadMissionToMemory

Server will load mission into memory on first client downloading it. Then it keeps it pre-processed pre-cached in memory for next clients, saving some server CPU cycles.

Example
arma3_x64.exe -loadMissionToMemory

autoInit

Automatically initialize mission just like the first client does. The server config file (server.cfg) must contain Persistent = 1; otherwise the autoInit parameter is skipped.

This will break the Arma 3: Mission Parameters function, so do not use it when you work with mission parameters, only default values are returned!
Example
arma3_x64.exe -autoInit

serverMod

Loads the specified sub-folders for different server-side (not broadcasted to clients) mods. Separated by semi-colons. Absolute path and multiple stacked folders are possible. In Linux multiple folders arguments need the following separation syntax: -mod=mod1\;mod2\;mod3.

Example
arma3_x64.exe -serverMod=myAwesomeMod;anotherAwesomeMod;

disableServerThread

Option to disable the server send messaging thread in case of random crashing (may also decrease performance of server on multicore CPUs)

Example
arma3_x64.exe -disableServerThread

bandwidthAlg

Set to 2 to use a new experimental networking algorithm that might be better than the default one.

Example
arma3_x64.exe -bandwidthAlg=2

limitFPS

Limits the server FPS to the provided value in 5..1000 FPS range (default 50).

Example
arma3_x64.exe -limitFPS=300

networkDiagInterval

Polls the status of bandwidth, traffic and similar data every X seconds. Since Arma 3 logo black.png2.18 is also logs size and count of public variables when using the Profiling binary.

Example
arma3_x64.exe networkDiagInterval=10

Performance

maxMem

Overrides memory allocation limit to a certain amount (in megabytes).

Until Arma 3 logo black.png2.14 there was a bug on the Linux server binary where it parses the maxMem value as a signed integer, therefore making 4096 interpreted as a negative value; in order to avoid this issue, use values like 2047, 4095, 8191, 16383, 32767 (2048 -1, 4096 -1 etc).

1024 MiB is a hard-coded minimum (anything lower falls back to 1024). The maximum is influenced by your operating system (any value over the maximum will be reverted to this value):

  • 32-bit Windows + 32-bit game: 2047
  • 64-bit Windows + 32-bit game: 3071
  • 64-bit Windows + 64-bit game: (physical memory * 4) / 5

Without the -maxMem parameter the engine attempts to set this parameter internaly to a reasonable value often defaulting to max values as described above. The file cache is always excluded from the virtual address limit, see our developers blog: https://www.bistudio.com/blog/breaking-the-32-bit-barrier.

Note that setting maxMem to 2000 does not mean that the game will never allocate more then 2000 MiB. It says that the game will do everything in its power to not cross this limit. In general, it makes sense not using this parameter at all and only resort to it in case you experience issues with memory.
Example
arma3_x64.exe -maxMem=4096

maxVRAM

Defines video memory allocation limit to number (in megabytes). Use to resolve e.g. Windows problem: http://support.microsoft.com/kb/2026022/en-us?p=1. Minimum value is 128 MiB (anything lower falls back to 128). The value is ignored (under DX11) if engine properly detected VRAM size, minus 20% reserve with ceiling limit 300MB max.

Example
arma3_x64.exe -maxVRAM=4096

maxFileCacheSize

Arma 3 logo black.png2.14 Sets the default filecache size (when files are loaded from disk, they are cached in RAM. If the cache is full, the oldest file is thrown out).

  • Default size was either maxMemory - 448 MB or if you had more than 2 GB of memory available to Arma 3, it would be limited to max 2048 MB.
  • Setting lower than 1 GB is not recommended.
  • Minimum possible value is 512 MB
Example
arma3_x64.exe -maxFileCacheSize=2048

noCB

Turns off multicore use. It slows down rendering but may resolve visual glitches.

Example
arma3_x64.exe -noCB

CPUCount

Change to a number less or equal than numbers of available cores. This will override auto detection (which equate to native cores). The best way to simulate dual core on quad core is to use -cpuCount=2 when you run the game and then change the affinity to 2 cores to make sure additional cores can never be used when some over-scheduling happens. It might be also possible to set the affinity in the OS before you launch the process, that would work as well.

Example
arma3_x64.exe -exThreads=8

exThreads

Change to a number 0,1,3,5,7. This will override auto detection (which use 3 for dualcore and 7 for quadcore). All file operations go through a dedicated thread. This offloads some processing from the main thread, however it adds some overhead at the same time. The reason why threaded file ops were implemented was to serve as a basement for other threads ops. When multiple threads are running at the same time, OS is scheduling them on different cores. Geometry and Texture loading (both done by the same thread) are scheduled on different cores outside the main rendering loop at the same time with the main rendering loop.

Ex(tra)threads table
Parameter Description
Number Geometry loading Texture loading File operations
0 0 0 0
1 0 0 1
3 0 1 1
5 1 0 1
7 1 1 1
Example
arma3_x64.exe -exThreads=7

malloc

Sets the particular memory allocator to be used. Significantly affects both performance and stability of the game. More details.

Example
arma3_x64.exe -malloc=someMalloc

hugePages

Enables hugepages with the default memory allocator (malloc) for both client and server.

Example
arma3_x64.exe -hugePages

enableHT

Enables the use of all logical CPU cores for parallel tasks processing. If your CPU does not support Hyper-Threading or similar technology, this parameter is ignored. When disabled, only physical cores are used.

Note that enabling this parameter may slightly improve or harm the performance depending on a scenario. This parameter may be overridden by -cpuCount so if you want to use the maximum number of CPU cores use "-enableHT" without "-cpuCount".
Example
arma3_x64.exe -enableHT

setThreadCharacteristics

Registers the game's executable as "Game" in Windows for performance improvements.

This flag can freeze the whole Operating System if running Windows Server!
Example
arma3_x64.exe -setThreadCharacteristics


Developer Options

noPause

Allow the game running even when its window does not have focus (i.e. running in the background)

Example
arma3_x64.exe -noPause

noPauseAudio

Keeps audio running in background while tabbed out. Should be used together with -noPause to work correctly

Example
arma3_x64.exe -noPauseAudio

showScriptErrors

Introduced to show errors in scripts on-screen. In Eden Editor, script errors are always shown, even when this parameter is not used.

Example
arma3_x64.exe -showScriptErrors

debug

Enables more verbose error logging. See Arma 3: Debug Mode

Example
arma3_x64.exe -debug

noFreezeCheck

Disables the freeze check. It creates otherwise max 4 dumps per game run in total - 2 per distinct freeze. Similar to Crash Files.

Example
arma3_x64.exe -noFreezeCheck

noLogs

Be aware this means none errors saved to RPT file (report log). Yet in case of crash the fault address block info is saved. More details here.

Example
arma3_x64.exe -noLogs

filePatching

Allows the game to load unpacked data. For more info see CMA:DevelopmentSetup

Example
arma3_x64.exe -filePatching

init

Run scripting command once in the main menu. For example to start a certain SP mission of choice automatically. See also playMission. The Mission has to reside in the "arma3\Missions" folder, NOT the user directory.

Example
arma3_x64.exe -init=playMission["","M04Saboteur.Sara"]

<path>\mission.sqm

Load a mission directly in the editor. Example: "C:\arma3\users\myUser\missions\myMission.intro\mission.sqm"

autotest

Loads automatically a series of defined missions and on error writes to a log file.

The parameter can be used to automatically run a series of test missions. For example FPS measurement or scripting validation.

  • The game runs in special mode. It runs all missions from the given list.
  • If any mission fails (ends with other than END1), it is logged into the rpt file (search: <autotest).
  • In case of any fail, the game also returns an errorlevel to DOS. This can be used to issue an notification by a secondary application.
Launch Arma 3 with
-autotest=c:\arma3\autotest\autotest.cfg

The autotest.cfg looks like:

class TestMissions
{
	class TestCase01
	{
		campaign = "";
		mission = "autotest\TestCase01.Desert_E"; // relative path to the arma directory
	};
	class TestCase02
	{
		campaign = "";
		mission = "C:\arma3\autotest\TestCase02.Desert_E"; // absolute path
	};
};
If -profiles is used, the relative path is relative to the specified profile path.
Example
arma3_x64.exe -autotest=c:\arma3\autotest\autotest.cfg
RPT entry
<AutoTest result="FAILED">
	EndMode = LOSER
	Mission = autotest\TestCase01.Desert_E
</AutoTest>

If possible use simple worlds, like Desert, to keep the loading times short. The loading screen command might be useful as well to speed up task that need no rendering.

beta

Loads the specified beta sub-folders. Separated by semicolons. Absolute path and multiple stacked folders are possible. In Linux multiple folders arguments need the following separation syntax:

Example
arma3_x64.exe -mod=betamod1\;betamod2\;betamod3

This allows use of beta build w/o disabling in-game mod/extension management (in UI menu).

checkSignatures

Provide a thorough test of all signatures of all loaded banks at the start game. Output is in .rpt file.

Example
arma3_x64.exe -checkSignatures

d3dNoLock

Doesn't lock the VRAM.

Example
arma3_x64.exe -d3dNoLock

d3dNoMultiCB

D3D uses Single Constant Buffers instead of Multiple Constant Buffers.

Example
arma3_x64.exe -d3dNoMultiCB

noFilePatching

Ensures that only PBOs are loaded and NO unpacked data.

It was replaced in favor of the -filePatching parameter.
Example
arma3_x64.exe -noFilePatching

debugCallExtension

Logs extension calls in the rpt log like this: arma3-startup parameter debugCallExtension output.png

Example
arma3_x64.exe -debugCallExtension

command

Creates named pipe "\\.\pipe\name" for receiving predefined set of commands. See Arma 3: Named Pipe.

Example
arma3_x64.exe -command=MyFancyPipeName

language

Starts client with preferred language. See Stringtable.xml - Supported Languages for a list of supported languages. Case-sensitive! (className column)

Arma 3 logo black.png2.18 made the parameter work properly.
Example
arma3_x64.exe -language=German

preprocDefine

Defines a macro and optionally its value. Multiple macro can be defined by using this parameter multiple times.

Example 1
arma3_x64.exe -preprocDefine="CMD__MACRONAME=MACROVALUE"
arma3_x64.exe -preprocDefine=CMD__MACRONAME
arma3_x64.exe -preprocDefine=CMD__MACRO1 -preprocDefine=CMD__MACRO2
Example 2

arma3_x64.exe -preprocDefine=MACRO

The macro name will start with CMD__, the engine automatically adds the prefix if it is not present (CMD__MACRO).

dumpAddonDependencyGraph

dumps Graphviz text file into the RPT directory with a graph of all addon dependencies (requiredAddons)

Example
arma3_x64.exe -dumpAddonDependencyGraph