Line 1: |
Line 1: |
| {{Modding:Player Guide/header}} | | {{Modding:Player Guide/header}} |
| | | |
− | This page explains how to install SMAPI (the tool which lets you use mods) on Linux. This guide also applies for the Steam Deck's distribution of Linux, SteamOS. See also: | + | This page explains how to install SMAPI (the tool which lets you use mods) on Steam Deck. |
− | * [[Modding:Installing SMAPI on Android|Instructions for Android]]
| + | |
− | * [[Modding:Installing SMAPI on Mac|Instructions for macOS]]
| + | See instructions for: [[Modding:Installing SMAPI on Android|Android]] • [[Modding:Installing SMAPI on Linux|Linux]] • [[Modding:Installing SMAPI on Mac|macOS]] • [[Modding:Installing SMAPI on Windows|Windows]]. |
− | * [[Modding:Installing SMAPI on Windows|Instructions for Windows]]
| |
| | | |
| __TOC__ | | __TOC__ |
| | | |
| ==Install== | | ==Install== |
− | <ol>
| + | Before you install SMAPI, you need to know which version of the game you're running: ''native'' (Linux version) or ''Proton'' (Windows version). If you're not sure, see [https://www.youtube.com/watch?v=f1GvONkE9S0 this video tutorial]. |
− | <li>Download the [https://smapi.io/ latest version of SMAPI].</li>
| + | |
− | <li>Extract the <samp>.zip</samp> file somewhere (but not in your game folder!).</li>
| + | ===Stardew Valley in native mode=== |
− | <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>
| + | # Download the [https://smapi.io/ latest version of SMAPI]. |
− | </ol>
| + | # Extract the <samp>.zip</samp> file somewhere (but not in your game folder!). |
| + | # 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]].) |
| | | |
| <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> |
| + | |
| + | ===Stardew Valley in Proton=== |
| + | '''TODO''' |
| | | |
| ==Update SMAPI== | | ==Update SMAPI== |
Line 25: |
Line 28: |
| | | |
| ==Troubleshooting== | | ==Troubleshooting== |
− | * If the SMAPI window no longer appears after a game update, reinstall SMAPI to fix the launcher.
| + | ===SMAPI window no longer appears after game update=== |
− | * 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).
| + | # Run the SMAPI installer again to fix the launcher. |
− | * See the [[Modding:Player Guide/Troubleshooting|troubleshooting page]] for general troubleshooting.
| + | |
| + | ===Can't launch game when SMAPI is installed=== |
| + | # Open a terminal in [[Modding:Player Guide/Getting Started#Find your game folder|your game folder]]. |
| + | # Run <code>./StardewModdingAPI</code> in the terminal to see what the error is: |
| + | #* If you see "''The library 'libhostpolicy.so' required to execute the application was not found''", you have the Linux version of SMAPI with the Proton version of the game. See the [[#Install|instructions for Proton]] above. |
| + | #* If you see a different error, check whether the [[Modding:Player Guide/Troubleshooting|troubleshooting page]] has a section for it. If not, see the 'get help' section there. |
| + | |
| + | ===Other issues=== |
| + | See the [[Modding:Player Guide/Troubleshooting|troubleshooting page]] for general troubleshooting. |
| | | |
| {{Modding guide footer | | {{Modding guide footer |