FreeSpace Wiki - User contributions [en]

Mac Installation Guide

2009-05-03T17:27:40Z

Ovvldc:

[[Category:Source Code Project]][[Category:FreeSpace_Open_on_Mac]]Installing FreeSpace Open on a Mac takes several distinct steps:

== Install FreeSpace 2 (optional) ==

If you want to play the original FS2 campaign, you need a copy of the original game. You can find instructions for that on the [[Getting FreeSpace]] page.

FreeSpace 2 is a game for Windows only, so the installer also requires Windows to run. On a Mac you can work around this is several ways:

*install FS2 on a Windows PC and move the entire program's folder to your mac.
*use [http://www.apple.com/macosx/features/bootcamp.html Boot Camp].
*use [http://www.parallels.com/en/products/desktop/ Parallels Desktop], [http://www.vmware.com/products/fusion/ VMware Fusion] or [http://www.virtualbox.org/ VirtualBox].
*use [http://www.codeweavers.com/products/cxmac/ CrossOver Mac] or [http://wiki.winehq.org/MacOSX/Installing Wine].

You should [[FreeSpace_Open_Installer#Install_procedure|install the orginal game]], and also install the [http://www.pxo.net/files/fs21x-12.exe 1.2 patch].

In all cases, you should end up with a folder that contains an ''FS2.exe'', several ''.vp'' files, and several folders including ''data'', ''ereg'' and ''tools''. The usual location on your Windows (virtual) machine is ''C:\Games\FreeSpace2\''. Move this folder to a convenient place on your Mac. You no longer need any of the .exe files.

== Install FreeSpace Open ==

You can do it by hand, but by far the easiest way is to use Turey's [http://www.fsoinstaller.com/ FSO installer]. For the Mac, you need the cross-platform [http://www.fsoinstaller.com/files/installer/java/FreeSpaceOpenInstaller.jar .jar installer]. It needs Java 1.5, which is standard on OSX 10.4 (Tiger) onwards, and can be hacked into 10.3 (Panther).

Run the installer. Select the folder where you moved FS2 or an empty folder if just want FS2O. Then make sure you leave the ''Update Current Files'' option ''un''checked. Otherwise, you can select anything you want.

After you select software and [[User-made Campaigns (FS2)|mods]], allow the installer to fetch the latest versions. '''Caution''': Depending on your mod choices, the installer may start downloading several GBs. If you are on a relatively slow connection (including basic broadband) this could take hours.

If you want a newer build of the FSO game than the installer provides for, you can find build announcements in the [http://www.hard-light.net/forums/index.php/board,113.0.html Cross-Platform Development forum]. '''Caution''': these builds are experimental and may not function as intended.

Find your FS2O folder, mount the disk image and put the FS2_Open application in your FS2O folder

== Installing the OSX game launcher ==

On platforms other than Mac, FS2O is configured via [[Command-Line Reference|command-line options]]. On the Mac, these options are not used on a command line, but are listed instead in the ''~library/FS2_Open/data/cmdline_fso.cfg'' file. You can edit this file by hand, but a more convenient way is to use [http://www.soulstorm-creations.com/PROJECT_SOULSTORM_2_0/cocoa-objective-c/fs2-open-launcher-os-x-3.0.html Soulstorm's OSX launcher]. Download the disk image, mount it, and put the launcher in your FS2/FSO folder.

When you first run the installer, let it update itself to at least version 3.1, and enter the location of your FS2O application in the bottom part of the window.

Go to the ''GamePlay + Speed'' tab to select one of the mods you have installed. FS2O can have only one mod active at the same time, so select the one you want to play. The launcher should be able to find the mods in your FS2O folder. If not, you will have to add them to your ''cmdline_fso.cfg'' file by hand.

Go to the ''Graphics'' tab to enter your graphics options. The [[MediaVP]]'s mod readme.txt file recommends the following settings, but your Mac may or may not support these:
-spec (Enable Specular maps)
-glow (Enable Glowmaps)
-env (Enable Environment Maps)
-missile_lighting (Apply Lighting to Missiles)
-normal (Enable Normal Maps)
-3dshockwave (Enable 3D Shockwaves in random orientations)

-ambient_factor 35
-spec_exp 15
-spec_point 1.2
-spec_static 1.5
-spec_tube 1.5
-ogl_spec 20

== Install additional mods ==

You can use the FSO installer to download more mods, or follow the links in the [[User-made Campaigns (FS2)|FS campaign list]]. [[Total conversions|Total conversion mods]] are also available, which take place outside the [[Portal:FreeSpace Universe|FreeSpace universe]].

[[Category:Source Code Project]]

Mac Installation Guide

2009-05-01T22:57:57Z

Ovvldc: more cleanup

[[Category:Source Code Project]][[Category:FreeSpace_Open_on_Mac]]Installing FreeSpace Open on a Mac takes several distinct steps:

== Install FreeSpace 2 (optional) ==

If you want to play the original FS2 campaign, you need a copy of the original game. You can find instructions for that on the [[Getting FreeSpace]]page.

FreeSpace 2 is a game for Windows only, so the installer also requires Windows to run. On a Mac you can work around this is several ways:

*install FS2 on a Windows PC and move the entire program's folder to your mac.
*use [http://www.parallels.com/en/products/desktop/ Parallels Desktop], [http://www.vmware.com/products/fusion/ VMware Fusion] or [http://www.virtualbox.org/ VirtualBox].
*use [http://www.codeweavers.com/products/cxmac/ CrossOver Mac] or [http://wiki.winehq.org/MacOSX/Installing Wine].

You should [[FreeSpace_Open_Installer#Install_procedure|install the orginal game]], and also install the [http://www.pxo.net/files/fs21x-12.exe 1.2 patch].

In all cases, you should end up with a folder that contains an ''FS2.exe'', several ''.vp'' files, and several folders including ''data'', ''ereg'' and ''tools''. The usual location on your windows (virtual) machine is ''C:\Games\FreeSpace2\''. Move this folder to a convenient place on your Mac. You no longer need any of the .exe files.

== Install FreeSpace Open ==

You can do it by hand, but by far the easiest way is to use Turey's [http://www.fsoinstaller.com/ fsoinstaller]. For the Mac, you need the cross-platform [http://www.fsoinstaller.com/files/installer/java/FreeSpaceOpenInstaller.jar .jar installer]. It needs Java 1.5, which is standard on OSX 10.4 (Tiger) onwards, and can be hacked into 10.3 (Panther).

Run the installer. Select the folder where you moved FS2 or an empty folder if just want FS2O. Then make sure you leave the ''Update Current Files'' option ''un''checked. Otherwise, you can select anything you want.

After you select software and [[User-made Campaigns (FS2)|mods]], allow the installer to fetch the latest versions. '''Caution''': Depending on your mod choices, the installer may start downloading several GB. If you are on a relatively slow connection (including basic broadband) this could take hours.

If you want a newer build of the FSO game than the installer provides for, you can find build announcements in the [http://www.hard-light.net/forums/index.php/board,113.0.html Cross-Platform Development forum]. '''Caution''': these builds are experimental and may not function as intended.

Find your FS2O folder, mount the disk image and put the FS2_Open application in your FS2O folder

== Installing the OSX game launcher ==

On platforms other than Mac, FS2O is configured via [[Command-Line Reference|command-line options]]. On the Mac, these options not used on a command line, but are listed instead in the ''~library/FS2_Open/data/cmdline_fso.cfg'' file. You can edit this file by hand, but a more convenient way is to use [http://www.soulstorm-creations.com/PROJECT_SOULSTORM_2_0/cocoa-objective-c/fs2-open-launcher-os-x-3.0.html Soulstorm's OSX launcher]. Download the disk image, mount it, and put the launcher in your FS2/FSO folder.

When you first run the installer, let it update itself to at least version 3.1, and enter the location of your FS2O application in the bottom part of the window.

Go to the ''GamePlay + Speed'' tab to select one of the mods you have installed. FS2O can have only one mod active at the same time, so select the one you want to play. The launcher should be able to find the mods in your FS2O folder. If not, you will have to add them to your ''cmdline_fso.cfg'' file by hand.

Go to the ''Graphics'' tab to enter your graphics options. The [[MediaVP|MediaVPS]] mod readme.txt file recommends the following settings, but your Mac may or may not support these:
-spec (Enable Specular maps)
-glow (Enable Glowmaps)
-env (Enable Environment Maps)
-missile_lighting (Apply Lighting to Missiles)
-normal (Enable Normal Maps)
-3dshockwave (Enable 3D Shockwaves in random orientations)

-ambient_factor 35
-spec_exp 15
-spec_point 1.2
-spec_static 1.5
-spec_tube 1.5
-ogl_spec 20

== Install additional mods ==

You can use the fsoinstaller to download more mods, or follow the links in the [[User-made Campaigns (FS2)|FS campaign list]]. [[Total conversions|Total conversion mods]] are also available, which take place outside the [[Portal:FreeSpace Universe|FreeSpace universe]].

Mac Installation Guide

2009-05-01T22:31:22Z

Ovvldc: /* Installing the OSX game launcher */

[[Category:Source Code Project]][[Category:FreeSpace_Open_on_Mac]]Installing FreeSpace Open on a Mac takes several distinct steps:

== Install FreeSpace 2 (optional) ==

If you want to play the original FS2 campaign, you need a copy of the original game. You can find instructions for that on the [[Getting FreeSpace]]page.

FreeSpace 2 is a game for Windows only, so the installer also requires Windows to run. On a Mac you can work around this is several ways:

*install FS2 on a Windows PC and move the entire program's folder to your mac.
*use [http://www.parallels.com/en/products/desktop/ Parallels Desktop], [http://www.vmware.com/products/fusion/ VMware Fusion] or [http://www.virtualbox.org/ VirtualBox].
*use [http://www.codeweavers.com/products/cxmac/ CrossOver Mac] or [http://wiki.winehq.org/MacOSX/Installing Wine].

In all cases, you should end up with a folder that contains an ''FS2.exe'', several ''.vp'' files, and several folders including ''data'', ''ereg'' and ''tools''. Move this folder to a convenient place on your mac. You no longer need any of the .exe files.

== Install FreeSpace Open ==

You can do it by hand, but by far the easiest way is to use Turey's [http://www.fsoinstaller.com/ fsoinstaller]. For the Mac, you need the cross-platform [http://www.fsoinstaller.com/files/installer/java/FreeSpaceOpenInstaller.jar .jar installer]. It needs Java 1.5, which is standard on OSX 10.4 (Tiger) onwards, and can be hacked into 10.3 (Panther).

Run the installer. Select the folder where you moved FS2 or an empty folder if just want FSO. Then make sure you leave the ''Update Current Files'' option ''un''checked. Otherwise, you can select anything you want.

After you select software and [[User-made Campaigns (FS2)|mods]], allow the installer to fetch the latest versions. '''Caution''': Depending on your mod choices, the installer may start downloading several GB. If you are on a relatively slow connection (including basic broadband) this could take hours.

If you want a newer build of the FSO game than the installer provides for, you can find build announcements in the [http://www.hard-light.net/forums/index.php/board,113.0.html Cross-Platform Development forum]. '''Caution''': these builds are experimental and may not function as intended.

== Installing the OSX game launcher ==

On platforms other than Mac, FSO is configured via [[Command-Line Reference|command-line options]]. On the Mac, these options not used on a command line, but are listed instead in the ''~library/FS2_Open/data/cmdline_fso.cfg'' file. You can edit this file by hand, but a more convenient way is to use [http://www.soulstorm-creations.com/PROJECT_SOULSTORM_2_0/cocoa-objective-c/fs2-open-launcher-os-x-3.0.html Soulstorm's OSX launcher]. Download the disk image, open it, and put the launcher in your FS2/FSO folder.

When you first run the installer, let it update itself to at least version 3.1, and enter the location of your FSO application in the bottom part of the window.

Go to the ''GamePlay + Speed'' tab to select one of the mods you have installed. FSO can have only one mod active at the same time, so select the one you want to play. The launcher should be able to find the mods in your FSO folder. If not, you will have to add them to your ''cmdline_fso.cfg'' file by hand.

Go to the ''Graphics'' tab to enter your graphics options. The [[MediaVP|MediaVPS]] mod readme.txt file recommends the following settings, but your Mac may or may not support these:
-spec (Enable Specular maps)
-glow (Enable Glowmaps)
-env (Enable Environment Maps)
-missile_lighting (Apply Lighting to Missiles)
-normal (Enable Normal Maps)
-3dshockwave (Enable 3D Shockwaves in random orientations)

-ambient_factor 35
-spec_exp 15
-spec_point 1.2
-spec_static 1.5
-spec_tube 1.5
-ogl_spec 20

== Install additional mods ==

You can use the fsoinstaller to download more mods, or follow the links in the [[User-made Campaigns (FS2)|FS campaign list]]. [[Total conversions|Total conversion mods]] are also available, which take place outside the [[Portal:FreeSpace Universe|FreeSpace universe]].

Mac Installation Guide

2009-05-01T22:30:59Z

Ovvldc: /* Installing the OSX game launcher */

[[Category:Source Code Project]][[Category:FreeSpace_Open_on_Mac]]Installing FreeSpace Open on a Mac takes several distinct steps:

== Install FreeSpace 2 (optional) ==

If you want to play the original FS2 campaign, you need a copy of the original game. You can find instructions for that on the [[Getting FreeSpace]]page.

FreeSpace 2 is a game for Windows only, so the installer also requires Windows to run. On a Mac you can work around this is several ways:

*install FS2 on a Windows PC and move the entire program's folder to your mac.
*use [http://www.parallels.com/en/products/desktop/ Parallels Desktop], [http://www.vmware.com/products/fusion/ VMware Fusion] or [http://www.virtualbox.org/ VirtualBox].
*use [http://www.codeweavers.com/products/cxmac/ CrossOver Mac] or [http://wiki.winehq.org/MacOSX/Installing Wine].

In all cases, you should end up with a folder that contains an ''FS2.exe'', several ''.vp'' files, and several folders including ''data'', ''ereg'' and ''tools''. Move this folder to a convenient place on your mac. You no longer need any of the .exe files.

== Install FreeSpace Open ==

You can do it by hand, but by far the easiest way is to use Turey's [http://www.fsoinstaller.com/ fsoinstaller]. For the Mac, you need the cross-platform [http://www.fsoinstaller.com/files/installer/java/FreeSpaceOpenInstaller.jar .jar installer]. It needs Java 1.5, which is standard on OSX 10.4 (Tiger) onwards, and can be hacked into 10.3 (Panther).

Run the installer. Select the folder where you moved FS2 or an empty folder if just want FSO. Then make sure you leave the ''Update Current Files'' option ''un''checked. Otherwise, you can select anything you want.

After you select software and [[User-made Campaigns (FS2)|mods]], allow the installer to fetch the latest versions. '''Caution''': Depending on your mod choices, the installer may start downloading several GB. If you are on a relatively slow connection (including basic broadband) this could take hours.

If you want a newer build of the FSO game than the installer provides for, you can find build announcements in the [http://www.hard-light.net/forums/index.php/board,113.0.html Cross-Platform Development forum]. '''Caution''': these builds are experimental and may not function as intended.

== Installing the OSX game launcher ==

On platforms other than Mac, FSO is configured via [[Command-Line Reference|command-line options]]. On the Mac, these options not used on a command line, but are listed instead in the ''~library/FS2_Open/data/cmdline_fso.cfg'' file.

You can edit this file by hand, but a more convenient way is to use [http://www.soulstorm-creations.com/PROJECT_SOULSTORM_2_0/cocoa-objective-c/fs2-open-launcher-os-x-3.0.html Soulstorm's OSX launcher]. Download the disk image, open it, and put the launcher in your FS2/FSO folder.

When you first run the installer, let it update itself to at least version 3.1, and enter the location of your FSO application in the bottom part of the window.

Go to the ''GamePlay + Speed'' tab to select one of the mods you have installed. FSO can have only one mod active at the same time, so select the one you want to play. The launcher should be able to find the mods in your FSO folder. If not, you will have to add them to your ''cmdline_fso.cfg'' file by hand.

Go to the ''Graphics'' tab to enter your graphics options. The [[MediaVP|MediaVPS]] mod readme.txt file recommends the following settings, but your Mac may or may not support these:
-spec (Enable Specular maps)
-glow (Enable Glowmaps)
-env (Enable Environment Maps)
-missile_lighting (Apply Lighting to Missiles)
-normal (Enable Normal Maps)
-3dshockwave (Enable 3D Shockwaves in random orientations)

-ambient_factor 35
-spec_exp 15
-spec_point 1.2
-spec_static 1.5
-spec_tube 1.5
-ogl_spec 20

== Install additional mods ==

You can use the fsoinstaller to download more mods, or follow the links in the [[User-made Campaigns (FS2)|FS campaign list]]. [[Total conversions|Total conversion mods]] are also available, which take place outside the [[Portal:FreeSpace Universe|FreeSpace universe]].

Mac Installation Guide

2009-05-01T22:28:08Z

Ovvldc: /* Installing the OSX game launcher */

[[Category:Source Code Project]][[Category:FreeSpace_Open_on_Mac]]Installing FreeSpace Open on a Mac takes several distinct steps:

== Install FreeSpace 2 (optional) ==

If you want to play the original FS2 campaign, you need a copy of the original game. You can find instructions for that on the [[Getting FreeSpace]]page.

FreeSpace 2 is a game for Windows only, so the installer also requires Windows to run. On a Mac you can work around this is several ways:

*install FS2 on a Windows PC and move the entire program's folder to your mac.
*use [http://www.parallels.com/en/products/desktop/ Parallels Desktop], [http://www.vmware.com/products/fusion/ VMware Fusion] or [http://www.virtualbox.org/ VirtualBox].
*use [http://www.codeweavers.com/products/cxmac/ CrossOver Mac] or [http://wiki.winehq.org/MacOSX/Installing Wine].

In all cases, you should end up with a folder that contains an ''FS2.exe'', several ''.vp'' files, and several folders including ''data'', ''ereg'' and ''tools''. Move this folder to a convenient place on your mac. You no longer need any of the .exe files.

== Install FreeSpace Open ==

You can do it by hand, but by far the easiest way is to use Turey's [http://www.fsoinstaller.com/ fsoinstaller]. For the Mac, you need the cross-platform [http://www.fsoinstaller.com/files/installer/java/FreeSpaceOpenInstaller.jar .jar installer]. It needs Java 1.5, which is standard on OSX 10.4 (Tiger) onwards, and can be hacked into 10.3 (Panther).

Run the installer. Select the folder where you moved FS2 or an empty folder if just want FSO. Then make sure you leave the ''Update Current Files'' option ''un''checked. Otherwise, you can select anything you want.

After you select software and [[User-made Campaigns (FS2)|mods]], allow the installer to fetch the latest versions. '''Caution''': Depending on your mod choices, the installer may start downloading several GB. If you are on a relatively slow connection (including basic broadband) this could take hours.

If you want a newer build of the FSO game than the installer provides for, you can find build announcements in the [http://www.hard-light.net/forums/index.php/board,113.0.html Cross-Platform Development forum]. '''Caution''': these builds are experimental and may not function as intended.

== Installing the OSX game launcher ==

On platforms other than Mac, FSO is configured via [[Command-Line Reference|command-line options]]. On the Mac, these options are listed in the ''~library/FS2_Open/data/cmdline_fso.cfg'' file.

You can edit this file by hand, but a more convenient way is to use [http://www.soulstorm-creations.com/PROJECT_SOULSTORM_2_0/cocoa-objective-c/fs2-open-launcher-os-x-3.0.html Soulstorm's OSX launcher]. Download the disk image, open it, and put the launcher in your FS2/FSO folder.

When you first run the installer, let it update itself to at least version 3.1, and enter the location of your FSO application in the bottom part of the window.

Go to the ''GamePlay + Speed'' tab to select one of the mods you have installed. FSO can have only one mod active at the same time, so select the one you want to play. The launcher should be able to find the mods in your FSO folder. If not, you will have to add them to your ''cmdline_fso.cfg'' file by hand.

Go to the ''Graphics'' tab to enter your graphics options. The [[MediaVP|MediaVPS]] mod readme.txt file recommends the following settings, but your Mac may or may not support these:
-spec (Enable Specular maps)
-glow (Enable Glowmaps)
-env (Enable Environment Maps)
-missile_lighting (Apply Lighting to Missiles)
-normal (Enable Normal Maps)
-3dshockwave (Enable 3D Shockwaves in random orientations)

-ambient_factor 35
-spec_exp 15
-spec_point 1.2
-spec_static 1.5
-spec_tube 1.5
-ogl_spec 20

== Install additional mods ==

You can use the fsoinstaller to download more mods, or follow the links in the [[User-made Campaigns (FS2)|FS campaign list]]. [[Total conversions|Total conversion mods]] are also available, which take place outside the [[Portal:FreeSpace Universe|FreeSpace universe]].

Mac Installation Guide

2009-05-01T22:27:14Z

Ovvldc:

[[Category:Source Code Project]][[Category:FreeSpace_Open_on_Mac]]Installing FreeSpace Open on a Mac takes several distinct steps:

== Install FreeSpace 2 (optional) ==

If you want to play the original FS2 campaign, you need a copy of the original game. You can find instructions for that on the [[Getting FreeSpace]]page.

FreeSpace 2 is a game for Windows only, so the installer also requires Windows to run. On a Mac you can work around this is several ways:

*install FS2 on a Windows PC and move the entire program's folder to your mac.
*use [http://www.parallels.com/en/products/desktop/ Parallels Desktop], [http://www.vmware.com/products/fusion/ VMware Fusion] or [http://www.virtualbox.org/ VirtualBox].
*use [http://www.codeweavers.com/products/cxmac/ CrossOver Mac] or [http://wiki.winehq.org/MacOSX/Installing Wine].

In all cases, you should end up with a folder that contains an ''FS2.exe'', several ''.vp'' files, and several folders including ''data'', ''ereg'' and ''tools''. Move this folder to a convenient place on your mac. You no longer need any of the .exe files.

== Install FreeSpace Open ==

You can do it by hand, but by far the easiest way is to use Turey's [http://www.fsoinstaller.com/ fsoinstaller]. For the Mac, you need the cross-platform [http://www.fsoinstaller.com/files/installer/java/FreeSpaceOpenInstaller.jar .jar installer]. It needs Java 1.5, which is standard on OSX 10.4 (Tiger) onwards, and can be hacked into 10.3 (Panther).

Run the installer. Select the folder where you moved FS2 or an empty folder if just want FSO. Then make sure you leave the ''Update Current Files'' option ''un''checked. Otherwise, you can select anything you want.

After you select software and [[User-made Campaigns (FS2)|mods]], allow the installer to fetch the latest versions. '''Caution''': Depending on your mod choices, the installer may start downloading several GB. If you are on a relatively slow connection (including basic broadband) this could take hours.

If you want a newer build of the FSO game than the installer provides for, you can find build announcements in the [http://www.hard-light.net/forums/index.php/board,113.0.html Cross-Platform Development forum]. '''Caution''': these builds are experimental and may not function as intended.

== Installing the OSX game launcher ==

On platforms other than Mac, FSO is configured via [[Command-Line Reference|command-line options]]. On the Mac, these options are listed in the ''~library/FS2_Open/data/cmdline_fso.cfg'' file.

You can edit this file by hand, but a more convenient way is to use [http://www.soulstorm-creations.com/PROJECT_SOULSTORM_2_0/cocoa-objective-c/fs2-open-launcher-os-x-3.0.html Soulstorm's OSX launcher]. Download the disk image, open it, and put the launcher in your FS2/FSO folder.

When you first run the installer, let it update itself to at least version 3.1, and enter the location of your FSO application in the bottom part of the window.

Go to the ''GamePlay + Speed'' tab to select one of the mods you have installed. FSO can have only one mod active at the same time, so select the one you want to play. The launcher should be able to find the mods in your FSO folder. If not, you will have to add them to your ''cmdline_fso.cfg'' file by hand.

Go to the ''Graphics'' tab to enter your graphics options. The [[MediaVP|MediaVPS]] mod recommends the following settings, but your Mac may or may not support these:
-spec (Enable Specular maps)
-glow (Enable Glowmaps)
-env (Enable Environment Maps)
-missile_lighting (Apply Lighting to Missiles)
-normal (Enable Normal Maps)
-3dshockwave (Enable 3D Shockwaves in random orientations)

-ambient_factor 35
-spec_exp 15
-spec_point 1.2
-spec_static 1.5
-spec_tube 1.5
-ogl_spec 20

== Install additional mods ==

You can use the fsoinstaller to download more mods, or follow the links in the [[User-made Campaigns (FS2)|FS campaign list]]. [[Total conversions|Total conversion mods]] are also available, which take place outside the [[Portal:FreeSpace Universe|FreeSpace universe]].

Mac Installation Guide

2009-05-01T22:25:58Z

Ovvldc: first draft

[[Category:FreeSpace_Open_on_Mac]][[Category:Source Code Project]]Installing FreeSpace Open on a Mac takes several distinct steps:

== Install FreeSpace 2 (optional) ==

If you want to play the original FS2 campaign, you need a copy of the original game. You can find instructions for that on the [[Getting FreeSpace]]page.

FreeSpace 2 is a game for Windows only, so the installer also requires Windows to run. On a Mac you can work around this is several ways:

*install FS2 on a Windows PC and move the entire program's folder to your mac.
*use [http://www.parallels.com/en/products/desktop/ Parallels Desktop], [http://www.vmware.com/products/fusion/ VMware Fusion] or [http://www.virtualbox.org/ VirtualBox].
*use [http://www.codeweavers.com/products/cxmac/ CrossOver Mac] or [http://wiki.winehq.org/MacOSX/Installing Wine].

In all cases, you should end up with a folder that contains an ''FS2.exe'', several ''.vp'' files, and several folders including ''data'', ''ereg'' and ''tools''. Move this folder to a convenient place on your mac. You no longer need any of the .exe files.

== Install FreeSpace Open ==

You can do it by hand, but by far the easiest way is to use Turey's [http://www.fsoinstaller.com/ fsoinstaller]. For the Mac, you need the cross-platform [http://www.fsoinstaller.com/files/installer/java/FreeSpaceOpenInstaller.jar .jar installer]]. It needs Java 1.5, which is standard on OSX 10.4 (Tiger) onwards, and can be hacked into 10.3 (Panther).

Run the installer. Select the folder where you moved FS2 or an empty folder if just want FSO. Then make sure you leave the ''Update Current Files'' option ''un''checked. Otherwise, you can select anything you want.

After you select software and [[User-made Campaigns (FS2)|mods]], allow the installer to fetch the latest versions. '''Caution''': Depending on your mod choices, the installer may start downloading several GB. If you are on a relatively slow connection (including basic broadband) this could take hours.

If you want a newer build of the FSO game than the installer provides for, you can find build announcements in the [http://www.hard-light.net/forums/index.php/board,113.0.html Cross-Platform Development forum]. '''Caution''': these builds are experimental and may not function as intended.

== Installing the OSX game launcher ==

On platforms other than Mac, FSO is configured via [[Command-Line Reference|command-line options]]. On the Mac, these options are listed in the ''~library/FS2_Open/data/cmdline_fso.cfg'' file.

You can edit this file by hand, but a more convenient way is to use [http://www.soulstorm-creations.com/PROJECT_SOULSTORM_2_0/cocoa-objective-c/fs2-open-launcher-os-x-3.0.html Soulstorm's OSX launcher]. Download the disk image, open it, and put the launcher in your FS2/FSO folder.

When you first run the installer, let it update itself to at least version 3.1, and enter the location of your FSO application in the bottom part of the window.

Go to the ''GamePlay + Speed'' tab to select one of the mods you have installed. FSO can have only one mod active at the same time, so select the one you want to play. The launcher should be able to find the mods in your FSO folder. If not, you will have to add them to your ''cmdline_fso.cfg'' file by hand.

Go to the ''Graphics'' tab to enter your graphics options. The [[MediaVP|MediaVPS]] mod recommends the following settings, but your Mac may or may not support these:
-spec (Enable Specular maps)
-glow (Enable Glowmaps)
-env (Enable Environment Maps)
-missile_lighting (Apply Lighting to Missiles)
-normal (Enable Normal Maps)
-3dshockwave (Enable 3D Shockwaves in random orientations)

-ambient_factor 35
-spec_exp 15
-spec_point 1.2
-spec_static 1.5
-spec_tube 1.5
-ogl_spec 20

== Install additional mods ==

You can use the fsoinstaller to download more mods, or follow the links in the [[User-made Campaigns (FS2)|FS campaign list]]. [[Total conversions|Total conversion mods]] are also available, which take place outside the [[Portal:FreeSpace Universe|FreeSpace universe]].

Source Code Project index

2009-05-01T21:27:06Z

Ovvldc: fixed Linux guide link and added mac installation link

'''For a summary on how to get started with FreeSpace 2, click [[Getting_started_with_FreeSpace_2|here]].'''

===Getting Started with the FreeSpace Source Code Project (FSSCP)===

#[[FSSCP Introduction]]
#[[Getting FreeSpace]]
#Installing FreeSpace 2 (FS2) Open
#*[[FreeSpace Open Installer|Using the FreeSpace Open (FSO) Installer]]
#*[[Installing fs2_open|Manual Installation Guide (Steps to take if not using the FSO Installer)]]
#*[[Guide to FS Open on Linux|Linux Installation Guide]]
#*[[Mac Installation Guide]]

====Optional Post-Install Information====
*[[Installing Mods for FS2 Open|Installing Mods for FS2 Open]]
*[[Troubleshooting]]
*[[Bug Reporting]]

====Errata====
*[[FS2 Status Page]]
*[[FS2 data installation]]


===Getting Started with Development===
*[[Getting the FreeSpace2: SCP Source Code|Getting the Source Code]]
*[[Coding In C]]
*[[Linux CVS Howto]]


===Notes===
*[[FreeSpace 2 EULA]]

[[Category:Source Code Project]]