Zelda II : The Adventure of Link
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
Apple Silicon
64 bits
Jeu d’origine
Zelda II : The Adventure of Link NES
Téléchargement et liens
- Télécharger Zelda II : The Adventure of Link
- Code source 214 étoiles sur GitHub
- Licence : MIT
Historique des versions
0.6.0
Changelog complet
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
Changelog complet
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.appand 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, runxattr -dr com.apple.quarantine z2rs.appin 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
Changelog complet
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
Pkey 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.appand 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, runxattr -dr com.apple.quarantine z2rs.appin 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.
0.5.0
Changelog complet
What's new in 0.5.0 (REFORGED update)
Randomizer
z2rs can now build a randomized Zelda II from your own ROM. In the launcher, open the ROM randomizer tab, type a seed or press Random seed, pick a preset (Beginner, Standard or Max rando) or set the options yourself, and press Play. The flag string holds every option, so you can paste it to a friend, and with the same seed and version they get the same game. A six character hash on the file select screen confirms it. The browser build has the same seed and flag fields. Android does not have the randomizer yet.
The options follow the community Z2Randomizer by Digshake and Ellendar. The code is new and none of that project's data is used, so seeds are not compatible between the two. What you can randomize:
- The overworld: shuffle locations on the original maps, or generate each continent from scratch in one of several biomes, with Death Mountain built from cave pockets and Maze Island as a real maze. Continent size, connections, hidden Palace 6 and New Kasuto, and encounter rates are options too.
- Palaces: ten layout styles build new palaces from the rooms in your ROM, with options for length, item rooms, boss exits, Dark Link's distance, Thunderbird and colours.
- Items: palace and overworld items, P-bag caves, small items and keys. Every seed is checked before you play it, so it can always be finished.
- Starting items, spells, containers, lives and levels.
- Enemies, enemy and boss health, experience, level caps, and the attack, magic and life tables.
- Drops: the drop pools, how often enemies drop, and fixed drop rhythms.
- Spells: which wizard teaches what, Fire linked to another spell or replaced by Dash, swapped up and down stabs, jump always on, permanent sword beam and random knockback.
- Hints from townspeople and town signs, new townsfolk lines, visible false walls and hidden jars, the New Kasuto requirement and shorter wizard visits.
- Faster text, fewer low health beeps, no death flashing, faster spell casting, and tunic, beam and palette colours. You can also apply your own Link sprite as an IPS patch.
A spoiler log is optional. Each seed keeps its own battery save and save states, and online co-op checks that both players have the same seed. A few options are not done yet and are marked that way in the launcher: spells and quest items in the item pool, flute warp, a harder Carock, the updated HUD, custom music and two continent links. guide/randomizer.md has the details.
Enhancements inspired by ZALiA
A new set of optional changes, many of them modelled on features of ZALiA, HoverBat's Zelda II remake. Everything is off by default. Set them in the launcher's new Enhancements tab, or press O in the game (LB+RB+Y on a gamepad) to open an options menu that pauses the game. Among them:
- Faster dialogue, continuing from the last town or palace entrance, keeping some experience after a game over, entering towns from the side, and a softlock escape on the overworld.
- Fixes for the level-up softlocks, crumbling floors, the shield hitbox and experience drain.
- Changes to Iron Knuckles, Ra, Stalfos, Wizzrobes, Magos and several bosses.
- Double jump, stab frenzy, longer sword reach, damage reduction, magic regeneration, faster running, a rescue fairy and flute warping between towns.
- Starting loadouts, scaled enemy and experience values, palette randomization and a major item shuffle.
- Cheats, a quest timer, screen shake, background flash colour, separate music and effect volumes, brightness and scanline effects, and developer overlays.
Online co-op players need matching gameplay options. These enhancements are desktop only for now. guide/enhancements.md lists every option.
Fixes from Discord and GitHub reports
- The browser build stayed silent on 48 kHz audio devices, and over a long session the sound skipped about every 25 seconds. Both are fixed. Sound now starts from any click or key press on the page, a message on screen says when the browser is still holding it back, and a
sound:line under Mute shows the audio state for bug reports. - Pressing Left before letting go of Right (or the other way round) could send Link sliding backwards at high speed. The most recent direction now wins, as on a real NES pad.
allow_opposing_directionsin the config turns this off. - Some Windows machines crashed at launch, including one inside AMD's OpenGL driver, and some crashed when an Xbox Series controller was used. The game now tries DirectX 12 and then Vulkan, skips a graphics backend that crashed it last time, and stops trying OpenGL by itself.
gpu_backendin the config picks one by hand,gamepads_enabledcan turn controllers off, andz2-native.login the data directory shows how far startup got. - In 16:9 widescreen, thin strips flashed at the edges of the original picture on the overworld, and monsters vanished there a few pixels early. Both are fixed.
- The Android app can now import an HD pack from a
.zipfile or a folder.
Downloads
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.appand 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, runxattr -dr com.apple.quarantine z2rs.appin 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.0-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.4.0
Changelog complet
What's new in 0.4.0
z2rs now runs on Android 8.0 and newer. Download z2rs-0.4.0-android.apk on the phone, open it, pick your own Zelda II (USA) ROM and press Play. An on-screen gamepad is shown until you connect a controller, and two controllers give local co-op. You can change the pad's size and opacity, turn on haptics, switch to a left-handed layout or high contrast, and use the pad's buttons with TalkBack or Switch Access. Back opens a pause menu with save and load. Online co-op and HD packs are not available on Android yet. guide/android.md has the details.
Fixes
- Games ran two to four times too fast, with crackling sound, on Windows machines whose output device is set to 96 or 192 kHz. A 44.1 kHz setup on a 48 kHz device ran about 9% fast. Sound is now resampled to whatever rate the device uses, and game speed follows the NES clock.
- Fullscreen left thick black borders on screens whose height is not a whole multiple of 240 lines, such as the 2560x1600 Legion Go. The picture now scales to fill the screen height. The 16:9 widescreen preset covers a 16:9 screen, and 16:10 fills a 16:10 screen.
--scale-mode integer(or "Whole-number scaling only" in the launcher) brings back whole-number scaling. - Windows could open larger than the screen on displays with 125 to 200% scaling, most visibly with an HD pack loaded. Window sizes now fit the screen after display scaling and leave room for the title bar and taskbar.
- On Windows the game crashed with a stack overflow just after "netplay: synchronizing" when an online co-op session started. It now starts normally.
Downloads
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.appand 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, runxattr -dr com.apple.quarantine z2rs.appin 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.4.0-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.3.0
Changelog complet
Desktop 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.appand 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, runxattr -dr com.apple.quarantine z2rs.appin 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.
SHA256SUMS lists the checksum of every archive.
0.2.0
Desktop builds of z2rs. Download the archive for your system, unpack it,
and run z2rs with your own Zelda II (USA) ROM:
./z2rs --rom /path/to/zelda2.nes
No ROM is included and none is uploaded anywhere. z2-signal in the
same archive is the signalling server for online co-op, and you only
need it if you host a session yourself.
These builds are not code signed. macOS needs right click and Open the
first time, Windows SmartScreen needs More info and Run anyway, and on
Linux the file may need chmod +x.
SHA256SUMS lists the checksum of every archive.
0.1.0
Desktop builds of z2rs. Download the archive for your system, unpack it,
and run z2rs with your own Zelda II (USA) ROM:
./z2rs --rom /path/to/zelda2.nes
No ROM is included and none is uploaded anywhere. z2-signal in the
same archive is the signalling server for online co-op, and you only
need it if you host a session yourself.
These builds are not code signed. macOS needs right click and Open the
first time, Windows SmartScreen needs More info and Run anyway, and on
Linux the file may need chmod +x.
SHA256SUMS lists the checksum of every archive.
Réagir sur le forum
Une question, un retour d’expérience ? Ouvrez la discussion sur le forum.