Difference between revisions of "FreeSpace Open Installer"

From FreeSpace Wiki
Jump to: navigation, search
(installer does not work)
(some updates to JR2's old guide)
Line 1: Line 1:
Turey's FreeSpace Open Installer is currently the only official online installer for FS2_Open.
+
The FreeSpace Open Installer is currently the only official online installer for FS2_Open.  The Installer was originally written by Turey, and then completely rewritten by Goober5000.  The source code is hosted by the [[SCP]].
  
The programs web page is [http://www.fsoinstaller.com/ here]
+
The program's web page is [http://www.fsoinstaller.com/ here].
 
 
'''WARNING:''' The Installer currently does not work. Use the [[Getting_started#Manual_installation|manual installation]].
 
  
 
== Features ==
 
== Features ==
 
The most recent Installer includes:
 
The most recent Installer includes:
  
* FreeSpace Open 3.6.10 Final (regular and debug)
+
* FreeSpace Open 3.7.0 Final (regular and debug)
* FRED2 Open 3.6.10 Final (regular and debug)
+
* FRED2 Open 3.7.0 Final (regular and debug)
* Launcher 5.5e
+
* Launcher 5.5g
 
* Linux 32-bit and 64-bit Executables
 
* Linux 32-bit and 64-bit Executables
 
* Mac Executables
 
* Mac Executables
* Soulstorm's OSX Launcher
 
* fs2open_pxo.cfg
 
 
* The OpenAL Installer (optional)
 
* The OpenAL Installer (optional)
* 3.6.10 MediaVPs (note that you will still have to dwnload the patch for the mediavps separately, can be found at http://freespacemods.net/files/MVP3610/3610_Patch.zip )
+
* 3.6.12 MediaVPs
 
* .OGG Cutscenes
 
* .OGG Cutscenes
 
* Derelict SCP Version (With optional voice)
 
* Derelict SCP Version (With optional voice)
* Just Another Day 1 & 2 (separate options for each)
 
 
* FreeSpace Port
 
* FreeSpace Port
 
* Silent Threat: Reborn
 
* Silent Threat: Reborn
* Awakenings
 
 
* Homesick
 
* Homesick
 
* Transcend
 
* Transcend
 
* Sync
 
* Sync
 
Source:
 
[http://www.hard-light.net/forums/index.php/topic,42854.0.html Original thread by Turey]
 
  
 
== Walkthrough installing ==
 
== Walkthrough installing ==
 
<!-- Someone help me clean this up -->
 
<!-- Someone help me clean this up -->
* ''Based off the walkthrough available [http://www.hard-light.net/forums/index.php/topic,47045.0.html here]''
 
  
 
This Installer is known to work on Windows, Linux (tested on OpenSuse, Gentoo and Fedora, should work on others), and Mac (OSX Panther, with a hacked install of Java 1.5)
 
This Installer is known to work on Windows, Linux (tested on OpenSuse, Gentoo and Fedora, should work on others), and Mac (OSX Panther, with a hacked install of Java 1.5)
Line 45: Line 35:
 
* It automatically takes you to the download page of the most recent version if your version is out of date.
 
* It automatically takes you to the download page of the most recent version if your version is out of date.
 
* It checks that all the files are up-to-date.
 
* It checks that all the files are up-to-date.
* This Install process downloads about 3.5 GB of data, if you download everything.  Just so you can prepare; for example, you could set it to download overnight.
+
* This install process downloads several GB of data, if you download everything.  Just so you can prepare; for example, you could set it to download while you are working on something else.
  
 
=== Download Links ===
 
=== Download Links ===
* [http://www.fsoinstaller.com/files/installer/FreeSpaceOpenInstaller.zip Windows Installer (Zipped .exe, 19 MB)] (Doesn't need Java, get this one if you are unsure and are using Windows)]: Works with Windows without having to use Java.  20 MB in size.  Download it, open it, then skip to the "Using the Installer" section.
+
* [http://www.fsoinstaller.com/files/installer/FreeSpaceOpenInstaller.jar fsoinstaller.com]
--this one is "easy" for Windows users.  Not that the .JAR version is hard... but if you've never used the Control Panel before, and don't intend to, then use this option.
+
* [http://scp.indiegames.us/installer/FreeSpaceOpenInstaller.jar scp.indiegames.us]
* [http://www.fsoinstaller.com/files/installer/java/FreeSpaceOpenInstaller.jar Win/Linux/Mac Installer (.jar, 26 KB)] (Requires Java 1.5): Works with Windows, Linux, and Mac20 KB in size.  Requires Java version 1.5 or higher.  See "For Java" section, below.
+
 
--this one is cross-platform.  It's also exactly the same as the .EXE version, except that it requires JAVA, and possibly using the Command Prompt. Don't worry; I have instructions...
+
Both links contain the same installerThe program requires Java version 1.5 or higher, and can be run on any operating system that can run a compatible version of Java.
* You can also get the Installer [http://www.fsoinstaller.com/files/installer/java/ source code here.]
+
 
 +
You can also get the source code from the SCP's SVN repository at svn://svn.icculus.org/fs2open/trunk/fsoinstaller.
  
 
=== Install procedure ===
 
=== Install procedure ===
Line 60: Line 51:
 
# Do the same thing for disk 3.
 
# Do the same thing for disk 3.
 
# If you ONLY have the FS2 disks, then put [http://www.fsoinstaller.com/files/installer/installedversions.txt this file] (right-click Save Target/Link As) in C:\Games\FreeSpace2\Installer\ (create this folder if it doesn't exist)  If you have BOTH the FS1 and FS2 disks, skip to the next step.
 
# If you ONLY have the FS2 disks, then put [http://www.fsoinstaller.com/files/installer/installedversions.txt this file] (right-click Save Target/Link As) in C:\Games\FreeSpace2\Installer\ (create this folder if it doesn't exist)  If you have BOTH the FS1 and FS2 disks, skip to the next step.
# If you don't have the Descent: FreeSpace a.k.a. Conflict: FreeSpace (aka FS1) Disks, then skip to step 10.  If you do, insert disk 1 in your CD drive.  Copy all of the files with the extension of ".MVE" from the disk directory \Data\movies\ to the folder C:\Games\FreeSpace2\fsport\data\movies\ (create this folder if it doesn't exist)
+
# If you don't have the Descent: FreeSpace a.k.a. Conflict: FreeSpace (aka FS1) Disks, then skip to the last step.  If you do, insert disk 1 in your CD drive.  Copy all of the files with the extension of ".MVE" from the disk directory \Data\movies\ to the folder C:\Games\FreeSpace2\fsport\data\movies\ (create this folder if it doesn't exist)
 
# Do the same thing for disk 2.
 
# Do the same thing for disk 2.
 
# If you ONLY have the Conflict: FreeSpace a.k.a. Descent: FreeSpace (aka FS1) disks (and not the FS2 disks), put [http://www.geocities.com/joshuap_richards/Installer_FS1/installedversions.txt this file] (right-click, Save Target/Link As) in C:\Games\FreeSpace2\Installer (create this folder if it doesn't exist)  If you have BOTH the FS1 and FS2 disks, then skip to the next step.
 
# If you ONLY have the Conflict: FreeSpace a.k.a. Descent: FreeSpace (aka FS1) disks (and not the FS2 disks), put [http://www.geocities.com/joshuap_richards/Installer_FS1/installedversions.txt this file] (right-click, Save Target/Link As) in C:\Games\FreeSpace2\Installer (create this folder if it doesn't exist)  If you have BOTH the FS1 and FS2 disks, then skip to the next step.
# If you have BOTH the FS1 and the FS2 disks, then put [http://www.geocities.com/joshuap_richards/Installer_both/installedversions.txt this file] (right-click, Save Target/Link As) in C:\Games\FreeSpace2\Installer (create this folder if it doesn't exist)
 
 
# Run the Installer, under the "Installing the FreeSpace Open Installer" section, above.
 
# Run the Installer, under the "Installing the FreeSpace Open Installer" section, above.
  
 
==== Using the Installer ====
 
==== Using the Installer ====
 
 
# First window, click next.
 
# First window, click next.
# Press "Next" again, or click the big button to change the location for the FreeSpace 2 install.  (Don't, unless you have a reason to, eg, you really want another location or you've already installed Retail FS2 to a different directory than C:\Games\FreeSpace2 .)
+
# Press "Next" again, or click the big button to change the location for the FreeSpace 2 install.  (Don't, unless you have a reason to, e.g., you really want another location or you've already installed Retail FS2 to a different directory than C:\Games\FreeSpace2.)
 
# Make sure "Update Installed Sections Only" and "Say Yes to All" are not checked.  Then hit "Next".
 
# Make sure "Update Installed Sections Only" and "Say Yes to All" are not checked.  Then hit "Next".
 
# <!-- 4-6. -->If you are a Windows user, select everything, except for "Macintosh (Universal Binary) Executables", "Launcher for OS X", and the two "Linux Executables" sections. If you are a Mac user, select everything, except for "Windows Executables" and the two "Linux Executables" sections.
 
# <!-- 4-6. -->If you are a Windows user, select everything, except for "Macintosh (Universal Binary) Executables", "Launcher for OS X", and the two "Linux Executables" sections. If you are a Mac user, select everything, except for "Windows Executables" and the two "Linux Executables" sections.
 
# Wait for the Installer to finish (this may take a long time!).  You will know it is done when the "Next" button becomes black, instead of gray.
 
# Wait for the Installer to finish (this may take a long time!).  You will know it is done when the "Next" button becomes black, instead of gray.
 
When it becomes black, click it. This means the installation is finshed.
 
When it becomes black, click it. This means the installation is finshed.
# READ the NOTES!!!  They might contain important information. After you do, hit "Exit" (The notes are saved in the \FreeSpace2\Installer directory for later viewing.)
+
# READ the NOTES!!!  They might contain important information. After you do, hit "Exit".
 
# Hit the Close button on the Command Prompt Window.
 
# Hit the Close button on the Command Prompt Window.
  

Revision as of 21:52, 30 January 2014

The FreeSpace Open Installer is currently the only official online installer for FS2_Open. The Installer was originally written by Turey, and then completely rewritten by Goober5000. The source code is hosted by the SCP.

The program's web page is here.

Features

The most recent Installer includes:

  • FreeSpace Open 3.7.0 Final (regular and debug)
  • FRED2 Open 3.7.0 Final (regular and debug)
  • Launcher 5.5g
  • Linux 32-bit and 64-bit Executables
  • Mac Executables
  • The OpenAL Installer (optional)
  • 3.6.12 MediaVPs
  • .OGG Cutscenes
  • Derelict SCP Version (With optional voice)
  • FreeSpace Port
  • Silent Threat: Reborn
  • Homesick
  • Transcend
  • Sync

Walkthrough installing

This Installer is known to work on Windows, Linux (tested on OpenSuse, Gentoo and Fedora, should work on others), and Mac (OSX Panther, with a hacked install of Java 1.5)

First step is getting Retail FS2. You can buy it from either Good Old Games or off of eBay or something. Install it and the related patch, then get the FreeSpace Open Installer.

Requirements and Notes

You can update your installation by simply running the Installer again. It will download files that are out of date.

The Installer requires an internet connection to install. This is because:

  • It checks to see if it is out of date by pulling the number of the most recent version off of the web.
  • It automatically takes you to the download page of the most recent version if your version is out of date.
  • It checks that all the files are up-to-date.
  • This install process downloads several GB of data, if you download everything. Just so you can prepare; for example, you could set it to download while you are working on something else.

Download Links

Both links contain the same installer. The program requires Java version 1.5 or higher, and can be run on any operating system that can run a compatible version of Java.

You can also get the source code from the SCP's SVN repository at svn://svn.icculus.org/fs2open/trunk/fsoinstaller.

Install procedure

  1. Install FreeSpace 2 from your disks, if you haven't already. Install it to C:\Games\FreeSpace2. Then install the 1.2 patch.
  2. Now, put disk 2 of FreeSpace 2 back into your CD drive.
  3. Copy all the files with the extension of ".MVE" from the disk root directory ( \ ) to the folder C:\Games\FreeSpace2\data\movies\ (create this folder if it doesn't exist)
  4. Do the same thing for disk 3.
  5. If you ONLY have the FS2 disks, then put this file (right-click Save Target/Link As) in C:\Games\FreeSpace2\Installer\ (create this folder if it doesn't exist) If you have BOTH the FS1 and FS2 disks, skip to the next step.
  6. If you don't have the Descent: FreeSpace a.k.a. Conflict: FreeSpace (aka FS1) Disks, then skip to the last step. If you do, insert disk 1 in your CD drive. Copy all of the files with the extension of ".MVE" from the disk directory \Data\movies\ to the folder C:\Games\FreeSpace2\fsport\data\movies\ (create this folder if it doesn't exist)
  7. Do the same thing for disk 2.
  8. If you ONLY have the Conflict: FreeSpace a.k.a. Descent: FreeSpace (aka FS1) disks (and not the FS2 disks), put this file (right-click, Save Target/Link As) in C:\Games\FreeSpace2\Installer (create this folder if it doesn't exist) If you have BOTH the FS1 and FS2 disks, then skip to the next step.
  9. Run the Installer, under the "Installing the FreeSpace Open Installer" section, above.

Using the Installer

  1. First window, click next.
  2. Press "Next" again, or click the big button to change the location for the FreeSpace 2 install. (Don't, unless you have a reason to, e.g., you really want another location or you've already installed Retail FS2 to a different directory than C:\Games\FreeSpace2.)
  3. Make sure "Update Installed Sections Only" and "Say Yes to All" are not checked. Then hit "Next".
  4. If you are a Windows user, select everything, except for "Macintosh (Universal Binary) Executables", "Launcher for OS X", and the two "Linux Executables" sections. If you are a Mac user, select everything, except for "Windows Executables" and the two "Linux Executables" sections.
  5. Wait for the Installer to finish (this may take a long time!). You will know it is done when the "Next" button becomes black, instead of gray.

When it becomes black, click it. This means the installation is finshed.

  1. READ the NOTES!!! They might contain important information. After you do, hit "Exit".
  2. Hit the Close button on the Command Prompt Window.

OpenAL notes:

  1. If you don't have it, get OpenAL: (all users, Windows / Mac / Linux) Go to www.openal.org, and click on the "Downloads" link on the left.
  2. Get the correct version for your OS:

Windows users get "1.1 Installer for Windows" - Note: If you're using Windows, and you have nvopenal.dll or ctoal.dll in your Windows\System32 directory, then delete them and then install the newest version of OpenAL. These files are older versions, and will cause problems with the new install. Mac users get Installer for OS X. Linux users get the Binary RPM, or compile from the source code.

If you have any issues with the installation post here.