Modding:Android

From Stardew Valley Wiki
Jump to: navigation, search

Modding:Index

This page explains how to use mods on Android. Modding on Android is trickier than PC; you can't use SMAPI mods yet and they're more complex to install.

For help with mods on Linux/Mac/Windows, see the player's guide to mods.

Obtain the APK

The game is stored on your phone in an Android Package file with an .apk extension. Downloading the APK from third-party websites isn't recommended, since it'll often be outdated or contain malware.

There are two ways to access the APK file:

  • If you have root access, it's located at /data/app/com.chucklefish.stardewvalley-1/base.apk.
  • Otherwise install APK Extractor and run it. The APK will be extracted to ExtractedApks/Stardew Valley_com.chucklefish.stardewvalley.apk on your device.

SMAPI / Content Patcher mods

These aren't available on Android yet. See SMAPI on other platforms for more info.

XNB mods

Option A: MT Manager app on your phone

  1. Copy the XNB files you want to install into a new folder on your device.
  2. Install and open MT Manager on your phone.
  3. On the left side of the screen:
    1. Find the Stardew Valley APK.
    2. Tap it.
    3. Select 'view'. This should open a folder containing the game's asset files.
  4. On the right side of the screen:
    1. Find the folder containing XNB mods (from step 1).
    2. Make sure the corresponding folder is open on the left side of the screen (e.g. the Portraits folder if you're installing portrait mods).
    3. Select the files to copy. (To select all, tap the menu and choose 'select all'.)
    4. Long tap the selected files, and choose the copy option.
    5. A menu should appear. Change the 'level' option to Storage, and the 'update mode' to Replace All. Tap OK to copy the files.
  5. On the left side of the screen:
    1. Return to the folder containing the .apk file.
    2. Tap on the Stardew Valley APK file, choose 'Function', then 'APK Sign'.
    3. Tap the new APK file that generates and choose 'Install'.

Option B: Android Studio on your computer

  1. Install an unzip program like 7-zip.
  2. Install JDK 8.
  3. Install Android Studio (make sure to install build-tools).
  4. Install APK Signer Tool (v2).
  5. Unzip the Stardew Valley APK to your computer.
  6. Replace the vanilla XNBs (found in ./assets/Content/) with the modded XNBs.
  7. Re-zip the contents of the Stardew Valley APK. Make sure not to include the container folder.
  8. Change the file extension from .zip to .apk.
  9. Open APK Signer Tool (v2).
  10. Fill out all fields on the Keyfile Generator page (doesn't matter what you enter).
  11. On the Align & Sign tab, select the modded APK file.
  12. Select key and fill out the appropriate fields.
  13. Click Align and Sign.
  14. Wait a few moments.
  15. Move the APK to the device and install.

Audio mods

  1. Download unxwb and XWBTool.
  2. Unzip both to your working directory.
  3. Copy the .obb file from your phone's internal storage (located at Internal Storage/Android/obb/main.2.com.chucklefish.stardewvalley.obb) to your working directory.
  4. Run this command to unpack the file:
    unxwb main.2.com.chucklefish.stardewvalley.obb
    That will output 87 with names like 00000000.wav.
  5. Move the unpacked .wav files to a separate folder to keep things organised.
  6. Replace any of the audio files as desired (but the names must remain the same).
  7. Run this command to repack the file (replacing folderPath with the full path to the folder containing the .wav files):
    XWBTool "folderPath/*.wav" -o Music.xwb
    Note that the output file must be called Music.xwb when repacking.
  8. Rename Music.xwb to main.2.com.chucklefish.stardewvalley.obb.
  9. Move the modified .obb file back to your phone's internal storage (at Internal Storage/Android/obb/main.2.com.chucklefish.stardewvalley.obb).
  10. Enjoy your modified music!

Here's a spreadsheet of unpacked .wav file names.