Installing Long War of the Chosen - long-war-2/lwotc GitHub Wiki (2024)

LWOTC 1.0 is available on the Steam Workshop. For the latest release version, subscribe to and follow all directions there (rather than the manual method described below)

  1. Download the latest LWOTC release from Nexus Mods. Starting with version 1.0, LWOTC does not require a customized highlander; use the one on the workshop.

  2. Unpack the zip archive to your Steam\steamapps\common\XCOM 2\XCom2-WarOfTheChosen\XComGame\Mods directory (on Windows). If the 'Mods' directory doesn't exist, create it first.

    You should end up with the directories ...\XCom2-WarOfTheChosen\XComGame\Mods\LongWarOfTheChosen and ...\XCom2-WarOfTheChosen\XComGame\Mods\X2WOTCCommunityHighlander.

    Upgrading from an earlier version of LWOTC If you're installing the complete package (approx. 2.2GB), remove any existing LongWarOfTheChosen, X2WOTCCommunityHighlander and DLC2CommunityHighlander folders from the 'Mods' directory before unpacking the new LongWarOfTheChosen. If you're installing an update package, unpack it into Mods without deleting the existing mods first, and overwrite the existing files.

    Mac users See Feral Interactive's instructions on "installing mods that you have downloaded" for Mac OS X

    Mac Note: do NOT unpack to the wotc directory, follow these instructions literally. defaultmodoptions.ini should look like this:




    Linux users See Feral Interactive's instructions on "installing mods that you have downloaded" for Linux

  3. Download and install the latest release of the Alternative Mod Launcher. In AML's settings, make sure there are at least two paths to mod directories - one for the workshop mods, the other for local mods.

  4. Subscribe to all the mods in the [LWOTC] Required Mods collection on the Steam Workshop.

  5. Delete all the files in Documents\My Games\XCOM2 War of the Chosen\XComGame\Config (don't worry, these will be regenerated when you start the game).

    Important Do not delete the config files in the game directory, i.e. Steam\steamapps\common\XCOM 2\XCom2-WarOfTheChosen\XComGame\Config - the game will fail to start if you do.

    Linux users Delete ~/.local/share/feral-interactive/XCOM 2 WotC/VFS/Local/my games/XCOM2 War of the Chosen/XComGame/Config

  6. Start the game with only the Long War of the Chosen and X2WOTCCommunityHighlander mods selected, as well as the required mods listed in step 5.

    If you see a "Long War (LWOTC)" button on the main menu, you're good to go!

    If you see a "New Game" button instead, exit the game completely and launch it again. The "New Game" button should now be replaced by "Long War (LWOTC)". If that's not the case, see the Troubleshooting Guide.

  7. You can now exit and enable all other mods, consider subscribing to the recommended list of LWOTC mods for a better experience.

  8. If you get an "Enable Tutorial?" pop-up, click "Disable Tutorial". Doing otherwise will enable the Tutorial, which will brick your campaign.

  9. If you get a "Disable War of The Chosen Introduction?" pop-up then click "Disable Introduction" Doing otherwise will enable Lost and Abandoned, which will brick your campaign.


  1. Please do not play with Iron Man enabled! LWOTC is still in development and needs reproducible examples to help fix bugs. Iron Man makes it much harder to get a save file that reproduces a specific problem (plus the developers have to play with Iron Man enabled too).
  2. Enable auto saving, so you almost always have easy access to a save file that reproduces any bug you encounter.
  3. Make sure LWOTC is installed to ...\XCom2-WarOfTheChosen\XComGame\Mods\ not ...\XCOM 2\XComGame\Mods\.

Mods, Compatibility, and Extra Steps.

For a full list of mods and information, we have a HUGE community-maintained list of mods and their compatibility. However, there are a few mods the LWOTC team would like to explicitly talk about.

Mods you should not be using with LWOTC

  1. These mods are already integrated into LWOTC.

  2. These mods (and arguably any mods that require these) may cause crashes when launching some missions in LWOTC. That said, we welcome anyone giving them a try, since it's been a while since we tested them.

Mods the LWOTC team wants to explicitly recommend to you.

  1. List of mods we strongly recommend:

    • [WOTC] Stats on New Promotion Screen

    • [WotC] Mod Config MenuProvides a "Mod Settings" button on the XCOM 2 options menu that gives you access to configuration settings for various mods, including robojumper's Squad Select. Additionally, many mods use it to allow the player to configure them.

  2. List of Quality of Life mods that work OK with LWOTC, and we recommend.

    • [WOTC] Unit Flag ExtendedLets you see enemy Damage Range, Aim, Movement, and HP on the map.

    • Free Camera RotationLets you move the camera at 30 or 45 Degree intervals instead of 90 Degree ones. Note that it overrides the Target Preview key by default, so we recommend you edit the mod's XComInput.ini file and disable or rebind the entry for "LeftAlt" (just put a ; at the start of the line to disable it).

    • Evac All - WOTCAdds a command to Evac all units in the Evac zone.

    • Gotcha AgainAdds various Icons and Indicators to let you know things like who you're flanking, line of sight to allies, triggering enemy overwatch, and more.

    • TacticalUI Kill CounterLets you see how many enemies are still active so you don't have to remember them all. After you build a shadow chamber, also lets you know how many are inactive.

    • Yet another F1Lets you press F1 to see very detailed information on your target.

  3. You can use the Extended Information! mod, but you will need to open the mod settings for Extended Information and disable anything related to Aim Assist.

Optional mod for bug fix.

  1. You can use the Reliable Ever Vigilant mod to avoid the bug where Ever Vigilant perk activates pistol overwatch instead of primary weapon overwatch when soldier has a pistol.

Note You can find previous versions of the LWOTC mod here.

Reporting issues

You will encounter problems in the game. There are known ones already. If you would like to report an issue, please follow these steps:

  1. If you're having problems starting the game or a mission, try clearing your config directory (Documents\My Games\XCOM2 War of the Chosen\XComGame\Config) and moving your profile.bin file out of the SaveData directory (which is next to the Config folder)

  2. Check out the Troubleshooting guide for more advice.

  3. Create an issue in this GitHub repository if you're still having issues.

  4. Attach a zipped save file that replicates the problem if possible. If you have an autosave, please load it and then save it explicitly with an meaningful name.

  5. Provide as much information as you can, including what other mods you have enabled, the steps that reproduce the problem, what the impact of the problem is, and so on.

Installing Long War of the Chosen - long-war-2/lwotc GitHub Wiki (2024)


Top Articles
Latest Posts
Article information

Author: Jamar Nader

Last Updated:

Views: 6048

Rating: 4.4 / 5 (75 voted)

Reviews: 82% of readers found this page helpful

Author information

Name: Jamar Nader

Birthday: 1995-02-28

Address: Apt. 536 6162 Reichel Greens, Port Zackaryside, CT 22682-9804

Phone: +9958384818317

Job: IT Representative

Hobby: Scrapbooking, Hiking, Hunting, Kite flying, Blacksmithing, Video gaming, Foraging

Introduction: My name is Jamar Nader, I am a fine, shiny, colorful, bright, nice, perfect, curious person who loves writing and wants to share my knowledge and understanding with you.