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.
Race Into Space is distributed under GNU General Public License
(GPL) version 2. You can find the terms and conditions in file
.git-hooks directory in the root. This contains a
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
astyle) is completely automated; please try to use it.
You need CMake.
The build system automatically finds, downloads, and/or compiles:
- 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 libsdl-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 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
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
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 run
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 run
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 along with SDL:
$ brew install cmake boost sdl
CMake automatically handles the other dependencies using the stuff in
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
- 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"