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

From Stardew Valley Wiki
Jump to navigation Jump to search
(Add thumbnail to show APK location visually)
(+ document ZaneYork port)
Line 8: Line 8:
 
__TOC__
 
__TOC__
  
==Install==
+
==Choose a port==
 +
The Android version of the game is very custom compared to other platforms, so the official version of SMAPI isn't compatible. There are two unofficial [[wikipedia:Porting|ports]] of SMAPI for Android, by MartyrPher and ZaneYork. They use different installers, but both use MartyrPher's port as a base so mod compatibility should be equivalent. Both support most SMAPI mods and content packs (including framework mods like Content Patcher, Farm Type Manager, Json Assets, and PyTK).
 +
 
 +
Generally, you can use whichever port has the newer SMAPI version. When you switch from one port to the other, uninstalling the previous one first is recommended.
 +
 
 +
==MartyrPher's port==
 +
===Install===
 
: ''See also [https://www.youtube.com/watch?v=jOXl6Dmu7wY unofficial video guide].''
 
: ''See also [https://www.youtube.com/watch?v=jOXl6Dmu7wY unofficial video guide].''
 
You can use MartyrPher's Android SMAPI Loader, an unofficial port of SMAPI to Android that 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. The APK file is located under the expandable subheading "Assets"—see image on right.[[File:Android_APK_file_location_guide.png|thumb|APK file is underlined in green]] Make sure you get the download that looks like <code>SMAPI-Android-Installer-&lt;version&gt;.apk</code>.
 
# Download the latest installer APK from {{github|MartyrPher/SMAPI-Android-Installer/releases|the unofficial download page}} onto your phone. The APK file is located under the expandable subheading "Assets"—see image on right.[[File:Android_APK_file_location_guide.png|thumb|APK file is underlined in green]] Make sure you get the download that looks like <code>SMAPI-Android-Installer-&lt;version&gt;.apk</code>.
Line 20: Line 24:
 
That's it! Just launch the game to play with mods.
 
That's it! Just launch the game to play with mods.
  
==Update==
+
===Update===
 
Just install the new version; the installer will automatically clean up previous versions.
 
Just install the new version; 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 (if you haven't already).
 +
# Manually delete the <tt>smapi-internal</tt> folder from the <tt>StardewValley</tt> game folder.
 +
 +
==ZaneYork's port==
 +
===Install===
 +
# Install the [https://play.google.com/store/apps/details?id=com.zane.smapiinstaller SMAPI Installer app] from the Play Store.
 +
# Run the 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).
 +
 +
That's it! Just launch the game to play with mods.
 +
 +
===Update===
 +
# Update the installer app from the Play Store.
 +
# Run the app again to update SMAPI. The installer will automatically clean up previous versions.
 +
 +
===Uninstall===
 +
# Uninstall the SMAPI Stardew Valley app.
 +
# Uninstall the SMAPI installer.
 
# 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.
  

Revision as of 16:13, 14 March 2020

Modding:Player Guide/header

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

Choose a port

The Android version of the game is very custom compared to other platforms, so the official version of SMAPI isn't compatible. There are two unofficial ports of SMAPI for Android, by MartyrPher and ZaneYork. They use different installers, but both use MartyrPher's port as a base so mod compatibility should be equivalent. Both support most SMAPI mods and content packs (including framework mods like Content Patcher, Farm Type Manager, Json Assets, and PyTK).

Generally, you can use whichever port has the newer SMAPI version. When you switch from one port to the other, uninstalling the previous one first is recommended.

MartyrPher's port

Install

See also unofficial video guide.
  1. Download the latest installer APK from the unofficial download page onto your phone. The APK file is located under the expandable subheading "Assets"—see image on right.
    File:Android APK file location guide.png
    APK file is underlined in green
    Make sure you get the download that looks like SMAPI-Android-Installer-<version>.apk.
  2. Install the APK.
  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 install the new version; the installer will automatically clean up previous versions.

Uninstall

  1. Uninstall the SMAPI Stardew Valley app.
  2. Uninstall the SMAPI installer (if you haven't already).
  3. Manually delete the smapi-internal folder from the StardewValley game folder.

ZaneYork's port

Install

  1. Install the SMAPI Installer app from the Play Store.
  2. Run the 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).

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

Update

  1. Update the installer app from the Play Store.
  2. Run the app again to update SMAPI. 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.

Using mods

To install mods, just unzip them into the newly-created StardewValley/Mods folder. To launch the game with mod support, just run the SMAPI Stardew Valley icon.