zelda3-android

A port of Zelda3 to Android.

Original Repository: https://github.com/snesrev/zelda3

Use the instructions on the original repository (or below if you don't have access to a computer) to extract the zelda3_assets.dat file from your rom and put it in Android/data/com.dishii.zelda3/files
Running the app once will create the directory (the app shall crash on first launch, but the directory will be created).
For this version to work, make sure your zelda3.ini file entries match these https://github.com/yeticarus/zelda3-android/blob/main/app/src/main/assets/zelda3.ini

Android 13 users: check the releases tab for the Android 13 version of the app.

How to Change Settings:
Android/data/com.dishii.zelda3/files contains zelda3.ini. Use a text editor to change options within this file.

Default Settings: This branch supports both touch screen controls and bluetooth controllers.
By default, the ini file is set for screen touch control. Screen buttons will apear at first touch. For using a controller, see the appropriate lines in the ini file.

Instructions for creating zelda3_assets.dat on android:

1. Download PyDroid: https://play.google.com/store/apps/details?id=ru.iiec.pydroid3&hl=en_US. Choose to skip any options that ask for money, you can do all of the following steps without paying.
2. Open the hamburger menu at the top left of the app and select Pip.
3. Type in "Pillow" without the quotes and it will have you install the repository app from the app store.
4. Once the repository app is installed, you can install "Pillow" and "pyyaml"
5. Download the source code zip file for zelda3 at https://github.com/snesrev/zelda3/releases/tag/v0.3
6. Extract the zip file.
7. Place your rom file in the main zelda3 directory that you extracted, the same one as extract_assets.bat, and rename it to zelda3.sfc
8. Open PyDroid again, open the hamburger menu, and select Terminal.
9. Navigate to where you placed the rom file. (If you are unfamiliar with terminal commands, "ls" lists the folders and files and "cd Foldername" changes the directory. An example using the 0.3 release of zelda3 above would be "cd Download" "cd zelda3-0.3" "cd zelda3-0.3" or simply "cd Download/zelda3-0.3/zelda3-0.3")
10. Paste in this command python3 assets/restool.py --extract-from-rom
11. It should pause for a while and when it finishes you should be able to see zelda3_assets.dat in the same folder as your rom. You can go ahead and copy that to the Android/data/com.dishii.zelda3/files location.
12. Copy https://github.com/yeticarus/zelda3-android/blob/main/app/src/main/assets/zelda3.ini to Android/data/com.dishii.zelda3/files. Feel free to edit it to tweek options.