Mac Installation Guide - Revision history

Jg18: removed an unnecessary blank line

2012-01-07T09:23:26Z

removed an unnecessary blank line

← Older revision		Revision as of 09:23, 7 January 2012
Line 1:		Line 1:
	[[Category:Source Code Project]][[Category:FreeSpace_Open_on_Mac]]		[[Category:Source Code Project]][[Category:FreeSpace_Open_on_Mac]]

	<span style="color:#faa700"><center>'''Note: See [http://www.hard-light.net/forums/index.php?topic=79546.0 this thread] for an up-to-date version of these instructions.'''</center></span>		<span style="color:#faa700"><center>'''Note: See [http://www.hard-light.net/forums/index.php?topic=79546.0 this thread] for an up-to-date version of these instructions.'''</center></span>

Jg18: added link to new OS X instructions (too tired/lazy to edit this article)

2012-01-07T09:20:57Z

added link to new OS X instructions (too tired/lazy to edit this article)

← Older revision		Revision as of 09:20, 7 January 2012
Line 1:		Line 1:
	[[Category:Source Code Project]][[Category:FreeSpace_Open_on_Mac]]Installing FreeSpace Open on a Mac takes several distinct steps:		[[Category:Source Code Project]][[Category:FreeSpace_Open_on_Mac]]

			<span style="color:#faa700"><center>'''Note: See [http://www.hard-light.net/forums/index.php?topic=79546.0 this thread] for an up-to-date version of these instructions.'''</center></span>


			Installing FreeSpace Open on a Mac takes several distinct steps:

	== Install FreeSpace 2 (required) ==		== Install FreeSpace 2 (required) ==

SpaceFreak: Undo revision 31461 by Kore - Adbot alert!

2010-10-26T16:06:16Z

Undo revision 31461 by Kore - Adbot alert!

← Older revision	Revision as of 16:06, 26 October 2010
(No difference)

Shade: another campaign list related fix

2010-05-02T13:13:17Z

another campaign list related fix

← Older revision		Revision as of 13:13, 2 May 2010
Line 63:		Line 63:
	== Install additional mods ==		== 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]].		You can use the FSO installer to download more mods, or follow the links in the [[Campaign List\|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]]		[[Category:Source Code Project]]

Shade: removed dead link

2010-05-02T13:11:01Z

removed dead link

← Older revision		Revision as of 13:11, 2 May 2010
Line 22:		Line 22:
	Run the installer. Select the folder where you have your FS2. Then make sure you leave the ''Update Current Files'' option ''un''checked. Otherwise, you can select anything you want.		Run the installer. Select the folder where you have your FS2. 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.		After you select software and 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.		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.

Fisk: FS2 isn't optional and the source for it is GOG.

2010-02-21T17:20:56Z

FS2 isn't optional and the source for it is GOG.

← Older revision		Revision as of 17:20, 21 February 2010
Line 1:		Line 1:
	[[Category:Source Code Project]][[Category:FreeSpace_Open_on_Mac]]Installing FreeSpace Open on a Mac takes several distinct steps:		[[Category:Source Code Project]][[Category:FreeSpace_Open_on_Mac]]Installing FreeSpace Open on a Mac takes several distinct steps:

	== Install FreeSpace 2 (~~optional~~) ==		== Install FreeSpace 2 (required) ==

	~~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~~.		You need a copy of the original game. You can buy a copy from [http://www.gog.com/en/gamecard/freespace_2 Good Old Games].

	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:		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:
Line 12:		Line 12:
	*use [http://www.codeweavers.com/products/cxmac/ CrossOver Mac] or [http://wiki.winehq.org/MacOSX/Installing Wine].		*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].		If you've gotten your copy of FS2 from a source other than GOG, you'll need to 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.		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.
Line 18:		Line 18:
	== Install FreeSpace Open ==		== 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).		You can do it by hand according to the instructions at [http://www.hard-light.net/forums/index.php?topic=60842.0 the bottom of this thread], but you can also 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.		Run the installer. Select the folder where you have your FS2. 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.		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.
Line 26:		Line 26:
	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.		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		Find your FS2 folder and put the FS2_Open application in your FS2 folder

	== Installing the OS X game launcher ==		== Installing the OS X game launcher ==

Echelon9: Typo fix

2009-08-14T06:19:41Z

Typo fix

← Older revision		Revision as of 06:19, 14 August 2009
Line 54:		Line 54:
	Open up ~/Library/FS2_Open/fs2_open.ini with the text editor of your choice (TextEdit.app). You'll see something like the following:		Open up ~/Library/FS2_Open/fs2_open.ini with the text editor of your choice (TextEdit.app). You'll see something like the following:
	[Default]		[Default]
	VideocardFs2open=OGL -(~~1440x90~~)x32 bit		VideocardFs2open=OGL -(1440x900)x32 bit
	LastPlayer=PlayerS		LastPlayer=PlayerS

Echelon9 at 04:00, 14 August 2009

2009-08-14T04:00:13Z

← Older revision		Revision as of 04:00, 14 August 2009
Line 28:		Line 28:
	Find your FS2O folder, mount the disk image and put the FS2_Open application in your FS2O folder		Find your FS2O folder, mount the disk image and put the FS2_Open application in your FS2O folder

	== Installing the ~~OSX~~ game launcher ==		== Installing the OS X 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.		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.
Line 50:		Line 50:
	-spec_tube 1.5		-spec_tube 1.5
	-ogl_spec 20		-ogl_spec 20

			== Further OS X graphics settings ==
			Open up ~/Library/FS2_Open/fs2_open.ini with the text editor of your choice (TextEdit.app). You'll see something like the following:
			[Default]
			VideocardFs2open=OGL -(1440x90)x32 bit
			LastPlayer=PlayerS

			To set FS2_Open SCP to use the highest setting possible, add the following lines (set AF and AA to preference). Anti-aliasing is available in 3.6.11:
			OGL_AnisotropicFilter=16
			OGL_AntiAliasSamples=8

	== Install additional mods ==		== Install additional mods ==

Ovvldc at 17:27, 3 May 2009

2009-05-03T17:27:40Z

← Older revision		Revision as of 17:27, 3 May 2009
Line 8:		Line 8:

	*install FS2 on a Windows PC and move the entire program's folder to your mac.		*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.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].		*use [http://www.codeweavers.com/products/cxmac/ CrossOver Mac] or [http://wiki.winehq.org/MacOSX/Installing Wine].

TopAce: minor touchups; categorization

2009-05-02T09:30:31Z

minor touchups; categorization

← Older revision		Revision as of 09:30, 2 May 2009
Line 3:		Line 3:
	== Install FreeSpace 2 (optional) ==		== 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.		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:		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:
Line 13:		Line 13:
	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].		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.		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 ==		== 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).		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.		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.		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.		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.
Line 29:		Line 29:
	== Installing the OSX game launcher ==		== 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.		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.		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.
Line 35:		Line 35:
	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 ''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:		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)		-spec (Enable Specular maps)
	-glow (Enable Glowmaps)		-glow (Enable Glowmaps)
Line 52:		Line 52:
	== Install additional mods ==		== 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]].		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]]