Zelda II : The Adventure of Link

Port 0.6.0

Portage natif de Zelda II : The Adventure of Link pour macOS.

z2rs est un portage natif de Zelda II : The Adventure of Link pour macOS, distribué en binaire dans ses releases.

Architecture

Mac OS X - macOS Mac OS X - macOS Apple Silicon Apple Silicon 64-bit 64-bit

Original game

Zelda II : The Adventure of Link NES

Download and links

Version history

0.6.0
What's new in 0.6.0 This release adds optional areas to explore, HD animation support for enemies and townspeople, camera zoom, and fixes for HD sprite placement and save states. These are the changes since 0.5.2. New areas The launcher and the in-game options menu now have a "New areas (ZALiA-inspired)" group. Enable its master switch, then choose which areas to add: Parapa Annex: a seven-room wing off the entrance to Palace 1, with an outdoor back door, a key and locked door, and extra rewards. Five challenge areas: Skyward Stair, Ember Run, Rubble Maze, Lizalfos Pit, and Crumbling Causeway. Target Gallery in Mido: hit 12 targets before time runs out to earn a heart piece. Pogo Tower in Darunia: climb by bouncing off enemies with the downward thrust and collect the prize at the top. Six hidden caves with heart and magic pieces, a P-bag, and a 1-up. Four pieces make a container; the caves and minigames together supply one heart container and one magic container. Dark Isle: a new island in southeastern East Hyrule, reached through caves. Visit Grimhollow, a town of monsters with dialogue and healers, and climb Thornspire, a ten-room eighth palace. These are original…
Full changelog

What's new in 0.6.0

This release adds optional areas to explore, HD animation support for enemies and townspeople, camera zoom, and fixes for HD sprite placement and save states. These are the changes since 0.5.2.

New areas

The launcher and the in-game options menu now have a "New areas (ZALiA-inspired)" group. Enable its master switch, then choose which areas to add:

  • Parapa Annex: a seven-room wing off the entrance to Palace 1, with an outdoor back door, a key and locked door, and extra rewards.
  • Five challenge areas: Skyward Stair, Ember Run, Rubble Maze, Lizalfos Pit, and Crumbling Causeway.
  • Target Gallery in Mido: hit 12 targets before time runs out to earn a heart piece.
  • Pogo Tower in Darunia: climb by bouncing off enemies with the downward thrust and collect the prize at the top.
  • Six hidden caves with heart and magic pieces, a P-bag, and a 1-up. Four pieces make a container; the caves and minigames together supply one heart container and one magic container.
  • Dark Isle: a new island in southeastern East Hyrule, reached through caves. Visit Grimhollow, a town of monsters with dialogue and healers, and climb Thornspire, a ten-room eighth palace.

These are original layouts and dialogue inspired by the kinds of additions in ZALiA. The ZALiA preset now enables the Annex, challenge rooms, minigames, and caves. Dark Isle has its own toggle and stays off in that preset. All new areas stay off with the original-game settings.

Collected items, opened doors, and minigame rewards persist in battery saves with the original ROM. New entrances and terrain appear while their options are enabled. With a randomized ROM, an area is skipped if its reserved map slot is already occupied. If a seed occupies an area's progress storage, that progress survives in save states but not battery saves. Online co-op checks that both players have matching area options and data.

The new content still has a few unfinished details: minigame introduction and rules dialogue does not appear, the Target Gallery's ledges are decorative, and Old Barrow has a normal cave entrance rather than the planned hammer boulder. The challenge rooms have automated checks for their entrances, exits, enemies, and rewards; completing every trial by hand has not been checked.

HD characters and scenery

HD packs can now animate whole enemies, bosses, and townspeople, as well as Link. Packs can select animations for individual enemy states and NPC types. Characters drawn in the widescreen margins use their HD animations too.

Several placement and pose fixes keep the replacement art aligned with the original game:

  • Link's side-view ground position now lines up with his original collision geometry, including when he faces left.
  • Overworld Link is centered on the map sprite.
  • Link returns to walking after the item pickup animation finishes.
  • Surfaced Zoras have their own animation clips.
  • Helmethead's detached helmets are matched to their own sprites.
  • Loading a save state or rewinding no longer leaves old HD animation frames occupying the character cache indefinitely.

Pack authors can give scenery layers their own horizontal or vertical drift and animate them from PNG frames. The animation follows emulated time, so it pauses with the game and returns to the same frame after a seek or state load. Layers can also target individual new rooms. The pack checker validates layer frame sizes, animation rates, and drift settings.

The native debug overlays now show the collision geometry used by the game. Actor and collision dumps help pack authors compare their art with the original sprite positions.

Camera zoom

The native launcher and in-game display options now include camera zoom. It follows Link, keeps the status bar and boss meter at their normal size, and zooms back out for dialogue and menus. In local co-op it follows the midpoint of both players while they fit in view.

From a terminal, use --camera-zoom 2 for 2x zoom. Values from 1 to 4 are accepted; 1 turns it off. --present-size 2560x1440 sets an exact output size. Camera zoom changes the view only.

