Building Project Ascension on Windows - Proj-Ascension/Client GitHub Wiki

Dependencies

  • CMake

    Just download the installer and install it wherever you want, make sure one of the "Add to path" radio buttons is checked.

  • Boost

    You can either opt to build the libraries yourself, but you can just as easily download prebuilt binaries.

    Copy the 2nd boost_1_58_0 folder to C:\Boost.

  • Qt

    Depending on which compiler you want to use (mingw or msvc), you'll need to install a version of Qt that is compatible with your setup. Currently, we're primarily targeting msvc but mingw doesn't require you to install Visual Studio, and there's an issue with tray icons on mingw. Nevertheless, instructions are exactly the same for both so we will leave the decision up to you.

    • Install the qt version from this list. (If installing the mingw version, make sure it's checked under Tools->mingw-(version))
  • MSVC (if applicable)

    Microsoft has now made C++ build tools separate from Visual Studio, which can be acquired here if you don't wish to install Visual Studio to build. However, if you were so inclined, the community edition compiles just fine, free of charge. You don't need any of the extra features, so feel free to untick everything.

  • Project Ascension (duh)

    The client team uses git, but if you just want to test the project, you can download a stable or unstable archive of the repo.

Process

CLion

  1. Install msysgit and make sure that you tick either the 2nd option or the 3rd option.

  2. Open CLion

  3. "Check out from version control" -> "Git"

  4. Input the Git URL

  5. Choose a directory to clone the repo to

  6. Open the directory

  7. Click play

Qt Creator

  1. Open Qt Creator

  2. Open project, navigate to where you unzipped the project & open CMakeLists.txt

  3. Run CMake without arguments.

  4. Click the play button on the bottom left panel, or press Ctrl-R

Visual Studio

Currently, Visual Studio doesn't natively support CMake projects, so CMake needs to be run externally in order to get the Visual Studio project files.

  1. Open CMake GUI

  2. Locate the source directory (The root directory containing CMakeLists.txt) and the build directory (The root directory where you would like the binary to be compiled)

  3. Click "configure" and choose the correct Visual Studio version from the drop-down menu (ARM builds haven't been tested yet, but x86 & 64 work)

  4. After it complains about not finding Qt, click "Add Entry" and add a variable called CMAKE_PREFIX_PATH of type PATH and direct it to the location where the Qt CMake files are installed (Default: C:\Qt\Qt<minor version>\msvc\lib\cmake)

  5. Click "generate"

  6. Open "ProjectAscension.sln" (If it asks you to sign in, you don't need to)

  7. Open the Solution Explorer pane and right-click on ZERO_CHECK and ALL_BUILD and unload each one.

  8. Ctrl-F5 or Debug->Run without debugging.

⚠️ **GitHub.com Fallback** ⚠️