d68fbe50/vanilla-conquer

Vanilla Conquer provides clean, cross-platform builds of the C&C Remastered Collection and the standalone legacy games.

Vanilla Conquer

Vanilla Conquer is a fully portable version of the first generation C&C engine and is capable of running both Tiberian Dawn and Red Alert on multiple platforms. It can also be used for mod development for the Remastered Collection.

The main focus of Vanilla Conquer is to keep the default out-of-box experience faithful to what the games were back when they were released and work as a drop-in replacement for the original executables while also providing bug fixes, compatiblity and quality of life improvements.

Current project goals are tracked as GitHub issues with the goal label.

Developers hang around The Assembly Armada Discord server if you feel like chatting.

Building

We support wide variety of compilers and platforms to target. Vanilla Conquer is known to compile with recent enough gcc, MSVC, mingw-w64 or clang and known to run on Windows, Linux, macOS and BSDs.

Windows

Requirements

The following components are needed to build Vanilla Conquer executables:

• MSVC v142 C++ x86/x64 build tools
• Windows 10 SDK
• CMake (installable from MSVC build tools)
• SDL2 development libraries, Visual C++
• OpenAL Core SDK

Extract SDL2 and OpenAL somewhere you know. If you are building only Remastered dlls you can skip installing SDL2 and OpenAL.

Building

In a VS command line window:

mkdir build
cd build
cmake .. -DSDL2_ROOT_DIR=C:\path\to\SDL2 -DOPENAL_ROOT=C:\path\to\OpenAL
cmake --build .

This will build Vanilla Conquer executables in the build directory. If you are building Remastered dlls you need to configure cmake with -A win32 and ensure your VS command line is x86.

Linux / macOS / BSD

Requirements

• GNU C++ Compiler (g++) or Clang
• CMake
• SDL2
• OpenAL

On Debian/Ubuntu you can install the build requirements as follows:

sudo apt-get update
sudo apt-get install g++ cmake libsdl2-dev libopenal-dev

Building

mkdir build
cd build
cmake ..
make -j8

This will build Vanilla Conquer executables in the build directory.

Releases

Binary releases of the latest commit are available from here, which is updated whenever new code is merged into the main branch.

Running

VanillaTD and VanillaRA

Copy the Vanilla executable (vanillatd.exe or vanillara.exe) to your legacy game directory, on Windows also copy SDL2.dll and OpenAL32.dll.

For Tiberian Dawn the final freeware Gold CD release (GDI, NOD) works fine.

For Red Alert the freeware CD release works fine as well. The official Red Alert demo is also fully playable. The demo supports custom skirmish maps (except interior) and includes one campaign mission for both Allied and Soviet from the retail game.

While it is possible to use the game data from the Remastered Collection, The Ultimate Collection or The First Decade they are currently not supported. Any repackaged version that you may already have from any unofficial source is not supported. If you encounter a bug that may be data related like invisible things or crashing when using a certain unit please retest with the retail data first before submitting a bug report.

Remastered

The build process will produce Vanilla_TD and Vanilla_RA directories in your build directory if you enable them with -DBUILD_REMASTERTD=ON and -DBUILD_REMASTERRA=ON. These work as mods for the Remastered Collection.

To manually install a local Remastered mod, launch both games once then head to My Documents/CnCRemastered/CnCRemastered/Mods. You should see Tiberian_Dawn and Red_Alert directories.

Tiberian Dawn

Copy the Vanilla_TD directory to the Tiberian_Dawn directory.

The directory structure should look like this:

My Documents/CnCRemastered/CnCRemastered/Mods/Tiberian_Dawn/Vanilla_TD/Data/TiberianDawn.dll
My Documents/CnCRemastered/CnCRemastered/Mods/Tiberian_Dawn/Vanilla_TD/ccmod.json
My Documents/CnCRemastered/CnCRemastered/Mods/Tiberian_Dawn/Vanilla_TD/GameConstants_Mod.xml

You should now see the new mod in the mods list of Tiberian Dawn Remastered.

Red Alert

Copy the Vanilla_RA directory to the Red_Alert directory.

The directory structure should look like this:

My Documents/CnCRemastered/CnCRemastered/Mods/Red_Alert/Vanilla_RA/Data/RedAlert.dll
My Documents/CnCRemastered/CnCRemastered/Mods/Red_Alert/Vanilla_RA/ccmod.json

You should now see the new mod in the mods list of Red Alert Remastered.