Difference between revisions of "Arma 3: Launcher"

From Bohemia Interactive Community
Jump to navigation Jump to search
(Structure changed and information actualized.)
Line 2: Line 2:
 
[[File:Arma3LauncherIcon.png|128px|right]]
 
[[File:Arma3LauncherIcon.png|128px|right]]
  
The official Arma 3 Launcher was launched July 14, 2014 with the [http://arma3.com/news/bohemia-interactive-deploys-arma-3-bootcamp-update#.ViDkMispr00 Bootcamp update] (1.24).
+
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=
 
[[Image:A3Launcherribbon.PNG|200px|left]]
 
<br style="clear:both" />
 
* '''Ribbon:''' Colored ribbon in the top-right corner now identifies the currently used Steam branch.
 
** Default (=Main branch): no ribbon
 
** If the launcher is executed from an install from [[Game Updater]], the displayed ribbon might be incorrect.
 
* Game version is displayed under Arma 3 logo.
 
  
=News=
+
='''Overlay'''=
Displays news from [http://dev.arma3.com/].  
+
==Play and status bar==
 +
'''Play'''
 +
[[Image:Arma3LauncherQuickSelect.jpeg|130px|right]]
 +
* 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 service initialization when launching the game. BattlEye has to be enabled in options.
 +
* 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.''
  
[[Image:Arma 3 Launcher News.png|500px|left]]
+
==Options==
<br style="clear:both" />
+
[[Image:Arma3LauncherOptions.PNG|250px|right]]
* Older items are being loaded as you scroll down
+
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. There are also various links and additional info available in here.
** To load additional items, click Load more at the bottom
 
  
=Parameters=
+
'''Options'''
 +
*Configuration 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 task-bar.
 +
**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.
 +
*Compatibility tab
 +
**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. Default state: HW acceleration enabled.
 +
**Use an old system dialog for the folder selection - This item can be helpful when folder selections in Mod options tab don't work on your computer.
 +
*Mod options tab
 +
**Mods storage - Select where all the mods downloaded from Steam Workshop should be stored.
 +
**Watched folders - Allows you to define folders to continuously scan and auto-include any local mods found into Launcher Mods tab.
  
Additional information can be found here: [[Arma 3 Startup Parameters]]
+
'''Support Links and Links'''
 +
*Feedback - Link to [http://feedback.arma3.com Feedback Tracker], place where you can report bugs and propose new features.
 +
*Support - Link to [http://support.bistudio.com/arma-3 Bohemia Interactive support page]. You can find frequently asked questions and answers here.
 +
*Bohemia Interactive - Link to  [http://www.bistudio.com/ Bohemia Interactive website].
 +
*Arma 3 - Link to [http://www.arma3.com Arma 3 website].
 +
*Community Wiki - Link to [http://community.bistudio.com/ Community Wiki], place where you are now.
 +
*Steam Workshop - Link to [http://steamcommunity.com/workshop/browse/?appid=107410 Arma 3 Steam Workshop], main source of user-created mods and missions for Arma 3.
  
==Basic==
+
'''Diagnostics'''
 +
*Export Launcher logs to desktop - Collects Launcher logs and configs and packs them to a zip archive in user's Desktop folder. When reporting a Launcher issue on Feedback tracker, please, include this archive.
 +
*Prepare Arma troubleshooting report - Prepares a troubleshooting report that contains game logs and diagnostic information about the game and your system.
 +
*Game - Displays the game (.exe) version.
 +
*Branch - Current Steam branch is displayed.
 +
*Launcher - Launcher's version, click to copy the version number into clipboard.
  
[[Image:Arma3LauncherParam.png|500px|left]]
+
==Version and Branch==
<br style="clear:both" />
+
[[Image:A3Launcherribbon.PNG|200px|right]]
Allows setting up launch [[Arma_3_Startup_Parameters|parameters]]. Pages are separated to Basic and Advanced.  
+
* Game version is displayed under the Play button.<br>
 +
* Colored ribbon in the top-left corner identifies the currently used Steam branch (default main branch - no ribbon).
  
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>
+
='''Tabs'''=
*'''Mods''' - Loads the specified sub-folders for different mods. Separated by semi-colons<br>
+
==News==
*'''No Splash''' - Bypass the splash screens on startup of Arma3<br>
+
<!-- [[Image:Arma 3 Launcher News.png|250px|right]] -->
*'''Skip Intro''' - Disables world intros in the main menu permanently<br>
+
Displays news from [http://dev.arma3.com/].
*'''Windowed''' - Displays Arma windowed instead of full screen<br>
+
* Unread items are marked by orange color.
*'''Profiles''' - Profile name to load<br>
+
* To load additional items, click Load more at the bottom.
  
'''Restore default setting:''' turns off all parameters.
+
==Parameters==
==Advanced==
+
Allows setting up launch [[Arma_3_Startup_Parameters|parameters]]. Pages are separated to Basic and Advanced.
[[Image:Arma3LauncherParamAdv.png|500px|left]]
 
  
<br style="clear:both" />
+
'''Basic'''
===Advanced===
+
[[Image:Arma3LauncherParam.png|250px|right]]
*'''Par''' - Reads startup parameters from a file<br>
+
*Mods - Loads the specified sub-folders for different mods. Separated by semi-colons.
*'''Check Signatures''' - Introduced to provide thorough test of all signatures of all loaded banks at the start game<br>
+
*No Splash - Bypass the splash screens on startup of Arma 3.
*'''CPU Count''' - Define number of CPUs/cores available<br>
+
*Skip Intro - Disables world intros in the main menu permanently.
*'''ExThreads''' - Option to define extra threads
+
*Windowed - Displays Arma 3 windowed instead of full screen.
** File operations - use a dedicated thread for file operations (enabled when ExThreads is 1 or 3 or 5 or 7)
+
*Profiles - Profile name to load.
** Texture loading - use a dedicated thread for loading textures (enabled when ExThreads is 2 or 3 or 6 or 7)
+
*Mission File - Automatically opens the selected mission in the game editor.
** Geometry loading - use a dedicated thread for loading geometry data (enabled when ExThreads is greater than or equal to 4)<br>
+
*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]].
*'''Enable Hyper-Threading''' - Enables the use of hyper-threading CPU cores which might slightly improve performance in certain scenarios<br>
+
*Restore default setting - Turns off all parameters.
*'''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===
+
'''Advanced'''
*'''Server IP''' - Server IP to connect to<br>
+
<!--[[Image:Arma3LauncherParamAdv.png|250px|right]]-->
*'''Server Port''' - Server port to connect to<br>
+
<br>For detailed description of Advanced Parameters see: [[Arma_3_Launcher_-_Advanced_Parameters|Launcher - Advanced Parameters]]
*'''Server Password''' - Server password to connect to<br>
 
*'''Host Session''' - Start a non-dedicated multiplayer host<br>
 
===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===
+
==Mods==
*'''Buldozer''' - Starts Buldozer mode<br>
+
The Mods tab 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. Workshop supports uploading unlimited size items containing multiple files.<br>
*'''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=
+
{{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.}}
[[Image:Arma 3LauncherMods.PNG|500px|left]]
+
[[Image:Arma 3LauncherMods.PNG|250px|right]]
<br style="clear:both" />
 
'''Description of current Mod Handling in Development Branch:''' [[Arma_3_Launcher_-_Mod_Handling|Arma 3 Launcher - Mod Handling]]
 
<br><br>
 
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>
 
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.
 
  
{{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.
+
*All subscribed Steam Workshop mods are visible here.
 +
*Loaded mods are mods marked for launch when you start the game.
 +
*Available mods 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 grabbing and moving of mod to desired area.
 +
'''Presets'''
 +
*Here you can save, load and name various presets of addons. This makes switching mod sets much faster. The current unsaved preset is preserved when the launcher quits.
 +
'''Mods'''
 +
*+ Steam Workshop - Opens Steam Workshop home page with ''mod'' tag pre-selected to allow easier mod subscribing.
 +
*+ Local 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
 +
**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.
 +
*Unload all - All mods are unloaded and moved into the Available mods part.
 +
*Load all - All mods are loaded and moved into the Loaded mods part.
 +
*Status icon - Signifies the status of the mod, for detailed info visit [[Arma_3_Launcher_-_Mod_Handling|Arma 3 Launcher - Mod Handling]].
 +
*Signature icon - Mods with multiplayer signatures are marked by a green sign icon.
  
Updates while those applications running will be enabled once Valve delivers this feature.}}
+
For more info about mod handling and detailed description of all related windows see: [[Arma_3_Launcher_-_Mod_Handling|Arma 3 Launcher - Mod Handling]]
  
*[[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>
+
==BattlEye==
*'''?:''' Checkbox to load or unload mods. Checked state means the mod will be loaded into the game when clicking '''Play''' button.  
+
BattlEye is anti-cheat software used by Arma 3. BattlEye initialization progress is presented on the progress bar.<br>
*'''Name:''' Name of the mod
+
'''BattlEye Status'''
*'''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>
+
* Enable BattlEye anti-cheat software - When enabled (default), it will launch [[BattlEye]] anti-cheat service before launching Arma 3.
*'''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>
+
* BattlEye Log Messages - Displays the BattlEye messages and status updates. Messages can be copied to a clipboard.
* '''Status:''' Signifies the status of the mod
+
''NOTE: BattlEye EULA needs to be accepted. If not, the service is not launched.''
{| class="wikitable"
 
! '''Icon'''
 
! '''State'''
 
! '''Status in Mod Info'''
 
! '''Description'''
 
|-
 
| [[Image:ExtensionState NotReady.png|16px]]
 
| Not Ready
 
| Not Ready
 
  
Verifing...
 
  
Checking..
+
='''Advanced Functions'''=
| Item is being initialized.
+
==Command line parameters==
|-
+
Launcher recognizes following parameters (parameters are not case sensitive):
| [[Image:ExtensionState Busy.png|16px]]
+
*'''-safeMode''' - the Launcher will start in the safe-mode.
| Busy
+
*'''-noHwa''' - The Launcher will start with graphic hardware acceleration disabled (only the Launcher, this switch has no meaning for the game itself).
| Downloading...
+
*'''-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.''
  
Synchronizing...
+
==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 [http://feedback.arma3.com Feedback 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.''
  
Removing...
+
See Also: [[Arma 3 Startup Parameters]]
  
Working...
+
==Logs==
| Item is currently being processed. It cannot be loaded into the game.
+
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 [http://feedback.arma3.com Feedback Tracker] (category Launcher) and include these logs.''
| | [[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'''
 
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>
 
*'''+ 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=
 
* '''Enable BattlEye anti-cheat software''' - when enabled (default), it will launch [[BattlEye]] anti-cheat service before launching Arma 3
 
* '''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=
 
[[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=
 
[[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.
 
 
 
 
=Play and status bar=
 
[[Image:Arma3LauncherQuickSelect.jpeg|150px|right]]
 
*'''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=
 
Find Launcher logs 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 http://feedback.arma3.com (launcher category) and include these logs.
 
 
=Troubleshooting and the safe mode=
 
Check the [http://arma3.com/launcher/troubleshooting troubleshooting webpage] to learn about required redistributables and known issues.
 
: 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=
 
Launcher recognize 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;
 
*'''-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]]
 
 
[[Category:Arma 3]]
 
[[Category:Arma 3]]
 
[[Category:Arma 3 Official Tools Manual]]
 
[[Category:Arma 3 Official Tools Manual]]

Revision as of 17:04, 1 December 2015

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).


Overlay

Play and status bar

Play

Arma3LauncherQuickSelect.jpeg
  • 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 service initialization when launching the game. BattlEye has to be enabled in options.
  • 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

Arma3LauncherOptions.PNG

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. There are also various links and additional info available in here.

Options

  • Configuration 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 task-bar.
    • 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.
  • Compatibility tab
    • 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. Default state: HW acceleration enabled.
    • Use an old system dialog for the folder selection - This item can be helpful when folder selections in Mod options tab don't work on your computer.
  • Mod options tab
    • Mods storage - Select where all the mods downloaded from Steam Workshop should be stored.
    • Watched folders - Allows you to define folders to continuously scan and auto-include any local mods found into Launcher Mods tab.

Support Links and Links

Diagnostics

  • Export Launcher logs to desktop - Collects Launcher logs and configs and packs them to a zip archive in user's Desktop folder. When reporting a Launcher issue on Feedback tracker, please, include this archive.
  • Prepare Arma troubleshooting report - Prepares a troubleshooting report that contains game logs and diagnostic information about the game and your system.
  • Game - Displays the game (.exe) version.
  • Branch - Current Steam branch is displayed.
  • Launcher - Launcher's version, click to copy the version number into clipboard.

Version and Branch

A3Launcherribbon.PNG
  • Game version is displayed under the Play button.
  • Colored ribbon in the top-left corner identifies the currently used Steam branch (default main branch - no ribbon).


Tabs

News

Displays news from [1].

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

Parameters

Allows setting up launch parameters. Pages are separated to Basic and Advanced.

Basic

Arma3LauncherParam.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
For detailed description of Advanced Parameters see: Launcher - Advanced Parameters

Mods

The Mods tab 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.

Template:Important

Arma 3LauncherMods.PNG
  • All subscribed Steam Workshop mods are visible here.
  • Loaded mods are mods marked for launch when you start the game.
  • Available mods 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 grabbing and moving of mod to desired area.

Presets

  • Here you can save, load and name various presets of addons. This makes switching mod sets much faster. The current unsaved preset is preserved when the launcher quits.

Mods

  • + Steam Workshop - Opens Steam Workshop home page with mod tag pre-selected to allow easier mod subscribing.
  • + Local 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
    • 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.
  • Unload all - All mods are unloaded and moved into the Available mods part.
  • Load all - All mods are loaded and moved into the Loaded mods part.
  • Status icon - Signifies the status of the mod, for detailed info visit Arma 3 Launcher - Mod Handling.
  • Signature icon - Mods with multiplayer signatures are marked by a green sign icon.

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. BattlEye initialization progress is presented on the progress bar.
BattlEye Status

  • Enable BattlEye anti-cheat software - When enabled (default), it will launch BattlEye anti-cheat service before launching Arma 3.
  • BattlEye Log Messages - Displays the BattlEye messages and status updates. Messages can be copied to a clipboard.

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


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.
  • -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.

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 Feedback Tracker (category Launcher) and include Launcher logs (see following paragraph).
NOTE: Missing redistributables should be automatically installed by Steam on Launcher's first start.

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 Feedback Tracker (category Launcher) and include these logs.