ROM and assets
Asset extraction needs a compatible USA ROM.
Could not find any ROMs
Place zelda3.sfc or zelda3.smc at the project root,
or pass -r with a path relative to the project root.
ROM hash not supported
Normal extraction expects the USA release of A Link to the Past.
Python
Use the project virtual environment for asset tools.
If Python reports No module named PIL or No module named yaml,
install requirements.txt into the project venv and run tools through that venv.
python3 -m venv venv
source venv/bin/activate
python -m pip install -r requirements.txtSDL2
sdl2-config is required for Make builds.
Install SDL2 development files. On Debian/Ubuntu, use libsdl2-dev.
On macOS with Homebrew, install sdl2.
Windows builds
Visual Studio and TCC have different dependency paths.
- Visual Studio missing SDL2 targets: restore NuGet packages for
Zelda3.sln. - TCC missing compiler: place
tcc.exeatthird_party\tcc\tcc.exe. -
TCC missing SDL: place
SDL2.dllatthird_party\SDL2-2.26.3\lib\x64\SDL2.dll.
Package paths
Asset location depends on the package type.
| Package | Expected asset location |
|---|---|
| Source or tarball | Beside the executable or in the project root. |
| AppImage | ~/.local/share/Z3R/zelda3_assets.dat |
| Flatpak | ~/.var/app/io.github.xander_haj.Z3R/data/Z3R/zelda3_assets.dat |