==Overview==
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==
The current stable release, 1.65, can be downloaded at [http://oolite.org/download.shtml Oolite.org]. Test releases can be downloaded from [http://developer.berlios.de/project/showfiles.php?group_id=3577 the BerliOS project]. New releases are announced on [http://www.aegidian.org/bb/viewforum.php?f=8 the Oolite forum].

To install, run the executable that you have just downloaded. You will get the familiar Windows installer.

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 will run on Vista, so long as drivers are available for the hardware you have. Early reports show no problems with Windows 7. You are advised to run the latest 3D graphics drivers from your 3D card manufacturer.

===Important note for Vista users!===
With the Oolite default Windows location, Vista relocates files such that saved games and OXP add-ons malfunction and are hidden from casual observation.

<h5>Do Not Install Oolite in the Default Windows Directoy</h5>
Install Oolite to a non-default location such as C:\Oolite\ or C:\Games\Oolite\.

It is STRONGLY recommended NOT to use the default installation folder. To be complete, do not install Oolite along ANY path including the following:
* %ProgramFiles%
* %ProgramData%
* %SystemRoot%
This is because Vista virtualizes files in these locations for legacy processes. The Microsoft explanation is here: [http://technet.microsoft.com/en-us/magazine/2007.06.uac.aspx]. An Oolite user warning is here: [http://aegidian.org/bb/viewtopic.php?t=5610 here].

<h5>Recovering Your Commanders Saved Under Vista</h5>
If you have already installed Oolite on a Vista machine and wish to move your saved games to a new and safer file location, search for the string "oolite-save" and include system and hidden files. For example, the default commander could be found in the file named "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: it should be in C:\Program Files\Oolite. Vista users who have changed their installation folder as recommended above will need to look in the Oolite folder they created when they installed the game. 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.

===Notes for amd64 users===
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.

==Building Oolite from source==
'''Updated on 09 January 2009.'''

'''These are the latest instructions for building Oolite on Windows. Acknowledgments and thanks to Kaks for providing them:'''

'''Important note: It is recommended that all packages for Windows be installed in paths that do not contain spaces. The same recommendation applies for the Windows username of the account the build is performed from. There have been reports of MSYS/make problems in such cases.'''

# If you have an older version of GNUstep(GNUstep-base-1.11.1-gui-0.10.1-3 - from the wiki howto), uninstall it, then delete its root directory if it's still there(c:\GNUstep).
# Google & download the following 2 packages, and - this is important - install them in this sequence: http://ftpmain.gnustep.org/pub/gnustep/binaries/windows/gnustep-system-0.19.2-setup.exe, http://ftpmain.gnustep.org/pub/gnustep/binaries/windows/gnustep-core-0.19.2-setup.exe
# Google & download tortoiseSVN, install.
# You need to have installed the latest oolite test download (1.72.1-test atm). Also required is the dependencies file for Windows. Download Local_20090108.zip [ftp://ftp.alioth.net/oolite/Local_20090108.zip].
# Go to the Windows Start menu, navigate to and select ''Start>Programs>GNUstep>Shell''
# At the prompt :
## <code>mkdir /Local </code>
## <code>mkdir /Local/oolite </code>
## <code>mkdir /Local/oolite/trunk </code>. The first slash & the upper case L are very important!
# From windows, extract the directories inside Local_20080124.zip to <code>C:\GNUstep\Local </code>
# Still from windows go to <code>C:\GNUstep\Local\oolite\trunk </code>
# It's empty. Right click>SVN checkout. The repository is <code>svn://svn.berlios.de/oolite-linux/trunk </code>. Wait for it to finish.
# From inside the GNUstep shell
##<code>export PATH=$PATH:/Local/bin </code>
##<code>cd /Local/oolite/trunk </code>
##<code>make clean </code>
##<code>make </code>
At this point Ean - from the Oolite board - reports that
{| width="100%" style="border: 1px solid #cfcfbf; background-color: #f0f0ff; padding: .1em; cellpadding: 0; cellspacing: 0; color: #000000;"
|I had to add /Local/include to the include search path - dunno why but it works now.
|}

11. Now you need to rename oolite.debug and copy dll files around. Ean has provided a fixwin shell script to do that automatically. An updated - and hopefully problem free - version of that script is inside this zip file [http://wiki.alioth.net/images/3/3f/Fixwin.zip]. Once extracted, put the file in C:\GNUstep\Local\oolite\trunk\

If everything goes well, these are the last two lines you need to type to get the compiled oolite to run:

# <code>fixwin</code>
# <code>openapp oolite.app </code>

If you have a problem running fixwin, do the following instead:

12. Still inside the GNUstep shell, type <code>mv oolite.debug oolite.app </code>

13. Now copy all the dlls from your installed copy of oolite 1.72.1-test. Assuming that you installed it to the default directory, copy all dlls from <code>C:\Program Files\Oolite\oolite.app\</code> into <code>C:\GNUstep\Local\oolite\trunk\oolite.app </code>

14. Now you also need to copy all the dlls from <code>C:\GNUstep\Local\bin</code> to <code>C:\GNUstep\Local\oolite\trunk\oolite.app</code>. Overwrite all the duplicates.

15. We're now ready to launch the compiled oolite! From inside the GNUstep shell:
# <code>cd /Local/oolite/trunk </code>
# <code>openapp oolite.app </code>

''' The instructions below are valid only for versions prior to 1.70, only use them as an alternative if the updated ones fail for whatever reason.'''

# Download and install the necessary software
## Download and install svn for Windows: [http://subversion.tigris.org/project_packages.html#binary-packages]. Accept all defaults given by the installer.
## 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]. Accept all defaults given by the installer.
## Download the SDL files required to build Oolite: [http://prdownload.berlios.de/oolite-pc/Local.zip]
## Unzip this file to <code>c:\GNUstep\Local</code>
# Get the source and build it (note, the source comes from the oolite-linux project)
## Start the GNUstep command line (<i>Start -> Programs -> GNUstep Development -> MSYS for GNUstep</i>) and issue the following commands:
## <code>cd $GNUSTEP_LOCAL_ROOT</code>
## <code>export PATH=$PATH:$GNUSTEP_LOCAL_ROOT/bin</code>
## <code>mkdir oolite</code>
## <code>cd oolite</code>
## <code>svn checkout svn://svn.berlios.de/oolite-linux/trunk</code>
## <code>cd trunk</code>
## <code>make</code>
# To run the game in the build environment:
## Before running the first time: <code>cp $GNUSTEP_LOCAL_ROOT/bin/*.dll oolite.app</code>
## <code>openapp oolite.app</code>

Assuming you have installed one of Nic's releases as detailed above, you can easily keep updating the installation from the latest source. In the <code>$GNUSTEP_LOCAL_ROOT/oolite/trunk</code> directory, issue the commands:

# <code>export PATH=$PATH:$GNUSTEP_LOCAL_ROOT/bin</code>
# <code>svn up</code>
# <code>rm -rf oolite.app/Resources; make</code>

You only need to issue the export PATH command when you first start the command line. The rm -rf command before make is required because GNUstep for Windows cannot parse the XML plist file format, and the build fails when it tries to read one of these generated each time the build is performed. This failure is not important, and the process still works, but it is annoying.

Then use the following script to copy the new files over the existing installation:

<pre>
OA="/c/Program Files/Oolite/oolite.app"
cd $GNUSTEP_LOCAL_ROOT/oolite/trunk
if [ oolite.app/oolite.exe -nt "$OA/oolite.exe" ]; then
echo "Updating oolite.exe"
cp oolite.app/oolite.exe "$OA/oolite.exe"
fi

for a in AIs Config Images Models Music Sounds Textures; do
for b in Resources/$a/*; do
c=`basename $b`
if [ $b -nt "$OA/Contents/Resources/$a/$c" ]; then
echo "Updating with $b"
cp $b "$OA/Contents/Resources/$a/$c"
fi
done
done
</pre>

If you want to edit the source, Notepad++ has good Objective-C support and is free: [http://notepad-plus.sourceforge.net/]

Also see the Oolite-PC forum: [http://www.aegidian.org/bb/viewforum.php?f=8]

[[Category:Oolite]]