Need a video tutorial!

[LumenHeart]

Anyone has a video tutorial or guide so I can follow it?

[keatongreve]

What platform are you on? Have you looked at the Compiling section of the README?

[LumenHeart]

WINDOWS 11.

[keatongreve]

I don't have a Windows machine at the moment, maybe someone else would be able to produce a video walkthrough.

Assuming no familiarity with the tooling (I'm going to assume you can git clone, otherwise just download the repo from https://github.com/snesrev/zelda3/archive/refs/heads/master.zip), I think the complete process is as follows:

Python Setup

1. Download latest version of Python 3 from https://www.python.org/downloads/windows/
2. Run Python 3 installer.
3. Open a Command prompt and verify the commands python and pip works. AND verify python --version returns a number starting with 3.
4. If they do not, you may need to manually update your environment's PATH. Check out this video.
5. Once pip is working, run pip install pillow pyyaml
6. Open a python interactive window (run python) and verify these packages are installed.
7. run import PIL for Pillow
8. run import yaml for pyyaml. edit: I initially wrote 'pyyaml' here. this is wrong, the module itself is yaml in code, but the package name is pyyaml.

Resource generation and compilation

Follow the instructions at the beginning Compiling, which involves putting the ROM inside the repository. If you did the first section right, you can run those commands without problems.

Visual Studio

This is where I'm not entirely sure about the setup. But I believe you can install VS Community Edition from here. Once you've run through the installer, just open Zelda3.sln (NOT the vcxproj file) and Build the project.

[DarkermX]

Thank You mate. I am noob at this. This was really Helpful :)

[snesrev]

Can this be put in the wiki?

[Nanospark53]

I'm having problems with extracting and compiling the resources. It's saying my hash is wrong, but when I check the hash it is correct (66871d66be19ad2c34c927d6b14cd8eb6fc3181965b6e517cb361f7316009cfb). It keeps giving me some random hash that has nothing to do with the file I have (2a033aba8182e539103010b7b70dfa961d1fd07285386949638b39a7806004aa).

[keatongreve]

Which script is failing, extract or compile? Can you paste the commands you're running and the output?

[Nanospark53]

Which script is failing, extract or compile? Can you paste the commands you're running and the output?

I deleted everything the scripts created and now I get this outupt:
PS C:\zelda3-master\tables> python3 extract_resources.py
PS C:\zelda3-master\tables> python3 compile_resources.py
Traceback (most recent call last):
File "C:\zelda3-master\tables\compile_resources.py", line 64, in
ROM = util.LoadedRom(sys.argv[1])
IndexError: list index out of range

[keatongreve]

I fixed this in #34, you can either redownload the repo and start over or you can run tell the script specifically the ROM path. Assuming you just copied it in there already, try

C:\zelda3-master\tables> python3 extract_resources.py zelda3.sfc
C:\zelda3-master\tables> python3 compile_resources.py zelda3.sfc

[Nanospark53]

I fixed this in #34, you can either redownload the repo and start over or you can run tell the script specifically the ROM path. Assuming you just copied it in there already, try

C:\zelda3-master\tables> python3 extract_resources.py zelda3.sfc
C:\zelda3-master\tables> python3 compile_resources.py zelda3.sfc

I redownloaded the zip and it worked first try. Thank you for your help and your time! :)

[ryzendew]

Anyone has a video tutorial or guide so I can follow it?

https://youtu.be/xHJnL9H1mRA

[keatongreve]

Thanks for putting that together. FYI though, python3 is still a valid command in many cases, including Windows and macOS, but I certainly wish we could all eliminate Py2 faster. I think that change was made pretty recently and we can fix that up to make it more clear.

[ryzendew]

That cmd in windows no longer works same for linux i tested both it can rest now Sent from my iPhoneOn Sep 1, 2022, at 5:19 AM, Keaton Greve ***@***.***> wrote: Thanks for putting that together. FYI though, python3 is still a valid command in many cases, including Windows and macOS, but I certainly wish we could all eliminate Py2 faster. I think that change was made pretty recently and we can fix that up to make it more clear. —Reply to this email directly, view it on GitHub, or unsubscribe.You are receiving this because you commented.Message ID: ***@***.***>

[ryzendew]

if needed i can do a pro edited video that video was done all in a single go. so if it's needed let me know.

[keatongreve]

I thought it was pretty good, no need to put in more effort if it's a hassle. if you get around to it, my only thoughts:

1. it probably wouldn't hurt to mention that the Visual Studio project automatically installs SDL through NuGet (this might
   be helpful context so that people know to use Package Restore when seeing SDL errors, but NuGet works pretty well on the first build, or better than it used to...). honestly you could just throw this in the descrption, maybe it will help someone.
2. probably can cut the current video about halfway, shorter videos will help users not run away or lose attention.

@LumenHeart feel free to check out the instructions and/or video in this thread, and update us if you're still having issues.

[snesrev]

Is the documentation satisfactory now? Reopen if not.