From Roguetech Wiki
Jump to: navigation, search

Please note, youtube guide is from many versions ago, options in installer may not look exactly the same as the one you download.


The Core Installer followed by Community Asset Bundle(NOT OPTIONAL!), this is the intended game experience.

Installation[edit | edit source]

Preliminary[edit | edit source]

Game Version[edit | edit source]

Check which game version you need.

The Steam version required is Is noted in the change log

The GOG version required is noted in the Change Log

GOG Galaxy users:[edit | edit source]

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

How to Switch back on GOG Galaxy[edit | edit source]

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

Actually Install The Thing[edit | edit source]

  • Run the Core Installer, It auto detects your BATTLETECH folder.
  • Select the options you wish to install.
  • Ensure that you click First Time Install BTML!.
  • Tick all Clean Previous install options.
  • Run the Asset Bundle and ensure it installs to the same directory.
  • Run Battletech; you will see the loading process of the mod.
  • Click Career and Start New game.
  • Enjoy.

How do I run the installer?[edit | edit source]

Run the RogueTech Core installer[edit | edit source]

- Read the license agreement and agree to click next

- Select your Battletech Install location and click next

- Tick which options you wish to experience (Please note: Only tick the DLC options if you have bought the Battletech DLC)

- For the ModTek installation; Select either First Time install (If youre a RT virgin select this) or select Patch Modtek

- Please select Clean Previous install check boxes for best compatability (This will not remove your saves; but will remove any mechs you have designed in the skirmish bay)

- For advanced users; or when our support has advised you; please tick Activate Debug Menu;

- You will then see a list of the options you have selected to be installed, Please click install if you wish to continue;

- Please now download the Community Asset Bundle

Run the Community Asset Bundle[edit | edit source]

- Extract the Community Asset Bundle to a location of your choosing

- Once extracted, open its folder and run the executable file (NOT THE BIN files)

- Read and once agreed to the License agreement please click next

- Locate your Battletech install location (NOT THE MODS FOLDER) and click next

- Contents of the CAB file will install

- You will now be able to launch into RogueTech

The two packages includes all required dll's

  • Run Steam/GoG validation of game integrity check Prior to install
  • Please disable Save cloud synchronization for BATTLETECH
  • Ensure you're running the proper version/beta version of the game
  • Run the Core installer, it autodetects your battletech folder in which it needs to go
  • If you had another mod prior, Check to remove all skirmish saves!
  • Run the Asset Bundle INSTALLER and ensure it installs to the same directory. (Note: Do not just unzip the archive)
  • If this is your first install, check the BTML install option
  • Start your game

- Check file description and Change Log if you have to do a clean install

- Installer has an option to clean up prior installations

- Installer will delete modtek cache and will take care of most things

Installing RogueTech on Linux (Steam / native)[edit | edit source]

 !! WARNING!! : Running RogueTech natively on Linux is not supported at the moment.
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 Linux knowledge is expected from the user.

