106 874
modifications
Modifications
Sauter à la navigation
Sauter à la recherche
Modding:Installer SMAPI sur Linux (voir la source)
Version du 6 août 2023 à 20:08
, 6 août 2023 à 20:08push edit blocked by new user (adding external links)
{{modding player guide header}}
{{Traduire}}
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__
==Install==
<ol>
<li>Apply distro-specific prerequisites if needed:
{| 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>
|}
</li>
<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>
<li>If you installed Steam through Flatpak, see these instructions:
{{collapse|instructions for Flatpak|content=When using Flatpak, you need to change the default game location:
# Open Steam.
# Go to ''Steam > Settings > Downloads''.
# Click ''Steam Library Folders'' under ''Content Libraries''.
# Navigate to <samp>/home/[your username]/.local/share/Steam</samp>, and click ''Select''.
# Make sure the new location you just created is selected, then click "''...''" and select ''Make Default''.
# You may need to uninstall & reinstall the game to move it to the correct 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>
<small>To install manually instead, see instructions in the installer's readme.</small>
==Update SMAPI==
Just install the new version; the installer will automatically clean up previous versions.
==Uninstall==
# Launch the installer again (see [[#Install|install steps]]).
# When prompted, choose the ''uninstall'' option.
==Troubleshooting==
* If the SMAPI window no longer appears after a game update, reinstall SMAPI to fix the launcher.
* 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.
{{Modding guide footer
|prev = [[Modding:Guide Joueur/Commencer|Commencer]]
|next =
}}
[[de:Modding:SMAPI auf Linux]]
[[en:Modding:Installing SMAPI on Linux]]
[[es:Modding:Instalar SMAPI en Linux]]
[[zh:模组:在Linux上安装SMAPI]]
{{Traduire}}
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__
==Install==
<ol>
<li>Apply distro-specific prerequisites if needed:
{| 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>
|}
</li>
<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>
<li>If you installed Steam through Flatpak, see these instructions:
{{collapse|instructions for Flatpak|content=When using Flatpak, you need to change the default game location:
# Open Steam.
# Go to ''Steam > Settings > Downloads''.
# Click ''Steam Library Folders'' under ''Content Libraries''.
# Navigate to <samp>/home/[your username]/.local/share/Steam</samp>, and click ''Select''.
# Make sure the new location you just created is selected, then click "''...''" and select ''Make Default''.
# You may need to uninstall & reinstall the game to move it to the correct 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>
<small>To install manually instead, see instructions in the installer's readme.</small>
==Update SMAPI==
Just install the new version; the installer will automatically clean up previous versions.
==Uninstall==
# Launch the installer again (see [[#Install|install steps]]).
# When prompted, choose the ''uninstall'' option.
==Troubleshooting==
* If the SMAPI window no longer appears after a game update, reinstall SMAPI to fix the launcher.
* 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.
{{Modding guide footer
|prev = [[Modding:Guide Joueur/Commencer|Commencer]]
|next =
}}
[[de:Modding:SMAPI auf Linux]]
[[en:Modding:Installing SMAPI on Linux]]
[[es:Modding:Instalar SMAPI en Linux]]
[[zh:模组:在Linux上安装SMAPI]]