Race into Space

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.

License

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

Contributing

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.

Building

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

Linux

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

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

$ sudo apt install git

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-go, simply change the name. The last two commands also run the game automatically.

mkdir raceintospace-go && cd raceintospace-go && 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-go
cd raceintospace-go
cmake ../raceintospace
make
sudo make install
cd src/game
./raceintospace

Mac OS X

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

Windows

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"