Installation

From Roguetech Wiki
Jump to: navigation, search

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

Pre-requisites[edit | edit source]

General Requirements[edit | edit source]

  • Make sure you have all the latest Windows updates
  • Disable cloud saves for the Battletech game in Steam
  • Download the latest RogueTech installer which you can get from NEXUS
  • Make sure you have the right version of the Battletech game. The officially supported game version by RogueTech mod is 1.9.1

How to get the needed version of the Battletech game[edit | edit source]

One more time: the officially supported game version is 1.9.1

{Beta Opt in options only}

Steam[edit | edit source]

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[edit | edit source]

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

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.
  • To switch back, simply repeat the steps above, but choose "default" in the Channel Drop down options.

RogueTech Launcher Overview[edit | edit source]

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.

*

Launcher Overview[edit | edit source]

  • Install Target: The launcher will automatically find the path to the installed Battletech game
  • Checkout Workspace: 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. DO NOT DELETE THE WORKSPACE or you will need to download RogueTech & the CAB again.
  • Advanced Mode: allows to specify install and temporary files locations manually (most of the time you DON'T need to do this)
  • How to use: opens menu which provides description of launcher functionality
  • Enable Safe Patching: Use this option to enable a slower update when Update/Install RT is clicked. This will correct a corrupted install.
  • Reconfigure RT: Only available after updating/installing. Use this if you wish to change the options for RogueTech. WARNING: Changes to options can break existing saves.
  • Update/Install RT: Used this to check for updates to RT or install it for the first time.
  • Toggle DPI Mode: 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.
  • Launch RogueTech: Used to start RogueTech. IN WINDOWS ROGUETECH CAN ONLY BE STARTED FROM THIS LAUNCHER.
Configuration Options.png

Installing RogueTech on Windows[edit | edit source]

  1. Run the RogueTech Launcher, Windows Defender might issue several warnings, just ignore them.
  2. Make sure that the Install Target matches the actual install location of the Battletech game
  3. Make sure that you have enough space (~12 GB) at the Checkout Workspace location
  4. Click Update/Install RT the launcher will download the following assets:
    • Latest version of RogueTech
    • Latest version of Community Asset Bundle. You DO NOT need to download CAB separately
  5. After that RogueTech Launcher will open a window with configuration options
  6. 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.
  7. The Launcher will require to wipe the mod directory, so this will remove any other installed mods.
  8. After that the Launcher will install RogueTech mod.
  9. You are all set. Now the mod can be launched with the Launch RogueTech button in the installer.

Installing RogueTech on Linux[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)
  • 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)

Recently Verified Procedure: Try this first[edit | edit source]

Installing[edit | edit source]

  • First, install Battletech via Steam.
  • Go to the installation location (by default ~/.local/share/Steam/steamapps/common/BATTLETECH/) and make a symbolic link to the BattleTech executable with the name BattleTech.exe. You can do this with the command ln -s BattleTech BattleTech.exe. The RT installer will look for a file by this name later.
  • Start the latest RT installer with Wine 5.x or later. You may be prompted to install some mono dependencies; say yes.
  • 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 Mods directory in the install directory (by default ~/.local/share/Steam/steamapps/common/BATTLETECH/Mods. You will probably need to type .local 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 BattleTech.exe 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 dialog 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.

Running[edit | edit source]

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.

Older Procedure: May not work on recent versions[edit | edit source]

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]

  • Sanitize your shell (locale should be en_US.UTF8, TERM=xterm), otherwise installation WILL fail!
  • Run the RogueTech Launcher (the .exe files) with wine
    • 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
    • Click Update/Install RT to install RogueTech.
    • Observe wine shell output during installation. There shouldn't be any errors/exceptions.

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.

RogueTech Configuration Options[edit | edit source]

Difficulty Scaling[edit | edit source]

Defines how the difficulty of the contracts and planets changes throughout your play through

  • By Company Rating: difficulty will scale according to the COST of your 4 most expensive mechs
  • By Planet Rating: each planet has a fixed difficulty in skulls which will impact the difficulty of the contracts generated

Mission Control[edit | edit source]

Manages the size of the maps and spawn randomization

  • No spawn randomizer: fixed spawns on regular maps, same as in original BT game.
  • Randomizes Battle Spawns: randomized spawns on regular maps
  • Randomized Spawns 1.3 map size: randomized spawns on maps 1.3x larger than in original BT game
  • Randomized Spawns 1.6 map size: randomized spawns on maps 1.6x larger than in original BT game
  • Randomized Spawns 2.0 map size: randomized spawns on maps 2.0x larger than in original BT game

CombatLog Toggle[edit | edit source]

Changes whether the combat log is generated (for debug purposes).

Pilot Randomizer[edit | edit source]

  • Random Ronin Starting Pilots: you will get random Ronin pilots (with purple icon)
  • Random Generated Starting Pilots: you will get random pilots

DLC Modules[edit | edit source]

Select only DLC modules that you have purchased.

Select Which Era's Units to Enable[edit | edit source]

Each ticked box will add units from the corresponding era to the game.

Select which Era's Unique and Hero Units to Enable[edit | edit source]

Each ticked box will add the corresponding hero units to the game.

Optional Mods and Components[edit | edit source]

  • Each ticked box will add the corresponding units, weapons and other equipment to the game.
  • Nuclear Weapons Carriers - adds Nuclear Weapons (Like BOOOOM) to the game. Enemies will have those as well. Use at your own risk.

Additional Flashpoints and Stories[edit | edit source]

Adds new Flashpoints to the game. You need Flashpoints DLC for these

Additional Hireable Ronin[edit | edit source]

Adds more custome pilots for you to hire.

Emblem Options[edit | edit source]

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

SpeedMod Options[edit | edit source]

Defines what is the increase in movement speed of the mechs. 100% increased speed will make units moving 2 times faster.

Quality of Life Options[edit | edit source]

  • 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[edit | edit source]

  • 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[edit | edit source]

  • 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 flies
  • 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.
  • Better Headlights: beef up the lights on your Mechs, and add a toggle to turn them on/off (CTRL-SHIFT-H).

Select Style of Alternative Portraits for Mechs[edit | edit source]

Select which mech portraits to use.

Tech and Repair Options[edit | edit source]

  • Repair Armor after Battle: repairing armor will cost C-bills and tech-points
  • FREE Repair Armor: repairing armor is free

Misc. Tasks[edit | edit source]

Remove skirmish saves and game settings: removes skirmish saves and game settings (SURPRISE)