Open Source Tomb Raider Engine
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Thomas Buck d2e544ed08 Documented Particle 11 years ago
data Changed Font to Droid Sans Mono 11 years ago
mac_dist Bumped build id 11 years ago
src Documented Particle 11 years ago
.gitignore Added Doxyfile 11 years ago
BUGS Initial commit from SF CVS 11 years ago
COPYING Initial commit from SF CVS 11 years ago
ChangeLog Changed Font to Droid Sans Mono 11 years ago
Doxyfile Documented Particle 11 years ago
DoxygenLayout.xml Documented Particle 11 years ago
Makefile Console visible ingame! 11 years ago
README.md Changed Font to Droid Sans Mono 11 years ago
README.old Added new Readme 11 years ago
Requirements Initial commit from SF CVS 11 years ago
TODO Added test level. Fixed Mac Bundle libs. 11 years ago
deps.sh Replced deprecated alutLoadWAVFile(). 11 years ago
setup.sh Changed Font to Droid Sans Mono 11 years ago

README.md

OpenRaider

OpenRaider is an Open Source implementation of the classic Tomb Raider Game Engine. It was abandoned in 2003.

This project aims to get OpenRaider in a more usable state.

If you just want to see OpenRaider doing something, without installing any of the dependencies needed to build OpenRaider, install XQuartz (if you don’t have it already) and grab the Mac App Bundle from the most recent release.

Configuration

OpenRaider needs some configuration files, and level data and assets from custom levels or the Tomb Raider games. These are stored in ~/.OpenRaider. Running the included setup.sh will create/copy the necessary files and directories. The Mac App Bundle will do this for you automatically.

You still need to add level files in ~/.OpenRaider/paks/ and add them to ~/.OpenRaider/OpenRaider.init. Dust off your old Tomb Raider CDs or grab some custom levels from the interwebs.

Documentation

All previously included documentation was moved into the OpenRaider Repo Wiki!

A more or less recent Doxygen documentation of OpenRaider should be on the Github Pages for OpenRaider.

Dependencies

On Mac OS X 10.9 with XCode and MacPorts installed, the following should be enough to get all dependencies that are available as port:

sudo port install zlib cmake libsdl libsdl_ttf

You also need the XQuartz X11 Server.

To get Sound, you need freealut. Get, compile and install it like this:

git clone git@github.com:vancegroup/freealut.git
mkdir build
cd build
cmake .. -DCMAKE_INSTALL_PREFIX:STRING="/opt/local" -DCMAKE_C_FLAGS:STRING="-O2"
make
sudo make install

Building

If you installed the dependencies using MacPorts, you’ll need to have /opt/local/bin in your $PATH before you can execute make. If you’re using Bash, the MacPorts installer should have automatically edited your configuration.

Just run make debug and run bin/debug/OpenRaider for a debug build. make release builds a release binary. make bundle creates a Mac App Bundle that also runs the setup script, if necessary. make bundle-image packs the App Bundle into a DMG ready for distribution.

Usage

See the original README.old file. In the Main Menu, <Esc> will allow you to select a level to play.

License

The included font, Droid Sans Mono, was created by Steve Matteson and is licensed under the Apache 2.0 License.

OpenRaider is based on code, specs, and alogrithms from:

  • GooseEgg/Freyja 3d Modelers by Mongoose
  • TR Rosetta Stone spec sheet by Anonymous
  • TRView 1.0.0 by Yuri Zhivago, with patches by Mongoose

All code should be GPLed, unless otherwise noted.

2013 Housekeeping by xythobuz.