Editing Installation

This page provides an overview of the installation process for the RogueTech mod.

<blockquote>Please note: This is not a support forum, please talk to us over on Discord for support.

Latest launcher is always posted to Discord.

Really, you should use Discord. 

Discord Invite - https://discord.gg/93kxWQZ

[[File:LauncherScreen.png|479x479px]]

</blockquote>

{{tocright|limit=1}}
== Pre-requisites ==

=== System Requirements ===
RogueTech has some minimum requirements that differ from base BattleTech - these are highlighted below. While the game can function below these specs, gameplay and stability issues will happen far more frequently.

* OS: 64-bit Windows 7 or Higher
* <span style="color: #ff9900;">'''''Processor: 4 Thread x 4.2GHz or better'''''</span>
** Any slower and AI has trouble finishing calculations for VTOLs and LAMs. This can cause AI to do nothing on their turn after sitting for the limit of 40 seconds. 
* <span style="color: #ff9900;">'''''Memory: 16 GB RAM + 24GB static [[Performance_Tips#Pagefile|pagefile]]'''''</span>
** Any less and the game will crash, often failing to complete even the first mission after load. RogueTech is 15x the size (and growing) of original HBS BattleTech, and we've already optimized what we can. 
** The additional page file requirement is for stability due to a Unity Engine bug/problem (game will dump entire contents of RAM into pagefile for no reason). Without access to source code, we cannot correct/workaround.
* Graphics: Nvidia® GeForce™ GTX 560 Ti or AMD® ATI Radeon™ HD 5870 (1 GB VRAM)
* DirectX: Version 11
* Network: Broadband Internet connection (required for installation and updates)
* <span style="color: #ff9900;">'''''Storage: 35GB Base BT Installation + 25GB (at least... it's constantly growing) Mod Installation. Additional 25GB (at least... it's constantly growing) for launcher cache workspace required on any other storage.'''''</span>
** Our launcher requires to maintain this workspace to deliver smaller updates to you. Removing this cache will mean you will have to download an entire new copy of the mod every time we update. 
* Sound Card: DirectX 9 sound device

=== General Requirements ===

