Difference between revisions of "Manually Installing FreeSpace 2 Open"

From FreeSpace Wiki
Jump to: navigation, search
(here's the redirected page; nothing that was in this old page is missing from the most popular one)
m (Updates and conformations.)
Line 1: Line 1:
This guide assumes you already have a working copy of FreeSpace 2 installed. If not, see [[Installing FreeSpace 2]]. Also, this build assumes you do not use an installer. If you do, skip down to the part where it talks about configuring fs2_open.
+
This guide assumes you already have a working copy of FreeSpace 2 installed. If not, see [[Installing FreeSpace 2]]. Also, this build assumes you do not use an installer. If you do, skip down Step One.
  
 
== Quick Start: Using the Online Installer ==
 
== Quick Start: Using the Online Installer ==
Line 14: Line 14:
 
At the time of the last update, the installer includes (but is not limited to):
 
At the time of the last update, the installer includes (but is not limited to):
  
* FreeSpace Open 3.6.9 Final (regular and debug)
+
* FreeSpace Open 3.6.10 Final (regular and debug)
* FreeSpace Open 3.6.10 Experimental (regular and debug)
+
* FRED2 Open 3.6.10 Final (regular and debug)
* FRED2 Open 3.6.9 Final (regular and debug)
+
* Launcher 5.5e
* Launcher 5.5c
 
 
* launcher6.ini
 
* launcher6.ini
* Mac Executables
+
* FreeSpace Open 3.6.10 Final for Linux
* Soulstorm's OSX Launcher
+
* FreeSpace Open 3.6.10 Final for Mac
* fs2open_pxo.cfg
+
* 3.6.10 Final MediaVPs (optional)
* The OpenAL Installer (optional)
+
* 3.6.10 Advanced MediaVP Effects (optional; only for those with high-power systems; requires regular MediaVPs)
* 3.6.8 Zeta MediaVPs (optional, includes the 710 patches)
+
* The .OGG Cutscenes
* 3.6.8 Zeta adveffects (only for those with high-power systems, requires regular MediaVPs, includes 710 patch)
+
* Derelict SCP Version
* .OGG Cutscenes
 
* Derelict SCP Version (With optional voice)
 
* Just Another Day 1, 2 & 3 (separate options for each)
 
 
* FreeSpace Port
 
* FreeSpace Port
 +
* FreeSpace 1 .OGG Cutscenes
 
* Awakenings
 
* Awakenings
 +
* Cardinal Spear
 +
* Destiny of Peace
 +
* Silent Threat: Reborn
 
* Homesick
 
* Homesick
 
* Transcend
 
* Transcend
 
* Sync
 
* Sync
 +
* Blue Planet
 +
* Blackwater Operations Demo
 +
* Deus Ex Machina
 +
* Just Another Day 1, 2, & 3 (separate options for each)
 +
* The Procyon Insurgency
 +
* Shrouding the Light
 +
* Twilight
 +
* Warzone
  
 
=== Requirements and Notes ===
 
=== Requirements and Notes ===
Line 88: Line 96:
 
[http://www.hard-light.net/forums/index.php/board,173.0.html Nightly builds forum]
 
[http://www.hard-light.net/forums/index.php/board,173.0.html Nightly builds forum]
  
== Step Four: Choosing your MediaVPs ==
+
== Step Four: MediaVPs ==
  
With the release of the 3.6.10 MediaVPs, there are now two types of installs.  A MV_Complete, which includes everything, including the Advanced (high-end PC oriented) effects, and the separate MV_* files. The detailed instructions for installing and the current links can currently be found in the MediaVPs Release Thread linked below.
+
With the rerelease of the 3.6.10 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' directory under the main FreeSpace directory (\freespace2\mediavps) This preserves both possibility to play with either with retail FreeSpace 2 vp files if this is desired (for example in multiplayer) or using the retail FreeSpace 2 executive files and requires minimal extra time to set up. (See step six for further details).
+
MediaVPs should be installed in a new 'mediavps' directory under the main FreeSpace directory (\freespace2\mediavps) 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).
  
 
[http://www.hard-light.net/forums/index.php/topic,58230.0.html 3.6.10 MediaVPs Release Thread]
 
[http://www.hard-light.net/forums/index.php/topic,58230.0.html 3.6.10 MediaVPs Release Thread]
Line 100: Line 108:
 
=== Basic setup ===
 
=== Basic setup ===
  
At this point, you have one final stage remaining before fs2_open is ready to go. Open up the Launcher. (It should be in your main FreeSpace 2 folder). Select the EXE you'd like to use by clicking the "Browse..." button at the top of the Launcher.  There are two types typically for any build release, a 'd' or debug and a 'r' or regular/release. For normal play you will want to use an 'r' build but for any testing, development, or bug reporting you definitely want to use a 'd' build.  For example, fs2_open_3_6_10d.exe vs fs2_open_3_6_10r.exe.
+
At this point, you have one final stage remaining before fs2_open is ready to go. Open up the Launcher. (It should be in your main FreeSpace 2 folder). Select the EXE you'd like to use by clicking the "Browse..." button at the top of the Launcher.  There are two types typically for any build release:
 +
* a debug build with the name containing 'd' or 'debug' right after the version number. For example, fs2_open_3_6_10'''d'''.exe.
 +
* a regular/release build with the name containing 'r' or nothing right after the version number. For example, fs2_open_3_6_10.exe or fs2_open_3_6_11'''r'''_sse2-20100131_r5862.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 'd' build.  For example, fs2_open_3_6_10d.exe vs fs2_open_3_6_10.exe.
  
 
Next, ensure that the "Audio/Joystick" and "Network" tabs have the proper settings.
 
Next, ensure that the "Audio/Joystick" and "Network" tabs have the proper settings.
Line 110: Line 122:
 
=== Video setup ===
 
=== Video setup ===
  
On the "Video" tab, you can choose which API to use (OpenGL or Direct3D), what resolution to run in, and whether to use anti-aliasing (Multisampling) or not. With FreeSpace Open 3.6.9 '''OpenGL''' is strongly recommended over the Direct3D. Direct3D will no longer be available in 3.6.10 and on, unless a D3D coder joins the team to fix the many issues that have developed with it.
+
On the "Video" tab, you can choose choose various graphics options. Though the Launcher offers OpenGL and Direct3D for graphics APIs, it is good to note that 3.6.10 and newer builds do not include Direct3D and will use OpenGL regardless of what has been selected in the Luncher. With 3.6.9, Direct3D works, but OpenGL is recommended. You can also choose what resolution to run in, and whether to use anisotrophic filtering or not.
  
"Allow non standard modes" will let you choose resolutions other than 1024x768 and 640x480. There may be some small graphics alignment errors, but these are generally small and virtually unnoticeable.
+
"Allow non standard modes" will let you choose resolutions other than 1024x768 and 640x480. 3.6.10 and newer builds support widescreen resolutions and other non-standard resolutions, though using a non-4:3 resolution will stretch the HUD and the interface elements.
  
 
=== Features setup ===
 
=== Features setup ===
Line 130: Line 142:
 
At this point, if you try to start the original FreeSpace 2 executables, they'll likely crash at some point or other. To prevent this, do the following:
 
At this point, if you try to start the original FreeSpace 2 executables, they'll likely crash at some point or other. To prevent this, do the following:
  
=== Move the mediaVPs to a mod dir ===
+
=== Move the MediaVPs to a mod directory ===
You can take advantage of the SCP's -mod feature and move the mediaVPs to a folder inside your main FreeSpace 2 folder; this folder can be named anything you like, such as "mediavps". However, whenever you run FreeSpace 2, you must remember to  select that folder as the current mod. If you want to play another mod, you must make use of the SCP's multiple mod feature.
+
You can take advantage of FSO's -mod feature and move the MediaVPs to a folder inside your main FreeSpace 2 folder; this folder can be named anything you like; "mediavps" is recommended. However, whenever you run FreeSpace 2, you must remember to  select that folder as the current mod. If you want to play another mod, you must make use of the SCP's multiple mod feature.
  
 
=== Save any existing pilot files ===
 
=== Save any existing pilot files ===
Fs2_open upgraded the pilot files to allow for better mod handling in version 3.6.5. To prevent double entries from showing up, a new, upgraded version of the pilot file is created, and then the old one is deleted. To save your progress, copy all *.plr, *.csg, and *.css files that start with your pilot name. Then, rename the copies so that they're in the form of <your name>_scp. For example, my player file would be called "WMCoolmon_scp.plr". Then, only use the "_scp" versions when running fs2_open.
+
FSO upgraded the pilot files to allow for better mod handling in version 3.6.5. To prevent double entries from showing up, a new, upgraded version of the pilot file is created, and then the old one is deleted. To save your progress, copy all *.plr, *.csg, and *.css files that start with your pilot name. Then, rename the copies so that they're in the form of <your name>_scp. For example, my player file would be called "WMCoolmon_scp.plr". Then, only use the "_scp" versions when running FSO.
  
It's recommended you back up the originals as well, in case you accidentally click on the non-SCP version while in the SCP. (It should warn you that it's going to destructively convert them, however.)
+
It's recommended you back up the originals as well, in case you accidentally click on the non-FSO version while in FSO. (It should warn you that it's going to destructively convert them, however.)
  
 
== Cutscenes ==
 
== Cutscenes ==
  
Depending on how you installed the game, the cutscenes might not be on your hard drive yet. You can either use the [http://www.freespacemods.net/download.php?view.124 original MVE cutscenes from freespacemods] or from the CDs/DVD by copying them to the FreeSpace2/data/movies/ folder, or you can use the [http://www.fszmirror.com/files/FS2OGGcutscenepack.vp OGG cutscenes] (both found in [http://www.hard-light.net/forums/index.php/topic,38195.msg896412.html#msg896412 ShivanSPS FreeSpace 2 SCP Installation Procedure]).  The Ogg cutscenes are smaller but might not perform as well on older hardware that could run the MVEs without problem.  The Ogg pack is distributed as a VP, so it gets placed directly in your FreeSpace 2 folder.  Now you should have the full gamut of updated and retail content installed!
+
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: Do not use the AVI versions, support for them has been removed in fs2_open versions 3.6.10 and higher.
+
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 19:19, 23 February 2010

This guide assumes you already have a working copy of FreeSpace 2 installed. If not, see Installing FreeSpace 2. Also, this build assumes you do not use an installer. If you do, skip down Step One.

Quick Start: Using the Online Installer

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.

You can also get the Installer source code here.

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

At the time of the last update, the installer includes (but is not limited to):

  • FreeSpace Open 3.6.10 Final (regular and debug)
  • FRED2 Open 3.6.10 Final (regular and debug)
  • Launcher 5.5e
  • launcher6.ini
  • FreeSpace Open 3.6.10 Final for Linux
  • FreeSpace Open 3.6.10 Final for Mac
  • 3.6.10 Final MediaVPs (optional)
  • 3.6.10 Advanced MediaVP Effects (optional; only for those with high-power systems; requires regular MediaVPs)
  • The .OGG Cutscenes
  • Derelict SCP Version
  • FreeSpace Port
  • FreeSpace 1 .OGG Cutscenes
  • Awakenings
  • Cardinal Spear
  • Destiny of Peace
  • Silent Threat: Reborn
  • Homesick
  • Transcend
  • Sync
  • Blue Planet
  • Blackwater Operations Demo
  • Deus Ex Machina
  • Just Another Day 1, 2, & 3 (separate options for each)
  • The Procyon Insurgency
  • Shrouding the Light
  • Twilight
  • Warzone

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: Original thread by Turey

Step One: Understanding what you need

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

If Turey's installer is down, or if you want to assemble it all yourself, you need the following components, the rest of this guide tells you about those components and various inner workings of the SCP:

  • 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: Launcher 5.5e download

OS X: Soulstorm's OS X Launcher 3.0

Linux: YAL or here or whatever you can figure out.

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.6.10.

FreeSpace Open 3.6.10 release thread

Recent 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.

Recent 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 main code base in SVN. 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 rerelease of the 3.6.10 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' directory under the main FreeSpace directory (\freespace2\mediavps) 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.6.10 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 the Launcher. (It should be in your main FreeSpace 2 folder). Select the EXE you'd like to use by clicking the "Browse..." button at the top of the Launcher. There are two types typically for any build release:

  • a debug build with the name containing 'd' or 'debug' right after the version number. For example, fs2_open_3_6_10d.exe.
  • a regular/release build with the name containing 'r' or nothing right after the version number. For example, fs2_open_3_6_10.exe or fs2_open_3_6_11r_sse2-20100131_r5862.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 'd' build. For example, fs2_open_3_6_10d.exe vs fs2_open_3_6_10.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

On the "Video" tab, you can choose choose various graphics options. Though the Launcher offers OpenGL and Direct3D for graphics APIs, it is good to note that 3.6.10 and newer builds do not include Direct3D and will use OpenGL regardless of what has been selected in the Luncher. With 3.6.9, Direct3D works, but OpenGL is recommended. You can also choose what resolution to run in, and whether to use anisotrophic filtering or not.

"Allow non standard modes" will let you choose resolutions other than 1024x768 and 640x480. 3.6.10 and newer builds support widescreen resolutions and other non-standard resolutions, though using a non-4:3 resolution will stretch the HUD and the interface elements.

Features setup

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

The next box, with the buttons "Select mod" and "No mod" 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.

"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.

Finally, the two boxes below this let you toggle the various new features in fs2_open, many of which are graphical improvements. Recommended options for midrange systems are "Enable specular", "Enable glowmaps", "Enable Environment Maps", and "Enable jpg,tga textures" (not in 3.6.10). (You may have to choose a different section in the drop-down box to get to some of these options). There are many, many more options, but these should get you started.

Command line Flags

Step Six: (Optional) Preserving FreeSpace 2

At this point, if you try to start the original FreeSpace 2 executables, they'll likely crash at some point or other. To prevent this, do the following:

Move the MediaVPs to a mod directory

You can take advantage of FSO's -mod feature and move the MediaVPs to a folder inside your main FreeSpace 2 folder; this folder can be named anything you like; "mediavps" is recommended. However, whenever you run FreeSpace 2, you must remember to select that folder as the current mod. If you want to play another mod, you must make use of the SCP's multiple mod feature.

Save any existing pilot files

FSO upgraded the pilot files to allow for better mod handling in version 3.6.5. To prevent double entries from showing up, a new, upgraded version of the pilot file is created, and then the old one is deleted. To save your progress, copy all *.plr, *.csg, and *.css files that start with your pilot name. Then, rename the copies so that they're in the form of <your name>_scp. For example, my player file would be called "WMCoolmon_scp.plr". Then, only use the "_scp" versions when running FSO.

It's recommended you back up the originals as well, in case you accidentally click on the non-FSO version while in FSO. (It should warn you that it's going to destructively convert them, however.)

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.