Tedster59 / lwotc

Port of Long War 2 to XCOM 2's War of the Chosen expansion
8 stars 1 forks source link

Long War of the Chosen (LWOTC)

This is a port of Pavonis Interactive's Long War 2 (LW2) overhaul mod for XCOM 2 to the War of the Chosen (WOTC) expansion and update it for WOTC's new features.

Installing and playing the mod

If you just want to install and play the mod, check out our wiki page that explains exactly how to do that.

Contributing translations

If you would like to contribute to translations for LWOTC, then check out the wiki page that explains how it works.

Building and running the mod

If you want to contribute changes to code or assets, then you will need to build the mod so that you can test them. Before you can do that, you need to set some things up:

  1. Make sure you have the WOTC SDK full_content branch installed - see the xcom2mods wiki for details on how to do that (plus lots of other useful information)

  2. Fork this repository and then clone your fork locally, which you can do via Git for Windows (a command-line tool), GitHub Desktop, or some other git client tool

  3. Once you have cloned the repository, you may need to pull the code for the embedded highlander. If the X2WOTCCommunityHighlander directory is empty, then use the command line from the project's root directory (the one containing this README.md):

        > git submodule update --init

    or whatever is the equivalent with the git client tool you are using.

  4. Download the LWOTC media assets (video, graphics and sound) from this Google Drive link and unpack the resulting zip file into this project's LongWarOfTheChosen directory. It should merge the contents of the Content and ContentForCook directories.

  5. Set up the following environment variables:

    • XCOM2SDKPATH — typically <path to Steam>\steamapps\common\XCOM 2 War Of The Chosen SDK
    • XCOM2GAMEPATH — typically <path to Steam>\steamapps\common\XCOM 2\XCom2-WarOfTheChosen Don't put these paths in quotes.
  6. Open a new command prompt after setting those environment variables and run the following from the LWOTC project directory:

    > build-lwotc.bat -config default

    (You can specify -config debug to compile with debug info)

  7. You should also build the Community Highlander, which you can do by opening the solution file in X2WOTCCommunityHighlander in Mod Buddy and using that to build the project, or you can open the LWOTC project directory in VS Code and use the "Terminal > Run Task..." menu option and select "Build CHL (final release)" and then "Build DLC2 CHL" once the previous task has finished.

Once the highlander and LWOTC are built, you will be able to select them as local mods in Alternative Mod Launcher and run Long War of the Chosen.

Contributing

Contributions are welcome. If you just want to raise issues, please do so on GitHub, preferably including a save file if possible.

If you wish to contribute to development — and this project will rely heavily on such contributions — then please look through the issues and if you want tackle one, just leave a comment along the lines of "I'll take this one". If you find you can't complete the issue in a reasonable time, please add another comment that says you're relinquishing the issue.

All contributions are welcome, but bug fixes are extremely welcome!

Acknowledgements