Skip to content
Open
Changes from all commits
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
14 changes: 8 additions & 6 deletions docs/Install/Installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,24 +13,26 @@ If you're running the game _without_ Steam and it's immediately closing on start
## Linux (Proton/Wine)
As of version 0.0.7.2, SPL officially supports Linux through Proton/Wine. Below are the steps to install and run SPL on Linux.

Proton 10 is recommended. [Proton 11 does not load msvcrt.dll](https://github.com/Fexty12573/SharpPluginLoader/issues/62).

1. Install .NET Desktop Runtime 8.0 and Direct 3D Shader Compiler using [protontricks](https://github.com/Matoking/protontricks):
```bash
protontricks 582010 dotnetdesktop8 d3dcompiler_47
```
2. Download the latest linux release of SPL (`SharpPluginLoader-<version>-linux.zip`) from the [Releases Page](https://github.com/Fexty12573/SharpPluginLoader/releases) and extract it into the game's root directory. After doing so you should have a `ucrtbase.dll` file in the same directory as `MonsterHunterWorld.exe`.
2. Download the latest linux release of SPL (`SharpPluginLoader-<version>-linux.zip`) from the [Releases Page](https://github.com/Fexty12573/SharpPluginLoader/releases) and extract it into the game's root directory. After doing so you should have a `msvcrt.dll` file in the same directory as `MonsterHunterWorld.exe`.
3. Set the Steam launch options for MHW as follows:
```bash
# Use this for SPL only
WINEDLLOVERRIDES="ucrtbase=n,b" %command%
WINEDLLOVERRIDES="msvcrt=n,b" %command%

# Or this for SPL together with Stracker's Loader
WINEDLLOVERRIDES="ucrtbase,dinput8=n,b" %command%
WINEDLLOVERRIDES="msvcrt,dinput8=n,b" %command%
```

If the game fails to start, even with the dependencies above correctly installed, check your environment for `DOTNET_ROOT`. It may be set by your package manager. For example, on Gentoo with `eselect dotnet`. You can unset it in your Steam launch options like so:
```bash
# Unset DOTNET_ROOT to avoid conflict with native dotnet and dotnet installed in the Wine prefix.
DOTNET_ROOT= WINEDLLOVERRIDES="ucrtbase,dinput8=n,b" %command%
DOTNET_ROOT= WINEDLLOVERRIDES="msvcrt,dinput8=n,b" %command%
```

## Usage
Expand All @@ -54,7 +56,7 @@ Depending on the plugins you have installed you might also see an overlay/UI app
### Directory Structure Examples
```
<Root game directory>
└── winmm.dll/ucrtbase.dll
└── winmm.dll/msvcrt.dll
└── nativePC
└── plugins
└── CSharp
Expand All @@ -67,7 +69,7 @@ Depending on the plugins you have installed you might also see an overlay/UI app
Conversely, the following is **not** valid, as `Plugin1.dll` is inside the `Loader` directory. The plugin loader will not load it.
```
<Root game directory>
└── winmm.dll/ucrtbase.dll
└── winmm.dll/msvcrt.dll
└── nativePC
└── plugins
└── CSharp
Expand Down
Loading