Difference between revisions of "Arma 3: Launcher"

From Bohemia Interactive Community
Jump to navigation Jump to search
(BattlEye)
m (Text replacement - "\[ *(https?\:\/\/[^\[ ]*steamcommunity\.com[^\[ ]+) ([^ ]+) *\]" to "{{ExternalLink|link= $1|text= $2}}")
(37 intermediate revisions by 6 users not shown)
Line 1: Line 1:
{{GVI|Arma 3|1.24|category}}
+
{{GVI|Arma 3|1.24}}
 
[[File:Arma3LauncherIcon.png|128px|right]]
 
[[File:Arma3LauncherIcon.png|128px|right]]
  
The official Arma 3 Launcher was launched July 14, 2014 with the Bootcamp update 1.24. http://arma3.com/news/bohemia-interactive-deploys-arma-3-bootcamp-update#.VCsNUWddUug
+
The main purpose of the official Arma 3 Launcher is to enable easy management of local and [[Addons#Steam_Workshop|Steam Workshop]] mods including their load order and custom presets, setting up game parameters and display Arma 3 developer news.  
  
It's main purpose is to enable easy management of local and [[Addons#Steam_Workshop|Steam Workshop]] mods including their load order and custom presets, setting up game parameters and display Arma 3 developer news.  
+
The official Arma 3 Launcher was launched July 14, 2014 with the Bootcamp update 1.24 (http://arma3.com/news/bohemia-interactive-deploys-arma-3-bootcamp-update).
  
=Branch and Version=
+
=User interface=
[[Image:A3Launcherribbon.PNG|200px|left]]
+
[[Image:Launcher MainUI.png|800px|center]]
<br style="clear:both" />
+
== Common elements ==
* '''Ribbon:''' Colored ribbon in the top-right corner now identifies the currently used Steam branch.
+
[[image:Launcher_CommonUI.png|800px|center]]
** Default (=Stable branch): no ribbon
+
'''Play''' button
* Game version is displayed under Arma 3 logo.
 
  
=News=
+
[[Image:Launcher_QuickPresetSelector.png|160px|right]]
Displays news from [http://dev.arma3.com/].  
+
* Starts the game with a current Launcher setup of mods and parameters. Mods tab will get locked when the game is running.
 +
* Expanded Play button supports quick selection of mod presets including unmodded game.  
  
[[Image:Arma 3 Launcher News.png|500px|left]]
+
'''Status bar'''
<br style="clear:both" />
 
* older items are being loaded as you scroll down
 
** To load additional items, click Load more at the bottom
 
  
=Parameters=
+
* Displays the workshop mod download progress and notifies the user when the steam is offline (making the workshop unreachable).
 +
* Displays the state of BattlEye anti-cheat service initialization when launching the game. Use of BattlEye anti-cheat has to be enabled on [[#BattlEye|BattlEye]] page.
 +
* Displays notification when the mod updates handled by Steam Client are waiting for user to quit applications.
 +
* When the service is initialized, the status is switched automatically back to the Mods downloads.
 +
** ''Use arrows to switch between Mod downloads and Service progress.''
  
Additional information can be found here: [[Arma 3 Startup Parameters]]
+
'''Options''' menu gives you an access to [[#Options|Launcher options]], and also contains various links and additional info about the game. Logs and the game troubleshooter helper can be also accessed from this menu.
  
==Basic==
+
'''Colored ribbon''' in the top-left corner identifies the currently used Steam branch (default main branch - no ribbon).
  
[[Image:Arma3LauncherParam.png|500px|left]]
 
<br style="clear:both" />
 
Allows setting up launch [[Arma_3_Startup_Parameters|parameters]]. Pages are separated to Basic and Advanced.
 
  
Moreover, all Launcher resolves all parameters set in the Steam's set launch option dialog and displays them in the Basic/Command line parameters.
 
  
<br>
+
=Pages=
*'''Mods''' - Loads the specified sub-folders for different mods. Separated by semi-colons<br>
 
*'''No Splash''' - Bypass the splash screens on startup of Arma3<br>
 
*'''Skip Intro''' - Disables world intros in the main menu permanently<br>
 
*'''Windowed''' - Displays Arma windowed instead of full screen<br>
 
*'''Profiles''' - Profile name to load<br>
 
  
'''Restore default setting:''' turns off all parameters.
+
== Dashboard ==
==Advanced==
+
The first page in Launcher displays the latest news post, links to a social media of Arma 3 and Bohemia Interactive, and mainly the information about joined units from {{ExternalLink|link= https://units.arma3.com Arma|text= 3 Units}}.
[[Image:Arma3LauncherParamAdv.png|500px|left]]
 
  
<br style="clear:both" />
+
If you are a member of any unit, you can pre-select that units in Launcher, by checking the box on the unit, and it will be automatically activated in the game, once you start it. Or you can choose to play without a unit or let the game use the same unit you've played the last time.
===Advanced===
 
*'''Par''' - Reads startup parameters from a file<br>
 
*'''Check Signatures''' - Introduced to provide thorough test of all signatures of all loaded banks at the start game<br>
 
*'''CPU Count''' - Define number of CPUs/cores available<br>
 
*'''ExThreads''' - Option to define extra threads
 
** File operations - use a dedicated thread for file operations (enabled when ExThreads is 1 or 3 or 5 or 7)
 
** Texture loading - use a dedicated thread for loading textures (enabled when ExThreads is 2 or 3 or 6 or 7)
 
** Geometry loading - use a dedicated thread for loading geometry data (enabled when ExThreads is greater than or equal to 4)<br>
 
*'''Enable Hyper-Threading''' - Enables the use of hyper-threading CPU cores which might slightly improve performance in certain scenarios<br>
 
*'''Malloc''' - Particular allocator to be used<br>
 
*'''MaxMem''' - Memory allocation limit to number (in MegaBytes)<br>
 
*'''MaxVRAM''' - Defines Video Memory allocation limit to number (in MegaBytes)<br>
 
*'''Enable File Patching''' - Allow unpacked data to be loaded<br>
 
*'''No Logs''' - Don't store the log<br>
 
*'''World''' - Select a world loaded by default<br>
 
*'''Profile Path''' - Location of user-profile folder<br>
 
  
===Client===
+
== News ==
*'''Server IP''' - Server IP to connect to<br>
+
<!-- [[Image:Arma 3 Launcher News.png|250px|right]] -->
*'''Server Port''' - Server port to connect to<br>
+
Displays news from {{ExternalLink|link= http://dev.arma3.com/|text= Arma 3 website}}.
*'''Server Password''' - Server password to connect to<br>
+
* Unread items are marked by orange color.
*'''Host Session''' - Start a non-dedicated multiplayer host<br>
+
* To load additional items, click Load more at the bottom.
===Host===
 
*'''Server''' - Start as dedicated server<br>
 
*'''Server Port''' - Port to have dedicated server listen on<br>
 
*'''PID''' - File to write the server's PID (process ID) to<br>
 
*'''Ranking File''' - Generates a ranking file<br>
 
*'''NetLog''' - Enables multiplayer network traffic logging<br>
 
*'''Cfg''' - Selects the Server Basic Config file<br>
 
*'''Config''' - Selects the Server Config File<br>
 
*'''BEpath''' - Defines the path to BattlEye<br>
 
*'''Dedicated Server IP''' - Allows server process to use defined available IP address<br>
 
  
===Author===
+
== Parameters ==
*'''Buldozer''' - Starts Buldozer mode<br>
+
Allows setting up the [[Arma_3_Startup_Parameters|startup parameters]]. Parameters are separated to Basic and Advanced tabs:
*'''Init Script''' - Runs scripting command once in the main menu<br>
 
*'''Do Nothing''' - Engine closes immediately after detecting this option<br>
 
*'''No Pause''' - Allow the game running even when its window does not have focus<br>
 
*'''No Sound''' - Disables sound output<br>
 
*'''No Land''' - Starts with no world loaded,<br>
 
*'''Shows Script Errors''' - Introduced to show errors in scripts on-screen<br>
 
*'''Autotest''' - Loads automatically a series of defined missions and on error writes to a log file<br>
 
*'''Beta''' - Loads the specified beta sub-folders. Separated by semi-colons<br>
 
===Compatibility===
 
*'''No Context Buffers''' - Turns off multicore use. It slows down rendering but may resolve visual glitches<br>
 
  
=Mods=
+
'''Basic''' tab
[[Image:Arma 3LauncherMods.PNG|500px|left]]
+
[[Image:Launcher_ParametersBasic.png|250px|right]]
<br style="clear:both" />
+
*''Mods'' - Loads the specified sub-folders for different mods. Separated by semi-colons.
The Arma 3 Launcher Mods menu allows you to configure [http://steamcommunity.com/workshop/browse?appid=107410 Steam Workshop] mod content. From here you can see a list of all your subscribed content.<br>
+
*''No Splash'' - Bypass the splash screens on startup of Arma 3.
Workshop now supports uploading unlimited size items containing multiple files. Multiple-file mods follow the standard behavior of mods in Launcher with the following change. Because Steam Client handles such files differently, new functionality was introduced in Launcher to display the status of the item.
+
*''Skip Intro'' - Disables world intros in the main menu permanently.
 +
*''Windowed'' - Displays Arma 3 windowed instead of full screen.
 +
*''Profiles'' - Profile name to load.
 +
*''Mission File'' - Automatically opens the selected mission in the game editor.
 +
*''Command line parameters'' - Launcher resolves all parameters set in the Steam's set launch option dialog and displays them in here. See list of [[Arma_3_Startup_Parameters|supported parameters]].
 +
*''Restore default setting'' - Turns off all parameters.  
  
{{Important|All downloads are now handled by the Steam Client instead of the Launcher. When downloading updates for multiple-files mods, Steam Client will not provide the update when any Arma 3 related application (Arma 3, Launcher, Publisher) is running. Please, exit all the applications to allow updates to be pushed from the temporary download folder to a proper folder.
+
'''Advanced''' tab
 +
<!--[[Image:Arma3LauncherParamAdv.png|250px|right]]-->
 +
<br>For detailed description of Advanced Parameters see: [[Arma_3_Launcher_-_Advanced_Parameters|Launcher - Advanced Parameters]]
  
Updates while those applications running will be enabled once Valve delivers this feature.}}
+
== Mods ==
 +
The Mods page allows you to configure {{ExternalLink|link= http://steamcommunity.com/workshop/browse?appid=107410|text= Steam Workshop}} mod content. From here you can see a list of all your subscribed content. Workshop supports uploading unlimited size items containing multiple files.<br>
  
*[[Image:launcher_sort_icon_negative.png]]''':''' Allows you toggle the orientation of the mod list to ascending or descending simply by clicking on it. This list indicates the order that they are loaded into Arma 3. Load order is vital for some mods based on their dependencies as they may cause undesired behavior if not set correctly.<br>
+
{{Feature|important|All downloads are handled by the Steam Client. When downloading updates for multiple-files mods, Steam Client will download content but do not update the mod files when any Arma 3 related application (Arma 3, Launcher, Publisher) is running. Please, exit all the applications to allow updates to be pushed from the temporary download folder to a proper folder.}}
*'''?:''' Checkbox to load or unload mods. Checked state means the mod will be loaded into the game when clicking '''Play''' button.
+
[[Image:Launcher_Mods.png|250px|right]]
*'''Name:''' Name of the mod
 
*'''Preset:''' Here you can save, load and name various presets of addons. This makes switching mod sets much faster rather than ticking boxes each time. The current unsaved preset is preserved when the launcher quits<br>
 
*'''Mods List:''' Complete list of mods. To view various mods options and information, click on a list item. You can drag and drop an item between other loaded items to load it and change it's load order at the same time.<br>
 
* '''Status:''' Signifies the status of the mod
 
{| class="wikitable"
 
! '''Icon'''
 
! '''State'''
 
! '''Status in Mod Info'''
 
! '''Description'''
 
|-
 
| [[Image:ExtensionState NotReady.png|16px]]
 
| Not Ready
 
| Not Ready
 
  
Verifing...
+
*All subscribed Steam Workshop mods are visible here.
 +
*Loaded mods <span style="color: red">(1)</span> are mods marked for launch when you start the game.
 +
*Available mods  <span style="color: red">(2)</span> are mods which won't be loaded and used when the game starts.
 +
*User can move items between the two lists by clicking on the checkbox or by dragging the mod from one list to the other.
  
Checking..
+
'''Toolbar commands'''  <span style="color: red">(3)</span>
| Item is being initialized.
 
|-
 
| [[Image:ExtensionState Busy.png|16px]]
 
| Busy
 
| Downloading...
 
  
Synchronizing...
+
*[[Image:Launcher_Button_AddWorkshopMod.png|Add Steam Workshop Mod]]  - opens Steam Workshop home page with ''mod'' tag pre-selected to allow easier mod subscribing.
 +
*[[image:Launcher_Button_AddLocalMod.png|Add Steam Workshop Mod]] - opens browse folder dialog. User is able to include his local (non-Workshop) mods into Launcher to manage them from one place, mods can be also drag'n'dropped into the Launcher window.
 +
*[[Image:Launcher_Button_MoreModOptions.png|More toolbar button]] - opens a menu with more options:
 +
**Unsubscribe all Steam Workshop mods - Automatically unsubscribes all mods currently subscribed on Steam Workshop.
 +
**Add watched folder - Allows you to add watched folder where Launcher detects local mods.
 +
*''Mod search box'' - allows search in the mods in the lists below; can be also activate with a keyboard shortcut Ctrl+F.
  
Removing...
+
'''Icons'''
 +
*''Steam icon'' - indicates that the mods comes from Steam Workshop.
 +
*''Status icon'' - signifies the status of the mod, for detailed info visit [[Arma_3_Launcher_-_Mod_Handling#Mod_States|Arma 3 Launcher - Mod Handling]].
 +
*''Certificate icon'' - mods with multiplayer signatures are marked by a green certificate icon (it means that all PBOs has at least one BISIGN file).
  
Working...
+
'''Presets'''
| Item is currently being processed. It cannot be loaded into the game.
+
[[Image:Launcher_QuickPresetSelector.png|200px|right]]
|-
+
Mod presets are named sets of mods. You can display and manage presets by clicking on the name of current preset in the top right corner of the page <span style="color: red">(4)</span>. Here you can save, load and name various presets of mods. This makes switching mod sets much faster. The current unsaved preset is preserved when the launcher quits.
| | [[Image:ExtensionState Corrupted.png|16px]]
 
| Corrupted
 
| Corrupted
 
| Item is installed and corrupted and cannot be loaded into the game. Causes:
 
* mod target path is not set
 
* mod target path doesn't exist
 
* mod target path doesn't contain Addons directory
 
* mod target path / Addons doesn't contain an *.pbo or *.ebo file
 
|-
 
| [[Image:ExtensionState Listed.png|16px]]
 
| Update Queued
 
| Ready, update queued (on Steam)
 
| Item is installed and is queued for update. Update will not be processed when the Launcher, Publisher or game are running. This will be marked in the Progress bar.
 
|-
 
|
 
| OK
 
| Ready
 
| Item is installed and ready to be used.
 
|-
 
| [[Image:ExtensionState Listed.png|16px]]
 
| Listed
 
| Not Installed
 
| Item is not installed, waiting for download by the Steam Client.
 
|-
 
| [[Image:ExtensionState Listed.png|16px]]
 
| Installation Queued
 
| Not installed, download queued
 
| Item is waiting to be installed by the Steam Client.
 
|}
 
  
*** '''Updated'''
 
Mods in the state of "[[Image:ExtensionState Listed.png|16px]] Update queued" will be updated by the Steam Client once all the applications (Launcher, Publisher, game) are not running. When the Launcher starts, such mods are labeled as '''updated'''. The label serves only as a notification and can be removed by clicking the mod to open Mod info. The label will also disappear on the Launcher's next start on on the game start.
 
  
*** '''Auto-included'''
+
You can also start the game directly with a saved preset using ''Quick preset selector'', which can be access by clicking on the arrow on Play button.
Mods auto-included by scanning folders specified in '''Options''' are marked with an auto-included label. The label serves only as a notification and will be removed on the Launcher's next start.
 
  
** '''Mod info:''' Click on an item to open extended mod info. Here you can see additional information like image, size and last update time. Buttons enable you to open the mod page in Steam, open the mod installation folder, and unsubscribe and delete the mod<br>
 
*** '''Image''': click opens item's Steam Workshop page
 
*** '''Source:''' the source of mod is indicated by a watermark icon
 
**** Steam: for mods subscribed from Workshop. Also marked by a Steam watermark icon
 
**** Local: for mods included from disk. Also marked by a folder watermark icon.
 
*** '''Mulitplayer:''' mods with multiplayer signatures are marked by a green sign icon in Mod info and on the collapsed item. Mods partially signed (not all PBOs have a matching signature) are marked in Mod info.
 
  
*'''+ Steam:''' Opens Steam Workshop home page with '''mod''' tag pre-selected to allow easier mod subscribing<br>
+
For more info about mod handling and detailed description of all related windows see: [[Arma_3_Launcher_-_Mod_Handling|Arma 3 Launcher - Mod Handling]]
*'''+ Local folder:''' Opens browse folder dialog. User is able to include his local (non-Workshop) mods into Launcher to manage them from one place
 
* mods can be also drag'n'dropped into the Launcher window
 
  
=BattlEye=
+
== BattlEye ==
* '''Enable BattlEye anto-cheat software''' - when enabled (default), it will launch [[BattlEye]] anti-cheat service before launching Arma 3
+
BattlEye is anti-cheat software used by Arma 3. Launcher can start the anti-cheat service when you start the game. This options is controlled by the options ''Enable BattlEye anti-cheat software'', when checked it will start the BattlEye service when you start the game.
* '''BattlEye Log''' - displays the BattlEye messages and status updates. Messages can be coppied to a clipboard.
 
** BattlEye initialization progress is also presented on the progress bar
 
: NOTE: BattlEye EULA needs to be accepted. If not, the service is not launched.
 
  
=Options=
+
Messages and status  from BattlEye service are displayed on this page in the ''Log Messages'' list. When starting the game with BattlEye the current status is also displayed in the Launcher's status bar. The messages can be copied to Windows Clipboard by the button next to the message.
[[Image:Arma3LauncherOptions.PNG|500px|left]]
 
<br style="clear:both" />
 
Open Launcher Options by clicking on the cog icon in the top right corner (1st icon from the left). Options allow you to set up application wide settings for Launcher. <br>
 
*'''Language:''' switch Launcher to a Language of your choice. Default: English. Additional: Czech, German, Spanish, French, Italian, Portuguese, Polish and Russian. Depending on a region, Japanese and Korean language pack might be also available. <br>
 
*'''Disable Launcher's UI hardware acceleration''': Checkbox disables hardware acceleration for WPF rendering for Launcher. This is Launcher only, does not affect the game in any way. Default state: HW acceleration enabled.<br>
 
*'''Minimize Launcher to tray:''' When minimized, the launcher will appear in the notification zone instead of the task-bar.
 
*'''Mod Management:''' Allows you to define folders to continuously scan and auto-include any local mods found into Launcher '''Mods''' tab. Use Add and Remove buttons to include to delete your folders.
 
* '''Action after game start:'''
 
** Do nothing
 
** Minimize Launcher - minimizes Launcher after game starts
 
** Close Launcher - exits Launcher after game starts
 
** Close Launcher after game ends - exits Launcher after game ends
 
  
=Application Menu=
+
''NOTE: BattlEye EULA needs to be accepted. If not, the service is not launched.''
[[Image:A3LauncherApplicationMenu.png|500px|left]]
 
<br style="clear:both" />
 
Application menu contains links for most relevant project and company pages. Use it to quickly navigate to: [http://feedback.arma3.com Feedback Tracker], [http://support.bistudio.com/arma-3 Bohemia Interactive support page], [http://steamcommunity.com/workshop/browse/?appid=107410 Arma 3 Steam Workshop home], [http://community.bistudio.com/ Community Wiki], [http://www.bistudio.com/ Bohemia Interactive website], [http://www.arma3.com Arma 3 Website].<br>
 
*'''Export Launcher logs:''' collects Launcher logs and configs and packs them to a zip archive in user's Desktop folder. This action is here to make launcher feedback and improvements go smoother. When reporting a Launcher issue on Feedback tracker, please, include this archive.
 
*'''Game version:''' displays the game (.exe) version
 
*'''Branch''' current Steam branch is displayed
 
*'''Version:''' the menu also includes Launcher's version. Click to copy the version number into clipboard.
 
  
  
 +
== Servers ==
 +
Servers page contains an integrated server browser. It contains five tabs which contains a specific set of Arma 3 Servers.
 +
* '''Favorites''' - displays only Arma 3 servers you've marked as a favorite (with a star).
 +
* '''Recent''' - displays the servers you've played on recently.
 +
* '''Friends''' - the servers where you Steam friends play right now.
 +
* '''Internet''' - all the reachable internet servers.
 +
* '''Units''' - the servers related to Arma 3 Units that you are member of.
 +
[[image:Laiuncher_ServerBrowser.png|600px|center]]
  
=Play and status bar=
+
On each tab you can find the filter bar on the top, where you can enter a search phrase or filters or use the "Filters" button to display a dialog where you can edit your filters. If the filter is active, its icon and the frame will in gold. The server counter next to the filter bar shows number of displayed servers and total number of servers; when the filter is active, these numbers may be different.
[[Image:Arma3LauncherQuickSelect.jpeg|150px|right]]
+
[[image:Launcher_ServerFilterBasic.png|400px|center]]
*'''Play:''' Start the game with a current Launcher setup of mods and parameters. Mods tab will get locked when the game is running.<br>
 
** Play now allows quick selection of mod presets including unmodded game.
 
*'''Status bar:''' displays the workshop mod download progress and notifies the user when the steam is offline (making the workshop unreachable).  
 
** Progress bar will now display notification when the mod updates handled by Steam Client are waiting for user to quit applications.
 
*** Progress bar will now display the state of BattlEye service initialization when launching the game. BattlEye has to be enabled in options.
 
*** Use arrows to switch between Mod downloads and Service progress bar.
 
*** When the service is initialized, the status switched automatically back to the Mods downloads.
 
  
=Logs=
+
Each game server is represented by a row in the list. You can join the server by clicking on "JOIN" button that will appear when you move your mouse to that row. (If the server can't be joined, because it is locked the lock symbol will appear instead.). Clicking anywhere else on the row will expand it and display more information about the server (e.g. server version, server address, required DLCs).
Find Launcher logs in Users\''yourUserName''\AppData\Local\Arma 3 Launcher\Logs<br>
+
[[image:Launcher_ServerRow.png|800px|center]]
When something goes wrong (in several attempts, because Steam can have a bad moment sometimes :) ), please, create an issue on http://feedback.arma3.com (launcher category) and include these logs.
 
  
=Troubleshooting and the safe mode=
+
When you click on the JOIN button a dialog with required mods is displayed to you. On the top it displays the basic information about the server (you can click on it to display more  <span style="color:red">(1)</span>). The middle part of the dialog displays required and optional mods (and also the mods you have currently selected, but that can't be used on the server). When you click on '''SETUP MODS AND JOIN''' button  <span style="color:red">(2)</span> Launcher will automatically load the mods it recognizes and subscribes you Steam Workshop to the ones that you don't have. (Some servers might be missing a Steam Workshop identifiers for the mods, so Launcher might have a hard time detecting the right mod or the mod might not be available on the Workshop at all.) You can change what happens when you click the button by changing the action for each of the mods in the list of mods above it. <span style="color:red">(4)</span>  '''KEEP CURRENT SELECTION AND JOIN''' button  <span style="color:red">(3)</span> will connect you to the server without any changes to mods you have enabled on MODS page.
Check the [http://arma3.com/launcher/troubleshooting troubleshooting webpage] to learn about required redistributables and known issues.  
+
[[Image:Launcher_JoinDialog.png|800px|center]]
: Note: Missing redistributables should be automatically installed by Steam on Launcher's first start.
 
Find more information about the [[Arma_3_Unusual_process_exit|Unusual process exit error here]].
 
  
=Command line parameters=
+
The commands displayed at the bottom:
Launcher recognize following parameters (parameters are not case sensitive):
+
* ''Host server'' - starts the game and start the game server.
*'''-safeMode''': the Launcher will start in the safe-mode;
+
* ''Direct connect'' - let you connect to the server by manually entering it is address and game port.
*'''-noHwa''': the Launcher will start with graphic hardware acceleration disabled (only the Launcher, this switch has no meaning for the game itself);
 
*'''-noLauncher''': skips the Launcher and starts Arma 3 directly;
 
*'''-useBE''': used together with '''-noLauncher''' it also starts the BattlEye Anti-cheat Software before starting the game;
 
*any other parameters are considered to be parameters of Arma 3 and are passed to the game as they are.
 
  
  
See Also: [[Arma 3 Startup Parameters]]
+
== Options ==
[[Category:Arma 3]]
+
[[image:Launcher_Options.png|250px|right]]
[[Category:Arma 3 Official Tools Manual]]
+
*''Launcher Options'' tab
 +
**''Language'' - Switch Launcher to a Language of your choice. Available: English, Czech, German, Spanish, French, Italian, Portuguese, Polish and Russian (depending on a region, Japanese and Korean language pack might be also available).
 +
**''Minimize Launcher to tray'' - When minimized, the Launcher will appear in the notification zone instead of the taskbar.
 +
**''Action after game start'' - Available options are Do nothing, Minimize Launcher, Close Launcher, Close Launcher after game ends.
 +
**''Default page'' - Set a tab opened right after Launcher's start.
 +
**''Active theme'' - Select your favorite Launcher theme.
 +
**''Enable analytics'' - Enables [[Arma_3_Analytics|Arma 3 Analytics]]
 +
**''Disable Launcher's UI hardware acceleration'' - Checkbox disables hardware acceleration for WPF rendering for Launcher. This option is Launcher only, does not affect the game itself.
 +
**''Use an old system dialog for the folder selection'' - This item can be helpful when folder selections in Mod options tab doesn't work on your computer.
 +
 
 +
[[image:Launcher_Options_ModOptions.png|250px|right]]
 +
*''Mod Options'' tab
 +
**''Mods storage'' - Select where legacy Steam mods downloaded from Steam Workshop are stored. Note: this setting applies only to the legacy mods, most of the mods are stored by Steam client itself.
 +
**''Watched folders'' - Allows you to define folders to continuously scan and auto-include any local mods found into Mods page.
 +
 
 +
 
 +
=Advanced Functions=
 +
== Command line parameters ==
 +
Launcher recognizes following parameters (parameters are not case sensitive):
 +
*'''-safeMode''' - the Launcher will start in the safe-mode.
 +
*'''-noHwa''' - The Launcher will start with graphic hardware acceleration disabled (only the Launcher, this switch has no meaning for the game itself).
 +
*'''-noLauncher''' - Skips the Launcher and starts Arma 3 directly. Unless no other options is specified it starts 64-bit version of the game on 64-bit OS, 32-bit when you have 32-bit OS.
 +
*'''-useBE''' - Used together with ''-noLauncher'' it also starts the BattlEye Anti-cheat Software before starting the game.
 +
*'''-win32''' - Starts 32-bit version of the game. (To be used together with -noLauncher.) <span style="color:gray; font-size:80%;">(Added in 1.67 - 1.5.139660)</span>
 +
*'''-win64''' - Starts 64-bit version of the game. (To be used together with -noLauncher.) <span style="color:gray; font-size:80%;">(Added in 1.67 - 1.5.139660)</span>
 +
* ''Any other parameters are considered to be parameters of Arma 3 and are passed to the game as they are.''
 +
 
 +
== Troubleshooting ==
 +
1. Check the [http://arma3.com/launcher/troubleshooting troubleshooting webpage] to learn about required redistributables and known issues.<br>
 +
2. Find more information about the [[Arma_3_Unusual_process_exit|Unusual process exit error here]].<br>
 +
3. Report any remaining issue on {{ExternalLink|link= http://feedback.arma3.com Feedback|text= Tracker}} (category Launcher) and include Launcher logs (see following paragraph).<br>
 +
''NOTE: Missing redistributables should be automatically installed by Steam on Launcher's first start.''
 +
 
 +
== Creating a Troubleshooting Report ==
 +
*For issue with the launcher, you can export all launcher logs to the desktop via an action available in the option menu in the upper right corner (gear icon)<br>
 +
*For issues regarding Arma 3 you can file a troubleshooting report, also via an action available in the option menu in the upper right corner (gear icon)<br>
 +
See Also: [[Arma 3: Startup Parameters]]
 +
 
 +
== Logs ==
 +
Launcher logs are stored in ''Users\yourUserName\AppData\Local\Arma 3 Launcher\Logs''.<br>
 +
''When something goes wrong (in several attempts, because Steam can have a bad moment sometimes :) ), please, create an issue on {{ExternalLink|link= http://feedback.arma3.com Feedback|text= Tracker}} (category Launcher) and include these logs.''<br>
 +
You can also move the launcher logs packed into a zip file to the desktop, see '''Creating a Troubleshooting Report'''
 +
 
 +
 
 +
[[Category:Introduced with Arma 3 version 1.24]]
 +
{{GameCategory|arma3|Official Tools Manual}}

Revision as of 14:41, 26 July 2021

Arma 3 logo black.png1.24

Arma3LauncherIcon.png

The main purpose of the official Arma 3 Launcher is to enable easy management of local and Steam Workshop mods including their load order and custom presets, setting up game parameters and display Arma 3 developer news.

The official Arma 3 Launcher was launched July 14, 2014 with the Bootcamp update 1.24 (http://arma3.com/news/bohemia-interactive-deploys-arma-3-bootcamp-update).

User interface

Launcher MainUI.png

Common elements

Launcher CommonUI.png

Play button

Launcher QuickPresetSelector.png
  • Starts the game with a current Launcher setup of mods and parameters. Mods tab will get locked when the game is running.
  • Expanded Play button supports quick selection of mod presets including unmodded game.

Status bar

  • Displays the workshop mod download progress and notifies the user when the steam is offline (making the workshop unreachable).
  • Displays the state of BattlEye anti-cheat service initialization when launching the game. Use of BattlEye anti-cheat has to be enabled on BattlEye page.
  • Displays notification when the mod updates handled by Steam Client are waiting for user to quit applications.
  • When the service is initialized, the status is switched automatically back to the Mods downloads.
    • Use arrows to switch between Mod downloads and Service progress.

Options menu gives you an access to Launcher options, and also contains various links and additional info about the game. Logs and the game troubleshooter helper can be also accessed from this menu.

Colored ribbon in the top-left corner identifies the currently used Steam branch (default main branch - no ribbon).


Pages

Dashboard

The first page in Launcher displays the latest news post, links to a social media of Arma 3 and Bohemia Interactive, and mainly the information about joined units from 3 Units.

If you are a member of any unit, you can pre-select that units in Launcher, by checking the box on the unit, and it will be automatically activated in the game, once you start it. Or you can choose to play without a unit or let the game use the same unit you've played the last time.

News

Displays news from Arma 3 website.

  • Unread items are marked by orange color.
  • To load additional items, click Load more at the bottom.

Parameters

Allows setting up the startup parameters. Parameters are separated to Basic and Advanced tabs:

Basic tab

Launcher ParametersBasic.png
  • Mods - Loads the specified sub-folders for different mods. Separated by semi-colons.
  • No Splash - Bypass the splash screens on startup of Arma 3.
  • Skip Intro - Disables world intros in the main menu permanently.
  • Windowed - Displays Arma 3 windowed instead of full screen.
  • Profiles - Profile name to load.
  • Mission File - Automatically opens the selected mission in the game editor.
  • Command line parameters - Launcher resolves all parameters set in the Steam's set launch option dialog and displays them in here. See list of supported parameters.
  • Restore default setting - Turns off all parameters.

Advanced tab
For detailed description of Advanced Parameters see: Launcher - Advanced Parameters

Mods

The Mods page allows you to configure Steam Workshop mod content. From here you can see a list of all your subscribed content. Workshop supports uploading unlimited size items containing multiple files.

All downloads are handled by the Steam Client. When downloading updates for multiple-files mods, Steam Client will download content but do not update the mod files when any Arma 3 related application (Arma 3, Launcher, Publisher) is running. Please, exit all the applications to allow updates to be pushed from the temporary download folder to a proper folder.
Launcher Mods.png
  • All subscribed Steam Workshop mods are visible here.
  • Loaded mods (1) are mods marked for launch when you start the game.
  • Available mods (2) are mods which won't be loaded and used when the game starts.
  • User can move items between the two lists by clicking on the checkbox or by dragging the mod from one list to the other.

Toolbar commands (3)

  • Add Steam Workshop Mod - opens Steam Workshop home page with mod tag pre-selected to allow easier mod subscribing.
  • Add Steam Workshop Mod - opens browse folder dialog. User is able to include his local (non-Workshop) mods into Launcher to manage them from one place, mods can be also drag'n'dropped into the Launcher window.
  • More toolbar button - opens a menu with more options:
    • Unsubscribe all Steam Workshop mods - Automatically unsubscribes all mods currently subscribed on Steam Workshop.
    • Add watched folder - Allows you to add watched folder where Launcher detects local mods.
  • Mod search box - allows search in the mods in the lists below; can be also activate with a keyboard shortcut Ctrl+F.

Icons

  • Steam icon - indicates that the mods comes from Steam Workshop.
  • Status icon - signifies the status of the mod, for detailed info visit Arma 3 Launcher - Mod Handling.
  • Certificate icon - mods with multiplayer signatures are marked by a green certificate icon (it means that all PBOs has at least one BISIGN file).

Presets

Launcher QuickPresetSelector.png

Mod presets are named sets of mods. You can display and manage presets by clicking on the name of current preset in the top right corner of the page (4). Here you can save, load and name various presets of mods. This makes switching mod sets much faster. The current unsaved preset is preserved when the launcher quits.


You can also start the game directly with a saved preset using Quick preset selector, which can be access by clicking on the arrow on Play button.


For more info about mod handling and detailed description of all related windows see: Arma 3 Launcher - Mod Handling

BattlEye

BattlEye is anti-cheat software used by Arma 3. Launcher can start the anti-cheat service when you start the game. This options is controlled by the options Enable BattlEye anti-cheat software, when checked it will start the BattlEye service when you start the game.

Messages and status from BattlEye service are displayed on this page in the Log Messages list. When starting the game with BattlEye the current status is also displayed in the Launcher's status bar. The messages can be copied to Windows Clipboard by the button next to the message.

NOTE: BattlEye EULA needs to be accepted. If not, the service is not launched.


Servers

Servers page contains an integrated server browser. It contains five tabs which contains a specific set of Arma 3 Servers.

  • Favorites - displays only Arma 3 servers you've marked as a favorite (with a star).
  • Recent - displays the servers you've played on recently.
  • Friends - the servers where you Steam friends play right now.
  • Internet - all the reachable internet servers.
  • Units - the servers related to Arma 3 Units that you are member of.
Laiuncher ServerBrowser.png

On each tab you can find the filter bar on the top, where you can enter a search phrase or filters or use the "Filters" button to display a dialog where you can edit your filters. If the filter is active, its icon and the frame will in gold. The server counter next to the filter bar shows number of displayed servers and total number of servers; when the filter is active, these numbers may be different.

Launcher ServerFilterBasic.png

Each game server is represented by a row in the list. You can join the server by clicking on "JOIN" button that will appear when you move your mouse to that row. (If the server can't be joined, because it is locked the lock symbol will appear instead.). Clicking anywhere else on the row will expand it and display more information about the server (e.g. server version, server address, required DLCs).

Launcher ServerRow.png

When you click on the JOIN button a dialog with required mods is displayed to you. On the top it displays the basic information about the server (you can click on it to display more (1)). The middle part of the dialog displays required and optional mods (and also the mods you have currently selected, but that can't be used on the server). When you click on SETUP MODS AND JOIN button (2) Launcher will automatically load the mods it recognizes and subscribes you Steam Workshop to the ones that you don't have. (Some servers might be missing a Steam Workshop identifiers for the mods, so Launcher might have a hard time detecting the right mod or the mod might not be available on the Workshop at all.) You can change what happens when you click the button by changing the action for each of the mods in the list of mods above it. (4) KEEP CURRENT SELECTION AND JOIN button (3) will connect you to the server without any changes to mods you have enabled on MODS page.

Launcher JoinDialog.png

The commands displayed at the bottom:

  • Host server - starts the game and start the game server.
  • Direct connect - let you connect to the server by manually entering it is address and game port.


Options

Launcher Options.png
  • Launcher Options tab
    • Language - Switch Launcher to a Language of your choice. Available: English, Czech, German, Spanish, French, Italian, Portuguese, Polish and Russian (depending on a region, Japanese and Korean language pack might be also available).
    • Minimize Launcher to tray - When minimized, the Launcher will appear in the notification zone instead of the taskbar.
    • Action after game start - Available options are Do nothing, Minimize Launcher, Close Launcher, Close Launcher after game ends.
    • Default page - Set a tab opened right after Launcher's start.
    • Active theme - Select your favorite Launcher theme.
    • Enable analytics - Enables Arma 3 Analytics
    • Disable Launcher's UI hardware acceleration - Checkbox disables hardware acceleration for WPF rendering for Launcher. This option is Launcher only, does not affect the game itself.
    • Use an old system dialog for the folder selection - This item can be helpful when folder selections in Mod options tab doesn't work on your computer.
Launcher Options ModOptions.png
  • Mod Options tab
    • Mods storage - Select where legacy Steam mods downloaded from Steam Workshop are stored. Note: this setting applies only to the legacy mods, most of the mods are stored by Steam client itself.
    • Watched folders - Allows you to define folders to continuously scan and auto-include any local mods found into Mods page.


Advanced Functions

Command line parameters

Launcher recognizes following parameters (parameters are not case sensitive):

  • -safeMode - the Launcher will start in the safe-mode.
  • -noHwa - The Launcher will start with graphic hardware acceleration disabled (only the Launcher, this switch has no meaning for the game itself).
  • -noLauncher - Skips the Launcher and starts Arma 3 directly. Unless no other options is specified it starts 64-bit version of the game on 64-bit OS, 32-bit when you have 32-bit OS.
  • -useBE - Used together with -noLauncher it also starts the BattlEye Anti-cheat Software before starting the game.
  • -win32 - Starts 32-bit version of the game. (To be used together with -noLauncher.) (Added in 1.67 - 1.5.139660)
  • -win64 - Starts 64-bit version of the game. (To be used together with -noLauncher.) (Added in 1.67 - 1.5.139660)
  • Any other parameters are considered to be parameters of Arma 3 and are passed to the game as they are.

Troubleshooting

1. Check the troubleshooting webpage to learn about required redistributables and known issues.
2. Find more information about the Unusual process exit error here.
3. Report any remaining issue on Tracker (category Launcher) and include Launcher logs (see following paragraph).
NOTE: Missing redistributables should be automatically installed by Steam on Launcher's first start.

Creating a Troubleshooting Report

  • For issue with the launcher, you can export all launcher logs to the desktop via an action available in the option menu in the upper right corner (gear icon)
  • For issues regarding Arma 3 you can file a troubleshooting report, also via an action available in the option menu in the upper right corner (gear icon)

See Also: Arma 3: Startup Parameters

Logs

Launcher logs are stored in Users\yourUserName\AppData\Local\Arma 3 Launcher\Logs.
When something goes wrong (in several attempts, because Steam can have a bad moment sometimes :) ), please, create an issue on Tracker (category Launcher) and include these logs.
You can also move the launcher logs packed into a zip file to the desktop, see Creating a Troubleshooting Report