Save states

New desktop and browser save states store the complete game state, including the CPU, graphics memory, mapper, and frame counter. Loading a state from a different scene now restores that scene's tiles and graphics banks along with its RAM. Older desktop and browser state files still load.

Android and controllers

Android now presents HD packs at their full resolution instead of reducing them to the original game's resolution first.

Desktop players can override controller bindings for one run with --pad-map. For example, --pad-map South=A,East=B,Start=none maps the bottom face button to A, the right face button to B, and unbinds Start. Unlisted buttons keep their existing bindings.

Downloads and setup

Download the archive for Windows, Linux, Apple Silicon macOS, or Intel macOS and unpack it. Open z2rs-launcher (z2rs.app on macOS), choose your own Zelda II (USA) .nes file, and press Play. No ROM is included or uploaded. The Android APK supports Android 8.0 and newer.

HD graphics packs are separate downloads. Unpack each pack into its own empty folder, then select that folder in the launcher. Use this release for packs that need enemy animations or animated scenery layers.

On macOS, right-click the app and choose Open. If it is blocked, use System Settings > Privacy & Security > Open Anyway. On Windows, SmartScreen may require More info > Run anyway. On Linux, run chmod +x z2rs z2rs-launcher z2-signal if the unpacked programs are not executable.

HOW-TO-PLAY.txt in the desktop archives lists the controls and save locations. SHA256SUMS contains checksums for the archives and APK. The source code for these builds is available under this release's tag.

0.5.2
What's new in 0.5.2 This release fixes the bugs reported after 0.5.1. Most of them show up with an HD pack. Link no longer stays crouched after a sword swing With an HD pack, Link kept his crouching pose after a standing stab. He stood, walked and jumped normally, but the pack drew him on his knees until you did a crouching stab, which looked like he was sliding around on his knees. The game sets a flag on every standing stab that only a crouching stab clears, and z2rs read that flag as "ducking". z2rs now takes the pose from the frame the game draws. The game also draws its duck frame while a jump rises, so rising jumps showed the crouch pose too. They now use the pack's jump frames. Gameplay was never affected, only the HD pose. Dialogue no longer hides behind houses The town houses in the HD pack are drawn as layers over the background. The game writes its dialogue boxes, signs and pause menu into the background, so the house art covered them. Layers are no longer drawn inside those windows, and the full text shows. Enemies keep their HD art when hit When you hit an enemy, the game makes it flash by cycling it through all four sprite palettes. The HD pack only has art…
Full changelog

What's new in 0.5.2

This release fixes the bugs reported after 0.5.1. Most of them show up with an HD pack.

Link no longer stays crouched after a sword swing

With an HD pack, Link kept his crouching pose after a standing stab. He stood, walked and jumped normally, but the pack drew him on his knees until you did a crouching stab, which looked like he was sliding around on his knees. The game sets a flag on every standing stab that only a crouching stab clears, and z2rs read that flag as "ducking". z2rs now takes the pose from the frame the game draws. The game also draws its duck frame while a jump rises, so rising jumps showed the crouch pose too. They now use the pack's jump frames.

Gameplay was never affected, only the HD pose.

Dialogue no longer hides behind houses

The town houses in the HD pack are drawn as layers over the background. The game writes its dialogue boxes, signs and pause menu into the background, so the house art covered them. Layers are no longer drawn inside those windows, and the full text shows.

Enemies keep their HD art when hit

When you hit an enemy, the game makes it flash by cycling it through all four sprite palettes. The HD pack only has art for each enemy's normal colours, so three frames out of four fell back to the original sprite. z2rs now borrows the enemy's HD art from one of the other palettes and recolours it, so the enemy stays in HD and still flashes.

HD packs in the browser

The browser build accepted at most 256 files in a pack. The packs with the animated Link have about 2,500, one PNG per frame, so the browser rejected them and kept the pack it had loaded before. The limit is now 16,384 files. The 96 MiB size limit is unchanged. Picking a folder that holds two packs side by side is now refused with a message, instead of the browser picking whichever name sorted first. Paths written with backslashes in a pack's frame list now load too.

If the new Link still doesn't show on desktop, check two things. You need 0.5.1 or newer, because 0.5.0 ignores the animation frames. And unpack each pack into an empty folder: unpacking the new pack over the old v0.1 folder can leave the old pack.json in charge. The launcher now warns when a pack folder has an old pack.json next to new frames, or a newer pack one level down.

z2rs.com

Loading a ROM on z2rs.com did nothing in any browser, because the site was serving an older engine than its page expected. That is fixed. If a ROM fails to load, the error now shows on the screen instead of only in the Status box below it.

Desktop and Android builds of z2rs. Download the archive for your system and unpack it. Double-click z2rs-launcher (z2rs.app on macOS), pick your ROM, and press Play. The game remembers the ROM, so later you can also start z2rs directly. HOW-TO-PLAY.txt in the archive lists the controls and where settings and saves are kept.

