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. This was developed by Strategic Visions and published by Interplay as a disk-based game in 1992 and a CD-ROM in 1994.

The Race Into Space project home page is raceintospace.org, and the most recent stable releases are available from SourceForge. This repository contains a work-in-progress modernization of the game.

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

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 libsdl-dev libboost-dev libpng-dev \
    libjsoncpp-dev libogg-dev libvorbis-dev libtheora-dev \
    libprotobuf-dev protobuf-compiler

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 too:

$ brew install cmake boost

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

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"