528
edits
Changes
Jump to navigation
Jump to search
mLine 1:
Line 1: − + − + − * [[Modding:Installing SMAPI on Android|Instructions for Android]]+ − * [[Modding:Installing SMAPI on Mac|Instructions for macOS]]+ − * [[Modding:Installing SMAPI on Windows|Instructions for Windows]] Line 21:
Line 20: − + − <li>Configure your game client: see the instructions for [[#Steam|Steam]] and [[#Steam Deck|Steam Deck]].</li> − − ==Configure your game client== − ===Steam=== − No changes are needed! Just launch the game through Steam like normal, and it'll launch with SMAPI. − − ===Steam Deck=== − : ''See [https://www.youtube.com/watch?v=CrrWtqdbvC4 video tutorial].'' − − You'll also need to hide the SMAPI window to play on the Steam Deck console: − − # [[Modding:Player Guide/Getting Started#Find your game folder|Open your game folder]]. − # Open the <samp>StardewValley</samp> file (the one with no file extension) in a text editor like Atom. − # Change <code>SKIP_TERMINAL=false</code> to <code>SKIP_TERMINAL=true</code> and save. − − Now you can launch the game like usual, and it'll play with mods. − − '''Note:''' after doing this, you won't see mod update alerts or error messages unless you [https://log.smapi.io/ check the log], and your game won't launch after a crash until you delete the <samp>smapi-internal/StardewModdingAPI.crash.marker</samp> file. You should periodically check the log to make sure everything is working correctly. Line 55:
Line 36: + + + + + + + + + + + + + + + + + + + + + + + + + + Line 63:
Line 70: +
→Troubleshooting
{{Modding:Player Guide/header}}
{{modding player guide header}}
This page explains how to install SMAPI (the tool which lets you use mods) on Linux. See also:
This page explains how to install SMAPI (the tool which lets you use mods) on Linux.
See instructions for: [[Modding:Installing SMAPI on Android|Android]] • [[Modding:Installing SMAPI on Mac|macOS]] • [[Modding:Installing SMAPI on Steam Deck|Steam Deck]] • [[Modding:Installing SMAPI on Windows|Windows]].
__TOC__
__TOC__
# You may need to uninstall & reinstall the game to move it to the correct folder.
# You may need to uninstall & reinstall the game to move it to the correct folder.
}}</li>
}}</li>
<li>Run the <samp>install on Linux.sh</samp> file, and follow the on-screen instructions.<br />(If it the installer asks for your game install path, see [[Modding:Player Guide/Getting Started#Find your game folder|how to find your game folder]].)</li>
<li>Run the <samp>install on Linux.sh</samp> file, and follow the on-screen instructions.<br />(If the installer asks for your game install path, see [[Modding:Player Guide/Getting Started#Find your game folder|how to find your game folder]].)</li>
</ol>
</ol>
<small>To install manually instead, see instructions in the installer's readme.</small>
<small>To install manually instead, see instructions in the installer's readme.</small>
==Update SMAPI==
==Update SMAPI==
* SMAPI tries to find a compatible terminal or use your default terminal, but some terminals aren't compatible. If the installer or launcher don't launch a terminal, try installing xterm (doesn't need to be your default terminal).
* SMAPI tries to find a compatible terminal or use your default terminal, but some terminals aren't compatible. If the installer or launcher don't launch a terminal, try installing xterm (doesn't need to be your default terminal).
* See the [[Modding:Player Guide/Troubleshooting|troubleshooting page]] for general troubleshooting.
* See the [[Modding:Player Guide/Troubleshooting|troubleshooting page]] for general troubleshooting.
* If you're trying to install SMAPI for Stardew 1.5.6, be forewarned you need to install libssl1.x. See below for instructions:
{| class="wikitable"
|-
! distros
! prerequisites
|-
| Debian-based<br /><small>(Debian, Ubuntu, Linux Mint)</small>
| Install LibSSL 1.1 by running <code>sudo apt install libssl1.1</code> in a terminal.
|-
| Arch-based<br /><small>(Arch, Manjaro, EndeavourOS)</small>
| Install OpenSSL 1.1 by running <code>sudo pacman -S openssl-1.1</code> in a terminal.
|-
| NixOS
| Use [https://search.nixos.org/packages?channel=unstable&show=steam-run&type=packages steam-run] to run <samp>install on Linux.sh</samp> in the steps below.<br /><small>(Make sure your system has steam-run installed, or create a temporary nix-shell with steam-run by executing <code>export NIXPKGS_ALLOW_UNFREE=1 && nix-shell -p steam-run</code>. Then run <code>steam-run ./install\ on\ Linux.sh</code> in a terminal to start the installation.)</small>
|-
| Fedora
| Install OpenSSL 1.1 by running <code>sudo dnf install openssl1.1</code> in a terminal.
|-
| Gentoo
| Install OpenSSL 1.1 compatibility by running <code>sudo emerge --ask dev-libs/openssl-compat</code> in a terminal.
|-
| RHEL 8-based <br /><small>(RHEL 8, CentOS 8, Rocky 8, Alma 8)</small>
| Install OpenSSL 1.1 by running <code>sudo dnf install openssl</code> in a terminal.
|}
{{Modding guide footer
{{Modding guide footer
[[de:Modding:SMAPI auf Linux]]
[[de:Modding:SMAPI auf Linux]]
[[es:Modding:Instalar SMAPI en Linux]]
[[es:Modding:Instalar SMAPI en Linux]]
[[fr:Modding:Installer SMAPI sur Linux]]
[[zh:模组:在Linux上安装SMAPI]]
[[zh:模组:在Linux上安装SMAPI]]