noctra/Jackify
1
0
Fork 0
mirror of https://github.com/Omni-guides/Jackify.git synced 2026-01-17 19:47:00 +01:00
Code Issues Packages Projects Releases Wiki Activity

Initial Draft

Omni-guides
2024-10-04 23:07:05 +01:00
parent 9b1251a400
commit 622beec94b
1 changed files with 257 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

257
Wabbajack-on-Steam-Deck-Linux-via-Bottles.md Normal file

@@ -0,0 +1,257 @@
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/WabbajackLinux/WabbajackLinuxBanner.png" width="1000">
This is all unofficial, please don't ask for support from Wabbajack Support staff in the way you would if you have an issue running Wabbajack on Windows, instead please seek assistance from the #unofficial-linux-help channel on the Official Wabbajack Discord. There have been many users involved at various stages of getting things this far, and a lot of trial and error and testing has been done before things were repeatable enough to form into a guide and offer it as an option for those running Linux as their primary OS - most recently Sulfur Nitride, blejusca, Ouroboros, iGhost and trawzified on the Official Wabbajack Discord, but many, many more over the time. Thanks to all involved for getting this far!
As with my other guides, they may look longer and more involved than the steps actually are - this is to try and be as clear as possible, step by step.
This guide covers how to run Wabbajack in a Bottles environment. The process is very similar to running Wabbajack in a base Wine environment, but for Steam Deck users, and anyone that prefers to use Bottles rather than base Wine, this guide should get things up and running.
---
### Wabbajack in a Bottle
Thanks to advancements with Wine, it now appears that running Wabbajack on Linux is a viable option - though please understand that there won't be any guarantee of 100% compatibility. As it stands, it's 'good enough' to be able to install a Wabbajack modlist. Starting with Wine v9.15, it seems that only a few steps are required to successfully run the Wabbajack application, login to Nexusmods via the GUI, then download and install a modlist. Wabbajack on Linux requires a version of Wine newer than 9.15 and this isn't really possible on Steam Deck without disabling the OS protection. However, we can use an application called Bottles to run a Wine environment with the required version.
The following must be run in Desktop mode if you are carrying out these steps on Steam Deck.
---
### Step 1 - Create Wabbajack Directory, Download Wabbajack
I like to keep things contained in their own directory, so I recommend creating a directory to hold Wabbajack and associated files.
```
mkdir /home/deck/Wabbajack
```
Download the Wabbajack application from the [Wabbajack Website](https://www.wabbajack.org/) and move it into the newly created Wabbajack Directory.
---
### Step 2 - Install Bottles
Open the Discover Store, and search for Bottles, then click install:
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/WabbajackBottles/WabbajackBottles_DiscoverInstall.png" width="600">
If you are doing this on a system other than the Steam Deck, you may wish to utilise the version of Bottles available from your package manager, instead of the flatpak/Discover version.
Once installed, open up the Bottles application.
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/WabbajackBottles/WabbajackBottles_SearchBottles.png" width="600">
---
### Step 3 - Install Wine 9.XX from inside Bottles
Wabbajack requires Wine 9.15 or newer. Thankfully bottles lets us download new Wine versions from inside the app itself. Click the Three Lines menu button, followed by Preferences:
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/WabbajackBottles/WabbajackBottles_Preferences.png" width="600">
Switch to the Runners tab, then expand the option for Kron4ek, followed by clicking the download arrow next to `kron4ek-wine-9.XX-staging-tkg-amd64` (The version of Wine changes often, so just pick the newest version displayed, as long as it is newer than 9.15)
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/WabbajackBottles/WabbajackBottles_Runner.png" width="600">
---
### Step 4 - Create new bottle
Close down the preferences window, back to the main Bottles interface. Click the Create New Bottle button:
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/WabbajackBottles/WabbajackBottles_CreateNew.png" width="600">
Give the new Bottle a name, and then select Custom for the Environment. Click the arrow next to the Runner option, and select your newly downloaded kron4ek Wine version:
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/WabbajackBottles/WabbajackBottles_NewDetails.png" width="600">
Lastly, at the bottom of the Window, change the Bottle Directory to the Wabbajack directory created in Step 1:
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/WabbajackBottles/WabbajackBottles_BottleDirectory.png" width="600">
Click 'Create' at the top of the Window, and the new Bottle will be created and populated as Bottles requires. This can take a little while, so be patient:
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/WabbajackBottles/WabbajackBottles_BottleCreating.png" width="600">
When the setup is complete, click 'Close' on the success window:
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/WabbajackBottles/WabbajackBottles_BottleCreated.png" width="600">
---
### Step 5 - Advanced Settings (Renderer, FSYNC, Discrete Graphics)
Click the arrow associated with the newly created Bottle:
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/WabbajackBottles/WabbajackBottles_SelectBottle.png" width="600">
Scroll down to the Display section, and click Advanced Display Settings. In this new window, set the Renderer to "Vulkan":
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/WabbajackBottles/WabbajackBottles_AdvancedDisplay.png" width="600">
Click Save, then scroll down to the Performance section. Click to change the Synchronisation, and select "Fsync":
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/WabbajackBottles/WabbajackBottles_SetFsync.png" width="600">
You can now close this window and you should be back at the main Bottle interface.
---
### Step 6 - Install Dependencies (Mono and Gecko)
Wabbajack needs a couple of additional things installed into the Wine prefix - Mono and Gecko. To do this, click the arrow next to Dependencies
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/WabbajackBottles/WabbajackBottles_Dependencies.png" width="600">
Scroll down and click the Download arrow next to both Gecko and Mono, allowing each to download and install. This can take a little time.
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/WabbajackBottles/WabbajackBottles_Gecko.png" width="600">
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/WabbajackBottles/WabbajackBottles_Mono.png" width="600">
Once complete, click the back arrow in the top left of the window.
---
### Step 7 - Download and install WebView
Wabbajack relies on Edge WebView 2 from Microsoft to display certain parts of the application (such as the Nexus Login page). Sadly, WebView can't be installed directly from Bottles, so we need to download the WebView installer, and then run it from inside Bottles.
Browse to the [Microsoft Edge WebView](https://developer.microsoft.com/en-gb/microsoft-edge/webview2) download site, and click the download arrow next to "x64" in the "Evergreen Standalone Installer" area:
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/WabbajackBottles/WabbajackBottles_DownloadWebview.png" width="600">
Back in the main Bottles window, click the "Executable" button right in the middle:
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/WabbajackBottles/WabbajackBottles_RunExecutable.png" width="600">
Browse to the location of the WebView Installer executable and click Run:
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/WabbajackBottles/WabbajackBottles_RunWebviewInstaller.png" width="600">
After a little wait (around 30s on Deck), the Edge WebView installer window should appear and progress through the installation:
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/WabbajackBottles/WabbajackBottles_WebviewInstalling.png" width="600">
When complete, the window will just vanish, but this is fine.
---
### Step 8 - Set Windows version to 7
The WebView-related Nexus Login section of Wabbajack also requires the wine environment to be set as Windows 7 (I'm not sure why) but this can only be done after WebView is installed. Click the Settings button on the main Bottles window:
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/WabbajackBottles/WabbajackBottles_Settings.png" width="600">
Scroll down to the Compatibility section, and change the Windows Version to Windows 7:
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/WabbajackBottles/WabbajackBottles_SetWin7.png" width="600">
Finally, click the back arrow in the top left to return to the main Bottles window.
---
### Step 9 - Add and configure Wabbajack as an application
Even though the Bottle environment must be set as Windows 7 for the Nexus Login page to work, the rest of the Wabbajack application needs to run as Windows 10. To do this we must add Wabbajack.exe as an application, and then set it to be Windows 10.
From the main Bottle window, scroll down to the Tools section and expand the Legacy Wine Tools section, followed by clicking the launch button next to Configuration:
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/WabbajackBottles/WabbajackBottles_LegacyConfiguration.png" width="600">
In the Wine Configuration window that poops up, click the Add Application button:
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/WabbajackBottles/WabbajackBottles_AddApplication.png" width="600">
Browser to the location of your Wabbajack.exe downloaded in Step 2, which if you are following this guide, will be Z:\home\deck\Wabbajack\Wabbajack.exe
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/WabbajackBottles/WabbajackBottles_AddWabbajack.png" width="600">
Lastly, we need to set Wabbajack to use the Windows 10 version. Click Wabbajack.exe, then select Windows 10 from the drop down, and finally click Apply. Be careful not to select the "Default Settings" option by mistake.
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/WabbajackBottles/WabbajackBottles_WabbajackWin10.png" width="600">
---
### Step 10 - Symlink Steam Library
TO get Wabbajack to detect games as being installed, we must link our Linux Steam Library from Linux into the Bottles prefix. If you have been following the steps exactly, the prefix will exist at `/home/deck/Wabbajack/Wabbajack`, so the command to link the Steam Library will be (on internal storage):
```
ln -s $HOME/.local/share/Steam "$HOME/Wabbajack/Wabbajack/drive_c/Program Files (x86)/Steam"
```
If the game you wish to download a modlist for is instead installed on the SDCard, you would use (adjust as needed if your SDCard has a different path name):
```
ln -s /run/media/mmcblk0p1/SteamLibrary "$HOME/Wabbajack/Wabbajack/drive_c/Program Files (x86)/Steam"
```
---
### Step 11 - Add shortcut for Wabbajack.exe
To make it easier to start Wabbajack, we can add it as a shortcut. From the main Bottles window, click the Add "Shortcuts..." button.
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/WabbajackBottles/WabbajackBottles_WabbajackShortcut.png" width="600">
Browse to the location of Wabbajack.exe downloaded in Step 1, which for me is `/home/deck/Wabbajack/Wabbajack.exe`
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/WabbajackBottles/WabbajackBottles_AddShortcut.png" width="600">
---
### Step 12 - Run Wabbajack
At last, we can finally run the Wabbajack application. Click the Play button next to the new Wabbajack shortcut:
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/WabbajackBottles/WabbajackBottles_RunWabbajack.png" width="600">
The familiar Wabbajack download and install window should appear
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/WabbajackBottles/WabbajackBottles_WabbajackDownloading.png" width="600">
From here things should be mostly the same as on Windows, though there may be some graphical glitches present. The main thing is that the download and install process works successfully. Once Wabbajack is open, click the cog in the top right and enter your Nexus login credentials.
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/WabbajackBottles/WabbajackBottles_NexusLogin.png" width="600">
You should now be able to download and install a modlist from the gallery, or by downloading a .wabbajack and using the "Install from disk" option.
---
### Conclusion
So there you have it. There will likely be stability issues and you may need to restart Wabbajack at times - thankfully it will carry on where it left off. Hopefully as Wine progresses, things will become more stable for this application. If you are running this on Steam Deck, then you may wish to consider lowering the number of threads Wabbajack will use, otherwise the device can get *very hot*, as the CPU gets battered by the Wabbajack process. It will likely also take longer than a normal PC to perform the install stage of the process, again down to the CPU.
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/WabbajackBottles/WabbajackBottles_DeckComplete.png" width="600">