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

Some small additions for clarity, added disclaimer and a few small tweaks to make this good to publish.

Omni-guides
2024-02-26 12:31:23 +00:00
parent 4c96f79294
commit a0de36f0c8
1 changed files with 13 additions and 26 deletions
Download Patch File Download Diff File Expand all files Collapse all files

39
Using-the-omni‐guides.sh-Automation-Script.md

@@ -1,8 +1,14 @@
![Omni-guides Banner](https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/WabbajackModlistsBanner2.png)
DISCLAIMER - I am not affiliated with the Wabbajack group in any way, just a gamer trying to help other gamers. You may be able to get assistance with this guide from the #unofficial-linux-help channel of the main [Official Wabbajack Discord](https://discord.gg/wabbajack), but it may be best to @ me on Discord (@omni). Due to this being an unofficial guide, assistance on this from Wabbajack support directly, or the Modlist developers, is highly unlikely.
## Introduction
While the script is still in an alpha state, I've done my best to try and capture as many eventualities as I can - but there will always be some that slip through the net. Some Linux distro's keep things in different locations, have slight variations on command syntax, and so on, but I've done what I can to allow this to be as compatible as possible. I have mostly tested this on my Nobara(Fedora) laptop and Steam Deck, though technically it should work on any distro, keeping in mind the above potential for variations.
While the script is still in an alpha state, I've done my best to try and capture as many eventualities as I can - but there will always be some that slip through the net. Some Linux distro's keep things in different locations, have slight variations on command syntax, and so on, but I've done what I can to allow this to be as compatible as possible. I have mostly tested this on my Nobara (Fedora) system and Steam Deck, though technically it should work on any distro, keeping in mind the above potential for variations.
Only Skyrim Special Edition and Fallout 4 are supported at this time - the older games are much harder to get running at the best of times, and would be even harder to automate, but who knows in future..
For best results, the script expects a newly installed and unchanged modlist directory from Wabbajack, and a newly created but untouched Non-Steam Game Entry in steam, as per the steps below.
For a list of what the Automation Script does and doesn't do, please see the [Additional Notes](https://github.com/Omni-guides/Wabbajack-Modlist-Linux/wiki/_new#additional-notes) at the end of this page.
@@ -20,7 +26,7 @@ The script also assumes that you have *sudo* access for your user. There are onl
I will use Anvil as an example Modlist for this guide.
** IMPORTANT **: Once you have added the Non-Steam Game entry, click Play on it in Steam at least once, even if it fails or gives an error. This is required to register the Game Entry so that Protontricks can manage it.
** IMPORTANT **: _Once you have added the Non-Steam Game entry, click Play on it in Steam at least once, even if it fails or gives an error. This is required to register the Game Entry so that Protontricks can manage it._
---
@@ -46,26 +52,6 @@ Technically you can use any path or naming convention you like, but for simplici
Copy the Modlist directory from Windows into this newly created directory. There are many ways to do this. I chose to enable ssh on my Deck, and then use rsync to transfer. There are too many options to discuss here, but it should be relatively easy to search for methods. I copied the Modlist Install directory contents from Windows to the newly created directory on the Deck: /home/deck/Games/Skyrim/Anvil/
Finally for this step, it's best to make sure that the newly copied files have sufficient permissions for your user. Run **only one** of the following for each action (owner and permissions), depending on where you want to store the Modlist:
Change the owner and permissions of the directory on **Internal Storage**:
```
sudo chown -R deck:deck /home/deck/Games/Skyrim/Anvil
```
```
sudo chmod -R 755 /home/deck/Games/Skyrim/Anvil
```
OR
Change the owner and permissions of the directory on **SD Card**:
```
sudo chown -R deck:deck /run/media/mmcblk0p1/Games/Skyrim/Anvil
```
```
sudo chmod -R 755 /run/media/mmcblk0p1/Games/Skyrim/Anvil
```
---
### Step 2 - Add ModOrganizer.exe as a Non-Steam Game
@@ -103,7 +89,8 @@ Like so:
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/shared/Shared-STEAM_COMPAT_MOUNTS.png" width="400">
** IMPORTANT **: As a reminder - Once you have added the Non-Steam Game entry, click Play on it in Steam at least once, even if it fails or gives an error. This is required to register the Game Entry so that Protontricks can manage it.
******IMPORTANT**:**** _As a reminder - Once you have added the Non-Steam Game entry, click Play on it in Steam at least once, even if it fails or gives an error. This is required to register the Game Entry so that Protontricks can manage it._
---
@@ -125,13 +112,13 @@ The script will then attempt to detect all the Wabbajack Modlists you have insta
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/omni-guides.sh/Omni-Guides-sh_SelectModlist.png" width="600">
You will be asked to confirm you want to continue, and the script will move on to detecting the Modlist Install directory - if multiple possibilities are found, you'll be asked to select the right one. If nothing can be found automatically, you'll be asked to manually input the path.
You will be asked to confirm you want to continue, and the script will move on to detecting the Modlist Install directory - if multiple possibilities are found, you'll be asked to select the right one. If nothing can be found automatically, you'll be asked to manually input the path to the Modlist directory.
You will be prompted for your *sudo* password so that protontricks permissions can be set correctly, and the script will continue through more automated tasks:
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/omni-guides.sh/Omni-Guides-sh_SudoPassword.png" width="600">
Lastly, you will be asked if you want to set the resolution. This is optional but I'm trying to reduce the manual steps as much as I can. If you're running this on a Steam Deck, it will assume the desired resolution is 1280x800 (If you are going to be played while docked, you will have to manually alter the resolution via MO2 for skyrimprefs.ini/fallou4prefs and SSEDisplayTweaks). Not on a Steam Deck, you will be asked to input your desired resolution.
Lastly, you will be asked if you want to set the resolution. This is optional but I'm trying to reduce the manual steps as much as I can. If you're running this on a Steam Deck, it will assume the desired resolution is 1280x800 (If you are going to be playing while docked, you will have to manually alter the resolution via MO2 for skyrimprefs.ini/fallou4prefs and SSEDisplayTweaks). If you are not running this script on a Steam Deck, you will be asked to input your desired resolution, in the format 1920x1080.
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/omni-guides.sh/Omni-Guides-sh_SetResolution.png" width="600">
@@ -139,7 +126,7 @@ Lastly, you will be asked if you want to set the resolution. This is optional bu
### Post-script tasks
And that's it! You should now be able to click Play on the Modlist entry in Steam. MO2 should start and now be pre-configured correctly. You may still have to/want to disable any features or mods you don't want or aren't compatible - things such as ENB. For the most part, any Modlist-specific steps will still be listed in my manual guide for that Modlist, but I will also soon be attempting to add Modlist-specific steps to the automation script, where required.
And that's it! You should now be able to click Play on the Modlist entry in Steam. MO2 should start and now be pre-configured correctly - as much as I can, anyway. You may still have to/want to disable any features or mods you don't want or aren't compatible - things such as ENB. For the most part, any Modlist-specific steps will still be listed in my manual guide for that Modlist, but I will also soon be attempting to add Modlist-specific steps to the automation script, where required.
**PLEASE NOTE** - I have also seen a number of Modlists hang on first launch - either before displaying the Main Menu options (New Game etc), or after clicking New Game. This only seems to happen the first time, and is fine every subsequent time - I believe at this time that it is related to Shader Cache building, but I haven't been able to pin it down or resolve it. There are also some odd cases when on first launch, some mods may fail to load - again this is usually only for the first launch, but there have been times when a restart of Steam has been required (or just a reboot of the deck) - I haven't been able to find out why.. at least it is only a minor annoyance and subsequent launches are fine.