Difference between revisions of "Manually Installing FreeSpace 2 Open"

From FreeSpace Wiki
Jump to: navigation, search
m
(26 intermediate revisions by 15 users not shown)
Line 1: Line 1:
= CURRENTLY COLLATING INFORMATION FOR THIS PAGE =
+
<span style="font-size:125%; font-weight:bold; color:red">This page covers installing FSO and associated mods by hand.  You may want to use the [[Knossos (mod manager)]] or the [[FreeSpace Open Installer]] as it considerably streamlines and automates the whole process.</span>
: [[User:Fractux|Fractux]] 10:22, 13 April 2007 (CDT)
+
<br/>&nbsp;<br/>
'''FOR NOW, GO TO: [[Getting Started(Main)]]'''
 
----
 
----
 
  
== Before you Begin ==
+
This guide assumes you already have a working copy of FreeSpace 2 installed. If not, see [[Installing FreeSpace 2]].
  
 +
== Step One: Understanding what you need ==
 +
There are three main components that you need to get the most out of fs2_open.
  
===System Requirements===
+
* First, you need to install the retail data from [[Installing FreeSpace 2|FreeSpace 2]]
While the original FreeSpace 2 has rather low system requirments, such as a Pentium 200MHz, 32 MB RAM (64 recommended), and a 3D accelerator (Direct3D, Glide) required, FreeSpace 2 Open has slightly higher requirments. However, any computer from the early 2000s should be able to play this, though toggling all the modern graphical eye candy will require a more modern computer.
+
* Second, the '''fs2_open build'''. This is the core game engine, a single executable file.
 +
* Next, the '''launcher'''. This lets you configure the fs2_open executable for your particular system, in much the same way the original FreeSpace 2 launcher is used to configure it.
 +
* Finally, the '''MediaVPs'''. These contain all sorts of graphical improvements and are highly recommended. Version numbers of mediaVPs generally agree with the fs2_open build that they're supposed to be used with.
  
== FreeSpace Open Installer ==
+
== Step Two: Getting the Launcher ==
  
