Installation: Difference between revisions

From Project Apollo - NASSP
Jump to navigation Jump to search
imported>Tschachim
(Linked config category.)
m (Mention that OrbiterSound 5.0 is technically optional but extremely recommended, and mention that it can occasionally cause crashes due to its hotkey combination.)
 
(31 intermediate revisions by 11 users not shown)
Line 1: Line 1:
{{Infobox | caption=Latest Downloads | text={{Latest_Downloads}} }}
{{Infobox | caption=Latest Downloads | text={{Latest_Downloads Extended}} }}


Project Apollo - NASSP is an ongoing project, many developers are working on lots of new features and enhancements. If you are interested in this development but aren't a developer, have no suitable compiler/IDE like Microsoft Visual C++ 6 or Visual Studio 2005 and just want to preview and test the new features you can now beta test Project Apollo.
Project Apollo - NASSP is an ongoing project, many developers are working on lots of new features and enhancements. If you are interested in this development you can now test the current version of Project Apollo.


== What's going on at the moment? ==
Since Project Apollo is an open source project and all developers are working for free in their spare time we don't have project plans, schedules, or things like this. We coordinate the development by using our [https://www.orbiter-forum.com/forums/project-apollo-nassp.40/ forums]. So if you read the latest news you hopefully get all the necessary information you need to use Project Apollo. Of course every developer is happy to get feedback regarding his work to fix bugs and make improvements, so please do not hesitate to post in the forum if you discover something noteworthy.


