Difference between revisions of "Installation Guide"

From BTAWiki
Jump to navigation Jump to search
m
 
(24 intermediate revisions by 5 users not shown)
Line 1: Line 1:
 
[https://www.bta3062.com/files/BTAdvancedLauncher.php <u>'''Click here to download the BTA 3062 installer'''</u>]
 
[https://www.bta3062.com/files/BTAdvancedLauncher.php <u>'''Click here to download the BTA 3062 installer'''</u>]
 +
 +
'''BTA3062 IS NOT COMPATIBLE WITH THE XBOX GAME PASS VERSION OF BATTLETECH. THERE'S NOTHING WE CAN DO ABOUT THIS SORRY.'''
 +
 +
<b>NOTE: Battletech has to be started once in order to properly install BTA, which is to say after installing the base game, load it up, then quit. Then you're free to install BTA.</b>
  
 
== Windows Installation ==
 
== Windows Installation ==
1. Download the BattleTech Advanced 3062 Installer from the link provided above.
+
<div style="min-width:600px; width:80%;">
 +
'''0.''' Make sure you have Installed BATTLETECH, the base game.
 +
: '''0a.''' If you haven't run the game before, start it once or BTA will error on first load. If this happens restart the game and it should work the second time.
 +
 
 +
'''1.''' Download the BattleTech Advanced 3062 Installer from the link provided above.
 +
 
 +
'''2.''' Make sure you have at least 50GB free space on the drive you're installing BTA to; the launcher cache takes up roughly 30GB and the mod itself takes up about 15GB.
 +
 
 +
'''3.''' Create a folder for the BTA Installer to live in, '''not in your BATTLETECH game folder, User directory, Program Files directories, or Windows directory.''' A good default is <code>C:\BTA_Launcher</code> or similar. Then [https://support.microsoft.com/en-us/windows/zip-and-unzip-files-f6dde0a7-0fec-8294-e1d3-703ed85e7ebc extract '''BTAdvancedLauncher.exe''' from the zip file] to your newly created folder.
 +
 
 +
[[File:Extract Example.jpg|200px|Extract a Zip File example.]]
  
2. Make sure you have at least 40GB free space on the drive you're installing BTA to; the launcher cache takes up roughly 25GB and the mod files themselves are about 15GB.
+
'''4.''' Close BATTLETECH if it is currently running before continuing.
  
3. Use 7zip to open the BTAdvancedLauncher.zip file. It will contain just one file, the BTA 3062 Installer. Drag it into a storage folder (this is required as the installer creates a cache that it updates from, you'll need to keep this in a safe storage place, '''it needs to be somewhere on your hard drive other than in the Users directory or in the BATTLETECH game folder''', put it in a storage folder elsewhere such as D:\Installer Storage).
+
[[File:BTA Launcher Example.jpg|150px|right|BTA Launcher Example image.]]
 +
'''5.''' Run the BTA installer. It will open a window with a decorative image and a number of buttons at the bottom.
 +
<p/>
 +
: '''5a.''' Select your installation type between '''BTA Classic''' and '''BTA Light'''. Upon opening the installer, immediately click Set Preferences and select your BTA Install Type from the drop down menu. BTA Classic is the full experience while information about BTA Light can be viewed here: [[BTA Light]].
 +
<p/>
 +
: '''5b.''' Select your '''Mods Folder Location''' and Create and Select a location for the BTA Installer Cache. The cache can be in a different drive, but do not delete it or when you update the mod it will *all* have to be redownloaded.
 +
[[File:BTA Launcher Folders Example.jpg|600px|Folder Locations example image]]
 +
: '''Mods Folder:''' Create a <code>Mods</code> folder in your Battletech directory. By default your Battletech game directory will be at <code>[..]\steamapps\common\BATTLETECH\Mods</code> for the Steam version or <code>[..]\GOG Galaxy\Games\BATTLETECH</code> for the GOG version. As noted at the top of the page, the Microsoft Game Pass version does not support mods.
 +
<div style="float:right; clear:right;">[[File:LocalGameFiles.png|225px|Steam view local files example.]]</div>
 +
:: '''If you already have a "Mods" folder, wipe it completely clean. Delete all files and folders within it. This is critical, because many third party mods will cause conflicts and break BTA.'''
 +
:: If you are using the Steam version, you can find the install folder by going to your Steam games list, then Right Click the BATTLETECH game and go to "Manage" -> "Browse local files" as shown to the right. Create the Mods folder here.
 +
<p/>
 +
: '''Cache Folder:''' The Cache folder should be somewhere that won't be deleted, or the Installer will have to re-download the entire cache to update BTA. Don't place it in your BATTLETECH folder. It can be placed on another Drive if you wish. Create a folder where you want the Cache to live.
 +
<p/>
 +
: '''Point the Installer To the new Folder(s):''' To change the Install or Cache Download locations click <code>Advanced Mode</code> to unlock the "Browse" buttons. You can now select the Cache and/or Mods folder locations. The cache location is <code>Checkout workspace:</code> and the Mods folder is <code>Install Target:</code>
  
4. Navigate to your Battletech installation folder. For Steam Users: [..]\Steam\steamapps\common\BATTLETECH
+
<div style="float:right; clear:right;">[[File:Install Button Example.jpg|150px|Install Button example image]]</div>
: 4a. Inside your installation folder, create a new folder called "Mods" without quotation marks
+
'''6.''' If this is your first time installing a mod for BATTLETECH, then click the button marked <code>Update/Install BTA</code> in the lower left and move on to Step 7.
: 4b. If you already have a "Mods" folder, wipe it completely clean. Delete all files and folders within it.
+
: '''6b.''' If you have previously installed Mods for BATTLETECH then '''delete everything in your Mods folder''' before proceeding. Other mods, or old versions of BTA, are likely to cause conflicts and cause your game to not function. This will not delete your save games but they may not be compatible.
: 4c. Whitelist the BATTLETECH installation folder in your anti-virus software. This is a precautionary step and may not be necessary, but some AV programs flag the critical mod files ModTekInjector.exe and QuickStart.exe as suspicious which will prevent the mod from working.
 
  
5. Run the BTA installer from your storage folder. Use its target function to point towards your newly created Mods folder. It will pop up a box asking what options you'd like to install from among the DLCs and the [[Community Content]] pack. Only select what you want from those options and only select DLC options for which you actually own the DLCs.
+
'''7.''' A few messages will pop up on a fresh install, click "OK" to everything. Details are provided below, but you don't need to do anything else for this step.
 +
[[File:Installer Info Message Example.jpg|250px|Installer info message example image.]]
 +
: '''7a.''' The first message will be about downloading the cache, followed by a large download. The first time you run the installer it may take some time, this is normal. The installer automatically installs the CAB (Community Asset Bundle), you do not need a separate CAB installer.
 +
: '''7b.''' After the cache has downloaded you will see a message like "No data could be found at the current target location, New install to be done" followed by "Install Configuration is not valid, Clean Install is required". Click OK to everything and the window for the next step should appear.
  
6. It will pop up some warnings saying "there's nothing here, is it ok to install?" Just say OK to everything and let it do its work. The first time you run the installer it'll take some time, that's normal, everything is fine. The installer automatically installs the CAB (Community Asset Bundle), you do not need a separate CAB installer.
+
[[File:Installer Config Options Annotated.jpg|400px|right|Installer configuration options image, with annotations indicating DLC and Community Content sections.]]
 +
'''8.''' In this window select the installation options for BTA. Most importantly select the DLCs you have installed and whether or not to install the [[Community Content]] pack. Only select what you want from those options and '''only select DLC options for DLCs you own or the mod will not function.'''
 +
: '''8a.''' If you're running the game through Steam and are unsure which DLCs you have installed find the game in your Steam games list, Right Click -> Properties -> DLC in the list on the left. This shows all installed and active DLCs for the game. In GOG the Settings in GOG Galaxy should list which DLCs you own.
  
7. Once you start the game with BTA for the first time, open up Skirmish Mechbay, this loads some assets that the game won't load otherwise. You only have to do it once after you install BTA for the first time.
+
'''9.''' You're done! Click <code>Launch BTA 3062</code> in the launcher to run the game, or run it from Steam or your launcher of choice. We recommend using the BTA launcher as it will prompt you with new updates!
 +
 
 +
'''Note:''' It is strongly advised that you check out the [[Performance Tips]] page to improve your experience.
  
8. You're done!
 
  
 
=== Installing BTA in other languages: ===
 
=== Installing BTA in other languages: ===
Line 25: Line 58:
  
 
=== Video Guide ===
 
=== Video Guide ===
If you prefer videos check out this excellent comprehensive guide made by community member MangaMaD: (Note: the video is now somewhat dated and includes options like enabling Clan content which no longer exist, but the majority of it is still valid.)
+
If you prefer to follow along with a video instead, check out this guide.
  
<youtube>https://youtu.be/cvkJpD11lHU</youtube>
+
<b>NOTE: THE VIDEO SAYS TO ENTER THE SKIRMISH MECHBAY TO PRE-LOAD ASSETS. DO NOT DO THIS, THIS INFORMATION IS OUTDATED AND THIS WILL CAUSE PROBLEMS IN CURRENT VERSIONS OF BTA.</b>
  
 +
<youtube>https://youtu.be/UBRWrDExeT0</youtube>
  
=== Windows Installation Troubleshooting ===
+
== Windows Installation Troubleshooting ==
==== The Mod Doesn't Initialise Even If I Start Via The Launcher. All I'm Seeing Is The Base Game Menu ====
+
=== The Mod Doesn't Initialize Even If I Start Via The Launcher. All I'm Seeing Is The Base Game Menu ===
 
Likely cause: BTA was installed to the wrong target location.
 
Likely cause: BTA was installed to the wrong target location.
  
Line 38: Line 72:
 
(or wherever yours is installed).
 
(or wherever yours is installed).
  
==== ModTek Reports Several Mods Failed To Load ====
+
=== ModTek Reports "Some Mods Failed To Load" ===
Likely cause: The BTA Installer has been put in the Users directory or in the BATTLETECH game folder.
+
<u>Possible Cause 1</u>: The BTA Installer has been put in the Users directory or in the BATTLETECH game folder.
  
 
Solution: Move the Installer (just the BTAdvancedLauncher.exe, do not move anything else such as the XML files or the folder named BtalCache) into a separate storage folder somewhere else such as C:\Storage or C:\BTALauncher (or anything else you want to call it, as long as they're not in the Users directory/BATTLETECH game folder).
 
Solution: Move the Installer (just the BTAdvancedLauncher.exe, do not move anything else such as the XML files or the folder named BtalCache) into a separate storage folder somewhere else such as C:\Storage or C:\BTALauncher (or anything else you want to call it, as long as they're not in the Users directory/BATTLETECH game folder).
  
==== Menu Buttons On The Title Screen Don't Work After Installing ====
+
<u>Possible Cause 2</u>: you have 3rd party mod files (such as Give Me Death/Give Them Kell) that are incompatible with BTA present in the Mods folder.
 +
 
 +
Solution: Remove all third party mods from the Mods folder. '''Note: Give Me Death/Give Them Kell are already included in BTA, You just need to have both the Flashpoint and Heavy Metal DLCs to access them.'''
 +
 
 +
<u>Possible Cause 3</u>: Certain antivirus software may identify files, especially hotfix files, as risky and delete them causing issues.
 +
 
 +
Solution: whitelist the mod directory in your AV software
 +
 
 +
=== Menu Buttons On The Title Screen Don't Work After Installing ===
 
Likely cause: Corgi's Performance Fix is not compatible with your PC hardware.
 
Likely cause: Corgi's Performance Fix is not compatible with your PC hardware.
  
 
Solution: You will need to reinstall BTA without Corgi's Performance Fixes. Verify the game files on Steam to revert the .dll changes, run the BTA Installer again and when you get to the Configuration Options window uncheck the box marked "Corgi's Perf Fixes". Other than that continue with the installation as normal.
 
Solution: You will need to reinstall BTA without Corgi's Performance Fixes. Verify the game files on Steam to revert the .dll changes, run the BTA Installer again and when you get to the Configuration Options window uncheck the box marked "Corgi's Perf Fixes". Other than that continue with the installation as normal.
  
==== BATTLETECH Is Crashing Unexpectedly ====
+
=== BATTLETECH Is Crashing Unexpectedly ===
 
Likely cause: the most common cause of random crashes is your GPU drivers.
 
Likely cause: the most common cause of random crashes is your GPU drivers.
  
 
Solution: Do a clean install of your GPU drivers. Instructions on how to do this can be found here: https://www.youtube.com/watch?v=F8OLhUAPDq0
 
Solution: Do a clean install of your GPU drivers. Instructions on how to do this can be found here: https://www.youtube.com/watch?v=F8OLhUAPDq0
  
==== ModTek Error: "ModTek Died" During Game Start ====
+
=== ModTek Error: "ModTek Died" During Game Start ===
 
Likely cause: A mod folder has been accidentally moved into another mods folder or a zip file is present in a mod folder. ModTek will not load if it finds sub mods or archived files inside mod folders.
 
Likely cause: A mod folder has been accidentally moved into another mods folder or a zip file is present in a mod folder. ModTek will not load if it finds sub mods or archived files inside mod folders.
  
 
Solution: Delete the contents of BATTLETECH\Mods folder and reboot your PC before reinstalling BTA.
 
Solution: Delete the contents of BATTLETECH\Mods folder and reboot your PC before reinstalling BTA.
 +
 +
=== "Fatal Error Detected: Failed to execute script btalauncher" when trying to run the BTA Launcher ===
 +
Likely cause: trying to run the BTALauncher.exe from within the zip file.
 +
 +
Solution: extract the BTALauncher.exe out of the zip file and place it in a storage folder somewhere other than in the Users directory or in the BATTLETECH game folder.
 +
 +
=== "Search for app in the Store?" when trying to run .exe ===
 +
[[File:TroubleshootingAppstoreMessage.png]]
 +
 +
Likely cause: Under investigation. Errant Microsoft safety measures.
 +
 +
Solution:
 +
Right-click the .exe and select Properties. Under "Security" at the bottom of the General tab, look for the message "This file came from another computer and might be blocked to help protect this computer." Tick the "Unblock" box.
 +
 +
[[File:TroubleshootingUnblock.png]]
  
 
== Linux Installation ==
 
== Linux Installation ==
Line 69: Line 126:
  
 
'''WARNING:''' BTA will not work on ARM-based Macs due to their lack of a GPU. This is not possible for us to fix or do anything about, sorry in advance.
 
'''WARNING:''' BTA will not work on ARM-based Macs due to their lack of a GPU. This is not possible for us to fix or do anything about, sorry in advance.
 +
* UPDATE: A user reported success installing on their ARM-based Mac (Macbook pro 14" 2021) by following the instructions for  for [[Mac_Installation_Guide#Installation_Using_A_2nd_Non-Mac_Computer|copying the mods directory from a PC install]].
 +
 +
== Steam Deck Installation ==
 +
 +
[[Steam Deck Installation Guide|Click  here for the Steam Deck installation guide.]]
 +
 +
Note: There is likely room to improve this guide. Concise improvements are accepted in the #wiki-reporting channel on the Discord. Opinions are not.
  
 
== Pre-Cache ==
 
== Pre-Cache ==
  
'''99% of players DO NOT NEED THIS. Downloading the launcher is all you need unless you are specifically directed by a BTA member to  get the pre-cache to solve an issue with installation.'''
+
'''99% of players DO NOT NEED THIS. Downloading the launcher is all you need unless you are specifically directed by a BTA team member to  get the pre-cache to solve an issue with installation.'''
  
 
[https://www.bta3062.com/files/BTAdvancedPreCache.php Click here to download the BTA 3062 Pre-Cache].
 
[https://www.bta3062.com/files/BTAdvancedPreCache.php Click here to download the BTA 3062 Pre-Cache].

Latest revision as of 05:39, 3 December 2023

Click here to download the BTA 3062 installer

BTA3062 IS NOT COMPATIBLE WITH THE XBOX GAME PASS VERSION OF BATTLETECH. THERE'S NOTHING WE CAN DO ABOUT THIS SORRY.

NOTE: Battletech has to be started once in order to properly install BTA, which is to say after installing the base game, load it up, then quit. Then you're free to install BTA.

Windows Installation

0. Make sure you have Installed BATTLETECH, the base game.

0a. If you haven't run the game before, start it once or BTA will error on first load. If this happens restart the game and it should work the second time.

1. Download the BattleTech Advanced 3062 Installer from the link provided above.

2. Make sure you have at least 50GB free space on the drive you're installing BTA to; the launcher cache takes up roughly 30GB and the mod itself takes up about 15GB.

3. Create a folder for the BTA Installer to live in, not in your BATTLETECH game folder, User directory, Program Files directories, or Windows directory. A good default is C:\BTA_Launcher or similar. Then extract BTAdvancedLauncher.exe from the zip file to your newly created folder.

Extract a Zip File example.

4. Close BATTLETECH if it is currently running before continuing.

BTA Launcher Example image.

5. Run the BTA installer. It will open a window with a decorative image and a number of buttons at the bottom.

5a. Select your installation type between BTA Classic and BTA Light. Upon opening the installer, immediately click Set Preferences and select your BTA Install Type from the drop down menu. BTA Classic is the full experience while information about BTA Light can be viewed here: BTA Light.

5b. Select your Mods Folder Location and Create and Select a location for the BTA Installer Cache. The cache can be in a different drive, but do not delete it or when you update the mod it will *all* have to be redownloaded.
Folder Locations example image
Mods Folder: Create a Mods folder in your Battletech directory. By default your Battletech game directory will be at [..]\steamapps\common\BATTLETECH\Mods for the Steam version or [..]\GOG Galaxy\Games\BATTLETECH for the GOG version. As noted at the top of the page, the Microsoft Game Pass version does not support mods.
Steam view local files example.
If you already have a "Mods" folder, wipe it completely clean. Delete all files and folders within it. This is critical, because many third party mods will cause conflicts and break BTA.
If you are using the Steam version, you can find the install folder by going to your Steam games list, then Right Click the BATTLETECH game and go to "Manage" -> "Browse local files" as shown to the right. Create the Mods folder here.

Cache Folder: The Cache folder should be somewhere that won't be deleted, or the Installer will have to re-download the entire cache to update BTA. Don't place it in your BATTLETECH folder. It can be placed on another Drive if you wish. Create a folder where you want the Cache to live.

Point the Installer To the new Folder(s): To change the Install or Cache Download locations click Advanced Mode to unlock the "Browse" buttons. You can now select the Cache and/or Mods folder locations. The cache location is Checkout workspace: and the Mods folder is Install Target:
Install Button example image

6. If this is your first time installing a mod for BATTLETECH, then click the button marked Update/Install BTA in the lower left and move on to Step 7.

6b. If you have previously installed Mods for BATTLETECH then delete everything in your Mods folder before proceeding. Other mods, or old versions of BTA, are likely to cause conflicts and cause your game to not function. This will not delete your save games but they may not be compatible.

7. A few messages will pop up on a fresh install, click "OK" to everything. Details are provided below, but you don't need to do anything else for this step. Installer info message example image.

7a. The first message will be about downloading the cache, followed by a large download. The first time you run the installer it may take some time, this is normal. The installer automatically installs the CAB (Community Asset Bundle), you do not need a separate CAB installer.
7b. After the cache has downloaded you will see a message like "No data could be found at the current target location, New install to be done" followed by "Install Configuration is not valid, Clean Install is required". Click OK to everything and the window for the next step should appear.
Installer configuration options image, with annotations indicating DLC and Community Content sections.

8. In this window select the installation options for BTA. Most importantly select the DLCs you have installed and whether or not to install the Community Content pack. Only select what you want from those options and only select DLC options for DLCs you own or the mod will not function.

8a. If you're running the game through Steam and are unsure which DLCs you have installed find the game in your Steam games list, Right Click -> Properties -> DLC in the list on the left. This shows all installed and active DLCs for the game. In GOG the Settings in GOG Galaxy should list which DLCs you own.

9. You're done! Click Launch BTA 3062 in the launcher to run the game, or run it from Steam or your launcher of choice. We recommend using the BTA launcher as it will prompt you with new updates!

Note: It is strongly advised that you check out the Performance Tips page to improve your experience.


Installing BTA in other languages:

The process is the same as above, however once BTA is installed you will need to use the provided tools and instructions found in [..]BATTLETECH\Mods\CustomLocalization in order to apply the necessary language changes. DO NOT DOWNLOAD ANY FILES FROM ELSEWHERE ON THE INTERNET TO DO THIS STEP - they are not compatible with BTA and will likely break your install.

Video Guide

If you prefer to follow along with a video instead, check out this guide.

NOTE: THE VIDEO SAYS TO ENTER THE SKIRMISH MECHBAY TO PRE-LOAD ASSETS. DO NOT DO THIS, THIS INFORMATION IS OUTDATED AND THIS WILL CAUSE PROBLEMS IN CURRENT VERSIONS OF BTA.

Windows Installation Troubleshooting

The Mod Doesn't Initialize Even If I Start Via The Launcher. All I'm Seeing Is The Base Game Menu

Likely cause: BTA was installed to the wrong target location.

Solution: Open the BTA Installer and double check the field labelled "Install Target". It must be the same folder where BATTLETECH is installed, e.g.

C:\Program Files (x86)\Steam\steamapps\common\BattleTech\Mods 

(or wherever yours is installed).

ModTek Reports "Some Mods Failed To Load"

Possible Cause 1: The BTA Installer has been put in the Users directory or in the BATTLETECH game folder.

Solution: Move the Installer (just the BTAdvancedLauncher.exe, do not move anything else such as the XML files or the folder named BtalCache) into a separate storage folder somewhere else such as C:\Storage or C:\BTALauncher (or anything else you want to call it, as long as they're not in the Users directory/BATTLETECH game folder).

Possible Cause 2: you have 3rd party mod files (such as Give Me Death/Give Them Kell) that are incompatible with BTA present in the Mods folder.

Solution: Remove all third party mods from the Mods folder. Note: Give Me Death/Give Them Kell are already included in BTA, You just need to have both the Flashpoint and Heavy Metal DLCs to access them.

Possible Cause 3: Certain antivirus software may identify files, especially hotfix files, as risky and delete them causing issues.

Solution: whitelist the mod directory in your AV software

Menu Buttons On The Title Screen Don't Work After Installing

Likely cause: Corgi's Performance Fix is not compatible with your PC hardware.

Solution: You will need to reinstall BTA without Corgi's Performance Fixes. Verify the game files on Steam to revert the .dll changes, run the BTA Installer again and when you get to the Configuration Options window uncheck the box marked "Corgi's Perf Fixes". Other than that continue with the installation as normal.

BATTLETECH Is Crashing Unexpectedly

Likely cause: the most common cause of random crashes is your GPU drivers.

Solution: Do a clean install of your GPU drivers. Instructions on how to do this can be found here: https://www.youtube.com/watch?v=F8OLhUAPDq0

ModTek Error: "ModTek Died" During Game Start

Likely cause: A mod folder has been accidentally moved into another mods folder or a zip file is present in a mod folder. ModTek will not load if it finds sub mods or archived files inside mod folders.

Solution: Delete the contents of BATTLETECH\Mods folder and reboot your PC before reinstalling BTA.

"Fatal Error Detected: Failed to execute script btalauncher" when trying to run the BTA Launcher

Likely cause: trying to run the BTALauncher.exe from within the zip file.

Solution: extract the BTALauncher.exe out of the zip file and place it in a storage folder somewhere other than in the Users directory or in the BATTLETECH game folder.

"Search for app in the Store?" when trying to run .exe

TroubleshootingAppstoreMessage.png

Likely cause: Under investigation. Errant Microsoft safety measures.

Solution: Right-click the .exe and select Properties. Under "Security" at the bottom of the General tab, look for the message "This file came from another computer and might be blocked to help protect this computer." Tick the "Unblock" box.

TroubleshootingUnblock.png

Linux Installation

Click here for the Linux installation guide.

Please note: Linux users will not be able to run BattleTech using the "Launch BTA 3062" button in the BTA launcher. You will have to open it through Steam or by running the BattleTech executable file.

Mac Installation

Click here for the Mac installation guide.

WARNING: BTA will not work on ARM-based Macs due to their lack of a GPU. This is not possible for us to fix or do anything about, sorry in advance.

Steam Deck Installation

Click here for the Steam Deck installation guide.

Note: There is likely room to improve this guide. Concise improvements are accepted in the #wiki-reporting channel on the Discord. Opinions are not.

Pre-Cache

99% of players DO NOT NEED THIS. Downloading the launcher is all you need unless you are specifically directed by a BTA team member to get the pre-cache to solve an issue with installation.

Click here to download the BTA 3062 Pre-Cache.