Modding:Installing SMAPI on Android

From Stardew Valley Wiki
Revision as of 06:03, 28 June 2020 by Pathoschild (talk | contribs) (→‎ZaneYork's port: + note about installer not available on Play Store)
Jump to navigation Jump to search

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 (but there's no need to remove mods).

MartyrPher's port

MartyrPher's port is currently out of date, so you should use ZaneYork's port instead. (See choose a port above for more info.)

Details 

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.

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.

ZaneYork's port

Install

The installer is currently unavailable on the Play Store for unknown reasons. For now you can get the installer APK from GitHub and sideload it on your phone instead.

  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 or tap the floating action button in the installer app.

See also