Skip to content

Commit a7d6986

Browse files
FileEXFileEX
committed
Steam Deck manual
1 parent bbcc5ea commit a7d6986

3 files changed

Lines changed: 93 additions & 3 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: "Scripting introduction", link: "/guides/Scripting-introduction"},
90+
{label: "Steam Deck manual", link: "/guides/SteamDeck"},
9091
{label: "Introduction to scripting GUI", link: "/guides/GUI-introduction"},
9192
{label: "Script security", link: "/guides/Script-security"},
9293
{label: "Introduction to CEF", link: "/guides/CEF-introduction"},

‎web/src/pages/guides/CEF-introduction.mdx‎

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,6 @@
11
import AutoStarlightPage from '@src/components/AutoStarlightPage.astro';
22
import { getSeeAlsoLinksFromList } from '@src/utils/general';
33
import SeeAlsoSection from '@src/components/SeeAlsoSection.astro';
4-
import VersionBox from '@src/components/VersionBox.astro';
5-
import { Code } from '@astrojs/starlight/components';
6-
import NoteBox from '@src/components/NoteBox.astro';
74

85
<AutoStarlightPage frontmatter={{
96
template: 'doc',

‎web/src/pages/guides/SteamDeck.mdx‎

Lines changed: 92 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,92 @@
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 Steam Deck Manual',
8+
tableOfContents: true
9+
}}>
10+
11+
<NoteBox type='warning'>This page was created with limited knowledge of running Multi Theft Auto on the Steam Deck. Further testing is needed and steps may change as more knowledge is gained.</NoteBox>
12+
<NoteBox type="tip">Connecting a keyboard and mouse to your Steam Deck is recommended when following this guide.</NoteBox>
13+
14+
## Other methods
15+
A more simpler and straight forward way is using Bottles/Soda on Steam Deck, see [Client on Linux using Bottles/Soda Manual](/guides/LinuxManual#Bottles/Soda).
16+
17+
The instructions below can still be used on Steam Deck but require more fiddling around with Proton and the system.
18+
19+
## Prerequisites
20+
* A Steam Deck with the default OS (SteamOS) installed.
21+
* A copy of GTA San Andreas, either through Steam or copied over into your SteamOS.
22+
* Multi Theft Auto installer (download latest Win10+ release [here](https://multitheftauto.com/)).
23+
* Windows fonts (Download a ZIP archive with all three [here](https://drive.google.com/open?id=0B4SUSkTXjliXZnBXV2pEWkdTTms) and extract it):
24+
* tahoma.ttf
25+
* tahomabd.ttf
26+
* verdana.ttf
27+
28+
## MTA installation
29+
<Steps>
30+
1. Switch to desktop mode if not there already.
31+
2. Download the latest Multi Theft Auto version from the [official website](https://multitheftauto.com/).
32+
3. Add the installer as a non-Steam game (open up the context menu and click `Add To Steam`).
33+
4. Switch to game mode.
34+
5. Locate the installer in the non-Steam game section in your Steam library.
35+
6. Open the context menu and click `properties`, then switch to the `compatibility` tab. Here select the latest (non-experimental) version of Proton.
36+
7. Close properties and run the installer.
37+
8. Follow all the steps, it's advisable to not change the path to your MTA installation. Select (or type) your GTA San Andreas installation path when prompted.
38+
</Steps>
39+
40+
### Locating your MTA installation
41+
Proton creates a virtual filesystem for Windows. We need to locate the path it created for your MTA installation as we'll need it for the next steps.
42+
<Steps>
43+
1. Switch to desktop mode.
44+
2. Navigate to `/home/deck/.local/share/Steam/steamapps/compatdata/`.
45+
3. Locate the folder (these folders represent app IDs) that contains your installation. Either by sorting by newest or by opening them up and navigating to
46+
> `/home/deck/.local/share/Steam/steamapps/compatdata/<ID>/pfx/drive_c/Program Files (x86)/`
47+
48+
to verify that a folder for MTA (MTA San Andreas 1.X) exists.
49+
4. Note down this ID once found.
50+
</Steps>
51+
52+
### Installing Windows fonts
53+
Copy the fonts you downloaded and put them in `/home/deck/.local/share/Steam/steamapps/compatdata/<ID>/pfx/drive_c/windows/fonts`.
54+
55+
### Getting MTA to run
56+
<NoteBox type="info">
57+
Testing has shown that it's advisable to have a PC with an existing MTA installation running during your first startup.
58+
This is similar to running MTA in a VM, as it will take on the serial from this PC which should prevent the `serial cannot be validated` error.
59+
</NoteBox>
60+
61+
You're nearly there. We're now going to swap the MTA installation executable with the MTA launcher itself in your existing non-Steam game setup.
62+
<Steps>
63+
1. Switch to game mode.
64+
2. Navigate to your non-Steam game section in your Steam library and locate the installer from earlier.
65+
3. Open up properties and look for `target`.
66+
4. Modify the existing target with the path to your MTA installation (make sure to keep the double quotes!). By default it would be as follows
67+
> `/home/deck/.local/share/Steam/steamapps/compatdata/<ID>/pfx/drive_c/Program Files (x86)/MTA San Andreas 1.X`
68+
5. Start Multi Theft Auto and enjoy! You may have to select your GTA San Andreas installation path once more.
69+
</Steps>
70+
71+
## Troubleshooting
72+
* Missing tahoma.ttf/verdana.ttf font error
73+
* Download the fonts [here](https://drive.google.com/open?id=0B4SUSkTXjliXZnBXV2pEWkdTTms) and put them in
74+
> `/home/deck/.local/share/Steam/steamapps/compatdata/<ID>/pfx/drive_c/windows/fonts`
75+
* Flickering taskbar after MTA started (desktop mode)
76+
* Workarround for now, go to `settings -> video` tab and change resolution to **1280x720 windowed (DO NOT USE FULLSCREEN MODE)**.
77+
* MTA crashes when entering main menu after selecting fullscreen mode in video settings tab **(D3D9.dll crash offset ED711)**
78+
* Manually revert this setting by going to
79+
> `/home/deck/.local/share/Steam/steamapps/compatdata/<ID>/pfx/drive_c/Program Files (x86)/MTA San Andreas 1.X/MTA/config`
80+
81+
and opening coreconfig.xml with KWrite application. Search for `display_fullscreen_style` and change the property from **0** to **1**.
82+
* There was a problem validating your serial.
83+
* Follow the guide over [here](https://updatesa.multitheftauto.com/sa/trouble/?tr=serial-validation) and setup the linux server on steamdeck
84+
* Cannot start linux server on steamdeck due to missing **libncurses5 file/lib**
85+
* Download the ncurses5-compat-libs [here](https://arch.alerque.com/x86_64/ncurses5-compat-libs-6.2-1-x86_64.pkg.tar.zst). After downloading, open terminal inside Downloads folder and run following commands:
86+
```sh
87+
sudo steamos-readonly disable
88+
sudo pacman -U ncurses5-compat-libs-6.2-1-x86_64.pkg.tar.zst
89+
sudo steamos-readonly enable
90+
```
91+
92+
</AutoStarlightPage>

0 commit comments

Comments
 (0)