Difference between revisions of "FreeSpace Open Installer"

From FreeSpace Wiki
Jump to: navigation, search
m (Reflect source code hosting via Git)
(6 intermediate revisions by 3 users not shown)
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]].
+
Instructions on creating an install.txt file are [[FSO Installer Text Files|here]]. These are only for modders who are ready to add their released mod or campaign to the installer's list of available mods to install.
  
== Features ==
+
A mirror monitor for the various mods can be found [https://dev.tproxy.de/fs2/mirrors/ here].
The most recent Installer includes:
 
 
 
* FreeSpace Open 3.6.10 Final (regular and debug)
 
* FRED2 Open 3.6.10 Final (regular and debug)
 
* Launcher 5.5e
 
* Linux 32-bit and 64-bit Executables
 
* Mac Executables
 
* Soulstorm's OSX Launcher
 
* fs2open_pxo.cfg
 
* 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 )
 
* .OGG Cutscenes
 
* Derelict SCP Version (With optional voice)
 
* Just Another Day 1 & 2 (separate options for each)
 
* FreeSpace Port
 
* Silent Threat: Reborn
 
* Awakenings
 
* Homesick
 
* Transcend
 
* Sync
 
 
 
Source:
 
[http://www.hard-light.net/forums/index.php/topic,42854.0.html Original thread by Turey]
 
 
 
== Walkthrough installing ==
 
<!-- 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)
 
 
 
First step is getting Retail FS2. You can buy it from either [http://www.gog.com 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 about 3.5 GB of data, if you download everything.  Just so you can prepare; for example, you could set it to download overnight.
 
  
 
=== 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/fsoinstaller/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 Mac.  20 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...
 
* You can also get the Installer [http://www.fsoinstaller.com/files/installer/java/ source code here.]
 
 
 
=== Install procedure ===
 
# Install FreeSpace 2 from your disks, if you haven't already. Install it to C:\Games\FreeSpace2.  Then install [http://www.pxo.net/files/fs21x-12.exe the 1.2 patch].
 
# Now, put disk 2 of FreeSpace 2 back into your CD drive.
 
# 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)
 
# 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 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)
 
# 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 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.
 
 
 
==== Using the Installer ====
 
 
 
# 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 .)
 
# 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.
 
# 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.
 
# 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.)
 
# Hit the Close button on the Command Prompt Window.
 
 
 
OpenAL notes:
 
# <!-- 10-11 --> 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.
 
# 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 [http://www.hard-light.net/forums/index.php/topic,47045.0.html here].
 
 
 
 
 
 
 
 
 
<!-- Old information  Parsing through this before deletion
 
 
 
The FreeSpace Open Installer is an attempt to significantly reduce the difficulty of installing FreeSpace Open over a Retail FreeSpace 2 installation. The Installer was coded by Turey, originally using the [http://nsis.sourceforge.net/Main_Page NSIS] scripting language, but was re-written in Java as of December 12, 2006. The first version was released on October 16, 2006, and the latest versions of the exe and the source code can be found at [http://www.fsoinstaller.com fsoinstaller.com].
 
 
 
More information about the Installer can be found on [http://www.hard-light.net/forums/index.php/topic,42854.0.html Hard Light Productions].
 
 
 
=Features=
 
The Installer is designed to be one-size-fits-all, so that dial-up users can have a small Installer that only installs the necessary files, while broadband users can have an Installer that downloads all the extras for them.
 
The Installer automatically checks to see if it is outdated, and will bring up the download page of the newest version if it is outdated.
 
The first version of the Installer included only the Executables and the MediaVPs. Since then, many other parts have been added and refined.
 
 
 
==FreeSpace Open Executables==
 
The Executables were originally packaged as part of the installer, which added about eight megabytes to the size of the Installer. However, as of the 3.6.9 - RC 7.9x version, the Executables have been taken out of the Installer file and are downloaded at runtime.
 
 
 
==OpenAL==
 
One of the most common problems people have installing FreeSpace Open is that they do not install OpenAL. From the first version, the Installer has had an option to download and run the OpenAL installer automatically. This feature has temporarily been disabled, but will be re-enabled in the future. In the meantime, you can get OpenAL [http://fs2source.warpcore.org/exes/latest/OpenALwEAX.exe here].
 
 
 
==MediaVPs==
 
The MediaVPs are a set of graphical enhancements to FreeSpace Open, created by the [http://www.hard-light.net/forums/index.php/board,120.0.html FreeSpace Upgrade Project]. These upgrades have been included since the first version, and as of version 3.6.9 - RC 7.9x, they use the Mod Installation System (see below).
 
 
 
==Mod Installation System==
 
The Mod Installation System is a feature that first made its appearance in version 3.6.9 - RC 7.9x. The system allows the creator(s) of a mod or campaign to include their work in the Installer, so that it can be downloaded and installed at the same time as FreeSpace Open. By interfacing with text files, the Installer can get the most recent files for each mod directly from that mod's web site. This allows mod creators to update their files at any time, without the need for a new release of the Installer.
 
 
 
Help with the Mod Installation System can be found at [http://www.fsoinstaller.com/modhelp.html fsoinstaller.com]
 
 
 
Mods and Campaigns currently included in the Installer can be found at [http://www.fsoinstaller.com fsoinstaller.com].
 
  
=Version History=
+
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.
Visit the [http://www.fsoinstaller.com/changelog.html changelog on www.fsoinstaller.com].
 
  
-->
+
You can access the source code from https://github.com/scp-fs2open/fsoinstaller.
  
 
[[Category:Source Code Project]]
 
[[Category:Source Code Project]]

Revision as of 04:18, 3 May 2015

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.

Instructions on creating an install.txt file are here. These are only for modders who are ready to add their released mod or campaign to the installer's list of available mods to install.

A mirror monitor for the various mods can be found here.

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 access the source code from https://github.com/scp-fs2open/fsoinstaller.