Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Refactor run-client-on-linux, rename it to RunOnLinux.md #1072

Merged
merged 2 commits into from
Oct 27, 2024
Merged
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
31 changes: 21 additions & 10 deletions docs/client/run-client-on-linux.md
Original file line number Diff line number Diff line change
@@ -1,15 +1,26 @@
# How to run OMP client on linux

Warning! You DO NOT get the gui working, you can only run this EITHER through the wine terminal, OR a batch script.
(tested on wine-ge 8-26 in a 32-bit prefix in lutris)
-
### Warning! You DO NOT get the working gui, you can only run this EITHER through the wine terminal, OR a batch script.
### (tested on wine-ge 8-26 in a 32-bit prefix, running through lutris)

To get the client to run you need to download the launcher, and omp-client.dll. (https://assets.open.mp/omp-client.dll)
Then you need to put omp-client.dll in the AppData\Local\com.open.mp\omp\ folder of your prefix

You also should install allfonts through winetricks, or else the game will crash when you pause.
In case that the game doesn't work(for me it didn't show the login prompt on wtls), you should try toggling on/off the settings "Prefer system libraries" in lutris.
To get the client to run you need to download the launcher, and [omp-client.dll](https://assets.open.mp/omp-client.dll). \
Then you need to put omp-client.dll in the AppData\Local\com.open.mp\omp\ folder of your prefix.\
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.

### Here is a sample .bat file for editing
```
Z:\path\to\omp-launcher.exe -h server.ip -p port -n dzmtrzz -g Z:\home\yourname\foo\bar\baz\gamepath\
```

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.


## Troubleshooting

| Issue | Supposed fix |
| ------------------------------------------- |:----------------------------------------------------------------------:|
| Game crashes when pausing | There is a missing font, fix by installing allfonts through winetricks |
| Not displaying the login prompt on a server | Try toggling on/off the "Prefer system libraries" setting in lutris |


Here is a sample .bat file.
Z:\path\to\omp-launcher.exe -h server.ip -p port -n dzmtrzz -g Z:\home\yourname\foo\bar\baz\gamepath\
(replace dzmtrzz with whatever username you want, that's just a cheeky self insert)