* Make sure you have all the latest Windows updates
* The Battletech game must be installed and run at least once before you attempt to install RT. RT is a mod, and is therefore dependent on BT to run.
* Disable cloud saves for the Battletech game in Steam
* Download the latest RogueTech Launcher which you can get from [https://discourse.modsinexile.com/t/rogue-tech/134 ModsInExile]
*# The Default download will download ONLY the launcher. It will grab the install cache during installation - THIS CAN TAKE A WHILE AND LOOK LIKE HANGING. BE PATIENT.
*# The PreCache option is updated infrequently and contains *most* of the install cache.
** <span style="color: #ff0000;">If you are experiencing spotty internet connectivity, select PreCache option.</span>
** <span style="color: #ff0000;">You DO NOT need to download CAB separately, except when instructed to do so by the dev/support team in a ticket.</span>
** <span style="color: #ff9900;">WARNING: THIS MOD IS NOT SUPPOSED TO BE EASY, ENEMIES ARE DEADLIER AND THAT'S INTENTIONAL! </span>
* Make sure you have the right version of the Battletech game. The officially supported game version by RogueTech mod is 1.9.1

=== Firewall, Anti-Virus, and other protection settings ===
* The launcher requires access to github.com in order to download updates. Ensure github is not blocked on your firewall and other network software, including ISP-provided.
** An example of ISP-provided firewalling: Virgin Websafe
* The launcher may trigger anti-virus protections. We always send our versions to MS for approval, but it may take time for Defender to pick up and even longer to spread out to other anti-virus software.
* The vast quantities of files being shuffled and copied often cause anti-virus/malware to break. Additionally, the installer requires that we run an injector to modify files required for BT modding (modtek's injector). We STRONGLY recommend adding both the game directory, launcher directory, and cache directory (including subfolders) into folder exceptions.

=== How to get the needed version of the Battletech game ===
<span style="color: #ff9900;">One more time: the officially supported game version is 1.9.1</span>

{| class="wikitable mw-collapsible mw-collapsed"
|-
! {Beta Opt in options only} - Not In Use
|-
|
====Steam====
To pin your Steam install to a specific version, right-click the game in Steam, open Properties, select the BETAS tab, and select the correct version from the dropdown.

====GoG====
https://support.gog.com/hc/en-us/articles/212806945-How-do-I-revert-rollback-to-an-older-game-version-?product=gog

====''GOG Galaxy users''====

* ''Proceed to the game card for your game in the GOG Galaxy client.''
* ''Proceed to the game's settings via the "More" option, and select "Settings"''
* ''Select "ON" from the drop down menu in the "Beta Channels" option on the right hand side.''
* ''A "Channel" option should now be visible. And in the Dropdown should be the option for "Beta".''
* ''After selecting this option, GOG Galaxy should automatically start your download of the beta branch.''

* ''To switch back, simply repeat the steps above, but choose "default" in the Channel Drop down options.''

|}

== Installing RogueTech ==
=== Windows ===

<ol>
<li> Move the RogueTech Launcher to its own directory, and run the launcher to start. <span style="color: #ff9900;">We STRONGLY recommend putting the launcher into a new folder, X:\RogueTech\</span></li>
<ol><li>Add the folder to exclusion in Windows Defender (and any other AV you may have), so it will not murder the RT install in its infancy. Windows Defender might still issue several warnings, just ignore them. To add an exclusion to Windows Defender, goto: Virus and Threat Protection > Virus and Threat Protection Settings > Exclusions</li>
<li> While, in theory, the launcher can exist anywhere, special directories used by Windows seem to throw errors when trying to download the installation files, including sub-directories of C:\Windows, C:\Program Files, C:\Program Files (x86), and C:\Users. Seriously, Windows will mangle the install files (workspace). If it works from those folders/subfolders, buy a lottery ticket. </li>
<li> Ideally the install location should be a partition separate from your windows install. Generally this means don't use the C drive if possible.</li>
<li> Additionally, we have started encountering corrupt installs when people run the launcher from the drive root. Please move the launcher into it's own directory (i.e. X:\RT)</li>
<li><span style="text-decoration:blink;color:#ff9900">Just to be absolutely clear, because this problem makes up about 80% of our tickets: Do NOT use subfolders of:<br>-C:\Windows<br>-C:\Program Files<br>-C:\Program Files (x86)<br>-C:\Users<br>-Whatever your OneDrive folder is<br>-Your BT install location</span><br> '''This includes your Desktop, Downloads, and Documents folders.''' If you have previously installed to one of these locations, delete the entire RtlCache, move ''only'' the launcher exe to it's own location such as X:\RT, and install again from scratch, ensuring the assigned workspace is NOT pointed under any of the above listed folders.</span></li> 
</ol>

<li> Make sure that the '''<u>Install Target</u>''' matches the actual install location of the Battletech game, and there is enough free space (~36 GB) 
<ol><li> Steam: Right-click on BattleTech > Local Files tab > Browse Local Files... > This will open up your BT install location. Copy the path from the address bar. </li></ol>
</li>
<li> Make sure that you have enough space (~36 GB) at the '''<u>Checkout Workspace</u>''' location. Don't forget - if the checkout location and install location are located on the same drive, you'll need to add the required space together! (~80 GB)
<ol><li> This location needs to be in it's own folder, outside the folders listed above (in orange). Ignoring this WILL corrupt your cache eventually.</li>
<li> This location cannot exist within your HBSBT install location. Doing so has been known to cause cache corruption.</li></ol>
</li><li>
Click '''<u>Update/Install RT</u>''' the launcher will download the following assets:
<ol><li>Latest version of RogueTech </li>
<li>Latest version of Community Asset Bundle. <span style="color: #ff0000;">You DO NOT need to download CAB separately</span> 
{| class="wikitable mw-collapsible mw-collapsed"
|-
! RNGesus! My Internet Is Total Shit Option
|-
|
==== Manually Downloading ====
'''''<span style="color: #ff0000;">THIS IS AN ABSOLUTE LAST RESORT OPTION WHERE EVERY SOLUTION USING THE LAUNCHER HAVE FAILED. DO THIS ONLY WHEN INSTRUCTED BY DEV/SUPPORT IN A TICKET.</span>'''''

Create a folder D:\RT\ and copy RogueLauncher.exe there. 

Download Github Desktop >> https://desktop.github.com/
(you do not need a github account)[[File:Github Desktop Interface.png|thumb]]Open Github Desktop. 

File > Clone Repository

Click the URL tab. Clone each of the following repositories as shown below. '''Copy''' '''the URL first, then the Local Path'''. 
{| class="fandom-table"
|+
!'''Repository URL'''
!'''Local Path'''
|-
|<small><code><nowiki>https://github.com/wmtorode/RogueLauncherData.git</nowiki></code></small>
|<small><code>D:\RT\RtlCache\RogueData</code></small>
|-
|<small><code><nowiki>https://github.com/BattletechModders/RogueTech.git</nowiki></code></small>
|<small><code>D:\RT\RtlCache\RtCache</code></small>
|-
|<small><code><nowiki>https://github.com/BattletechModders/Community-Asset-Bundle-IS-StarLeague.git</nowiki></code></small>
|<small><code>D:\RT\RtlCache\CabCache\cabIsStarLeague</code></small>
|-
|<small><code><nowiki>https://github.com/BattletechModders/Community-Asset-Bundle-IS-ClanInvasion.git</nowiki></code></small>
|<small><code>D:\RT\RtlCache\CabCache\cabIsClanInvasion</code></small>
|-
|<small><code><nowiki>https://github.com/BattletechModders/Community-Asset-Bundle-IS-CivilWar.git</nowiki></code></small>
|<small><code>D:\RT\RtlCache\CabCache\cabIsCivilWar</code></small>
|-
|<small><code><nowiki>https://github.com/BattletechModders/Community-Asset-Bundle-IS-DarkAge.git</nowiki></code></small>
|<small><code>D:\RT\RtlCache\CabCache\cabIsDarkAge</code></small>
|-
|<small><code><nowiki>https://github.com/BattletechModders/Community-Asset-Bundle-IS-Customs.git</nowiki></code></small>
|<small><code>D:\RT\RtlCache\CabCache\cabIsCustoms</code></small>
|-
|<small><code><nowiki>https://github.com/BattletechModders/Community-Asset-Bundle-Clan-GoldenCentury.git</nowiki></code></small>
|<small><code>D:\RT\RtlCache\CabCache\cabClanGoldenCentury</code></small>
|-
|<small><code><nowiki>https://github.com/BattletechModders/Community-Asset-Bundle-Clan-Modern.git</nowiki></code></small>
|<small><code>D:\RT\RtlCache\CabCache\cabClanModern</code></small>
|-
|<small><code><nowiki>https://github.com/BattletechModders/Community-Asset-Bundle-Miscellaneous.git</nowiki></code></small>
|<small><code>D:\RT\RtlCache\CabCache\cabMisc</code></small>
|-
|<small><code><nowiki>https://github.com/BattletechModders/Community-Asset-Bundle-Data.git</nowiki></code></small>
|<small><code>D:\RT\RtlCache\CabCache\CabSupRepoData</code></small>
|-
|<small><code><nowiki>https://github.com/BattletechModders/Community-Asset-Bundle-Tanks.git</nowiki></code></small>
|<small><code>D:\RT\RtlCache\CabCache\cabTank</code></small>
|-
|<small><code><nowiki>https://github.com/BattletechModders/Community-Asset-Bundle-CustomUnits.git</nowiki></code></small>
|<small><code>D:\RT\RtlCache\CabCache\cabCU</code></small>
|-
|<small><code><nowiki>https://github.com/BattletechModders/CAB-3025.git</nowiki></code></small>
|<small><code>D:\RT\RtlCache\CabCache\cab3025</code></small>
|-
|<small><code><nowiki>https://github.com/BattletechModders/Community-Asset-Bundle-Maps.git</nowiki></code></small>
|<small><code>D:\RT\RtlCache\CabCache\cabmap</code></small>
|}
Any time cloning fails, click Retry. 

 '''WITHOUT MOVING ANY FILES AROUND,''' you should end up with the following folder structure:[[File:Cache Structure.png|none|thumb]]Within each of these fifteen folders you've now downloaded, there should be some content (for example, a README and a CAB-IS-CivilWar folder), as well as a hidden folder called .git - '''if this hidden folder is not present, it will not work''' (for example, if you cloned the repositories somewhere else and then moved their contents without hidden files visible). 
'''If you have any folders with names that start with Community-Asset-Bundle-, it will not work.''' This means you failed to give the desktop client the proper Local Path. Ensure that your folder structure is correct before moving on.


Open RogueLauncher, and ensure the workspace is pointed to: D:\RT\RtlCache\ (This should be default if you followed these instructions)

Click update/install, continue on with normal install instructions. 

You can uninstall github desktop now. 

'''''<span style="color: #ff0000;">You only need to do this once. Update sizes are generally small enough that connectivity issues will not affect it, especially with how little the CAB (the biggest chunk) changes.</span>'''''
|}
</li></ol></li><li>
After that RogueTech Launcher will open a window with configuration options
</li><li>
You can change the options to tailor RogueTech experience to your needs, though  For new players default install is recommended for best player experience.  Options explained at the end of this guide.
</li><li>
The Launcher will require to wipe the mod directory, so this will remove any other installed mods.
</li><li>
After that the Launcher will install RogueTech mod.
</li><li>
You are all set. Now the mod can be launched with the '''<u>Launch RogueTech</u>''' button in the installer.
</li></ol>

=== Linux ===
'''<span style="color:#ff9900">!! WARNING!! : Running RogueTech natively on Linux is not supported at the moment.</span>''' 


It can be done, but you have to do some legwork yourself. There is currently no definitive list of supported distributions or setups. If you manage to get it to run, consider adding your setup to the list below. 

''' Roguetech Launcher requires WINE 5.10 or newer to work.''' 

'''DO NOT pester the community support if it doesn't install or run on your particular distribution or general setup.''' 

Throughout the guide some shell expertise and general Linux knowledge is expected from the user. 

==== Known Working Configurations ====

* Arch Linux x86_64, 5.4.6-arch1-1, Steam (Stable), nvidia 440.44-5 (NVIDIA Quadro K1000M), Intel i7-3940XM, 32 GB RAM (2010 Lenovo Thinkpad W530)
*Arch Linux x86_64, 6.7.0-arch3-1, Steam (Stable), amdvlk, AMD Ryzen 7 7840U, 32GB Ram (GPD Win Max 2 2023)
* Ubuntu Linux LTS 18.04 x86_64, Steam (Stable)
* Ubuntu Studio Linux 19.10 x86_64, GOG (Stable)
* Debian Linux 10 x86_64, Steam (Stable) and GOGs
* Gentoo Linux x86_64, Steam (Beta), nvidia-drivers 435.21 (GeForce GTX 1060), Intel i7-6700K, 32GB RAM
*Manjaro April 2020 x64, Steam (Stable)
*Fedora 32 x64, Steam (Stable)
*Pop!_OS 20.04 LTS 5.4.0-42-lowlatency, Steam (Stable)
*Manjaro 21.1.6 Kernel 5.14.10 intel i5 8250U intel UHD620 Steam (Stable)
* Mint 21.1, x86_64, Steam (Stable), 16GB RAM
* Kubuntu 22.04 LTS x86_64, 6.2.0-26-generic, Steam (Stable), nvidia 470.199.02 (NVIDIA GeForce GTX 760), Intel Xeon E31270v2, 24 GB RAM



'''RT requires allowed number of opened files be set above 32k (''' ulimit -n 32768 ''')'''

Depending on distribution, that may require editing /etc/security/limits.conf, /etc/systemd/system.conf and /etc/systemd/user.conf and rebooting.



<br />

==== Recently Verified Procedure: Try this first ====

===== Installing =====

* First, install Battletech via Steam.
* Go to the installation location (by default <code>~/.local/share/Steam/steamapps/common/BATTLETECH/</code>) and make a symbolic link to the <code>BattleTech</code> executable with the name <code>BattleTech.exe</code>. You can do this with the command  <code>ln -s BattleTech BattleTech.exe</code>. The RT installer will look for a file by this name later.
* Start the latest RT installer with Wine 5.10 or later. You may be prompted to install some mono dependencies; say yes.
**Alternative approach - Go to your steam settings, add a Non-Steam game, and find where you put the roguelauncher.exe download off the wiki - this way you dont have to install the entirity of wine for just roguelauncher, seperately from the steam installed runtimes already
***You'll also have to edit the launcher link to force compatibility - I just used proton 8.0-5
***And set STEAM_COMPAT_MOUNTS=/customMountPoint %command%, if you're outside of /home
* In the RT Installer:
** Press the Advanced Mode button to turn on said mode.
** Hit the Browse button for the Install Target field and browse to the <code>Mods</code> directory in the install directory (by default <code>~/.local/share/Steam/steamapps/common/BATTLETECH/Mods</code>. You will probably need to type <code>.local</code> manually in the selection dialog and press enter from your home directory to get into this hidden directory from the Wine file open dialog. Also, if you copy/paste any paths with slashes in them, you will need to manually change the slashes to backslashes while doing so.
** Press the Set Preferences button. Browse to the <code>BattleTech.exe</code> symlink you created above in the BattleTech.exe path field. Make sure Use Steam Launch is checked. Close this window when done.
** Back in the main window, click Reconfigure RT. Make sure Inject Modtek is chosen near the bottom. Press OK when done.
** Back in the main window, press Update/Install RT and follow the prompts. If you get a small dialogue box with two tiny rectangles in it or similar, focus it and press enter. It should proceed as normal after that. RT should now be installed correctly.
**When presented with the installation options, choose to use the old fire and smoke animations (the new ones only show up as pink squares due to shader linking problems under Linux as per the "Known Bugs" list in the changelog).
** Right mouse click on the game in the Steam library -> `Properties...` -> `SET LAUNCH OPTIONS` and set it to `./run.sh %command%`


===== Running =====
Launch BattleTech in Steam. You should see the RogueTech title screen come up. If so, enjoy RogueTech! The Launch RogueTech button in the RT launcher probably won't work.
If it doesn't work, you may need to troubleshoot [https://forum.paradoxplaza.com/forum/threads/battletech-crash-on-startup-linux.1413661/ this known issue] with recent versions of BT.

===== Troubleshooting =====
====== Logfile location ====== 
Runtime errors are logged to <code>~/.config/unity3d/Harebrained Schemes/BATTLETECH/Player.log</code>.

====== Game doesn't start at all ======
If the game doesn't start at all, with no error message in Steam, then you probably ran into a recent bug with glibc (discussion: https://forum.paradoxplaza.com/forum/threads/battletech-crash-on-startup-linux.1413661/). In this case you have to manually remove the locally installed library  <code>libc.so.6</code> from your game installation directory (usually   <code>~/.local/share/Steam/steamapps/common/BattleTech_Data/Plugins/x86_64/libc.so.6</code> ).  Renaming the file may not be enough.
====== Game doesn't start randomly - sometimes start, sometimes not ======
On modern kernels (Starting with ~6.0) you may need to disable randomize_va_space kernel setting 

<code>echo 0 | sudo tee /proc/sys/kernel/randomize_va_space</code> 

or to set it permanently add a file /etc/sysctl.d/01-disable-aslr.conf with contents 

<code>kernel.randomize_va_space = 0</code>
====== Saves don't load anymore ====== 
If the game hangs when you load your save (top left progress indicator is permanently spinning quickly), and this '''''happens every time, with every save''''', then your <code>ulimit</code> settings for the maximum number of open file handles might be too low. This gets logged in the <code>Player.log</code> as an error during the save file is loaded, so check the log first. If the error is there, you need to adjust the <code>ulimit</code> settings for your login user (check your distro's documentation on how to do that), and then start a new desktop session to propagate the change. Players report it started working at 16384, but please bump it up to 32768 to give it some future buffer.
====== Game starts but as base game ====== 
* check to see if you have NET Framework 4.8 installed on wine. if not, use winetricks to install it <code>winetricks dotnet48</code> and then update the roguetech install and re run the modtek.exe file.
* Newer versions of RogueTech use a newer version of [https://github.com/BattletechModders/ModTek ModTek] (3.0.0+) and does not come with a ''ModTekInjector.exe'', instead you'll see a ''run.sh'' in your root ''BATTLETECH'' install folder. Make sure it is executable <code>chmod +x ~/.local/share/Steam/steamapps/common/BATTLETECH/run.sh</code> and add it to your steam launch options <code>./run.sh %command%</code>


==== Older Installation Procedure: May not work on recent versions ====
{| class="wikitable mw-collapsible mw-collapsed"
|-
! Older Procedure: May not work on recent versions
|-
|
===== Pre-Installation =====
The first couple of steps may be optional, but can help if game won't run for you. Enable as a last resort.

* In Steam:
** Optional: Opt into the steam beta (Steam -> Settings -> Account -> Beta Participation -> "Steam Beta Update")
** Optional: Disable shader pre-caching (Steam -> Settings -> Shader Precaching -> Untick the checkbox)
** Optional: Start game with empty <code>LD_PRELOAD</code> variable (Steam -> Library -> Battletech -> right click -> Properties -> Set launch options: <code>env LD_PRELOAD="" %command%</code>)

* In Linux: install <code>mono, wine, wine-mono, jq</code>. The packages may be named differently depending on the distributions package naming scheme.
* On Debian-based distros ([K,L,X]Ubuntu, Mint, etc) you might have to install the latest wine-mono
** Download wine-mono from: [[/dl.winehq.org/wine-mono/|https://dl.winehq.org/wine-mono/]]
** Install (replace with correct filename): <code>wine msiexec /i ~/Downloads/wine-mono-4.x.x.msi</code>

===== RogueTech Installation =====

* Sanitize your shell (locale should be <code>en_US.UTF8</code>, <code>TERM=xterm</code>), otherwise installation WILL fail!
* Run the RogueTech Launcher (the <code>.exe</code> files) with wine 
** When asked for the install path navigate to the BATTLETECH folder where the game was initially installed (Steam default: <code>~/.local/share/Steam/steamapps/common/BATTLETECH</code>)
** Check below for an explanation what the installer options do
** Click '''<u>Update/Install RT</u>''' to install RogueTech.
** Observe wine shell output during installation. There shouldn't be any errors/exceptions.

===== Starting Battletech =====

* After you have made sure everything is in place, start BATTLETECH.
* Open a terminal and <code>tail -f</code> the logs '''BTModLoader.log''' and '''cleaned_output_log.txt''' (will be created on Battletech startup) in the <code>Mods</code> folder. If anything goes wrong, you'll immediately notice it!
* The initial start-up can take a while depending on your system specs, be patient!
* Observe the messages in the above mentioned logfiles. You can pretty much ignore <code>Log</code> and <code>Warning</code> messages - however there shouldn't be any <code>Error</code> or <code>Exception</code> messages. The game should start to the main screen and display a RogueTech banner with the game version being displayed as '''w/Modtek'''
* If you should notice one (or more) of those errors during startup the game will probably hang around 100% CPU on one core and display a never ending amount of regularly changing tooltips in the upper left corner of the window. If this happens you'll probably have to terminate the game (<code>kill -15</code> or even <code>kill -9</code> if it doesn't respond any more)
* If the game doesn't load: investigate the logs! Usually there's something in there.
* Also: clear the <code>.modtek</code> (i.e. <code>rm -rf .modtek</code> in the <code>Mods</code> folder) after you edited <code>mod.json</code> files before you restart the game.

|}

=== macOS ===

'''<span style="color:#ff9900">!! WARNING!! : Running RogueTech natively on macOS is not supported at the moment.</span>''' 

It can be done, but you have to do some legwork yourself. There is currently no definitive list of supported distributions or setups. If you manage to get it to run, consider adding your setup to the list below. 

'''DO NOT pester the community support if it doesn't install or run on your particular distribution or general setup.''' 

Throughout the guide some shell expertise and general macOS knowledge is expected from the user. 

# Create a "Mods" folder in BattleTech.app/Contents/Resources/.
# Put a symbolic link at "BattleTech.app/Contents/MacOS/BattleTech_Data", pointing to "BattleTech.app/Contents/Resources/Data".
# Put a symbolic link in the folder containing "BattleTech.app" named "Mods" (that is, "BattleTech.app/../Mods"). It should point to "BattleTech.app/Contents/Resources/Mods".
# Put a symbolic link in the folder containing "BattleTech.exe" (should be BattleTech.app/Contents/MacOS/), pointing to "BattleTech.app/Contents/Resources/Mods".
# Download and inject ModTek separately. Place the ModTek folder in the "Mods" folder you created in step 1. You can run the executable using "mono ModTekInjector.exe", without Wine.
# Download RogueLauncher and run it using an unmodified Wine prefix, with wine64 [executable path]. I stress unmodified not because it would otherwise break, but because I cannot confirm it wouldn't. At any rate, you don't need Winetricks.
# Set the Install Target to "BattleTech.app/Contents/MacOS/Mods".
## A note on paths in Wine on macOS: you can type in paths by starting with "Z:\" and entering the absolute file path, with "\" instead of "/". Additionally, it is possible to run into issues where the length of the file path is longer than Windows supports. In such scenarios, you can make temporary symbolic links to sidestep that. You'll know this is a problem if you enter a folder in the Wine file explorer and its contents are blank, when you know there are files in it.
# Download and run CAB Installer, using the same method as RogueLauncher. This didn't work with pre-cache files for me, though I only tried once before having it download them directly. It worked fine otherwise.
# Open RogueLauncher.exe again and click "Launch RT". A progress bar should appear stating that RT is launching. When it hits 100%, you may see a popup that a serious exception occurred, but the game should still launch and the loading screen should show ModTek loading all of the mods.
'''Installed on OSX 12.4, Apple M1'''

The directions above mostly worked, however the RogueLauncher would fail to load all the cache. I used Parallel to run a Windows 11 VM to fully load the cache, then copied the cache over to my OSX cache folder and then relaunched RogueLauncher to finish the install.

Additionally I am not able to "Launch RT" through the exe, due to a issue with pathing; but Launching BT from steam after install seems to launch in RogueTech Mode.

=== SteamDeck ===

Credit: /u/asmithatx via Reddit

https://old.reddit.com/r/BattleTechMods/comments/11rzdp7/install_rougetech_and_bta_3062_on_steamdeck/

'''<span style="color:#ff9900">!! WARNING !! : Running RogueTech natively on SteamDeck is not supported at the moment.</span>''' 

[[SteamDeck Install|Link to instructions]]

== RogueTech Launcher Overview ==
RogueTech comes with a launcher which installs the game and runs (on Windows only) the game. The Launcher window can be seen on the right.
[[File:RT launcher.png|thumb|
*
]]

=== Launcher Overview ===

* '''<u>Install Target:</u>''' The launcher will automatically find the path to the installed Battletech game
* '''<u>Checkout Workspace</u>''': The space this tool needs to work. This can be almost anywhere on your PC as long as it has enough free space (at least 12 GB) and is not in the Install location. <span style="color:#ff9900">DO NOT DELETE THE WORKSPACE</span> or you will need to download RogueTech & the CAB again.
* '''<u>Advanced Mode</u>''': allows to specify install and temporary files locations manually (most of the time you DON'T need to do this)

* '''<u>How to use:</u>''' opens menu which provides description of launcher functionality
* '''<u>Enable Safe Patching</u>''': Use this option to enable a slower update when Update/Install RT is clicked. This will correct a corrupted install.
* '''<u>Reconfigure RT</u>''': Only available after updating/installing. Use this if you wish to change the options for RogueTech. <span style="color: #ff0000;">WARNING: Changes to options can break existing saves.</span> 
* '''<u>Update/Install RT</u>''': Used this to check for updates to RT or install it for the first time.
* '''<u>Toggle DPI Mode</u>''': Used to activate/deactivate High DPI Mode, may help with display scaling problems on some displays, RogueLauncher needs to be restarted for this to take effect.
* '''<u>Launch RogueTech</u>''': Used to start RogueTech.  <span style="color: #ff0000;">IN WINDOWS ROGUETECH CAN ONLY BE STARTED FROM THIS LAUNCHER.</span>

[[File:Configuration Options.png|thumb]]

=== Adding Features ===
If you want to enable additional features, there are no compatibility issues. It is always* OK to add more features to an existing RT career (*barring [[Known Issues|unreported issues]]).

== RogueTech Configuration Options ==
These options can be found during setup. If you wish to reconfigure these options, the ''Reconfigure RT'' button on the launcher can be enabled by clicking ''Update/Install RT''.

<span style="color:#ff9900">If this is your first time playing RT, see [[Beginner Tips]] for an easier time to adjust to RT.</span>

=== Map Mode ===
Select between [[Mods/WarTech IIC|Wartech IIC]], or the [[Online Experience]]

=== Difficulty Scaling ===
Defines how the difficulty of the contracts and planets changes throughout your play through
* If you've purchased a few upgrades and can deploy 6 mechs, your lance value will calculate on the 6 most expensive units in your bay (most of the time these will be your mechs).
* Each rating level (half-skull) is set to 13.5M CBills.
* '''Enhanced Difficulty:''' There is a theoretical design maximum of 35, or 17.5 Skulls. New [[Mods/DropCostsEnhanced]] uses different colour schemes to show difficulty tiers (below). <s>Logically, this means at 5 Skulls, difficulty rating may not truly represent what enemy lances can spawn.</s>

[[File:ColouredSkulls FULL.png|657x657px]]

====By Company Rating==== 
Difficulty will scale according to the cost of your most expensive dropped mechs, up to deployable amount. - Skull Ratings will be determined by your average drop rating over the last couple missions.

====By Planet Rating====
Difficulty will scale according to the cost of your most expensive mechs, up to the deployable amount. - Skull Ratings are determined by Planet

=== Spawn Randomizer ===

* Randomizes Battle Spawns:  randomized spawns on regular maps
* No spawn randomizer: fixed spawns on regular maps, same as in original BT game.

=== Battle Deployments ===
Select whether you want to manually direct your dropship to deploy your units, or use game default of automatic deployment. 

=== Control Convoys ===
Select whether you want to manually direct any allied convoys on escort missions, or use the game default AI.

=== Choose the Map Size ===
Increase the Map Size to change the field. 

=== Choose to Spawn Allies Support ===
Select to enable or disable support lances for PLAYER side.

=== CombatLog Toggle ===
Changes whether the combat log is generated (for debug purposes). May improve performance on some machines if Floaties are disabled.

=== Pilot Randomizer ===

* Random Ronin Starting Pilots: you will get random '''<u>Ronin</u>''' pilots (with purple icon)
* Random Generated Starting Pilots: you will get random pilots

=== Concrete Jungle ===
Replaces Urban biomes with Wartorn Nightmares biomes. WARNING: Also plants "violent surprises" in random buildings. Has been reported to have vastly better performance compared to Urban.

Recommend disabling for first-time RT players.

=== Select Which Era's Units to Enable ===
Each ticked box will add units from the corresponding era to the game. 

More info can be found on [[Content Modules]].

=== Select which Era's Unique and Hero Units to Enable ===
Each ticked box will add the corresponding hero units to the game. 

More info can be found on [[Content Modules]].

=== Optional Mods and Components ===

* Each ticked box will add the corresponding units, weapons and other equipment to the game.
* Nuclear Weapons Carriers - adds Nuclear Weapons (Like [https://www.youtube.com/watch?v=mP3bcPvgIG8 BOOOOM]) to the game. Enemies will have those as well. Use at your own risk. Recommended to disable if this is your first time to RT.

More info can be found on [[Content Modules]].

=== Additional Flashpoints and Stories ===
Adds new Flashpoints to the game. <span style="color: #ff0000;">You need Flashpoints DLC for these</span>

More info can be found on [[Content Modules]].

=== Additional Hireable Ronin ===
Adds more custom pilots for you to hire.

=== Emblem Options ===
Each ticked box adds a different set of emblems to the game.

=== Evacuated Cities === 
Whether you want to commit warcrimes.

=== Fire FX ===
Shiny glowing fire, instead of tiny smoke plumes. 
<span style="color: #ff0000;">Disable if all you see is pink, this is a known shader issue, ESPECIALLY on linux/mac!</span>

=== Fog of War on a by Unit Basis ===
Reveal Fog of War on a by unit basis. This has no affect on unit ability to see, sensor, or shoot, and is only for what you see from your top view.

=== Night Vision Overlay ===
Greens the screen when your mech has night vision.

=== SpeedMod Options ===
Defines what is the increase in animation speed of the mechs. 100% increased speed will make units animate 2 times faster.

Combining with the in-game option Speed Up Combat has led to negative results. Use with caution.

=== Quality of Life Options ===

* Skip Intro: skips intro videos
* Retrainer: allows to retrain your pilots for 500k c-bills. In order to retrain press shift-click on their tree-tab
* Use Mouse4 as ESC key: self-explanatory
* Debug Logger Enabled: enables debug logs

=== Mech Auto Sorting Options ===
Auto sorts mechs in Mech Bay. Will do the sort on first entering the mech bay screen.

* No auto-sorting
* Sort mechs by cost: sorts mechs by cost in your mech bay AND in skirmish mech bay
* Sort mechs by tonnage: sorts mechs by tonnage in your mech bay AND in skirmish mech bay
* Sort mechs by name: sorts mechs by name in your mech bay AND in skirmish mech bay

=== FX Options ===

* Command Portrait Loader: The Commander Portrait Loader is a BattleTech mod (using ModTek) allowing you to use custom PNGs as portraits and to select one of 26 voices for your Commander when starting a new campaign.
* Battletech Sound Replacement: this is a small file that replaces the sound effects of PPCs, ACs and MGs, using Mechwarrior 4 sound effects to add to the game. 
* Skip Travel Cutscenes: skips Argo cutscenes when it jumps. Jump to Planet transit is still enabled for loading/transition purposes. 
* Crystal Clear: Provides control over post-processing effects not available through the game interface. It's totally configurable and can get rid of the super grainy effect, among others. FPS gains have been reported.
* Silence: for the sound sensitive. After a while even the game's great audio gets old. This mod lets you configure and disable certain audio feedback like the pilots talking in the barracks/hiring hall, or the PA system aboard the Argo. It can also mute the sounds of mechs rotating their torsos, and now the grating Crab and Hatchetman noises.
* Scorched Earth: greatly improves the way scorch mark and footstep decals perform.

=== ColourFloaties ===
Coloured Panic System floaties. Shiny. 

=== Select Style of Alternative Portraits for Mechs ===
Select which mech portraits to use.

=== Tech and Repair Options ===

* Repair Armor after Battle: repairing armor will cost C-bills and tech-points
* FREE Repair Armor: repairing armor is free, but your base MechTech points will be reduced.

Note this does not repair internal components. Auto Repair does not know internal component damage and it has proven extremely complicated to try and make it do so. These repairs must be carried out by going into Refit, click Repair All, and Confirm.

=== Misc. Tasks ===
Remove skirmish saves and game settings: removes skirmish saves and game settings (SURPRISE)

=== Rendering Options ===
Formerly known as the [[Performance_Tips#Tarkov_Fix|Tarkov Fix]]. Enables MultiThread Rendering. Leave this on for big performance boosts unless you're crashing a lot.

=== RT Perf Options ===
These performance fixes greatly enhance the performance of RT, bringing performance often in excess of vanilla levels. Since these fixes are highly customized, there may be errors associated with this when turning them on. If turning them off resolves an issue you're experiencing, be sure to open a ticket on discord and file a report, so that it can be addressed. 

[[Category:Guides]]