Difference between revisions of "Modding:Installing SMAPI on Android"
Jump to navigation
Jump to search
Pathoschild (talk | contribs) (→Obtaining the APK: + APK Extractor method (no root needed), link to info about rooting) |
Pathoschild (talk | contribs) (→Obtaining the APK: standardise header tense) |
||
Line 5: | Line 5: | ||
For help with mods on Linux/Mac/Windows, see the [https://stardewvalleywiki.com/Modding:Player_Guide player's guide to mods]. | For help with mods on Linux/Mac/Windows, see the [https://stardewvalleywiki.com/Modding:Player_Guide player's guide to mods]. | ||
− | == | + | ==Obtain the APK== |
The game is stored on your phone in an ''Android Package'' file with an <tt>.apk</tt> extension. Downloading the APK from third-party websites isn't recommended, since it be outdated or contain malware. | The game is stored on your phone in an ''Android Package'' file with an <tt>.apk</tt> extension. Downloading the APK from third-party websites isn't recommended, since it be outdated or contain malware. | ||
Revision as of 15:16, 10 April 2019
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 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
- Install an unzip program like 7-zip.
- Install JDK 8.
- Install Android Studio (make sure to install build-tools).
- Install APK Signer Tool (v2).
- Unzip the Stardew Valley APK to your computer.
- Replace the vanilla XNBs (found in ./assets/Content/) with the modded XNBs.
- Re-zip the contents of the Stardew Valley APK. Make sure not to include the container folder.
- Change the file extension from .zip to .apk.
- Open APK Signer Tool (v2).
- Fill out all fields on the Keyfile Generator page (doesn't matter what you enter).
- On the Align & Sign tab, select the modded APK file.
- Select key and fill out the appropriate fields.
- Click Align and Sign.
- Wait a few moments.
- Move the APK to the device and install.
Audio mods
- Download unxwb and XWBTool.
- Unzip both to your working directory.
- 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.
- Run this command to unpack the file:
unxwb main.2.com.chucklefish.stardewvalley.obb
That will output 87 with names like 00000000.wav. - Move the unpacked .wav files to a separate folder to keep things organised.
- Replace any of the audio files as desired (but the names must remain the same).
- 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. - Rename Music.xwb to main.2.com.chucklefish.stardewvalley.obb.
- Move the modified .obb file back to your phone's internal storage (at Internal Storage/Android/obb/main.2.com.chucklefish.stardewvalley.obb).
- Enjoy your modified music!