Modding:Installing SMAPI on Linux
Revision as of 18:42, 19 June 2017 by Pathoschild (talk | contribs) (copy from canimod.com with permission, dual-licensed CC BY-NC-SA for compatibility with wiki. Only author is Pathoschild.)
--- layout: default title: Player's guide to using mods » install SMAPI intro: > Welcome to Stardew Valley modding! This guide will help you install mods and fix any problems that come up. permalink: /for-players/install-smapi redirect_from: - /guides/using-mods --- <div class="scroll-box" style="float: right;"> <strong>For players</strong> <ul> <li><a href="/for-players/intro">Intro</a></li> <li><strong>Install SMAPI</strong></li> <li><a href="/for-players/use-mods">Use mods</a></li> <li><a href="/for-players/faqs">Troubleshooting & FAQs</a></li> </ul> </div> SMAPI is the tool which launches the game with mods (which are [downloaded separately](#using-mods)). It's safely installed alongside your normal game, and you can uninstall it anytime. ## Install SMAPI ### On Windows [...] ### On Linux 1. Download the [latest version of SMAPI](https://github.com/Pathoschild/SMAPI/releases). 2. Extract the `.zip` file somewhere (but not in your game folder!). 3. Open a terminal in the extracted folder and run `mono install.exe`. _The installer will detect your game and add SMAPI for you. (If you get an error like 'mono: command not found', you need to install [Mono](http://www.mono-project.com/).)_ That's it! Just launch the game to play with mods. To remove SMAPI later, run `mono install.exe` again and choose _uninstall_. ### On Mac [...] ### Manual install The installer is the recommended way to install SMAPI, but you can also install it manually. 1. Download the [latest version of SMAPI](https://github.com/Pathoschild/SMAPI/releases). 2. Unzip the `.zip` file somewhere. 3. Copy the files from the `internal/Mono` folder (if Linux/Mac) or `internal/Windows` folder (if Windows) into [your game folder](http://canimod.com/for-players/faqs#game-folder). If you did it properly, the `StardewModdingAPI.exe` file should be right next to the game's executable. 4. Make sure the game launches with SMAPI. * **Scenario A: you play on Windows:** [...] * **Scenario B: you play on Linux or Mac:** 1. Open the game folder. 2. Rename the `StardewValley` file (with no extension) to `StardewValley-original`. 3. Rename the `StardewModdingAPI` file (with no extension) to `StardewValley`. ## Update SMAPI To update SMAPI, just install the new version. The installer will automatically clean up previous versions. (If you use Steam, you don't need to set the launch options again.) ## Uninstall SMAPI To remove SMAPI, just run `install.exe` again and choose _uninstall_. If you need to uninstall manually, just do the opposite of _[manual install](#manual-install)_. <div class="scroll-box" style="display: inline-block;"> <big><strong>next:</strong> <a href="/for-players/use-mods">Use mods →</a></big> </div>