Difference between revisions of "Running Oolite-Windows"
(→Building Oolite from source) |
Cholmondely (talk | contribs) m (Tagged as Help page) |
||
| (82 intermediate revisions by 15 users not shown) | |||
| Line 1: | Line 1: | ||
==Overview== |
==Overview== |
||
| − | The Windows port of Oolite is still an alpha test version and there is still some work to do before the whole game functions as designed. However, the test versions are getting close to supporting the core game functions found on Mac OS X and Linux/Unix versions. Windows users need to remember they are using a '''testing release''' and therefore expect bugs or missing functionality. |
||
| + | The Windows port of Oolite is built from the same source as the [[Running Oolite-Mac|Mac OS X]] and [[Running Oolite-Linux|Linux]] versions, and has all the features of those versions. |
||
| + | |||
| + | All OXPs should be compatible with the Windows port. |
||
==Getting and installing the game== |
==Getting and installing the game== |
||
| − | The game may be downloaded from [http://nic.dnsalias.com/]. The most recent version is currently [http://nic.dnsalias.com/oolite-1.63gusto-r305-alpha20060310-win32.exe]. |
||
| + | |||
| + | The latest recommended release, 1.88 can be downloaded from [http://www.oolite.org/download/ Oolite.org]. |
||
| − | To install, run the |
+ | To install, run the installer that you have just downloaded. |
| − | Note that the installer was mirrored on alioth.net, but this site has not kept up to date with the later builds. |
||
| + | The game has been tested on Windows Vista SP2, 7, 8, 8.1 and 10. This game uses OpenGL, and you are advised to run the latest 3D graphics drivers from your 3D card manufacturer. |
||
| − | A regular build of changes from the SVN source is being carried out on a regular basis. The complete installer above must be installed before any of the updates will work. The update filename changes with each build, so get the latest update file by following the link here: [http://aegidian.org/bb/viewtopic.php?t=1529]. |
||
| + | '''It will not run on the DOS-extender versions of Windows''' such as Windows 95, 98 or ME. |
||
| − | The game has been tested on Windows XP and Windows 2000. '''It will not run on the DOS-extender versions of Windows''' such as Windows 95, 98 or ME. It is expected it will run with Vista, so long as drivers are available for the hardware you have. You are advised to run the latest 3D graphics drivers from your 3D card manufacturer. |
||
| + | '''For Windows XP, the last version compatible with the OS is 1.84.''' |
||
| + | ===Important note for Vista users!=== |
||
| + | <h5>Summary:</h5> |
||
| + | DATA LOSS and OXP MALFUNCTION can appear if you install an early version of Oolite (1.65 - 1.72.x) on Vista. '''Oolite 1.73 and later releases have corrected this issue''' by using a different default installation directory, instead of one inside program files, as before. |
||
| − | ===Errata=== |
||
| + | <h5>Do This</h5> |
||
| − | There was a problem in the 1.62 build that caused memory exhaustion. [http://www.aegidian.org/bb/viewtopic.php?t=1416 Please read this page] to find out how to manually patch the Windows installation. |
||
| + | When asked by the installer, change the Oolite install directory to a different location, one outside C:\Program Files\, like |
||
| + | * C:\Oolite\ |
||
| + | * C:\Games\Oolite\ |
||
| + | etc. |
||
| − | ==Running the game== |
||
| + | <h5>Don't Do This</h5> |
||
| − | Find the Oolite icon in the Start -> Programs menu and click on it. Alternatively double click the Oolite program icon on the desktop. |
||
| + | It is STRONGLY recommended NOT to use the folder C:\Program Files\Oolite\ or any path including the following: |
||
| + | * %ProgramFiles% |
||
| + | * %ProgramData% |
||
| + | * %SystemRoot% |
||
| − | ===Installing OXPs=== |
||
| + | <h5>Why?</h5> |
||
| − | You will need to find where the oolite.app folder is placed: it should be in C:\Program Files\Oolite. Create an AddOns folder beside the oolite.app folder. Put OXPs in here. Note that some OXPs when unzipped contain a folder with a README file and then the OXP - in this case, it's best to unzip the OXP somewhere other than AddOns and copy the OXP folder once unpacked into AddOns. |
||
| + | Vista rearranges some files outside the Oolite folder structure without visible alias/redirects, which completely hides all saved games and causes some OXP add-ons to malfunction. This is because Vista virtualizes files in those locations for legacy processes. You can read more about this problem on [http://aegidian.org/bb/viewtopic.php?t=5610 this Oolite forum thread]. The Microsoft explanation is here: [http://technet.microsoft.com/en-us/magazine/2007.06.uac.aspx]. |
||
| − | ===Notes for amd64 users=== |
||
| + | <h5>Recovering Your Commanders Saved Under Vista</h5> |
||
| − | No builds for 64-bit versions of Windows have yet been made, however, given the proper availability of graphics and sound drivers, the 32-bit version should run on 64-bit Windows. 32 bit Windows running on amd64 hardware should not have an issue. |
||
| + | If you have already installed Oolite on a Vista machine and wish to move your saved games to a new and safer file location: |
||
| + | * Examine location C:\Users\[username]\AppData\Local\VirtualStore\Program Files\Oolite\oolite.app\oolite-saves\ |
||
| + | or |
||
| + | * Use Windows Explorer to search for the string " *.oolite-save " with the Windows search option "''include system and hidden files''" checked (turned on). |
||
| − | ==Building Oolite from source== |
||
| − | Download and install GNUstep for windows: [ftp://ftp.gnustep.org/pub/gnustep/binaries/windows/base-1.11.1-gui-0.10.1/GNUstep-base-1.11.1-gui-0.10.1-3.exe] |
||
| − | Download the SDL files required to build Oolite: [http://prdownload.berlios.de/oolite-pc/Local.zip] |
||
| + | For example, the default commander, if saved, might be found in this path: |
||
| + | C:\Users\[username]\AppData\Local\VirtualStore\Program Files\Oolite\oolite.app\oolite-saves\Jameson.oolite-save |
||
| − | Unzip this file to $GNUSTEP_LOCAL_ROOT (c:\GNUstep\Local for a default GNUstep installation) |
||
| + | ==Running the game== |
||
| + | Find the Oolite icon in the Start -> Programs menu and click on it. Alternatively double click the Oolite program icon on the desktop. Note that the following key combination will get you out of 'graphics related trouble': |
||
| − | Start the GNUstep command line (Start -> Programs -> GNUstep Development -> msys) and issue the following commands: |
||
| + | Shift-Escape: Quit Oolite immediately |
||
| − | cd $GNUSTEP_LOCAL_ROOT |
||
| + | If your game seems to have unreasonably low fps performance (check this in-game by hitting SHIFT-F) it is strongly recommended you visit your graphic cards' suppliers website and download and install the latest drivers. |
||
| − | export PATH=$PATH:$GNUSTEP_LOCAL_ROOT/bin |
||
| + | ===Installing OXPs=== |
||
| + | You will need to find where the oolite.app folder is placed: versions 1.65 to 1.72.x should default to C:\Program Files\Oolite, later versions default install is C:\Oolite, to avoid clashes with Vista's virtual folders feature(see above). Create an AddOns folder beside the oolite.app folder. Put OXPs in here. '''NB:''' most OXPs zip files contain a folder with a README file and the actual OXP directory (somename.oxp) as a sub-folder - in this case, it's best to unzip the OXP somewhere else and then copy the unpacked .oxp folder into AddOns. |
||
| − | mkdir -p oolite/trunk |
||
| + | ===Notes for amd64 users=== |
||
| − | |||
| + | 64-bit builds of Oolite for Windows are available and the development environment used defaults to 64-bit executables generation. They are the recommended ones for 64-bit OSes. However, the 32-bit version should run on 64-bit Windows without issues as well. |
||
| − | cd oolite/trunk |
||
| − | |||
| − | svn checkout svn://svn.berlios.de/oolite-linux/trunk |
||
| − | |||
| − | make |
||
| − | See the Oolite-PC forum: [http://www.aegidian.org/bb/viewforum.php?f=8] |
||
| + | ==Building from Source== |
||
| + | [[Developing_Oolite#On_Windows]] |
||
| − | [[Category:Oolite]] |
+ | [[Category:Oolite]] [[Category:Help pages]] |
| + | [[Category:Factual]] |
||
Latest revision as of 23:58, 12 July 2021
Contents
Overview
The Windows port of Oolite is built from the same source as the Mac OS X and Linux versions, and has all the features of those versions.
All OXPs should be compatible with the Windows port.
Getting and installing the game
The latest recommended release, 1.88 can be downloaded from Oolite.org.
To install, run the installer that you have just downloaded.
The game has been tested on Windows Vista SP2, 7, 8, 8.1 and 10. This game uses OpenGL, and you are advised to run the latest 3D graphics drivers from your 3D card manufacturer.
It will not run on the DOS-extender versions of Windows such as Windows 95, 98 or ME.
For Windows XP, the last version compatible with the OS is 1.84.
Important note for Vista users!
Summary:
DATA LOSS and OXP MALFUNCTION can appear if you install an early version of Oolite (1.65 - 1.72.x) on Vista. Oolite 1.73 and later releases have corrected this issue by using a different default installation directory, instead of one inside program files, as before.
Do This
When asked by the installer, change the Oolite install directory to a different location, one outside C:\Program Files\, like
- C:\Oolite\
- C:\Games\Oolite\
etc.
Don't Do This
It is STRONGLY recommended NOT to use the folder C:\Program Files\Oolite\ or any path including the following:
- %ProgramFiles%
- %ProgramData%
- %SystemRoot%
Why?
Vista rearranges some files outside the Oolite folder structure without visible alias/redirects, which completely hides all saved games and causes some OXP add-ons to malfunction. This is because Vista virtualizes files in those locations for legacy processes. You can read more about this problem on this Oolite forum thread. The Microsoft explanation is here: [1].
Recovering Your Commanders Saved Under Vista
If you have already installed Oolite on a Vista machine and wish to move your saved games to a new and safer file location:
- Examine location C:\Users\[username]\AppData\Local\VirtualStore\Program Files\Oolite\oolite.app\oolite-saves\
or
- Use Windows Explorer to search for the string " *.oolite-save " with the Windows search option "include system and hidden files" checked (turned on).
For example, the default commander, if saved, might be found in this path:
C:\Users\[username]\AppData\Local\VirtualStore\Program Files\Oolite\oolite.app\oolite-saves\Jameson.oolite-save
Running the game
Find the Oolite icon in the Start -> Programs menu and click on it. Alternatively double click the Oolite program icon on the desktop. Note that the following key combination will get you out of 'graphics related trouble':
Shift-Escape: Quit Oolite immediately
If your game seems to have unreasonably low fps performance (check this in-game by hitting SHIFT-F) it is strongly recommended you visit your graphic cards' suppliers website and download and install the latest drivers.
Installing OXPs
You will need to find where the oolite.app folder is placed: versions 1.65 to 1.72.x should default to C:\Program Files\Oolite, later versions default install is C:\Oolite, to avoid clashes with Vista's virtual folders feature(see above). Create an AddOns folder beside the oolite.app folder. Put OXPs in here. NB: most OXPs zip files contain a folder with a README file and the actual OXP directory (somename.oxp) as a sub-folder - in this case, it's best to unzip the OXP somewhere else and then copy the unpacked .oxp folder into AddOns.
Notes for amd64 users
64-bit builds of Oolite for Windows are available and the development environment used defaults to 64-bit executables generation. They are the recommended ones for 64-bit OSes. However, the 32-bit version should run on 64-bit Windows without issues as well.
