Skip to content

Commit f11a59f

Browse files
authored
Update ClientOnLinux.md
Updated client install steps for Linux
1 parent 0e6807f commit f11a59f

File tree

1 file changed

+22
-15
lines changed

1 file changed

+22
-15
lines changed

docs/client/ClientOnLinux.md

Lines changed: 22 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,26 +1,33 @@
1-
# How to run OMP client on linux
21

3-
### Warning! You DO NOT get the working gui, you can only run this EITHER through the wine terminal, OR a batch script.
4-
### (tested on wine-ge 8-26 in a 32-bit prefix, running through lutris)
2+
# How to run the open.mp client on Linux
53

4+
> **Warning:** You DO NOT get a working GUI, this must be executed in a Wine prefix via command line arguments.
5+
### Tested on:
66

7-
To get the client to run you need to download the launcher, and [omp-client.dll](https://assets.open.mp/omp-client.dll). \
8-
Then you need to put omp-client.dll in the AppData\Local\mp.open.launcher\omp\ folder of your prefix.\
9-
After that, you can execute the open mp launcher through the cli, or make a batch file like the one below, so that you can add it to your launcher of choice.
7+
- Lutris: wine-ge 8-26 32-bit prefix
8+
- Bottles: soda-9.0-1
109

11-
### Here is a sample .bat file for editing
10+
### How to:
11+
12+
1. Ensure you have a Wine prefix created with GTA San Andreas installed.
13+
2. Download the [open.mp](https://github.com/openmultiplayer/launcher/releases/latest) launcher and install it inside the Wine prefix.
14+
3. Download the [SA-MP client](https://github.com/KrustyKoyle/files.sa-mp.com-Archive) and install it in the same Wine Prefix.
15+
4. Download the [omp-client.dll](https://assets.open.mp/omp-client.dll) and copy it to the `AppData\Local\mp.open.launcher\omp\` folder of the main user in your prefix.
16+
17+
Finally, you can execute the open.mp launcher through the Wine prefixes CLI or write it to a .bat script for easy launching.
18+
19+
### Sample launch command
1220
```
13-
Z:\path\to\omp-launcher.exe -h server.ip -p port -n dzmtrzz -g Z:\home\yourname\foo\bar\baz\gamepath\
21+
Z:\path\to\omp-launcher.exe -h server.ip -p port -n user.name -g Z:\home\yourname\path\to\gta-san-andreas\install\
1422
```
1523

16-
You can run omp-launcher.exe with the --help flag to get more info about the flags, in case the example above isn't enough.
24+
> You can run omp-launcher.exe with the --help flag to get more info about the flags, in case the example above isn't enough.
1725
1826

1927
## Troubleshooting
2028

21-
| Issue | Supposed fix |
22-
| ------------------------------------------- |:----------------------------------------------------------------------:|
23-
| Game crashes when pausing | There is a missing font, fix by installing allfonts through winetricks |
24-
| Not displaying the login prompt on a server | Try toggling on/off the "Prefer system libraries" setting in lutris |
25-
26-
29+
| Issue | Supposed fix |
30+
| -------------------------------------------- |:------------------------------------------------------------------------------------:|
31+
| Game crashes when pausing | There is a missing font, fix by installing allfonts through winetricks. |
32+
| Not displaying the login prompt on a server | Try toggling on/off the "Prefer system libraries" setting in lutris. |
33+
| Black box appears and the game does not load | You may be missing launch parameters on the CLI. Please review your launch command. |

0 commit comments

Comments
 (0)