MacOS - Revision history

Qaisjp: make warning bigger for people that can't read

2020-11-08T00:43:57Z

make warning bigger for people that can't read

← Older revision		Revision as of 00:43, 8 November 2020
Line 1:		Line 1:
	{{Warning\|This page is intended for developers. If you are here looking for instructions to install the client on macOS, [https://gist.github.com/qaisjp/778ed99ac8a8dcb93f797a28ba5f8303 please read this page!]}}		<div style="font-size: 2em; line-height: 1em;">{{Warning\|This page is intended for developers. If you are here looking for instructions to install the client on macOS, [https://gist.github.com/qaisjp/778ed99ac8a8dcb93f797a28ba5f8303 please read this page!]}}</div>

	This page is incomplete, and is still being updated by developers. If you are here to learn how to run MTA on OS X, you only need to read the first section "[[#Making_Your_Own_Wrapper\|Making Your Own Wrapper]]".		This page is incomplete, and is still being updated by developers. If you are here to learn how to run MTA on OS X, you only need to read the first section "[[#Making_Your_Own_Wrapper\|Making Your Own Wrapper]]".

Qaisjp: Add link to external macOS page

2019-06-18T03:40:17Z

Add link to external macOS page

← Older revision		Revision as of 03:40, 18 June 2019
Line 1:		Line 1:
			{{Warning\|This page is intended for developers. If you are here looking for instructions to install the client on macOS, [https://gist.github.com/qaisjp/778ed99ac8a8dcb93f797a28ba5f8303 please read this page!]}}

	This page is incomplete, and is still being updated by developers. If you are here to learn how to run MTA on OS X, you only need to read the first section "[[#Making_Your_Own_Wrapper\|Making Your Own Wrapper]]".		This page is incomplete, and is still being updated by developers. If you are here to learn how to run MTA on OS X, you only need to read the first section "[[#Making_Your_Own_Wrapper\|Making Your Own Wrapper]]".

Qaisjp: /* Running Multi Theft Auto */ extract winefonts link

2019-05-29T19:58:19Z

Running Multi Theft Auto: extract winefonts link

← Older revision		Revision as of 19:58, 29 May 2019
Line 50:		Line 50:
	=== Running Multi Theft Auto ===		=== Running Multi Theft Auto ===
	Now we need to install Multi Theft Auto.		Now we need to install Multi Theft Auto.
	* Some font files are required for MTA to run. Copy the font files (''.ttf'') from ~~[https://drive.google.com/open?id=0B4SUSkTXjliXZnBXV2pEWkdTTms here]~~ and extract them to `drive_c/windows/fonts` (inside our wrapper). You may have to create the fonts folder yourself if it does not exist.		* Some font files are required for MTA to run. Copy the font files (''.ttf'') from {{WineFonts}} and extract them to `drive_c/windows/fonts` (inside our wrapper). You may have to create the fonts folder yourself if it does not exist.
	* Download the installer from [https://multitheftauto.com the homepage].		* Download the installer from [https://multitheftauto.com the homepage].
	* Open Wineskin.app (inside our wrapper) and select "Install Software", and then select "Choose Setup Executable".		* Open Wineskin.app (inside our wrapper) and select "Install Software", and then select "Choose Setup Executable".

Qaisjp: /* Running San Andreas */ high sierra and above

2019-05-19T23:26:01Z

Running San Andreas: high sierra and above

← Older revision		Revision as of 23:26, 19 May 2019
Line 43:		Line 43:
	* Select "Advanced" to bring up a window titled "Wineskin Advanced".		* Select "Advanced" to bring up a window titled "Wineskin Advanced".
	* Click the "Browse" button next to the "Windows EXE" field and navigate to ''gta_sa.exe''. [[Media:MacOS_wineskin_tut8.png\|The window should now look like this.]]		* Click the "Browse" button next to the "Windows EXE" field and navigate to ''gta_sa.exe''. [[Media:MacOS_wineskin_tut8.png\|The window should now look like this.]]
	* Press "Set Screen Options" at the bottom of the window, and make sure you deselect "Decorate windows", and select "Use Direct3D boost". [[Media:MacOS_wineskin_tut9.png\|It should be configured like this.]] '''[http://wineskin.urgesoftware.com/tiki-view_blog_post.php?postId=87 High Sierra users must read these instructions.]'''		* Press "Set Screen Options" at the bottom of the window, and make sure you deselect "Decorate windows", and select "Use Direct3D boost". [[Media:MacOS_wineskin_tut9.png\|It should be configured like this.]] '''[http://wineskin.urgesoftware.com/tiki-view_blog_post.php?postId=87 High Sierra (and above) users must read these instructions.]'''
	* Click Done. On the "Wineskin Advanced" window, press "Test Run" and San Andreas will begin to run. Note that it will take some time for it to run.		* Click Done. On the "Wineskin Advanced" window, press "Test Run" and San Andreas will begin to run. Note that it will take some time for it to run.
	* After the two GTASA startup logos display, press any key to skip the splash screen.		* After the two GTASA startup logos display, press any key to skip the splash screen.

Qaisjp: /* Running San Andreas */ add high sierra fix

2018-01-20T21:08:36Z

Running San Andreas: add high sierra fix

← Older revision		Revision as of 21:08, 20 January 2018
Line 43:		Line 43:
	* Select "Advanced" to bring up a window titled "Wineskin Advanced".		* Select "Advanced" to bring up a window titled "Wineskin Advanced".
	* Click the "Browse" button next to the "Windows EXE" field and navigate to ''gta_sa.exe''. [[Media:MacOS_wineskin_tut8.png\|The window should now look like this.]]		* Click the "Browse" button next to the "Windows EXE" field and navigate to ''gta_sa.exe''. [[Media:MacOS_wineskin_tut8.png\|The window should now look like this.]]
	* Press "Set Screen Options" at the bottom of the window, and make sure you deselect "Decorate windows", and select "Use Direct3D boost". [[Media:MacOS_wineskin_tut9.png\|It should be configured like this.]]		* Press "Set Screen Options" at the bottom of the window, and make sure you deselect "Decorate windows", and select "Use Direct3D boost". [[Media:MacOS_wineskin_tut9.png\|It should be configured like this.]] '''[http://wineskin.urgesoftware.com/tiki-view_blog_post.php?postId=87 High Sierra users must read these instructions.]'''
	* Click Done. On the "Wineskin Advanced" window, press "Test Run" and San Andreas will begin to run. Note that it will take some time for it to run.		* Click Done. On the "Wineskin Advanced" window, press "Test Run" and San Andreas will begin to run. Note that it will take some time for it to run.
	* After the two GTASA startup logos display, press any key to skip the splash screen.		* After the two GTASA startup logos display, press any key to skip the splash screen.
	* After you've tried the game a little, quit. You may close (press Cancel) the dialog box that asks you whether you want to view logs.		* After you've tried the game a little, quit. You may close (press Cancel) the dialog box that asks you whether you want to view logs.

	=== Running Multi Theft Auto ===		=== Running Multi Theft Auto ===
	Now we need to install Multi Theft Auto.		Now we need to install Multi Theft Auto.

Qaisjp: /* Running Multi Theft Auto */ Fix font link

2017-04-19T18:35:41Z

Running Multi Theft Auto: Fix font link

← Older revision		Revision as of 18:35, 19 April 2017
Line 50:		Line 50:
	=== Running Multi Theft Auto ===		=== Running Multi Theft Auto ===
	Now we need to install Multi Theft Auto.		Now we need to install Multi Theft Auto.
	* Some font files are required for MTA to run. Copy the font files (''.ttf'') from [https://~~www~~.~~dropbox~~.com/~~s/y148veucqb7sfku/fonts.zip~~?dl=0 here] and extract them to `drive_c/windows/fonts` (inside our wrapper). You may have to create the fonts folder yourself if it does not exist.		* Some font files are required for MTA to run. Copy the font files (''.ttf'') from [https://drive.google.com/open?id=0B4SUSkTXjliXZnBXV2pEWkdTTms here] and extract them to `drive_c/windows/fonts` (inside our wrapper). You may have to create the fonts folder yourself if it does not exist.
	* Download the installer from [https://multitheftauto.com the homepage].		* Download the installer from [https://multitheftauto.com the homepage].
	* Open Wineskin.app (inside our wrapper) and select "Install Software", and then select "Choose Setup Executable".		* Open Wineskin.app (inside our wrapper) and select "Install Software", and then select "Choose Setup Executable".

Qaisjp: update headers

2016-08-08T15:26:55Z

update headers

← Older revision		Revision as of 15:26, 8 August 2016
Line 3:		Line 3:
	Contact [[User:qaisjp]] if you need any help with anything on this page.		Contact [[User:qaisjp]] if you need any help with anything on this page.

	= User Experience =		=== User Experience ===
	This section outlines what our automated version will do.		This section outlines what our automated version will do.

Line 17:		Line 17:
	* start Multi Theft Auto for us automatically		* start Multi Theft Auto for us automatically

	= Making Your Own Wrapper =		== Making Your Own Wrapper ==
	This section is written like a tutorial for public consumption, but is intended to serve as working documentation to aid the automated version in development. It is recommended that you read through this entire section (including the "Tips" section at the bottom) before following the tutorial, if you wish to build your own Wineskin wrapper. You do not need to read any other sections.		This section is written like a tutorial for public consumption, but is intended to serve as working documentation to aid the automated version in development. It is recommended that you read through this entire section (including the "Tips" section at the bottom) before following the tutorial, if you wish to build your own Wineskin wrapper. You do not need to read any other sections.

	== Grabbing the Winery==		=== Grabbing the Winery===
	* Grab the [http://wineskin.urgesoftware.com/tiki-index.php?page=Downloads Wineskin Winery]. At the time of writing, v1.7. This allows you to create your own wrapper.		* Grab the [http://wineskin.urgesoftware.com/tiki-index.php?page=Downloads Wineskin Winery]. At the time of writing, v1.7. This allows you to create your own wrapper.
	* Open ''Wineskin Winery.app'', and [[Media:MacOS_wineskin_tut1.png\|click "Update" underneath "No Wrapper Installed" to download the master wrapper.]].		* Open ''Wineskin Winery.app'', and [[Media:MacOS_wineskin_tut1.png\|click "Update" underneath "No Wrapper Installed" to download the master wrapper.]].
Line 33:		Line 33:
	Now we have generated an empty wrapper, we need to add GTA, install MTA, and configure some other settings.		Now we have generated an empty wrapper, we need to add GTA, install MTA, and configure some other settings.

	== Running San Andreas ==		=== Running San Andreas ===
	Firstly, we will test out Grand Theft Auto: San Andreas. For the sake of this tutorial we will assume that you already have a folder containing your GTA:SA files (copied over from a Windows installation). You ''may'' need a no-cd version of the exe.		Firstly, we will test out Grand Theft Auto: San Andreas. For the sake of this tutorial we will assume that you already have a folder containing your GTA:SA files (copied over from a Windows installation). You ''may'' need a no-cd version of the exe.

Line 48:		Line 48:
	* After you've tried the game a little, quit. You may close (press Cancel) the dialog box that asks you whether you want to view logs.		* After you've tried the game a little, quit. You may close (press Cancel) the dialog box that asks you whether you want to view logs.

	== Running Multi Theft Auto ==		=== Running Multi Theft Auto ===
	Now we need to install Multi Theft Auto.		Now we need to install Multi Theft Auto.
	* Some font files are required for MTA to run. Copy the font files (''.ttf'') from [https://www.dropbox.com/s/y148veucqb7sfku/fonts.zip?dl=0 here] and extract them to `drive_c/windows/fonts` (inside our wrapper). You may have to create the fonts folder yourself if it does not exist.		* Some font files are required for MTA to run. Copy the font files (''.ttf'') from [https://www.dropbox.com/s/y148veucqb7sfku/fonts.zip?dl=0 here] and extract them to `drive_c/windows/fonts` (inside our wrapper). You may have to create the fonts folder yourself if it does not exist.
Line 60:		Line 60:
	* Perform a Test Run, and hopefully Multi Theft Auto should run!		* Perform a Test Run, and hopefully Multi Theft Auto should run!

	== Tips ==		=== Tips ===
	* You can use the keybind Cmd+Opt+A at any time to switch between windowed & fullscreen. You may need to use this if you cmd+tab out of the app, and the app ends up moving to windowed mode.		* You can use the keybind Cmd+Opt+A at any time to switch between windowed & fullscreen. You may need to use this if you cmd+tab out of the app, and the app ends up moving to windowed mode.
	* If you are asked at any time to install Gecko or Mono, simply press yes.		* If you are asked at any time to install Gecko or Mono, simply press yes.

Qaisjp: move section around

2016-08-08T15:26:18Z

move section around

@@ Line 1: / Line 1: @@
-This page is incomplete, and is still being updated by developers. If you are here to learn how to run MTA on OS X, you only need to read the first section "Making Your Own Wrapper".
+This page is incomplete, and is still being updated by developers. If you are here to learn how to run MTA on OS X, you only need to read the first section "[[#Making_Your_Own_Wrapper|Making Your Own Wrapper]]".
 Contact [[User:qaisjp]] if you need any help with anything on this page.
 = Making Your Own Wrapper =
@@ Line 51: / Line 65: @@
 * If you receive the message "Warning: Could not detect anti-virus product" when starting MTA, simply check the box saying "I will not install an anti-virus", and press OK. This message occurs because MTA cannot detect OS X antiviruses.
 [[Category:Development]]<lowercasetitle></lowercasetitle>

Qaisjp: /* Making Your Own Wrapper */

2016-08-08T15:25:17Z

Making Your Own Wrapper

← Older revision		Revision as of 15:25, 8 August 2016
Line 4:		Line 4:

	= Making Your Own Wrapper =		= Making Your Own Wrapper =
	This section is written like a tutorial for public consumption, but is intended to serve as working documentation to aid the automated version in development. It is recommended that you read through this entire section (including the "Tips" section at the bottom) before following the tutorial, if you wish to build your own Wineskin wrapper.		This section is written like a tutorial for public consumption, but is intended to serve as working documentation to aid the automated version in development. It is recommended that you read through this entire section (including the "Tips" section at the bottom) before following the tutorial, if you wish to build your own Wineskin wrapper. You do not need to read any other sections.

	== Grabbing the Winery==		== Grabbing the Winery==

Qaisjp: add images

2016-08-08T15:23:31Z

add images

← Older revision		Revision as of 15:23, 8 August 2016
Line 1:		Line 1:
	This page is incomplete, and is still being updated by developers. If you are here to learn how to run MTA on OS X, you only need to read the first section "Making Your Own Wrapper".		This page is incomplete, and is still being updated by developers. If you are here to learn how to run MTA on OS X, you only need to read the first section "Making Your Own Wrapper".

			Contact [[User:qaisjp]] if you need any help with anything on this page.

	= Making Your Own Wrapper =		= Making Your Own Wrapper =
Line 6:		Line 8:
	== Grabbing the Winery==		== Grabbing the Winery==
	* Grab the [http://wineskin.urgesoftware.com/tiki-index.php?page=Downloads Wineskin Winery]. At the time of writing, v1.7. This allows you to create your own wrapper.		* Grab the [http://wineskin.urgesoftware.com/tiki-index.php?page=Downloads Wineskin Winery]. At the time of writing, v1.7. This allows you to create your own wrapper.
	* Open ''Wineskin Winery.app'', and click the + plus button. This will bring up a new window titled "Add Engine".		* Open ''Wineskin Winery.app'', and [[Media:MacOS_wineskin_tut1.png\|click "Update" underneath "No Wrapper Installed" to download the master wrapper.]].
	* Select the latest engine (at the time of writing, WS9Wine1.9.15) and click the blue "Download and Install" button.		* Now click the + plus button. This will bring up a new window titled "Add Engine".
	* Once the engine has downloaded, click "Update" underneath "No Wrapper Installed".		* Select the latest engine (at the time of writing, WS9Wine1.9.15) and [[Media:MacOS_wineskin_tut2.png\|click the blue "Download and Install" button]].
	* Now you can click "Create New Blank Wrapper" button at the bottom of the "Wineskin Winery" window.		* Now you can [[Media:MacOS_wineskin_tut3.png\|click "Create New Blank Wrapper" button at the bottom of the "Wineskin Winery" window]].
	* Call the application whatever you like, "Multi Theft Auto" is a good name to use.		* Call the application whatever you like, "Multi Theft Auto" is a good name to use.
	* You may receive a firewall dialog. Press "Yes".		* [[Media:MacOS_wineskin_tut4.png\|You may receive a firewall dialog.]] Press "Yes".
	* Allow the wrapper to be created. This will take some time.		* Allow the wrapper to be created. This will take some time.
	* A new wrapper will be generated in the Applications folder '''in your home folder'''. It will not appear in your main Applications folder (which resides in the root of your drive, for all the users).		* A new wrapper will be generated in the Applications folder '''in your home folder'''. It will not appear in your main Applications folder (which resides in the root of your drive, for all the users).
Line 21:		Line 23:

	* Right click your main wrapper app (in my case, "MTASA.app") and press "Show package contents"		* Right click your main wrapper app (in my case, "MTASA.app") and press "Show package contents"
	* There should be three items inside here. Open the ''drive_c'' shortcut, open ''Program Files'', and create a folder called ''Rockstar Games''.		* [[Media:MacOS_wineskin_tut5.png\|There should be three items inside here.]] Open the ''drive_c'' shortcut, open ''Program Files'', and create a folder called ''Rockstar Games''.
	* Copy (or move) your ''GTA San Andreas'' folder here.		* Copy (or move) your ''GTA San Andreas'' folder here.
	* Your drive_c folder should now look a bit like this.		* [[Media:MacOS_wineskin_tut6.png\|Your drive_c folder should now look a bit like this.]]
	* Now select ''Wineskin.app'' (which inside our main app). This application allows us to configure our wrapper.		* Now select ''Wineskin.app'' (which inside our main app). [[Media:MacOS_wineskin_tut7.png\|This application allows us to configure our wrapper.]]
	* Select "Advanced" to bring up a window titled "Wineskin Advanced".		* Select "Advanced" to bring up a window titled "Wineskin Advanced".
	* Click the "Browse" button next to the "Windows EXE" field and navigate to ''gta_sa.exe''		* Click the "Browse" button next to the "Windows EXE" field and navigate to ''gta_sa.exe''. [[Media:MacOS_wineskin_tut8.png\|The window should now look like this.]]
	* Press "Set Screen Options" at the bottom of the window, and make sure you deselect "Decorate windows", and select "Use Direct3D boost". It should be configured like this.		* Press "Set Screen Options" at the bottom of the window, and make sure you deselect "Decorate windows", and select "Use Direct3D boost". [[Media:MacOS_wineskin_tut9.png\|It should be configured like this.]]
	* Click Done. On the "Wineskin Advanced" window, press "Test Run" and San Andreas will begin to run. Note that it will take some time for it to run.		* Click Done. On the "Wineskin Advanced" window, press "Test Run" and San Andreas will begin to run. Note that it will take some time for it to run.
	* After the two GTASA startup logos display, press any key to skip the splash screen.		* After the two GTASA startup logos display, press any key to skip the splash screen.