Difference between revisions of "Modding:Installing SMAPI on Android"

From Stardew Valley Wiki
Jump to navigation Jump to search
(reorganize caveats into FAQs, expand instructions for finding old versions of newer mods)
Line 7: Line 7:
  
 
__TOC__
 
__TOC__
−
 
−
==Caveats==
 
−
* 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.
 
−
* '''Stardew Valley 1.5 and SMAPI 3.8 aren't available on Android yet.''' You may need to use older versions of many mods.
 
−
** You will frequently need older versions of mods that work with SMAPI 3.7.6, which was released on NexusMods on 21 November 2020. Check the old versions of the mods you want to use that were released around the same time as SMAPI 3.7.6 on NexusMods. You can sort old versions of mods by Date Uploaded.
 
  
 
==Install==
 
==Install==
Line 29: Line 24:
 
# Manually delete the <tt>smapi-internal</tt> folder from the <tt>StardewValley</tt> game folder.
 
# Manually delete the <tt>smapi-internal</tt> folder from the <tt>StardewValley</tt> game folder.
  
−
==Using mods==
+
==FAQs==
−
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 or tap the floating action button in the installer app.
+
===How do I add and use mods?===
 +
Once SMAPI is installed, install mods by unzipping them into the newly-created <tt>StardewValley/Mods</tt> 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:
 +
 
 +
# Try the latest version and see if it works. If not, continue with the next steps.
 +
# From the Nexus mod page, click the ''Files'' tab to find all available versions.
 +
# Check if there's a "Main File" which says it's for Android. If not, continue with the next steps.
 +
# Next to "Old Files" (if present), change the sort to "Date Uploaded" and "Desc".
 +
# Find 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 November 2020.
 +
# If you didn't find a matching file, try checking the mod comments or posting a new comment.
  
 
{{Modding guide footer
 
{{Modding guide footer

Revision as of 14:49, 30 June 2021

Modding:Player Guide/header

This page explains how to install SMAPI (the tool which lets you use mods) on Android. See also:

Install

  1. Download the latest installer APK file (the file under "Assets" that ends with .apk).
  2. Install the APK on your phone.
  3. 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).
  4. When it's done, you can safely uninstall the installer app.

That's it! Just launch the game to play with mods.

Update

Just follow the install steps again; the installer will automatically clean up previous versions.

Uninstall

  1. Uninstall the SMAPI Stardew Valley app.
  2. Uninstall the SMAPI installer.
  3. Manually delete the smapi-internal folder from the StardewValley game folder.

FAQs

How do I add and use mods?

Once SMAPI is installed, install mods by unzipping them into the newly-created StardewValley/Mods 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 port of SMAPI to Android developed by MartyrPher and later ZaneYork (see main source code and 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:

  1. Try the latest version and see if it works. If not, continue with the next steps.
  2. From the Nexus mod page, click the Files tab to find all available versions.
  3. Check if there's a "Main File" which says it's for Android. If not, continue with the next steps.
  4. Next to "Old Files" (if present), change the sort to "Date Uploaded" and "Desc".
  5. Find 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 November 2020.
  6. If you didn't find a matching file, try checking the mod comments or posting a new comment.
Retrieved from "https://stardewvalleywiki.com/mediawiki/index.php?title=Modding:Installing_SMAPI_on_Android&oldid=122586"