Since Project Apollo is an open source project and all developers are working for free in their spare time we have no project plans, schedules or things like this. We coordinate the development by using our [http://www.ibiblio.org/mscorbit/mscforum/ forums]. So if you read the latest news you hopefully get all necessary informations you need to use and test Project Apollo. Of course every developer is happy to get feedback regarding his work to fix bugs and make improvements, so please do not hesitate to post in the forum if you discovered something noteworthy in the beta versions.
= NASSP 8.0 Beta =


== How do I start? ==
== Install Orbiter Beta ==


This section tries to provide step-by-step instructions to set up the "beta testing enviroment" for Project Apollo. You need to do the following steps only once. If you want to update your beta version read the "How do I update?" section below.
Follow this link: http://orbit.medphys.ucl.ac.uk/betainstall.html for instructions on how to install the beta version of Orbiter.


* Download and install the free CVS client [http://www.tortoisecvs.org TortoiseCVS]. You need this to get the current config files, meshes, textures etc. from the CVS server.  
Note: As of July 2021, Orbiter has become open source and further development has moved to GitHub. The above link explains how to install the last SVN snapshot before development moved (Orbiter Beta R90), but it is unknown how long this SVN repository will be maintained. An alternate way to download Orbiter Beta R90 would be provided, but redistribution of complete installation archives without permission is a violation of Orbiter's license.


* Make a new, empty folder on your local harddisc, you can choose the location and the name of the new folder as you like, in the following it is assumed that the folder is "C:\ProjectApollo".
IMPORTANT: At your discretion, you may follow the last step in the previous link to re-use the planet textures from another Orbiter 2016 directory. In this case, you must also copy the NASSP texture files to the other directory which will be outlined further down. Please skip the next step, "Installing High-Resolution Textures (Optional)", if you decide to do this.


* Right-click the new folder in your Windows Explorer and choose '''CVS Checkout...''' from the context menu.
== Installing High-Resolution Textures (Optional) ==
* Enter the following settings in the "Checkout Module" window:
** Protocol: Password server (:pserver:)
** Server: nassp.cvs.sourceforge.net
** Repository folder: /cvsroot/nassp
** User name: anonymous
** Module: projectApollo<BR><BR>After that your CVSROOT should look like this:<BR>''':pserver:anonymous@nassp.cvs.sourceforge.net:/cvsroot/nassp'''<BR><BR>


* Press "OK". TortoiseCVS downloads now the current version of the Project Apollo files to your computer. This will take some time...
Download high-resolution Earth & Moon textures: http://orbit.medphys.ucl.ac.uk/download.html


* After the checkout install Orbiter in your folder, that means in the example above the path of Orbiter is "C:\ProjectApollo\orbiter.exe". This includes the following files at the moment:<BR><BR>'''Orbiter 2006-P1 Edition''' (http://www.orbitersim.com)
Note: Do not select "Orbiter core package download" as you have already downloaded the latest Beta version in the previous step.
** orbiter060929_base.zip
** orbiter060929_sdk.zip<BR><BR>Optional:<BR>
**Earth060504_L10.zip
**Moon060504_L8.zip<BR>You can install every other Planetary extension package, too.<BR><BR><div style="margin-left: -1.5em;">'''OrbiterSound 3.0''' (http://orbiter.dansteph.com)</div>
** OrbiterSound30.exe<BR><BR><div style="margin-left: -1.5em;">Orbiter and OrbiterSound should not overwrite any of the CVS files.</div><BR>


* Now you have everything you need except the probably most important files, the modules. Please download and unzip the '''Modules Pack''' using the link at the top of this page. Make sure that the "Use Folders" option box is ticked/checked.<BR><BR>If you have a compiler/IDE you can build them for yourself, of course:
IMPORTANT: These high-resolution textures are extremely large, and will require around 30 GB of disk space for the Earth textures and around 15 GB of disk space for the Moon textures. Those with slow or metered internet connections may want to skip this step, as significant internet bandwidth is required. You may alternatively decide to only download one set of high-resolution textures, for Earth only or Moon only, to conserve disk space.
** You will find the Project Apollo workspace file for Microsoft Visual C++ 6.0 in the "ProjectApollo" source folder ("C:\ProjectApollo\Orbitersdk\samples\ProjectApollo\ProjectApollo.dsw"). All available projects are included in this workspace.
** You will find the Project Apollo solution file for Microsoft Visual Studio 2005 in the "ProjectApollo" source folder ("C:\ProjectApollo\Orbitersdk\samples\ProjectApollo\ProjectApollo2005.sln"). All available projects are included in this solution.<BR><BR>


* Download and unzip the latest '''Meshland Pack''' using the link at the top of this page in your beta testing folder. Make sure that the "Use Folders" option box is ticked/checked. CVS will ignore the new files. Start Orbiter, go to the "Modules" tab and activate the "MeshLand" module.<BR>
== Installing the Direct3D9 Graphics Client ==


* Start Orbiter, go to the "Parameters" tab and make sure that at least '''Complex flight model''' and '''Limited fuel''' are enabled. If you're using a Virtual AGC scenario, also enable '''Nonspherical gravity sources'''.<BR>
Go to http://users.kymp.net/~p501474a/D3D9Client/ to get the latest version of the client. Scroll down to "Additional Downloads", then "Downloads for Orbiter Beta". It is important to install the correct version of D3D9 for the Orbiter beta revision that you are using, which at the time of writing is R90. You must use the BETA version of the client, IE: "D3D9ClientBeta30.7-forBETA r90(r1436).zip" would correspond to Orbiter Beta revision 90.


* Go to the "Modules" tab and activate the '''ProjectApolloMFD''' and '''MeshLand''' modules.<BR>
Download and unzip the D3D9 client ZIP file into your Orbiter Beta installation folder.
 
Start "Orbiter_ng.exe" (NOT "Orbiter.exe") from your Orbiter installation folder. Go to the "Modules" tab on the left side of the window, and activate the "D3D9Client" module. The "Video" tab will appear. Configure the video settings as you like, they are quite similar to the usual Orbiter video settings. It is recommended to use "Full Screen Window" mode.
 
IMPORTANT: Click "Advanced" and check the box labeled "Enable absolute animation handling" to prevent animation drift happening in certain cases in the 3D virtual cockpit (VC). You can also configure the other options in that page to your liking. We also recommend setting Reflection Mode to "Full Scene" in order to get the best appearance out of the CM's reflective texture.
 
== Installing Surface Micro-Textures (Optional) ==
 
This step is optional, but highly recommended. Follow this link, and scroll down to "MicroTexture Pack for D3D9Client" and click the "Download" link: http://users.kymp.net/p501474a/Orbiter/Orbiter.html
 
Unzip the contents into your Orbiter directory.
 
== Installing the Apollo Landing Site packs (Optional) ==
 
Download "Apollo Landing Sites for Orbiter 2016" by ggalfi here: http://absimp.org/orbitersim/apollolandingsites.html
 
The scenery is breathtaking, but be aware there can sometimes be a mismatch between the visible terrain and the physical terrain in the Orbiter engine, so the LM can sometimes be floating above or sunken into the surface after landing. If you try and land exactly at the historical landing site, the mismatch should be minimal.
 
== Install OrbiterSound 5.0 ==
 
This step is technically optional, but it is <i>extremely recommended</i> as otherwise you will have no sound in Orbiter at all. However, be wary about doing things such as typing on your keyboard in another application while Orbiter is still running in the background; OrbiterSound has a non-configurable hotkey combination that can cause crashes if you're not careful.
 
OrbiterSound 5.0 can be found at the following link: http://orbiter.dansteph.com/forum/index.php?page=download
Run the installer, and when installation is complete, open "Orbiter_ng.exe" and activate the module in Orbiter "Modules" tab, like you did when activating the D3D9 client. You can also run the newly-installed "SoundConfig.exe" application to adjust settings to your liking.
 
== Install NASSP 8.0 Beta ==
 
Download the latest beta build of NASSP at this link: https://github.com/orbiternassp/NASSP/releases
 
Unzip this into your Orbiter directory.
 
IMPORTANT: If you are re-using a texture directory from another Orbiter installation (as outlined in step 1), copy the "Textures/ProjectApollo" folder over to the actual Texture directory that is being used by your Orbiter Beta/NASSP installation. For example, if your Orbiter Beta installation is borrowing its textures from an installation of Orbiter 2016, then you would copy your "Textures/ProjectApollo" folder into your Orbiter 2016 installation folder. Also note that this step should be repeated every time you update to a new version of NASSP that includes a change in textures.
 
== Configure NASSP ==
 
Start "Orbiter_ng.exe", go to the "Parameters" tab and make sure that at least "Complex flight model", "Limited fuel" and "Nonspherical gravity sources" are enabled.
 
Note: At this time, it is recommended to leave "Gravity-gradient torque" and "Atmospheric wind effects" disabled as in some occasions they can cause crashes with NASSP.
 
Go to "Visual effects" tab and configure them to your liking. Make sure to check the box for "surface elevation", and use "Linear" interpolation in order to not have the landed LM seem sunken into/floating over the lunar terrain. You can also check "Particle streams" to see the various particle/dust effects in NASSP, and "Local light sources" for the night-time launch pad lighting.
 
Go to the "Modules" tab and activate the "ProjectApolloMFD" and "ApolloRTCCMFD" modules.
 
Go to the "Extras" tab, open the "Vessel configuration" section, and double-click "Project Apollo Configuration". If you have a joystick, this is where you can configure your joystick for use in NASSP. Do not use the normal Orbiter "Joystick" controls page to configure your joystick, there it should be <Disabled>. In the "Miscellaneous" section of the Project Apollo Configuration window, make sure "Multi-Threading in time acceleration" is checked, for performance reasons. It is also recommended to set a maximum limit for time acceleration, NASSP runs best at 50x or less depending on the hardware you are using.
 
Congratulations, you should now have a fully-functional Orbiter Beta install with the latest beta release of NASSP 8.0! We hope you enjoy, and have fun flying!
 
== Updating to the latest beta release ==
 
Once installed, updating to the latest beta build is as easy as downloading the latest beta release ZIP file from the GitHub link at the top corner of this page, and unzipping its contents into your Orbiter installation folder.
 
IMPORTANT: If you are re-using a texture directory from another Orbiter installation (as outlined in step 1), and the new NASSP version includes texture changes, copy the "Textures/ProjectApollo" folder over to the actual Texture directory that is being used by your Orbiter Beta/NASSP installation. (Click yes to overwrite files)
 
= NASSP 7.0 Stable (Deprecated) =
 
This version of NASSP is several years old, having released in 2017. It is no longer actively maintained, but should remain perfectly usable if you desire a "stable" version of NASSP that will not change, at the cost of missing out on more recent improvements to simulation accuracy, etc. If you wish to upgrade from NASSP 7.0 to 8.0, it is highly recommended to perform a complete reinstall from scratch, following the instructions provided in the earlier "NASSP 8.0" section.
 
This section tries to provide step-by-step instructions to set up the Orbiter environment for Project Apollo. You need to do the following steps only once. If you want to update your installation read the "How do I update?" section below.
 
== Install Orbiter ==
 
If you have installed the latest Orbiter 2010 version already, you can use this installation for Project Apollo, of course. Otherwise you need to install Orbiter. This includes the following steps at the moment:<br><br>'''Orbiter 2010-P1 Edition'''
* Orbiter100830.zip/msi as explained here: http://www.orbiter-forum.com/download.php<br><br>Optional:
* Earth091124_11_14.zip
* Moon090730_L11.zip
 
'''OrbiterSound 4.0'''
* http://orbiter.dansteph.com/forum/index.php?page=download
 
Optional: '''High resolution surface tiles for the Kennedy Space Center'''
* [http://sourceforge.net/projects/nassp/files/Orbiter/KSC_HiRes_Tiles.zip/download KSC_HiRes_Tiles.zip]
 
== Installation Prerequisites ==
 
Install the '''[https://www.microsoft.com/en-us/download/details.aspx?id=48145 Microsoft VS C++ 2015 Redistributable (x86) Package]''' if it's not installed already.
 
 
== Install Project Apollo - NASSP ==
 
Follow the '''Modules Pack''' link at the top of this page download and unzip the first .zip file to your Orbiter installation folder. Make sure that the directory structure of the archive is retained, usually there's a "Use Folders" option box or similar, which should be ticked/checked.
 
Optionally, you can download and unzip the '''Source Code.zip''' the same way if you wish to have the source code that corresponds to the binary release.
 
== Optional, but recommended: Install the DirectX 9 client ==
 
The built-in (aka "inline") Orbiter graphics client is based on DirectX 7. Especially with Windows 7 computers and/or recent graphics adapter this client isn't working very well or in some cases isn't working at all. Fortunately there's an DirectX 9 client by [http://www.orbiter-forum.com/member.php?u=408 jarmonik] meanwhile, which is working great with Project Apollo. So it is strongly suggested to give it a try. You can get it from [http://www.orbiter-forum.com/showthread.php?t=18431&highlight=d3d9client this thread] in the Orbiter main forum or by following these instructions:
 
*  Install a recent Microsoft DirectX Runtime, for example by using the [http://www.microsoft.com/en-us/download/details.aspx?id=35 Microsoft DirectX End-User Runtime Web Installer].
 
* Download and unzip the [http://d3d9client.codeplex.com/ client] file to your Orbiter installation folder the same way as the Project Apollo files above.
 
* Start '''Orbiter_ng.exe''' (NOT Orbiter.exe) from your Orbiter installation folder.
 
* Go to the "Modules" tab and activate the "D3D9Client" module.
 
* The "Video" tab appears, configure the video settings as you like, they are quite similar to the usual Orbiter video settings. Do not change any settings you don't know/understand.
 
* Launch a build-in scenario in order to check if the client is running fine before you continue with the instructions below.
 
 
== Configure Project Apollo ==
 
* Start Orbiter ('''Orbiter_ng.exe''' in case you're using the DirectX 9 client), go to the "Parameters" tab and make sure that at least '''Complex flight model''', '''Limited fuel''', '''Gravity-gradient torque''' and '''Nonspherical gravity sources''' are enabled.
 
* Go to the "Modules" tab and activate the '''[[ProjectApolloMFD]]''' module.
 
* Optionally you can change some options with the '''[[Launchpad Configuration Options]]''' on the "Extra" tab.
 
* That's all, now you can try if Project Apollo is working properly. You'll find the proper scenarios in the '''"Project Apollo - NASSP" scenario folder'''. Please note that the scenarions in the "Broken Scenarios" subfolder are, well, broken.


* That all, now you can try if Orbiter and Project Apollo is working. You'll find the proper scenarios in the '''"Project Apollo - NASSP" scenario folder''' and subfolders.


== How do I update? ==
== How do I update? ==


To get the latest version of Project Apollo you don't have to do the initial checkout again but you have to a CVS update.
To update your Project Apollo installation you can repeat the steps above in [[Installation#Install_Project_Apollo_-_NASSP|Install Project Apollo - NASSP]].
 
* Choose the '''CVS Update''' menu item from the Tortoise context menu for each folder below "C:\ProjectApollo", i.e. "Config", "Doc", "Html" etc. CVS will download the changed files and merge the changes into your local copies.


* Download and unzip the latest '''Modules Pack''' (using the link at the top of this page).
== How can I track the development source and/or participate in development? ==


* If there's a newer version download and unzip the latest '''Meshland Pack''', too.
Please see the [http://www.ibiblio.org/mscorbit/mscforum/index.php?board=34.0 development area of the forums], specifically the [http://www.ibiblio.org/mscorbit/mscforum/index.php?topic=2864.0 git instructions thread].


==See Also==
==See Also==


* [[:Category:Scenario configuration|Configuration]]
* [[:Category:Scenario configuration|Configuration]]

Latest revision as of 03:22, 22 April 2022

Latest Downloads
Latest NASSP 8.0 beta

https://github.com/orbiternassp/NASSP/releases

The link opens the GitHub download page.
NASSP 7.0.1 modules (legacy, last updated May 13th, 2021)

Project-Apollo-NASSP-V7.0.1.zip

Project Apollo - NASSP is an ongoing project, many developers are working on lots of new features and enhancements. If you are interested in this development you can now test the current version of Project Apollo.

Since Project Apollo is an open source project and all developers are working for free in their spare time we don't have project plans, schedules, or things like this. We coordinate the development by using our forums. So if you read the latest news you hopefully get all the necessary information you need to use Project Apollo. Of course every developer is happy to get feedback regarding his work to fix bugs and make improvements, so please do not hesitate to post in the forum if you discover something noteworthy.

NASSP 8.0 Beta

Install Orbiter Beta

Follow this link: http://orbit.medphys.ucl.ac.uk/betainstall.html for instructions on how to install the beta version of Orbiter.

Note: As of July 2021, Orbiter has become open source and further development has moved to GitHub. The above link explains how to install the last SVN snapshot before development moved (Orbiter Beta R90), but it is unknown how long this SVN repository will be maintained. An alternate way to download Orbiter Beta R90 would be provided, but redistribution of complete installation archives without permission is a violation of Orbiter's license.

IMPORTANT: At your discretion, you may follow the last step in the previous link to re-use the planet textures from another Orbiter 2016 directory. In this case, you must also copy the NASSP texture files to the other directory which will be outlined further down. Please skip the next step, "Installing High-Resolution Textures (Optional)", if you decide to do this.

Installing High-Resolution Textures (Optional)

Download high-resolution Earth & Moon textures: http://orbit.medphys.ucl.ac.uk/download.html

Note: Do not select "Orbiter core package download" as you have already downloaded the latest Beta version in the previous step.

IMPORTANT: These high-resolution textures are extremely large, and will require around 30 GB of disk space for the Earth textures and around 15 GB of disk space for the Moon textures. Those with slow or metered internet connections may want to skip this step, as significant internet bandwidth is required. You may alternatively decide to only download one set of high-resolution textures, for Earth only or Moon only, to conserve disk space.

Installing the Direct3D9 Graphics Client

Go to http://users.kymp.net/~p501474a/D3D9Client/ to get the latest version of the client. Scroll down to "Additional Downloads", then "Downloads for Orbiter Beta". It is important to install the correct version of D3D9 for the Orbiter beta revision that you are using, which at the time of writing is R90. You must use the BETA version of the client, IE: "D3D9ClientBeta30.7-forBETA r90(r1436).zip" would correspond to Orbiter Beta revision 90.

Download and unzip the D3D9 client ZIP file into your Orbiter Beta installation folder.

Start "Orbiter_ng.exe" (NOT "Orbiter.exe") from your Orbiter installation folder. Go to the "Modules" tab on the left side of the window, and activate the "D3D9Client" module. The "Video" tab will appear. Configure the video settings as you like, they are quite similar to the usual Orbiter video settings. It is recommended to use "Full Screen Window" mode.

IMPORTANT: Click "Advanced" and check the box labeled "Enable absolute animation handling" to prevent animation drift happening in certain cases in the 3D virtual cockpit (VC). You can also configure the other options in that page to your liking. We also recommend setting Reflection Mode to "Full Scene" in order to get the best appearance out of the CM's reflective texture.

Installing Surface Micro-Textures (Optional)

This step is optional, but highly recommended. Follow this link, and scroll down to "MicroTexture Pack for D3D9Client" and click the "Download" link: http://users.kymp.net/p501474a/Orbiter/Orbiter.html

Unzip the contents into your Orbiter directory.

Installing the Apollo Landing Site packs (Optional)

Download "Apollo Landing Sites for Orbiter 2016" by ggalfi here: http://absimp.org/orbitersim/apollolandingsites.html

The scenery is breathtaking, but be aware there can sometimes be a mismatch between the visible terrain and the physical terrain in the Orbiter engine, so the LM can sometimes be floating above or sunken into the surface after landing. If you try and land exactly at the historical landing site, the mismatch should be minimal.

Install OrbiterSound 5.0

This step is technically optional, but it is extremely recommended as otherwise you will have no sound in Orbiter at all. However, be wary about doing things such as typing on your keyboard in another application while Orbiter is still running in the background; OrbiterSound has a non-configurable hotkey combination that can cause crashes if you're not careful.

OrbiterSound 5.0 can be found at the following link: http://orbiter.dansteph.com/forum/index.php?page=download Run the installer, and when installation is complete, open "Orbiter_ng.exe" and activate the module in Orbiter "Modules" tab, like you did when activating the D3D9 client. You can also run the newly-installed "SoundConfig.exe" application to adjust settings to your liking.

Install NASSP 8.0 Beta

Download the latest beta build of NASSP at this link: https://github.com/orbiternassp/NASSP/releases

Unzip this into your Orbiter directory.

IMPORTANT: If you are re-using a texture directory from another Orbiter installation (as outlined in step 1), copy the "Textures/ProjectApollo" folder over to the actual Texture directory that is being used by your Orbiter Beta/NASSP installation. For example, if your Orbiter Beta installation is borrowing its textures from an installation of Orbiter 2016, then you would copy your "Textures/ProjectApollo" folder into your Orbiter 2016 installation folder. Also note that this step should be repeated every time you update to a new version of NASSP that includes a change in textures.

Configure NASSP

Start "Orbiter_ng.exe", go to the "Parameters" tab and make sure that at least "Complex flight model", "Limited fuel" and "Nonspherical gravity sources" are enabled.

Note: At this time, it is recommended to leave "Gravity-gradient torque" and "Atmospheric wind effects" disabled as in some occasions they can cause crashes with NASSP.

Go to "Visual effects" tab and configure them to your liking. Make sure to check the box for "surface elevation", and use "Linear" interpolation in order to not have the landed LM seem sunken into/floating over the lunar terrain. You can also check "Particle streams" to see the various particle/dust effects in NASSP, and "Local light sources" for the night-time launch pad lighting.

Go to the "Modules" tab and activate the "ProjectApolloMFD" and "ApolloRTCCMFD" modules.

Go to the "Extras" tab, open the "Vessel configuration" section, and double-click "Project Apollo Configuration". If you have a joystick, this is where you can configure your joystick for use in NASSP. Do not use the normal Orbiter "Joystick" controls page to configure your joystick, there it should be <Disabled>. In the "Miscellaneous" section of the Project Apollo Configuration window, make sure "Multi-Threading in time acceleration" is checked, for performance reasons. It is also recommended to set a maximum limit for time acceleration, NASSP runs best at 50x or less depending on the hardware you are using.

Congratulations, you should now have a fully-functional Orbiter Beta install with the latest beta release of NASSP 8.0! We hope you enjoy, and have fun flying!

Updating to the latest beta release

Once installed, updating to the latest beta build is as easy as downloading the latest beta release ZIP file from the GitHub link at the top corner of this page, and unzipping its contents into your Orbiter installation folder.

IMPORTANT: If you are re-using a texture directory from another Orbiter installation (as outlined in step 1), and the new NASSP version includes texture changes, copy the "Textures/ProjectApollo" folder over to the actual Texture directory that is being used by your Orbiter Beta/NASSP installation. (Click yes to overwrite files)

NASSP 7.0 Stable (Deprecated)

This version of NASSP is several years old, having released in 2017. It is no longer actively maintained, but should remain perfectly usable if you desire a "stable" version of NASSP that will not change, at the cost of missing out on more recent improvements to simulation accuracy, etc. If you wish to upgrade from NASSP 7.0 to 8.0, it is highly recommended to perform a complete reinstall from scratch, following the instructions provided in the earlier "NASSP 8.0" section.

This section tries to provide step-by-step instructions to set up the Orbiter environment for Project Apollo. You need to do the following steps only once. If you want to update your installation read the "How do I update?" section below.

Install Orbiter

If you have installed the latest Orbiter 2010 version already, you can use this installation for Project Apollo, of course. Otherwise you need to install Orbiter. This includes the following steps at the moment:

Orbiter 2010-P1 Edition

OrbiterSound 4.0

Optional: High resolution surface tiles for the Kennedy Space Center

Installation Prerequisites

Install the Microsoft VS C++ 2015 Redistributable (x86) Package if it's not installed already.


Install Project Apollo - NASSP

Follow the Modules Pack link at the top of this page download and unzip the first .zip file to your Orbiter installation folder. Make sure that the directory structure of the archive is retained, usually there's a "Use Folders" option box or similar, which should be ticked/checked.

Optionally, you can download and unzip the Source Code.zip the same way if you wish to have the source code that corresponds to the binary release.

Optional, but recommended: Install the DirectX 9 client

The built-in (aka "inline") Orbiter graphics client is based on DirectX 7. Especially with Windows 7 computers and/or recent graphics adapter this client isn't working very well or in some cases isn't working at all. Fortunately there's an DirectX 9 client by jarmonik meanwhile, which is working great with Project Apollo. So it is strongly suggested to give it a try. You can get it from this thread in the Orbiter main forum or by following these instructions:

  • Download and unzip the client file to your Orbiter installation folder the same way as the Project Apollo files above.
  • Start Orbiter_ng.exe (NOT Orbiter.exe) from your Orbiter installation folder.
  • Go to the "Modules" tab and activate the "D3D9Client" module.
  • The "Video" tab appears, configure the video settings as you like, they are quite similar to the usual Orbiter video settings. Do not change any settings you don't know/understand.
  • Launch a build-in scenario in order to check if the client is running fine before you continue with the instructions below.


Configure Project Apollo

  • Start Orbiter (Orbiter_ng.exe in case you're using the DirectX 9 client), go to the "Parameters" tab and make sure that at least Complex flight model, Limited fuel, Gravity-gradient torque and Nonspherical gravity sources are enabled.
  • That's all, now you can try if Project Apollo is working properly. You'll find the proper scenarios in the "Project Apollo - NASSP" scenario folder. Please note that the scenarions in the "Broken Scenarios" subfolder are, well, broken.


How do I update?

To update your Project Apollo installation you can repeat the steps above in Install Project Apollo - NASSP.

How can I track the development source and/or participate in development?

Please see the development area of the forums, specifically the git instructions thread.

See Also