Modding:Installing SMAPI on Android
This page explains how to install SMAPI (the tool which lets you use mods) on Android.
See instructions for: Linux • macOS • Steam Deck • Windows.
Install
Minimum requirements
- This requires Stardew Valley 1.6.15 or later, from either the Play Store or the Galaxy Store.
Install SMAPI
SMAPI on Android is still experimental. Some mods don't work yet; this may be addressed with upcoming SMAPI updates on Android.
- Download the SMAPI Launcher APK (the file that looks like
SMAPI.Launcher.vx.x.x.apk
). - Install the APK on your phone.
- Download SMAPI (the file that looks like
SMAPI.4.x.x-xxxx.zip
). - Open the SMAPI Launcher app.
- Click the "Install SMAPI From Zip" button.
- Choose the downloaded SMAPI file.
- Wait until the launcher says it successfully installed SMAPI.
- Click "Start Game" to run the game with mods.
If you need help, see SMAPI on Android's tutorial (including a Discord link where you can get help).
Update
Just follow the install steps again; the installer will automatically clean up previous versions.
Uninstall
- Uninstall the SMAPI Stardew Valley app.
- Uninstall the SMAPI installer.
- 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 which 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.
Who ported SMAPI to Android?
SMAPI on Android was originally ported by MartyrPher for Stardew Valley 1.4.x, updated and improved by ZaneYork for Stardew Valley 1.5.x, and then updated and improved by NRTnarathip for Stardew Valley 1.6.x. Each update builds on the last (e.g. NRTnarathip's version continues from the work by MartyrPher and ZaneYork).