Last stable version

The latest release of Oolite is version 1.90, released 2020-08-30. This is the version recommended for playing the game.

Oolite Starter

OoliteStarter is a versatile, open-source tool that is designed to simplify the process of setting up and managing Oolite. It was created to assist users in configuring Oolite for various purposes, including gameplay, modding, and development. By streamlining the process, OoliteStarter helps users save time and effort, making it easier for them to enjoy the Oolite experience. Main features:

• Allows installations of the expansions from our new site oolite.space
• Visualizes the known interdependencies or conflicts of expansions
• Allows the sharing of expansion sets with other players - or your future self!
• Remembers which expansions were installed when playing/saving a game

Download OoliteStarter from GitHub.
Full details can be found on the wiki.
Discussions and suggestions on our forum.

OXP Developer releases

The main downloads are optimised for maximum in-game performance and are recommended for players. People wishing to develop expansion packs for the game are recommended to install the OXP Developer releases. The following extra features are enabled in these releases at the expense of performance.

• Debug OXP and Debug Console are supported.
  On all platforms, installing Debug.oxp enables support for external console applications using the Oolite debug console TCP protocol. This OXP is contained in Oolite test and dev releases.
  OoDebugConsole is an example of a cross-platform, python based, external console application. It contains a precompiled console for Linux, MacOS and Windows based computers, and the original python based console if you prefer the source.
• OXP Verifier functionality is included;
• OXP Deprecation warnings are enabled;
• Localization tools support is included;
• AI Graphviz support is included;
• Debug information is added. (e.g. AI stack, collision, dump target state, entities, memory usage, script tracing etc.);
• JS monitor support is enabled;
• The JS method takeSnapshot() is enabled;
• Time Acceleration Factor (TAF) is enabled;
• Shift-F displays FPS, entities, coordinates and TAF info;
• Sanity checks are included.

Pre-Releases

The next version of Oolite is being developed, with frequent changes. Pre-Releases of the latest source are available for testers.

Warning: these builds may at any time contain serious bugs, prototype features, and other unstable code. We do not recommend these for regular play, and you should take backups of your saved games before using them.

If you would like to try out the latest code, and give us feedback on the new features, then you can find the pre-released Oolite installer on Oolite GitHub.

Building from source

You can obtain the Oolite source from GitHub Source Code repo. Instructions on building from source depend on your operating system and can be found on the wiki. You can also inspect the Github Workflow build-all.yml that automatically builds Oolite for all supported platforms.

The beginning

You start the game with a Cobra III multi-role ship, and 100 credits in spare cash. The Cobra III is an excellent ship - or rather, it has the potential to be an excellent ship. The one you own is very under-equipped, lacking basic upgrades for both combat and peaceful activities.

Nevertheless, even right now, it still has some advantages over the average ship you'll meet:

1. It has decent shields and a substantial energy reserve.
2. It can carry four missiles, each of which - if used carefully - might save your life.
3. It's fast. You might not be able to outrun all attackers outright, but the longer you can run for, the more chance you have of finding help.

There are a lot of controls - most of the keys on a standard keyboard are used for something - but many of these won't be necessary at first. Read the readme that comes with the game, or use the 'Keyboard settings' option to get the basic controls, and play the Tutorial option when starting a new game to get some practice at basic flight, combat and navigation. as well as introductions to key ship systems.

If you are using a joystick, you can configure this by pressing 'F2' and selecting 'Game Options' while docked or in-flight while paused.

Whatever career you want to pursue, though, you'll need to get some money to upgrade your ship a bit.

Lave Station

You're currently docked at Lave Station. Similar stations orbit the primary inhabited world of all Cooperative systems, and have facilities for trading, upgrading your ship, and communicating with people who may wish to offer you a deal.

Lave is a 'Rich Agricultural' system, selling foodstuffs and other organic products relatively cheaply, and importing mechanical and electronic goods at a good price. The easiest way to make money, though not the most profitable in the long run, is to trade cargo containers between systems, on the principle of "buy low, sell high". For most trade goods, this means buying at an Agricultural world to sell at an Industrial one, or vice versa. Keep a record of the prices you see and you'll soon work out which the most profitable cargoes are.

Go to the F8 screen (Market) and load some appropriate goods into your ship (up and down arrows to select goods, left and right arrows to move them between your ship and the market)

Now go to the F6 screen (short range chart). This shows you all the nearby systems, with a green circle the limit of your fuel range. Pressing 'i' will replace the names with symbols showing the government type, economic type, and technological level of the systems. If you are unsure what a symbol means, then move the cursor with the arrow keys until it is over a system, then press F7 to go to the system data screen to get a full description.

Your ship is not yet well-equipped for combat, so you should if possible stick to the systems with safer governments - Corporate States, Democracies and Confederacies - until you have some better equipment. Anarchy and Feudal systems are especially dangerous and should be avoided until you have a well-equipped ship and combat experience. Even Lave - a Dictatorship - may not be particularly safe to return to.

Based on the government and economy data, you should be able to see some systems where the trade goods you have bought will make a profit in relative safety. Move the cursor to one to select it as your destination, then launch from the station with F1.

Orbital space

You will now be launched from Lave station. Ahead of you will be the planet Lave itself, and closer than that will be the navigation buoy for the station. Your first flight task is to pull up so that you don't run into the buoy.

