The main Oolite repository.
Objective-C C JavaScript Shell HTML Makefile Other
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
DebugOXP/Debug.oxp Bumps master branch version number to 1.87 (#277) Nov 4, 2017
Doc Updated external libraries source changes document and upped again Wi… Apr 26, 2018
Mac-specific @ 90eb952 Yet another import of Mac-specific submodule Oct 20, 2017
Oolite.xcodeproj Mac: Enable recommended warnings Jun 6, 2017
Resources Default shader small bug fix Aug 19, 2018
Schemata Weapon type could now be any string depending on what equipment is pr… Jan 17, 2015
debian Fixes to deb-package builds. Mar 15, 2011
deps Updated external libraries source changes document and upped again Wi… Apr 26, 2018
installers Linux installer (issue #300): Install/Uninstall scripts updated Jul 10, 2018
src Fixed shader gloss and ior uniforms overriding material definitions o… Aug 19, 2018
tests @ 03ff99d Turn priority queue ad-hoc test into unit test May 29, 2016
tools Incorporate Debian patch for icosmesh in other locales Sep 6, 2015
.absolute_gitmodules Add instructions to README.txt for using git Nov 10, 2013
.gitignore Mac: Suppress auto scheme creation in Xcode May 29, 2016
.gitmodules hangover from submodules thing Dec 3, 2013
.travis.yml Add Travis CI support May 29, 2016
Doxyfile Doxygen config file. Use "doxygen Doxyfile" to generate the Mar 14, 2015
GNUmakefile Windows Resources Addition & Manifest Embedding (#279) Dec 12, 2017
GNUmakefile.postamble As suggested in Debian patch, separate strip and debug options in build Sep 6, 2015
Makefile As suggested in Debian patch, separate strip and debug options in build Sep 6, 2015 Changed version number on downloads table. Oct 25, 2017
config.make Disabling FOV in-flight control. Apr 20, 2015
libjs.make Revert "Linux: Makefiles updates for github project tree" Oct 10, 2013

Build Status (Mac)

GitHub release

Windows Linux OSX
Github release Github release Github release
Github release Github release Github release
Github release
Github release

Oolite for all platforms can be built from this repository. Here is a quick guide to the source tree.

For end-user documentation, see and Elite Wiki.


  • debian: Files to enable automatic setup under Linux using dpkg (Debian package manager) tools
  • DebugOXP: Debug.oxp, the expansion pack that enables console support in debug and test release builds
  • deps
    • Cocoa-deps: Dependencies for Mac OS X
    • Cross-platform-deps: Dependencies for platforms other than Mac OS X
    • Linux-deps: Dependencies for Linux on x86 and x86_64 processors
    • URLs: URLs used for binary dependecies on Mac OS X
    • Windows-deps: Dependencies for Windows on x86 and x86_64 processors
  • Doc: Documentation (including user guides)
  • installers: Files used to create various installers
  • Mac-specific: Additional projects used only on Mac OS X
    • DataFormatters: Debugger configurations for Xcode
    • DebugBundle: Implements the Debug menu and in-app console
    • OCUnitTest: A small number of unit tests
    • Oolite-docktile: An embedded plug-in which implements the Oolite dock menu when Oolite is not running
    • Oolite-importer: A Spotlight importer to make saved games and OXPs searchable
  • Oolite.xcodeproj: The OS X Xcode project to build Oolite
  • Resources: Game assets and resource files for Mac and GNUstep application bundles
  • Schemata: Plist schema files for the OXP Verifier
  • src: Objective-C and C sources, incuding header files
    • BSDCompat: Support for BSDisms that gnu libc doesn't have (strl*)
    • Cocoa: Files that are only compiled on Mac OS X
    • Core: Files that are compiled on all platforms
    • SDL: Files that are only compiled for platforms that use SDL
  • tests: A mixed bag of test cases for manual testing and ad-hoc code tests.
  • tools: Various tools for preparing files, builds, releases etc.


On Mac OS X, you will need the latest version of Xcode from the App Store. Then double click on the Xcode project in the Finder, select one of the Oolite targets from the Scheme pop-up, and hit Build and Run (the play button in the toolbar).

For Windows, see the Oolite wiki:

On Linux, if you have the Debian package tools (installed by default with Debian and Ubuntu), use dpkg-buildpackage.

On Linux, BSD and other Unix platforms without dpkg tools, you will need to get GNUstep and SDL development libraries in addition to what is usually installed by default if you choose to install the development headers/libraries etc. when initially installing the OS. For most Linux distros, GNUstep and SDL development libraries come prepackaged - just apt-get/yum install the relevant files. You may also need to install Mozilla Spidermonkey (libmozjs). On others you may need to build them from source. In particular, you need the SDL_Mixer library, which doesn't always come with the base SDL development kit. Then just type make, or, if you're using GNU make, make -f Makefile. On some systems, such as Gentoo, you may need to run make -f Makefile OBJCFLAGS=-fobjc-exceptions.


On OS X, you can run from Xcode by clicking on the appropriate icon (or choosing 'Run' from the 'Product' menu). On Linux/BSD/Unix, in a terminal, type openapp oolite


The Oolite source is available from github. Use git clone to retrieve. Then git submodule update --init to fetch the various submodules.

If you've cloned the source from a forked repository instead, this may not work - due to relative directory paths in .gitmodules, git tries to download the submodules from the fork instead of the original oolite repository. A workaround is to copy the file .absolute_gitmodules onto .gitmodules, then perform the submodules init, then replace .gitmodules with the relative path version. eg, on Unix:

$ cp .absolute_gitmodules .gitmodules
$ git submodule update --init
$ git checkout -- .gitmodules

You should now have access to the submodules, without git complaining that .gitmodules has changed or including .gitmodules in pull requests.