Race into Space is the free software version of Interplay's Buzz Aldrin's Race into Space. This is the reworked version following the source release for the computer version of the Liftoff! board game by Fritz Bronner. The original was developed by Strategic Visions and published by Interplay as a disk-based game in 1992 and a CD-ROM in 1994.

The most recent stable releases are available from SourceForge. There is a more recent (interim) 1.2 release on Flatpak (which shows as 2.0), https://flathub.org/apps/details/org.raceintospace.Raceintospace. More recent yet is the 2.0 beta available here at https://github.com/raceintospace/raceintospace/releases/tag/v.2.0beta. The repository here contains a work-in-progress modernization of the game, so if you want to run the very latest version, you will have to download and compile the source here.

We have made a number of improvements to the game, and are hoping to do a release soon. The changes made can be viewed in ChangeLog.md above.

Race Into Space is distributed under GNU General Public License (GPL) version 2. You can find the terms and conditions in file COPYING.

We coordinate development through the GitHub issue tracker. Feel free to report bugs, discuss tasks, or pick up work there. If you want to make changes, please fork, edit, and send us a pull request.

There's a .git-hooks directory in the root. This contains a pre-commit hook that verifies code styling before accepting changes. You can add this to your local repository's .git/hooks/ directory like:

$ cd raceintospace
$ ln -s ../../.git-hooks/pre-commit .git/hooks/pre-commit

Pull requests that don't match the project code style are still likely to be accepted after manually formatting and amending your changeset. The formatting tool (astyle) is completely automated; please try to use it.

You need CMake.

The build system automatically finds, downloads, and/or compiles:

• SDL
• Boost
• zlib
• libpng
• jsoncpp
• libogg
• libvorbis
• libtheora
• libprotobuf / protoc

The specifics of which things come from where depend on your platform.

On UNIXy systems (including Mac OS X), you can build everything with:

$ git clone git://github.com/raceintospace/raceintospace.git
$ mkdir raceintospace-build; cd raceintospace-build
$ cmake ../raceintospace
$ make

To download a copy of the game, go to the folder where you want the raceintospace subfolder to go, and run:

git clone https://github.com/raceintospace/raceintospace

We rely on the operating system to provide most of the dependencies. If you're on a Debian-based system, you can get everything with:

sudo apt-get install cmake libsdl1.2-dev libboost-dev libpng-dev \
    libjsoncpp-dev libogg-dev libvorbis-dev libtheora-dev \
    libprotobuf-dev protobuf-compiler

Or enter this all on one line:

sudo apt-get install cmake libsdl1.2-dev libboost-dev libpng-dev libjsoncpp-dev libogg-dev libvorbis-dev libtheora-dev libprotobuf-dev protobuf-compiler

If you don't already have git installed, you'll also have to run:

sudo apt install git

You may also need to run (especially if you get "No CMAKE_CXX_COMPILER could be found."):

sudo apt-get install build-essential

If you are on a Fedora-based system, you can get everything with:

$ sudo dnf install cmake gcc-c++ SDL-devel protobuf-devel boost-devel \
    libogg-devel libvorbis-devel libtheora-devel jsoncpp-devel \
    physfs-devel libpng-devel

Due to copyright concerns, the game's music has been placed in a nonfree repository. To add music to the game, run the following:

$ cd ~/ && git clone https://github.com/raceintospace/raceintospace-nonfree && cp -r ~/raceintospace-nonfree/data/audio/music/ ~/raceintospace/data/audio/ && cp -r ~/raceintospace-nonfree/data/midi/ ~/raceintospace/data/audio/

To compile the game quickly you can run a series of commands in-line. This creates a folder where the compiled game will be installed. If you want it named something other than raceintospace-build, simply change the name. The last two commands also run the game automatically.

mkdir raceintospace-build && cd raceintospace-build && cmake -DCMAKE_BUILD_TYPE=Debug ../raceintospace && make run

Or: mkdir raceintospace-build && cd raceintospace-build && cmake ../raceintospace && make && sudo make install && cd src/game && ./raceintospace

Once built, you can automatically delete the -build folder and recompile by entering this (assuming raceintospace and raceintospace-build are on the root of your home folder):

cd ~/ && sudo mkdir raceintospace-build && cd raceintospace-build && cmake ../raceintospace && make && sudo make install && cd src/game && ./raceintospace

Used to be:

cd ~/ && sudo rm -rf ~/raceintospace-build && mkdir raceintospace-build && cd raceintospace-build && cmake -DCMAKE_BUILD_TYPE=Debug ../raceintospace && make && sudo make install && cd src/game && ./raceintospace

After the first build, you can download the latest version of the source with:

cd ~/ && sudo rm -r raceintospace && git clone https://github.com/raceintospace/raceintospace

Then delete raceintospace-build and recompile:

cd ~/ && sudo rm -r raceintospace-build && mkdir raceintospace-build && cd raceintospace-build && cmake ../raceintospace && make && sudo make install && cd src/game && ./raceintospace

You can run these commands separately, or just run the ones you need (for instance, if you already have the folder you want the game installed to, there's of course no need to create it.

mkdir raceintospace-build
cd raceintospace-build
cmake -DCMAKE_BUILD_TYPE=Debug ../raceintospace
make run

You need CMake, which is readily obtained from Homebrew, which you probably have anyway. Homebrew also has a nice Boost package that doesn't cause any runtime linkage issues, so install that along with SDL:

$ brew install cmake boost sdl

CMake automatically handles the other dependencies using the stuff in lib/. Mac OS X sometimes includes libpng, and sometimes it doesn't, so we build our own. We do, however, rely on the platform-provided zlib.

You might want to use Xcode for development. CMake can generate an Xcode project file:

$ git clone git://github.com/raceintospace/raceintospace.git
$ rm -r raceintospace-build; cd raceintospace-build
$ cmake -G Xcode ../raceintospace
$ open raceintospace.xcodeproj

NOTE: The game may not successfully compile in Windows. See Issues #498, #128, #57 for details.

If the instructions below don't work, you may have to install Ubuntu (or one of its variants) in a VM, such as in Oracle VirtualBox, then follow the Debian/Ubuntu instructions above. Be sure to enable the VM's access to the host computer's network connection: in VirtualBox this setting is called "Bridged Adapter"; in Hyper-V it's "Default Virtual Switch".

Ingredients:

• Visual C++ Express 2010 ($0; other versions likely work too)
• CMake (free)
• A checkout of the source (e.g. from GitHub for Windows)

From here, use CMake-GUI or the command-line CMake to generate Visual Studio project files. Literally every dependency will be downloaded and compiled automatically.

For example (assuming code cloned in to c:\raceintospace):

# Change to "c:\"
md raceintospace-build
cd raceintospace-build
cmake ..\raceintospace

• Start Visual Studio by opening "raceintospace.sln".
• Right-click "ALL_BUILD" and choose "Build" (Everything will download and install)
• Right-click on "Race Into Space" and choose "Set as startup project"
• Right-click on "Race Into Space" and choose "Properties"
• Open "Configuration Properties" and choose "Output Directory" and set it to the path for "raceintospace-build\local\bin"
• Click on "Debugging" and edit "Environment". Add: BARIS_DATA=[path to raceintospace\data] BARIS_SAVE=.\save Click "run"