Fly around the area of the station for a bit to get used to the controls. You'll notice that the station is rotating to generate artificial gravity, which means that docking can be a challenge. Your Cobra III is a wide but short ship - use 'v' to look at some external views, and then 'F1' to return to the forward view. To dock safely with a station, you need to be coming in from directly in front of the docking port, and with the port horizontal in front of you.

Now is a very good time to practice this. Fly out to near the buoy, then turn to face the station. Centre the docking port in your view, then fly in slowly, adjusting your course so that you can see all four inner walls of the docking port. Once you're close enough that the station is mostly filling your screen, start rolling your ship to align the port horizontally, then keep rolling slowly to match the rotation. Make sure you're still coming in on course, and you should get in safely. Your shields will protect you if you're a little off course, provided you're not going too fast.

Practice launching and docking a few more times, until you're confident that you know how to do it.

Going to a new system

The system you targeted earlier on the F6 screen should still be selected, so fly a little way from the station - its mass will interfere with the jump if it is too close - then press 'h' to activate the witchspace drive. This will count down for 15 seconds, during which you are recommended to fly as level as possible, and then if nothing goes wrong you will arrive in your destination system.

Ahead of you will be the planet, and somewhere around that will be an orbital station similar to the one you just left. On your HUD is a blue dial - the compass. The green dot nearly centred in it is the planet - practice turning, watching how the green dot moves, and then using the compass to find the planet again.

When you get close to the planet, the compass will change to point towards the station. The first step, however, is to get towards the planet. Turn to face the planet, accelerate to top speed, and get closer. If there are no other ships about, your status light will be green, and you can use the torus drive to move considerably faster - press 'j' to activate it, and 'j' again to turn it off.

You are unlikely to reach the planet without meeting someone - if you're lucky, and if you followed the advice about safe systems, this will be a trader, perhaps with some escort fighters, or a flight of police ships or bounty hunters, all of whom will ignore you for now if you don't cause trouble.

If you are unlucky, it will be a pirate or several, and you will need to run, surrender or fight. Pirates are after your cargo, so dumping a few cargo pods - press 'shift-D' - may get them to go after the cargo rather than you. Drop too much, of course, and you won't be making much of a profit.

Running is also a possibility - try to run towards the planet, if possible, as this increases your chance of reaching safety or meeting some police ships (purple dots on the scanner) who will attack the pirates.

Fighting, with your ship as weak as it is, should be a last resort at this stage, but if the group is small you may stand a chance. Take on the smallest ships first - they die more easily but can do just as much damage. Don't forget you can dump cargo to surrender if it goes badly.

If you fight, save your missiles if possible - the bigger pirate ships are likely to have counter-measure systems which will destroy them almost as soon as you launch them. However, these systems are indiscriminate, and will destroy pirate missiles too. Therefore, if a pirate launches a missile at you, launch one back! With any luck, both missiles will be destroyed, and you can keep fighting. If that doesn't work, well, your missile will probably get them. You now need to dodge and weave to avoid the enemy missile - you'll probably survive if it hits a full shield, but only just.

The second station

Eventually you will reach the planet, hopefully with most of your cargo still on board. Use the compass to locate the station, fly up to it, and dock like you practiced. Sell the cargo - for a profit, if you chose well! - and go to the F3 screen (equipment) to buy fuel, and perhaps replace missiles.

Congratulations - you've survived your first trip. Save the game, then start planning a second trading run! Trading is the easiest way to make a reasonable amount of money with your starting ship, but you'll soon have enough spare to buy equipment and take on other sorts of work.

Career options

Very few pilots stick entirely to one of these careers throughout their time in space - or even in just one trip, and other careers are also open to qualified pilots.

Trading

Traders make their money by buying goods from export systems and selling them at import systems, as you did above. The main requirement is a cargo hold - the bigger the better. Many of the best profits can be found in dangerous systems, so a ship which can defend itself or run away from trouble is also useful.

Certain illegal cargoes can fetch the highest profits, but will also attract significant attention from the police.

Mining

With a Mining Laser and Fuel Scoop fitted, it is possible to break asteroids down into manageable chunks, and then collect those chunks to sell as minerals. It's a slow way to make money, but it's usually fairly safe.

Piracy

The practice of attacking trade ships to intimidate them into dumping cargo - or worse, destroying the ship in the hope that its wreckage will contain something salvageable - is illegal throughout Cooperative space, but the profits which can be achieved cause many pilots to engage in it regardless of the law.

Bounty hunting

Smugglers, pirates and other criminals will have a bounty placed on their craft by the Cooperative. Destruction of their ship will pay this bounty to their attacker, and many pilots use this as their main source of income.

Courier work

People often need to be in a different system, or have small parcels to be transported elsewhere, and are willing to pay a significant amount for this service. A passenger service requires passenger cabins to be fitted, but parcels can be kept in your safe. Remember that some people wishing to travel may have enemies - couriers tend to favour fast well-armed ships for their work.

Salvage / rescue

The aftermath of a battle often leaves cargo containers and escape capsules floating in space. Recovering these with a fuel scoop can give a significant profit - escape capsules can have rewards of up to 500 credits for their safe return.