No ROM is included and none is uploaded anywhere. You need your own Zelda II (USA) .nes file.

From a terminal, run the game directly:

./z2rs --rom /path/to/zelda2.nes [--scale 3] [--fullscreen]

./z2rs --help lists every flag. z2-signal is the signalling server for online co-op, and you only need it if you host your own instead of using the public one the launcher points at.

These builds are not code signed, so each system warns the first time:

  • macOS: right-click z2rs.app and choose Open. On newer macOS, if that does not offer Open, try once, then go to System Settings > Privacy & Security and click Open Anyway. If macOS still refuses, run xattr -dr com.apple.quarantine z2rs.app in the unpacked folder.
  • Windows: SmartScreen shows "Windows protected your PC". Click More info, then Run anyway.
  • Linux: if the files do not start, run chmod +x z2rs z2rs-launcher z2-signal.

On Android 8.0 or newer, download z2rs-0.5.2-android.apk on the phone and open it. Android asks once to allow installs from your browser or file manager. Open z2rs, pick your ROM and press Play. An on-screen gamepad is shown until you connect a controller. guide/android.md has the details.

SHA256SUMS lists the checksum of every archive and the APK.

0.5.1
What's new in 0.5.1 Animated Link in HD packs HD packs can now replace Link's whole body with their own animation frames instead of tile by tile. A pack lists them under actor_clips in pack.json: a character, a clip name such as walk or attack, a frame rate and a set of transparent PNG frames with a pivot each. While a clip plays, the game draws that one image where it draws Link, so poses that share a tile no longer show seams. Everything else in the pack still comes from the sheets, and a pack without actor_clips plays as before. The HD packs with the redrawn Link need this version. 0.5.0 skips keys it does not know, so it loads those packs without an error and draws Link from the sheets, which is why the new frames did not show up. guide/hd-packs.md describes the format and cargo xtask hdpack check validates a pack. Discord While Discord is running, the desktop build shows your area, attack, magic and life levels and lives on your profile. --no-discord, or "discord_presence": false in the config file, turns that off. Fixes On Windows 11, Print Screen opens the Snipping Tool, which took focus from the game for a moment. The game paused when it lost focus and stayed…
Full changelog

What's new in 0.5.1

Animated Link in HD packs

HD packs can now replace Link's whole body with their own animation frames instead of tile by tile. A pack lists them under actor_clips in pack.json: a character, a clip name such as walk or attack, a frame rate and a set of transparent PNG frames with a pivot each. While a clip plays, the game draws that one image where it draws Link, so poses that share a tile no longer show seams. Everything else in the pack still comes from the sheets, and a pack without actor_clips plays as before.

The HD packs with the redrawn Link need this version. 0.5.0 skips keys it does not know, so it loads those packs without an error and draws Link from the sheets, which is why the new frames did not show up. guide/hd-packs.md describes the format and cargo xtask hdpack check validates a pack.

Discord

While Discord is running, the desktop build shows your area, attack, magic and life levels and lives on your profile. --no-discord, or "discord_presence": false in the config file, turns that off.

Fixes

  • On Windows 11, Print Screen opens the Snipping Tool, which took focus from the game for a moment. The game paused when it lost focus and stayed paused, which looked like a freeze to anyone without a P key on their controller. A pause started by losing focus now ends when focus returns. A pause you chose yourself is left alone.
  • The browser build turns sound on at the first key press as well as the first click.

Desktop and Android builds of z2rs. Download the archive for your system and unpack it. Double-click z2rs-launcher (z2rs.app on macOS), pick your ROM, and press Play. The game remembers the ROM, so later you can also start z2rs directly. HOW-TO-PLAY.txt in the archive lists the controls and where settings and saves are kept.

No ROM is included and none is uploaded anywhere. You need your own Zelda II (USA) .nes file.

From a terminal, run the game directly:

./z2rs --rom /path/to/zelda2.nes [--scale 3] [--fullscreen]

./z2rs --help lists every flag. z2-signal is the signalling server for online co-op, and you only need it if you host your own instead of using the public one the launcher points at.

These builds are not code signed, so each system warns the first time:

  • macOS: right-click z2rs.app and choose Open. On newer macOS, if that does not offer Open, try once, then go to System Settings > Privacy & Security and click Open Anyway. If macOS still refuses, run xattr -dr com.apple.quarantine z2rs.app in the unpacked folder.
  • Windows: SmartScreen shows "Windows protected your PC". Click More info, then Run anyway.
  • Linux: if the files do not start, run chmod +x z2rs z2rs-launcher z2-signal.

On Android 8.0 or newer, download z2rs-0.5.1-android.apk on the phone and open it. Android asks once to allow installs from your browser or file manager. Open z2rs, pick your ROM and press Play. An on-screen gamepad is shown until you connect a controller. guide/android.md has the details.

SHA256SUMS lists the checksum of every archive and the APK.

Reply on the forum

A question or a hands-on report? Open the discussion on the forum.

Reply on the forum