search

Waterdish / zelda3-android

A port of Zelda3 to Android
102 stars 4 forks source link

readme

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.

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

NOTE: Controller only. No touch controls yet.

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

Default Settings: L3 Turbo button
18:9 Aspect Ratio
Fullscreen(no android on-screen controls)

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. The zip file with the exe file in it will not work.
  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.