Skip to content

Commit c580ae9

Browse files
FileEXFileEX
committed
MacOS manual
1 parent 1c1955d commit c580ae9

2 files changed

Lines changed: 121 additions & 0 deletions

File tree

‎web/astro.config.mjs‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -87,6 +87,7 @@ export default defineConfig({
8787
label: "Guides",
8888
items: [
8989
{label: "Client on Linux manual", link: "/guides/Client-on-Linux-manual"},
90+
{label: "Client on MacOS X manual", link: "/guides/Client-on-mac"},
9091
{label: "Steam Deck manual", link: "/guides/SteamDeck"},
9192
{label: "Scripting introduction", link: "/guides/Scripting-introduction"},
9293
{label: "Introduction to scripting GUI", link: "/guides/GUI-introduction"},

‎web/src/pages/guides/Client-on-mac.mdx‎

Lines changed: 120 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,120 @@
1+
import AutoStarlightPage from '@src/components/AutoStarlightPage.astro';
2+
import NoteBox from '@src/components/NoteBox.astro';
3+
import { Steps } from '@astrojs/starlight/components';
4+
5+
<AutoStarlightPage frontmatter={{
6+
template: 'doc',
7+
title: 'Client on MacOS X manual',
8+
tableOfContents: {
9+
maxHeadingLevel: 4,
10+
}
11+
}}>
12+
13+
<NoteBox type="needs_checking">This guide might be outdated.</NoteBox>
14+
15+
<NoteBox type="important">
16+
**This does not work on macOS Catalina.**
17+
18+
macOS Catalina removes support for 32bit software. A 64bit version of Wine does exist, but it's not easy to make 32bit software run inside 64bit Wine — at least not on macOS.
19+
20+
Other options include:
21+
* Install Windows in a Virtual Machine (using e.g. VirtualBox), and install MTA in there
22+
* [Downgrading Catalina to an earlier version](https://www.digitaltrends.com/computing/how-to-downgrade-from-catalina-to-mojave/)
23+
* [Hacking Catalina to support 32 bit software](https://apple.stackexchange.com/questions/363574/how-much-of-32-bit-support-is-dropped-in-macos-catalina)
24+
</NoteBox>
25+
26+
## Preparation
27+
* Download [MTA Installer](https://mtasa.com/download)
28+
* Make sure you have the GTA San Andreas folder copied to your computer.
29+
* You might need a GTA SA 1.00 No CD crack - any HOODLUM release will do.
30+
31+
## Install Wine
32+
<Steps>
33+
1. Make sure you have [Homebrew](https://brew.sh/) installed.
34+
2. Get the latest staging version of Wine, you can do this by running the following commands:
35+
* `brew tap homebrew/cask-versions`: import the Homebrew repository for alternate cask versions
36+
* `brew cask install wine-staging`: install wine-staging
37+
3. Run wine start explorer.exe and press **Install** if prompted about Wine Mono.
38+
<NoteBox type="tip">If you are not prompted about Wine Mono now, make sure you select **Install** if you are ever prompted to install it in the future.</NoteBox>
39+
</Steps>
40+
41+
## Play GTA
42+
Run
43+
```sh
44+
wine start explorer.exe
45+
```
46+
and navigate to `gta_sa.exe`.
47+
48+
If you get stuck after the NVIDIA logo, just hit **Space** to skip the Rockstar logo videos that would ordinarily play.
49+
50+
<NoteBox type="tip">
51+
1. You can use `Cmd+Tab` to minimise GTA San Andreas.
52+
2. Start GTA from the Terminal like this:
53+
```sh
54+
wine start /unix ~/Documents/Projects/mtasa/macos/Rockstar\ Games/GTA\ San\ Andreas/gta_sa.exe
55+
```
56+
</NoteBox>
57+
58+
## Install MTA
59+
Navigate and run mta installer using your preferred method (from explorer.exe or from the Terminal, as above).
60+
61+
### Verify MTA works
62+
<Steps>
63+
1. Start MTA (from the installer, or by navigating through `C:\Program Files (x86)\`).
64+
2. Hit `Map Editor`
65+
3. Make sure you can fly around the GTA map!
66+
4. Process to test CEF (see below).
67+
</Steps>
68+
69+
### Running MTA in the future
70+
<Steps>
71+
1. Opening `Terminal.app`.
72+
2. Running
73+
```sh
74+
wine start /unix ~/.wine/drive_c/Program\ Files/MTA\ San\ Andreas\ 1.5/Multi\ Theft\ Auto.exe
75+
```
76+
</Steps>
77+
78+
## CEF (web browsers)
79+
CEF stands for Chromium Embedded Framework. It is essential that this works for you.
80+
This section has been copied to the following AppDB entries: [1.5.6](https://appdb.winehq.org/objectManager.php?sClass=version&iId=38051)
81+
82+
### Test CEF
83+
<Steps>
84+
1. Open the console by hitting the backtick key (to the left of the `1` key).
85+
2. Enter `start webbrowser`
86+
3. Close the console using the same key, and press the Chromium icon in the bottom left corner.
87+
4. If you do NOT see the MTA website, please see the "Fix CEF" section below.
88+
</Steps>
89+
90+
### Fix CEF
91+
<Steps>
92+
1. Open `Terminal.app`.
93+
2. Type
94+
```sh
95+
cd "~/.wine/drive_c/Program Files/MTA San Andreas 1.5/MTA"
96+
```
97+
and hit **Enter**.
98+
3. Type
99+
```sh
100+
ln -s libcef.dll chrome_elf.dll icudtl.dat natives_blob.bin v8_context_snapshot.bin snapshot_blob.bin CEF/
101+
```
102+
103+
If you previously followed an earlier version of these instructions and this line complains about File exists, first run the following commands, then reattempt the above command:
104+
```sh
105+
cd CEF
106+
rm libcef.dll chrome_elf.dll icudtl.dat natives_blob.bin v8_context_snapshot.bin snapshot_blob.bin
107+
cd ../
108+
# Now you may run the `ln -s` command above.
109+
```
110+
4. Test this feature as described above.
111+
</Steps>
112+
113+
## Enable EAX
114+
<Steps>
115+
1. Type `winecfg` into a Terminal.
116+
2. Navigate to **Staging**.
117+
3. Enable EAX.
118+
</Steps>
119+
120+
</AutoStarlightPage>

0 commit comments

Comments
 (0)