Difference between revisions of "FreeSpace Open Installer"

From FreeSpace Wiki
Jump to: navigation, search
(Installer works on OpenSuse Linux)
m (Reflect source code hosting via Git)
(26 intermediate revisions by 13 users not shown)
Line 1: Line 1:
You can use the excellent installer by Turey, that should give you a baseline of everything you need to play. The rest of this guide is full of information if you want to start tweaking things, or tackle things manually. However, for most players, you can stop with this step.
+
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 [http://www.fsoinstaller.com/ here].
  
[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)
+
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.
  
 +
A mirror monitor for the various mods can be found [https://dev.tproxy.de/fs2/mirrors/ here].
  
[http://www.fsoinstaller.com/files/installer/java/FreeSpaceOpenInstaller.jar Win/Linux/Mac Installer (.jar, 26 KB)] (Requires Java 1.5)
+
=== Download Links ===
 +
* [http://www.fsoinstaller.com/files/installer/FreeSpaceOpenInstaller.jar fsoinstaller.com]
 +
* [http://scp.indiegames.us/fsoinstaller/FreeSpaceOpenInstaller.jar scp.indiegames.us]
  
 +
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.
  
You can also get the Installer [http://www.fsoinstaller.com/files/installer/java/ source code here.]
+
[[Category:Source Code Project]]
 
 
For a walkthrough on using the Installer, click [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)
 
 
 
The most recent Installer includes:
 
 
 
* Retail Freespace 2
 
* FreeSpace Open 3.6.9 Final (regular and debug)
 
* FRED2 Open 3.6.9 Final (regular and debug)
 
* Launcher 5.5a
 
* launcher6.ini
 
* Mac Executables
 
* Soulstorm's OSX Launcher
 
* fs2open_pxo.cfg
 
* The OpenAL Installer (optional)
 
* 3.6.8 Zeta MediaVPs (optional, includes the 710 patches)
 
* 3.6.8 Zeta adveffects (only for those with high-power systems, requires regular MediaVPs, includes 710 patch)
 
* .OGG Cutscenes
 
* Derelict SCP Version (With optional voice)
 
* Just Another Day 1 & 2 (separate options for each)
 
* FreeSpace Port
 
* Awakenings
 
* Homesick
 
* Transcend
 
* Sync
 
 
 
 
 
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.
 
 
 
Source:
 
[http://www.hard-light.net/forums/index.php/topic,42854.0.html Original thread by Turey]
 
 
 
 
 
<!-- 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=
 
Visit the [http://www.fsoinstaller.com/changelog.html changelog on www.fsoinstaller.com].
 
 
 
-->
 

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.