Known working configurations[edit | edit source]

  • 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)
  • Ubuntu Linux LTS 18.04 x86_64, Steam (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

Pre-Installation[edit | edit source]

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 LD_PRELOAD variable (Steam -> Library -> Battletech -> right click -> Properties -> Set launch options: env LD_PRELOAD="" %command%)

  • In Linux: install mono, wine, wine-mono, jq. 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

RogueTech Installation[edit | edit source]

As stated above, first download latest Roguetech Mod files (yes, the windows .exe files). You need both!

  • Sanitize your shell (locale should be en_US.UTF8, TERM=xterm), otherwise installation WILL fail!
  • Unzip the asset bundle (will yield files ending in .bin and one .exe file)
  • Run both the RogueTech mod file installers (the .exe files) with wine (core first, then asset bundle)
    • When asked for the install path navigate to the BATTLETECH folder where the game was initially installed (Steam default: ~/.local/share/Steam/steamapps/common/BATTLETECH)
    • Check below for an explanation what the installer options do
    • Observe wine shell output during installation. There shouldn't be any errors/exceptions.

RogueTech Pre-Run Tasks[edit | edit source]


  • Since the windows filesystem isn't case sensitive, the path definitions in some of the mod.json files aren't written in the exact same way as the files are actually named (i.e upper/lowercase mismatch). What is irrelevant in windows breaks mod loading in Linux, as the path name won't match in such a case. Use the following helper script to identify mods that misbehave:

  • Copy that script to your BATTLETECH folder and run it. It will display all mods with path mismatches (i.e. read all paths from mod.json files and try to find them in the folder structure - or display an error message).
    The script will try to fix all wrong path definitions by creating a correctly named symlink pointing to the file in question.
 # display help:
 ./ -h
 # run the script in regular check mode:
 ./ -c
 # run the script in debug check mode:
 ./ -c -d
 # run the script in JSON check mode to validate JSON files too:
 ./ -c -j

  • Additionally create a lowercase mods symlink to the Mods folder as some mods have that path hardcoded in lowercase. Switch to your BATTLETECH installatiojn folder and run:
    • ln -s Mods mods

Starting Battletech[edit | edit source]

  • After you have made sure everything is in place, start BATTLETECH.
  • Open a terminal and tail -f the logs BTModLoader.log and cleaned_output_log.txt (will be created on Battletech startup) in the Mods 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 Log and Warning messages - however there shouldn't be any Error or Exception 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 (kill -15 or even kill -9 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 .modtek (i.e. rm -rf .modtek in the Mods folder) after you edited mod.json files before you restart the game.

Logfiles Locations[edit | edit source]

The following logfiles carry important information and may aid you in troubleshooting any issues you encounter:

  • ~/.local/share/Steam/steamapps/common/BATTLETECH/Mods/cleaned_output_log.txt/
  • ~/.local/share/Steam/steamapps/common/BATTLETECH/Mods/output_log.txt/
  • ~/.local/share/Steam/steamapps/common/BATTLETECH/Mods/.modtek/ModTek.log
  • ~/.config/unity3d/Harebrained\ Schemes/BATTLETECH/Player.log

Addendum[edit | edit source]

Original discussion on reddit:

Non-English System and non-unicode Languages[edit | edit source]

The installer needs the system languages to be set to english in order to function correctly, otherwise unpredictable bugs can happen due to files not being in the expected places.

To change your languages on Windows 10:

  • Open Control Panel.
  • Open "Region".
  • Click "Language preferences". A new window will open.
  • Change "Windows display language" to English, close window.
  • Open the "Administrative" tab, click "change system locale".
  • Change to English, close. The computer will ask for a restart.
  • Restart.
  • Carry on with RT install process.


Updates[edit | edit source]

To install a Roguetech update

  • Check that your Battletech version and Roguetech version are compatible.
  • Check the Change Log to see if a Clean Install is required or an asset bundle update..
  • Download Roguetech Core Update located on Nexus.
  • Run the Core Installer; it auto detects your BATTLETECH folder.
  • Select options you wish to install.
  • Click PATCH BTML option.
  • It is recommended that Remove Mods folder option is ticked.
  • Clean Install option as required in the Change Log.
  • Run the Community Asset Bundle and ensure it installs to the same directory.
  • Run Battletech; you will see the loading menu appear.
  • You may continue your save game (Unless otherwise directed by Change Log to start new game).
  • Enjoy.

Installer Settings[edit | edit source]

Details on what the options from the Core Installer do. Its designed to be more modular for the experience of a user.

This list of the installation options also has marked the recommended settings for new players.

There is no "intended" option setting for this, but the recommended settings will be pointed out by a [ * ] at the end of the name of an option.

Difficulty Modes[edit | edit source]

Option changes some of the general difficulty scale of the base game.

  • Normal RogueTech * : Even playing field for both AI and Players. No random Cheating involved. Pure gear and pilots stats.
  • Brutal RogueTech : Brutal Mode gives AI a escalating stat bonus to make them more on par with player abilities, adds special Mech variants (Ex. Nuke Urbie or Nurbie) and special contracts, which may or may not be ruthless (Ex. Kobiyashi Maru scenario).
Brutal Mode Introduces a higher degree of masochism difficulty for the player, and its expected to really make things difficult, so not recommended for new players.
While Brutal Mode can be introduced on the middle of a play-thru, it will most likely not be reversible on post-change save-games.

Difficulty Scaling[edit | edit source]

Option which changes Contract Skull difficulty setting on all the systems in-game.

  • Difficulty by Company Rating : Sets the difficulty of contracts to always be on the same scale as your current threat level.
  • Difficulty by Planet Rating * : Sets the difficulty of contracts to depend on the planet's own difficulty scale and each planet have their own difficulty rating, allowing better diversity of loot and contracts.
NOTE: Threat level is calculated by your Tech Level and other stuff, not just your current tonnage.

DLC Modules[edit | edit source]

Continuing with the modular system implemented for RogueTech, the DLC Modules are a way to setup if you have or not the required DLC, and to implement that specific DLCs' modded data.

  • Flashpoint : Adds the DLCs own Mechs into the RT variants and settings. And adds more Flashpoints [WIP] or replaces with RT variants of vanilla FPs.

Choose RogueTech Mode[edit | edit source]

  • Online RogueTech *: DEFAULT. Full Sandbox map which will have dynamic map changes due to your companies war efforts in supporting a faction. Affected globally to every player using this option.
  • Story RogueTech: Vanilla mode without Sandbox or Online map features.

Emblem Options *[edit | edit source]

Doesn't affect much in-game, but adds more variety to the available Emblems for your own Mercenary Group.

You can add your own emblem in-game by adding it to a mod with the correct structure. Look at battletech\Mods\RogueEmblems\ for an example (or just drag and drop it on there). It won't be automatically be added again on a deletion or a recommended update setting.

FX Options[edit | edit source]

Various FX options enabled by various mods from the community (with permission). [You don't need to download and isntall them, they are within the main installer already]

  • Commander Portrait Loader : Adds custom portraits for your own mech pilot. Nexus Link
[WIP 1.3]  Some of the 1.3 update changes made it somewhat unstable if you DON'T change anything on your default commander/pilot appearance, so its recommended to ALWAYS change your appearance and not use default settings with this mod. Also the appearance customizer will be locked after selecting, so the decision is final once done.
[BUG 1.3] Known bug is that the UI for the portrait is somewhat messed up on the creation screen, but it will work properly in-game.
While its possible to add your own commander profile in-game, its better to ask in the Discord or Sub-Reddit for more info on that.
  • Battletech Sound Replacement Pack * : 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. By Highwayleopard Nexus Link
  • Crystal Clear * : Reduces various Post Processing effects to lower the graphical impact in-game.[Customization] Nexus Link
  • Silence : Disables most Ambient Chatter on the Argo and in-game too. [Customization]. Recommended for streamers or people who just tired of the VOs. Nexus Link
  • Coloured Mech Portraits * : Simple adjustment to the mech portraits for adding a colored background to vanilla mechs, coloring divided by Mech Weight Class (Light/Medium/Heavy/Assault). By Armakoir.

Pilot Mods[edit | edit source]

  • Pilot Quirks * : Adds Pilot quirks which will give special stats and certain events which will affect them dynamically.
  • Pilot Fatigue * : Introduces pilot fatigue, making pilots have to rest a short time after missions, but still able to do missions but with lower stats.
  • Reduced Pilot XP gain by Rank * : Self explanatory.

Quality of Life Options[edit | edit source]

  • Shift+Click to change armour by 1 * : Self explanatory.
  • Skip Intro * : Self explanatory.
  • Speed Mod * : Doubles the game speed.
  • Sort Mechs by Cost : Self explanatory.
  • Disable Black Market Icons* : Self explanatory.
  • Retrainer * : Spend 500k C-Bills to brainwash retrain your pilots once per play-thru
. USAGE: Shift+Click on the Skills tab on a pilot, on pilot roster page.
  • Use Mouse 4 as ESC key : Self explanatory.

Optional Era Modules[edit | edit source]

Curated collections of Mechs and Vehicles sorted by era using the era definitions on

  • Mechs of the Civil War Era 3062-67
  • Mechs of the WoB Jihad Era 3068-3080
  • Mechs of the Republic Era 3080-3130
  • Mechs of the Dark Age Era 3130

Unique and Hero Units[edit | edit source]

Collections of named custom mechs drawn from a wide variety of Source Books and Technical Readout's as well as Hero mechs from Mech Warrior Online and sorted into the Era's described above.

  • Unique Mechs of the Civil War
  • Unique Mechs of the Jihad
  • Unique Mechs of the Republic
  • Unique Mechs of the Dark Age

Other Optional Mods and Components[edit | edit source]

A collection of Components and Community mods to customize and add more flavor.

  • Drones of Syberia: An optional flashpoint pack (requires Flashpoint DLC) set in the Nebula California. By Akodoreign
  • Elite Pilots and Mechs : A set of new opponents and challenges designed to make the life of your mech warriors, that little bit more fun. Included are elite pilots, new lance sub-types, custom mechs and a challenging set of ''duels''. By LadyAlekto.
  • Experimental Weapons : A collection of custom mechs and equipment. Not really lore-canon. Balanced for standard RogueTech. By MXMach.
  • Heavy Artillery Units : Adds in lore and custom units with Arrow IV cruise missiles and artillery weapons. Nasty mid to late game units. By Akodoreign, LadyAlekto, Cargo_Vroom and Raza5.
  • HBS Battletech Story : An import of HBS's story campaign, broken down in to Flashpoints (requires Flashpoint DLC). By Akodoreign (With thanks to HBS)
  • Looted Clan Mechs : Pirates have ''customized'' some stolen Clan mechs. By LadyAlekto
  • Mission Control : A framework that enables a wide variety of new or tweaked features. Currently in development. By CWolf
  • Non Canon IIC Units: Custom second line mechs for the Clans. By Raza5
  • Nuclear Weapons Carriers: Legendary Mechs and Vehicles armed with lootable nuclear warheads. By the RT Team
  • Pirate Tech Units : ''Innovative'' weapons, vehicles and mechs found throughout the periphery. By LadyAlekto
  • Protomechs : A collection of Protomechs from the tabletop game. By Rumia
  • Republic Institute of Strategic Combat : A collection of custom units, technology and weaponry inspired by the Dark Age RISC. By LadyAlekto
  • SuperHeavys : Oversized Mechs and Tanks (>100 ton), with their own special endgame missions to encounter them. By LadyAlekto and CargoVroom.
  • Urbocalypse: A variety of canon and non-canon Urban mech variants. Also includes the dreaded Urbie lance, that allows for Urbie lances to spawn in missions. By LadyAlekto and Raza5

Read In-game Settings[edit | edit source]

Continue reading to look into the information about the In-game settings available currently ingame.