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 Android. See also: | + | This page explains how to install SMAPI (the tool which lets you use mods) on Android. |
− | * [[Modding:Installing SMAPI on Linux|Instructions for Linux]]
| + | |
− | * [[Modding:Installing SMAPI on Mac|Instructions for Mac]]
| + | See instructions for: [[Modding:Installing SMAPI on Linux|Linux]] • [[Modding:Installing SMAPI on Mac|macOS]] • [[Modding:Installing SMAPI on Steam Deck|Steam Deck]] • [[Modding:Installing SMAPI on Windows|Windows]]. |
− | * [[Modding:Installing SMAPI on Windows|Instructions for Windows]]
| |
| | | |
| __TOC__ | | __TOC__ |
| | | |
| ==Install== | | ==Install== |
− | : ''See also [https://www.youtube.com/watch?v=jOXl6Dmu7wY unofficial video guide].'' | + | <div style="border: 1px solid #F96; border-left: 1em solid #F96; padding: 0.5em 1em; border-radius: 5px;"> |
| + | '''SMAPI for Stardew Valley 1.5.6 is in alpha testing. Some mods may not work with the latest version of the game yet.'''<br /> |
| + | You can watch {{github|ZaneYork/SMAPI-Android-Installer/issues/246|this tracking ticket}} to see the latest updates. |
| + | |
| + | An incomplete list of working/non-working Android mods can be found [https://android.stardew.rocks here]. |
| + | </div> |
| + | |
| + | '''Note: Because Android SMAPI is still in its testing phases, even the latest release may not work for everyone''' |
| | | |
− | You can use MartyrPher's Android SMAPI Loader, which is a port of SMAPI to Android which supports most SMAPI mods and content packs (including framework mods like Content Patcher, Farm Type Manager, Json Assets, and PyTK).
| |
| | | |
− | # Download the latest installer APK from {{github|MartyrPher/SMAPI-Android-Installer/releases|the unofficial download page}} onto your phone. Make sure you get the download that looks like <code>SMAPI-Android-Installer-<version>.apk</code>. | + | # Download the {{github|ZaneYork/SMAPI-Android-Installer/releases|latest installer APK file}} (the file under "Assets" that ends with <samp>.apk</samp>). |
− | # [https://www.greenbot.com/article/2452614/how-to-sideload-an-app-onto-your-android-phone-or-tablet.html Install the APK]. | + | # [https://www.greenbot.com/article/2452614/how-to-sideload-an-app-onto-your-android-phone-or-tablet.html Install the APK on your phone]. |
− | # Run the new app to install SMAPI. This may take a while depending on your device (e.g. 21s on a Samsung Galaxy S10, and 1 minute 13s on a Samsung Galaxy S6). | + | # Run the new app to install SMAPI. This may take a while depending on your device (''e.g.,'' 21s on a Samsung Galaxy S10, and 1 minute 13s on a Samsung Galaxy S6). |
| # When it's done, you can safely uninstall the installer app. | | # When it's done, you can safely uninstall the installer app. |
| | | |
Line 21: |
Line 26: |
| | | |
| ==Update== | | ==Update== |
− | Just install the new version; the installer will automatically clean up previous versions. | + | Just follow the [[#Install|install steps]] again; the installer will automatically clean up previous versions. |
| | | |
| ==Uninstall== | | ==Uninstall== |
| # Uninstall the SMAPI Stardew Valley app. | | # Uninstall the SMAPI Stardew Valley app. |
− | # Uninstall the SMAPI installer (if you haven't already). | + | # Uninstall the SMAPI installer. |
− | # Manually delete the <tt>smapi-internal</tt> folder from the <tt>StardewValley</tt> game folder. | + | # Manually delete the <samp>smapi-internal</samp> folder from the <samp>StardewValley</samp> game folder. |
| + | |
| + | ==FAQs== |
| + | ===How do I add and use mods?=== |
| + | Once SMAPI is installed, install mods by unzipping them into the newly-created <samp>StardewValley/Mods</samp> folder. To launch the game with mod support, just run the SMAPI Stardew Valley icon or tap the floating action button in the installer app. |
| + | |
| + | ===Why is there a separate SMAPI for Android?=== |
| + | The Android version of the game is very custom compared to other platforms, so the official version of SMAPI isn't compatible. There's a [[wikipedia:Porting|port]] of SMAPI to Android developed by MartyrPher and later ZaneYork (see {{github|ZaneYork/SMAPI|main source code}} and {{github|ZaneYork/SMAPI-Android-Installer|installer source code}}). It supports most SMAPI mods and content packs (including framework mods like Content Patcher, Farm Type Manager, Json Assets, and PyTK), but some mods may not be compatible. |
| + | <!-- |
| + | |
| + | ===How do I use mods that need Stardew Valley 1.5?=== |
| + | Stardew Valley 1.5 isn't released on Android yet, so you'll need older versions of many mods. Here's how to find a compatible version for most mods: |
| + | |
| + | <ol> |
| + | <li>Try the latest version.</li> |
| + | <li>From the Nexus mod page, click the ''Files'' tab to find all available versions.</li> |
| + | <li>Check under "Main Files" and "Optional Files": |
| + | # Try the latest file which... |
| + | #* says it's for Android; |
| + | #* ''or'' says it's for Stardew Valley 1.4; |
| + | #* ''or'' says it's for SMAPI 3.7.6 or earlier; |
| + | #* ''or'' was uploaded before 21 December 2020. |
| + | </li> |
| + | <li>Check under "Old Files" (if present): |
| + | # Change the sort to "Date Uploaded" and "Desc". |
| + | # Try the latest file which... |
| + | #* says it's for Stardew Valley 1.4; |
| + | #* ''or'' says it's for SMAPI 3.7.6 or earlier; |
| + | #* ''or'' was uploaded before 21 December 2020. |
| + | </li> |
| + | <li>Check the archived files (if any): |
| + | <ol> |
| + | <li>If there's a "File Archive" button at the bottom of the page, click it.</li> |
| + | <li>Try the latest file which matches the previous step. You can run this script in [https://webmasters.stackexchange.com/q/8525 your JavaScript console] to add download links: |
| + | |
| + | {{collapse| script to add download links|content=<syntaxhighlight lang="js"> |
| + | (function() { |
| + | const gameId = $("#section").attr("data-game-id"); |
| + | const downloadElements = $("#file-container-archived-files [data-id]"); |
| + | |
| + | for (let element of downloadElements) { |
| + | element = $(element); |
| + | const description = element.find(".files-description"); |
| + | const fileId = element.attr("data-id"); |
| + | |
| + | const html = ` |
| + | <div class="tabbed-block"> |
| + | <ul class="accordion-downloads clearfix"> |
| + | <li> |
| + | <a class="btn inline-flex popup-btn-ajax" href="/Core/Libs/Common/Widgets/DownloadPopUp?id=${fileId}&nmm=1&game_id=${gameId}"> |
| + | <svg title="" class="icon icon-nmm"> |
| + | <use xlink:href="https://www.nexusmods.com/assets/images/icons/icons.svg#icon-nmm"></use> |
| + | </svg> |
| + | <span class="flex-label">Mod manager download</span> |
| + | </a> |
| + | </li> |
| + | <li> |
| + | </li> |
| + | <li> |
| + | <a class="btn inline-flex popup-btn-ajax" href="/Core/Libs/Common/Widgets/DownloadPopUp?id=${fileId}&game_id=${gameId}"> |
| + | <svg title="" class="icon icon-manual"> |
| + | <use xlink:href="https://www.nexusmods.com/assets/images/icons/icons.svg#icon-manual"></use> |
| + | </svg> |
| + | <span class="flex-label">Manual download</span> |
| + | </a> |
| + | </li> |
| + | </ul> |
| + | </div> |
| + | `; |
| | | |
− | ==Using mods==
| + | $(html).insertAfter(description); |
− | To install mods, just unzip them into the newly-created <tt>StardewValley/Mods</tt> folder. To launch the game with mod support, just run the SMAPI Stardew Valley icon.
| + | } |
| + | })(); |
| + | </syntaxhighlight>}} |
| + | |
| + | '''Note:''' downloading archived mod versions is at your own risk, and mod authors often won't provide support for them.</li> |
| + | </ol> |
| + | </li> |
| + | <li>If you didn't find a matching file, try checking the mod comments or posting a new comment.</li> |
| + | </ol> |
| + | --> |
| | | |
| {{Modding guide footer | | {{Modding guide footer |
Line 37: |
Line 119: |
| | | |
| [[Category:Modding]] | | [[Category:Modding]] |
| + | |
| + | [[es:Modding:Instalar SMAPI en Android]] |
| + | [[ru:Модификации:Установка SMAPI на Android]] |
| + | [[zh:模组:在Android上安装SMAPI]] |