You can use the excellent installer by [http://www.hard-light.net/forums/index.php?action=profile;u=3428 Turey], that should give you a baseline of everything you need to play.  
+
Unless you are using an extremely old build, you will want to get the appropriate launcher for your OS.  It may be bundled with your release but the direct download link is below.
  
 +
Windows:  [http://www.hard-light.net/forums/index.php?topic=67950.0 wxLauncher]
  
There are two versions of the installer that you can download:
+
OS X:  [http://www.hard-light.net/forums/index.php?topic=67950.0 wxLauncher] unless you are using Tiger or a PowerPC Mac, in which case use Soulstorm's [http://www.hard-light.net/forums/index.php?topic=51391.0 OS X Launcher 3.0] ([[Soulstorm's OS X Launcher|instructions]])
  
*[http://www.fsoinstaller.com/files/installer/FreeSpaceOpenInstaller.zip Windows Installer (Zipped .exe, 19 MB)] (Windows)
+
Linux:  [http://www.hard-light.net/forums/index.php?topic=67950.0 wxLauncher] (build it from source; see the [http://code.google.com/p/wxlauncher/source/browse/ReadMe.txt readme] for instructions)
*[http://www.fsoinstaller.com/files/installer/java/FreeSpaceOpenInstaller.jar Win/Linux/Mac Installer (.jar, 26 KB)] (Requires [http://www.java.com/ Java 1.5 +])
 
**You can get the source code to the Java Installer [http://www.fsoinstaller.com/files/installer/java/ here].
 
  
 +
== Step Three: Choosing a build ==
 +
There are two main types of fs2_open builds, at the time of this writing. A "build" is any executable built from source code. Any build may also be a debug build. (Debug builds usually have names that end with "_d" or "_dbg" or somesuch) If you don't know why you'd want to use a debug build, you're almost certainly better off not using one.
  
This Installer is known to work on Windows, Linux (tested on Gentoo, Fedora, Ubuntu), and Mac (OSX Panther, with a hacked install of Java 1.5) <i>(more info for users)</i>
+
All builds should be extracted to your main FreeSpace 2 folder.
  
 +
=== Official Releases ===
 +
The first type is the "stable" release build. Additionally, some official release builds are available with installers. It's a good idea to get the most recent official release, even if you end up deciding to get a recent build anyway. Current official release is '''FreeSpace Open 3.8.0'''.
  
The most recent installer version of the Installer allows you to download:
+
[https://www.hard-light.net/forums/index.php?topic=93812.0 FreeSpace Open 3.8.0 release thread]
<i>(As of April 12, 2007)</i>
 
  
*FreeSpace 2
+
=== Test Builds ===
 +
Recent Builds are ones that individual coders release. Most of the time they're released to either test or showcase some particular new feature. If you're curious about how reliable a build is, your best bet is to check the original thread it was posted in and see what people's responses were.
  
*Windows:
+
[https://www.hard-light.net/forums/index.php/board,97.0.html Test builds forum]
**FreeSpace Open 3.6.9 Final (regular and debug)
 
**FRED2 Open 3.6.9 Final (regular and debug)
 
**FreeSpace Open Launcher 5.5a
 
  
*Macintosh:
+
[https://www.hard-light.net/forums/index.php/board,113.0.html Cross Platform Development forum (for Linux/OS X builds)]
**FreeSpace Open 3.6.9 Final (regular and debug)
 
**Soulstorm's OSX Launcher
 
  
*The OpenAL Installer ('''NOTE:''' [http://www.openal.org/ OpenAL] must be installed to run FS2 Open)
+
=== Nightly Builds ===
  
*3.6.8 Zeta Media VP Files (optional, includes 710 patch)
+
In addition to recent builds, nightly builds are built every evening after any changes have been applied to the source code. These are put out so that the code base can be quickly verified for general stability. Testing nightly builds on a regular basis and reporting bugs helps ensure a stable code base is maintained.
*3.6.8 Zeta Advanced effects (only for those with high-end systems. Requires regular Media VP Files, includes 710 patch)
 
  
*.OGG Cutscenes
+
[https://www.hard-light.net/forums/index.php/board,173.0.html Nightly builds forum]
  
 +
== Step Four: MediaVPs ==
  
'''Modifications available for Direct Download: '''
+
With the release of the 3.8 MediaVPs, there is once again only one set of recommended MediaVPs available. The detailed instructions for installing and the current links can currently be found in the MediaVPs Release Thread linked below.
* Derelict SCP Version (With optional voice)
 
* Just Another Day 1 & 2 (separate options for each)
 
* FreeSpace Port
 
* Awakenings
 
* Homesick
 
* Transcend
 
* Sync
 
  
 +
MediaVPs should be installed in a new 'MediaVPs_38X' directory under the main FreeSpace directory (\freespace2\MediaVPs_38X) This preserves the possibility to play with either with retail FreeSpace 2 vp files if this is desired (for example in multiplayer) and using the retail FreeSpace 2 executive files and requires minimal extra time to set up. (See step six for further details).
  
=== Requirements and Notes ===
+
[https://www.hard-light.net/forums/index.php?topic=94988.0 3.8 MediaVPs Release Thread]
You can update your installation by simply running the Installer again. This will download any files that are out of date.
 
  
<b>The Installer requires an internet connection to install.</b>
+
== Step Five: Configuring Everything ==
* It checks to see if your installation files are out of date via the web.
 
* It automatically takes you to the download page of the most recent version, if your version is out of date.
 
  
<i>Source: [http://www.hard-light.net/forums/index.php/topic,42854.0.html Original thread by Turey]</i>
+
=== Basic setup ===
  
=== Linux Specific Information ===
+
At this point, you have one final stage remaining before fs2_open is ready to go. Open up wxLauncher. Select the EXE you'd like to use from the dropdown menu in the "Basic Settings" tab.  There are two types typically for any build release:
 +
* a debug build with the name containing 'd', 'debug' or 'FASTDBG' right after the version number. For example, fs2_open_3_8_0_x64_AVX-FASTDBG.exe.
 +
* a regular/release build with the name containing 'r' or nothing right after the version number. For example, fs2_open_3_8_0_x64_AVX.exe.
  
Pre-Compiled binaries for FS2 Open 3.6.9 Final are not currently available in the Installer.
+
For normal play you will want to use a regular build but for any testing, development, or bug reporting you definitely want to use a debug build.  For example, fs2_open_3_8_0_x64_AVX-FASTDBG.exe vs fs2_open_3_8_0_x64_AVX.exe.
  
You have two options:
+
Next, ensure that the "Audio/Joystick" and "Network" tabs have the proper settings.
* Use Pre-Compiled binaries available [http://www.hard-light.net/forums/index.php/board,113.0.html here] or [http://www.hard-light.net/forums/index.php/board,97.0.html here]. <i>(Check both locations for the most up to date binary)</i>
 
* Download the source from CVS. Follow the instruction in the article covering [Fs2 open on Linux|FS2 on Linux].
 
  
== Manual Installation Guide ==
+
=== Speech setup ===
  
=== Linux Specific Information ===
+
If you are using Windows XP, or have the Speech API installed, fs2_open will be able to read briefings, techroom descriptions, and even ingame messages to you using computer-generated voices. Although no match for real voice acting, it is convenient when valid plot points are mentioned in the middle of combat. Speech in the various locations can be turned on and off by checking and unchecking the check boxes; you can choose which of the installed voices to use in fs2_open by changing the drop-down menu. As of this writing, fs2_open will only use the voice you choose for everything.  Text to Speech is typically only available in stable release builds.  Recent Builds from a coder's test branch will usually not have it, nor will Nightly Builds.
 +
 
 +
=== Video setup ===
 +
 
 +
In the "Video" section, you can choose choose various graphics options. Here, you can set the resolution as well as the colour depth. It is recommended to use a resolution greater or equal to 1024x768 at 32 bits of colour depth.
 +
 
 +
=== Mod setup ===
 +
 
 +
The "Mods" tab lets you easily switch between mods by clicking on them and hitting the "Activate" button.
 +
 
 +
This tab allow you to choose a mod directory to use; files in the mod directory will be given precedence over other files, so you can easily switch between mods by installing them to different directories.
 +
 
 +
=== Advanced setup ===
 +
 
 +
This tab is where most of fs2_open's options can be toggled on and off. At the bottom is a readout of your current command line; you should include this in any debugging reports you make.
 +
 
 +
The long list of checkboxes let you toggle the various new features in fs2_open, many of which are graphical improvements. Recommended options for midrange systems are "Enable post processing", "Enable soft particles" and "Enable FXAA anti-aliasing". There are many, many more options, but these should get you started.
 +
 
 +
"Custom flags" allows you to add any command line flags that don't show up in the Launcher. This may be because they require additional arguments, as is the case with the "-fov" command line argument. For more information, see the [[Command-Line Reference]] page.
 +
 
 +
[http://wiki.hard-light.net/index.php/Command-Line_Reference line Flags]
 +
 
 +
=== Language Setup ===
 +
 
 +
Freespace & Freespace 2 supported non-English languages such as French, German & Polish.  Some mods (most notably Freespace Port) also support non-English languages.  The steps required to change the language differ depending on which OS FSO is running on.
 +
 
 +
Note that due to pilot file limitations, pilots can only be used with '''one''' language.  If you switch languages you need to have multiple pilots.
 +
 
 +
To set the language, modify the Language entry in the [[Getting_started_with_FreeSpace_2#Registry|registry or the [Default] section of the .ini file]].
 +
 
 +
e.g.
 +
 
 +
<code>
 +
[Default]
 +
 
 +
...
 +
 
 +
Language=French
 +
</code>
 +
 
 +
== Step Six: Cutscenes ==
 +
 
 +
Depending on how you installed the game, the cutscenes might not be in the proper location.  If you bought your copy of FS2 from Good Old Games, the cutscenes (ten .mve files) are somewhere in \freespace2\data2\ or \freespace2\data3\ . You can get them working by moving them to \freespace2\data\movies\ . Create the directory if it does not exist. You can also download either the [http://www.freespacemods.net/download.php?view.124 original MVE cutscenes] or [http://freespacemods.net/download.php?view.128 OGG-encoded versions] from FreeSpaceMods.net. If you have the game CDs/DVD, you can copy the cutscenes from them to the FreeSpace2/data/movies/ folder.  The OGG cutscenes are smaller but might not perform as well on older hardware that could run the MVEs without problem.  Now you should have the full gamut of updated and retail content installed!
 +
 
 +
Note: If you've found the AVI versions of the cutscenes, do not use them. Support for AVI has been removed in FSO versions 3.6.10 and higher.
  
 
[[Category:Source Code Project]]
 
[[Category:Source Code Project]]

Revision as of 21:33, 2 September 2018

This page covers installing FSO and associated mods by hand. You may want to use the Knossos (mod manager) or the FreeSpace Open Installer as it considerably streamlines and automates the whole process.
 

This guide assumes you already have a working copy of FreeSpace 2 installed. If not, see Installing FreeSpace 2.

Step One: Understanding what you need

There are three main components that you need to get the most out of fs2_open.

  • First, you need to install the retail data from FreeSpace 2
  • Second, the fs2_open build. This is the core game engine, a single executable file.
  • Next, the launcher. This lets you configure the fs2_open executable for your particular system, in much the same way the original FreeSpace 2 launcher is used to configure it.
  • Finally, the MediaVPs. These contain all sorts of graphical improvements and are highly recommended. Version numbers of mediaVPs generally agree with the fs2_open build that they're supposed to be used with.

Step Two: Getting the Launcher

Unless you are using an extremely old build, you will want to get the appropriate launcher for your OS. It may be bundled with your release but the direct download link is below.

Windows: wxLauncher

OS X: wxLauncher unless you are using Tiger or a PowerPC Mac, in which case use Soulstorm's OS X Launcher 3.0 (instructions)

Linux: wxLauncher (build it from source; see the readme for instructions)

Step Three: Choosing a build

There are two main types of fs2_open builds, at the time of this writing. A "build" is any executable built from source code. Any build may also be a debug build. (Debug builds usually have names that end with "_d" or "_dbg" or somesuch) If you don't know why you'd want to use a debug build, you're almost certainly better off not using one.

All builds should be extracted to your main FreeSpace 2 folder.

Official Releases

The first type is the "stable" release build. Additionally, some official release builds are available with installers. It's a good idea to get the most recent official release, even if you end up deciding to get a recent build anyway. Current official release is FreeSpace Open 3.8.0.

FreeSpace Open 3.8.0 release thread

Test Builds

Recent Builds are ones that individual coders release. Most of the time they're released to either test or showcase some particular new feature. If you're curious about how reliable a build is, your best bet is to check the original thread it was posted in and see what people's responses were.

Test builds forum

Cross Platform Development forum (for Linux/OS X builds)

Nightly Builds

In addition to recent builds, nightly builds are built every evening after any changes have been applied to the source code. These are put out so that the code base can be quickly verified for general stability. Testing nightly builds on a regular basis and reporting bugs helps ensure a stable code base is maintained.

Nightly builds forum

Step Four: MediaVPs

With the release of the 3.8 MediaVPs, there is once again only one set of recommended MediaVPs available. The detailed instructions for installing and the current links can currently be found in the MediaVPs Release Thread linked below.

MediaVPs should be installed in a new 'MediaVPs_38X' directory under the main FreeSpace directory (\freespace2\MediaVPs_38X) This preserves the possibility to play with either with retail FreeSpace 2 vp files if this is desired (for example in multiplayer) and using the retail FreeSpace 2 executive files and requires minimal extra time to set up. (See step six for further details).

3.8 MediaVPs Release Thread

Step Five: Configuring Everything

Basic setup

At this point, you have one final stage remaining before fs2_open is ready to go. Open up wxLauncher. Select the EXE you'd like to use from the dropdown menu in the "Basic Settings" tab. There are two types typically for any build release:

  • a debug build with the name containing 'd', 'debug' or 'FASTDBG' right after the version number. For example, fs2_open_3_8_0_x64_AVX-FASTDBG.exe.
  • a regular/release build with the name containing 'r' or nothing right after the version number. For example, fs2_open_3_8_0_x64_AVX.exe.

For normal play you will want to use a regular build but for any testing, development, or bug reporting you definitely want to use a debug build. For example, fs2_open_3_8_0_x64_AVX-FASTDBG.exe vs fs2_open_3_8_0_x64_AVX.exe.

Next, ensure that the "Audio/Joystick" and "Network" tabs have the proper settings.

Speech setup

If you are using Windows XP, or have the Speech API installed, fs2_open will be able to read briefings, techroom descriptions, and even ingame messages to you using computer-generated voices. Although no match for real voice acting, it is convenient when valid plot points are mentioned in the middle of combat. Speech in the various locations can be turned on and off by checking and unchecking the check boxes; you can choose which of the installed voices to use in fs2_open by changing the drop-down menu. As of this writing, fs2_open will only use the voice you choose for everything. Text to Speech is typically only available in stable release builds. Recent Builds from a coder's test branch will usually not have it, nor will Nightly Builds.

Video setup

In the "Video" section, you can choose choose various graphics options. Here, you can set the resolution as well as the colour depth. It is recommended to use a resolution greater or equal to 1024x768 at 32 bits of colour depth.

Mod setup

The "Mods" tab lets you easily switch between mods by clicking on them and hitting the "Activate" button.

This tab allow you to choose a mod directory to use; files in the mod directory will be given precedence over other files, so you can easily switch between mods by installing them to different directories.

Advanced setup

This tab is where most of fs2_open's options can be toggled on and off. At the bottom is a readout of your current command line; you should include this in any debugging reports you make.

The long list of checkboxes let you toggle the various new features in fs2_open, many of which are graphical improvements. Recommended options for midrange systems are "Enable post processing", "Enable soft particles" and "Enable FXAA anti-aliasing". There are many, many more options, but these should get you started.

"Custom flags" allows you to add any command line flags that don't show up in the Launcher. This may be because they require additional arguments, as is the case with the "-fov" command line argument. For more information, see the Command-Line Reference page.

line Flags

Language Setup

Freespace & Freespace 2 supported non-English languages such as French, German & Polish. Some mods (most notably Freespace Port) also support non-English languages. The steps required to change the language differ depending on which OS FSO is running on.

Note that due to pilot file limitations, pilots can only be used with one language. If you switch languages you need to have multiple pilots.

To set the language, modify the Language entry in the registry or the [Default] section of the .ini file.

e.g.

[Default]

...

Language=French

Step Six: Cutscenes

Depending on how you installed the game, the cutscenes might not be in the proper location. If you bought your copy of FS2 from Good Old Games, the cutscenes (ten .mve files) are somewhere in \freespace2\data2\ or \freespace2\data3\ . You can get them working by moving them to \freespace2\data\movies\ . Create the directory if it does not exist. You can also download either the original MVE cutscenes or OGG-encoded versions from FreeSpaceMods.net. If you have the game CDs/DVD, you can copy the cutscenes from them to the FreeSpace2/data/movies/ folder. The OGG cutscenes are smaller but might not perform as well on older hardware that could run the MVEs without problem. Now you should have the full gamut of updated and retail content installed!

Note: If you've found the AVI versions of the cutscenes, do not use them. Support for AVI has been removed in FSO versions 3.6.10 and higher.