ALTTP · Oracle · Tools

ALTTPHacking.net

Oracle of Secrets

A Link to the Past ROM Hack · Beta Testing & Release Prep

Oracle of Secrets

A full-length SNES adventure built on The Legend of Zelda: A Link to the Past by scawful. All main dungeons and the final boss are playable; beta testing and final polish are underway ahead of release.

🧪Beta Testing

How to test Oracle of Secrets

Oracle of Secrets is distributed exclusively as a free .bps patch — never as a ROM. Beta builds and bug-report channels are hosted in the community Discord while puzzles, pacing, and expanded regions are finalized.

  1. Prepare your own clean, unheadered US A Link to the Past v1.0 ROM (1,048,576 bytes, CRC32 777aac2f, SHA-256 66871d66...7316009cfb).
  2. Grab Floating IPS (Flips) or beat.
  3. Join the Oracle of Secrets Discord to get the latest beta .bps patch and changelog.
  4. Apply the .bps patch to a copy of your clean US ROM. Keep your original backup untouched.
  5. Play on Mesen2 (recommended), Mesen2-OOS, Snes9x, ares, or original SNES hardware via flash cart (FXPAK Pro / SD2SNES).
📋What helps most

Beta feedback checklist

  • Progression & puzzles: spots where clues feel unclear, rooms where you get stuck, or unintended softlocks.
  • Visuals & audio: palette glitches, sprite clipping, missing sound effects, or screen-transition seams.
  • Performance & hardware: lag spikes, VBlank tears, or save/reopen quirks on Mesen2, Snes9x, ares, or FXPAK Pro.
  • Include context: area or dungeon name, emulator/hardware version, and a screenshot or .srm battery save when reporting in Discord.

Release commitment

When 1.0 launches, the .bps patch will be free for everyone on the same day here and on GitHub Releases — no paid or paywalled ROM builds.

Development footage (native SNES audio)

Direct captures from the 4 MB SNES ROM running in Mesen2-OOS and on Retroid Pocket 5, cropped cleanly with native SPC audio.

Title Screen

Calmed background vortex with native SNES title music.

Kalyxo Overworld Panoramic Tour

HUD-free camera sweep across Kalyxo's landmarks, shrines, and coastal regions.

Screenshots

Wayward Village & 12-Hour Day/Night HUD

Minish Cap Link standing in Wayward Village with the 12-hour Sun HUD clock.

Zora Sanctuary

Zora Sanctuary entrance open, with Link visible on the central stairs.

Eon Abyss (GBC-Styled Dark World)

Eon Abyss overworld blending Game Boy Color Oracle aesthetics on SNES.

Eon Abyss Windmill Interior

GBC-styled Windmill interior in the Eon Abyss running natively on SNES.

What's inside

  • Expanded 3-world map: Kalyxo Light World, the Game Boy Color–styled Eon Abyss Dark World, and the expanded Lyra Sea.
  • Original dungeons & shrines: Eight main dungeons plus regional shrines, side quests, and custom bosses.
  • Masks, mounts & items: Deku, Zora, Wolf, Minish, Moosh, Epona, and King of Red Lions alongside Gust Jar, Goldstar, Roc's Feather, Song of Soaring, and Magic Rings.
  • Modern SNES systems: 2-item HUD, full day/night time cycle, 3-world Mode 7 soaring maps, and custom 65816 assembly compiled with Asar / z3dk.

Open-source ALTTP hacking stack

Oracle of Secrets is built in the open alongside modern tools designed to make A Link to the Past ROM hacking approachable for everyone:

  • yaze — Cross-platform C++ editor for overworld, dungeons, expanded maps, graphics, palettes, messages, and music.
  • z3dk — Zelda 3 assembly toolchain, linter, and IDE language server.
  • Mesen2-OOS — Debugger fork with handheld Workshop overlay and automated runtime tests.

Credits & attribution

Contributors and feature credits

The game includes a large amount of work created by prominent members in the Zelda3 ROM hacking community over at Zeldix such as SePH, Conn, and Euclid.

Design of the overworld is done by scawful with graphics sourced from past Zelda titles, SpritersResource, Zeldix community assets, and abandoned Zelda hacks like Legends of Hyrule and Lyra Islands. Some areas from those hacks have been adjusted or ported over to this hack. Dungeons are entirely original designs by scawful.

Selected feature contribution notes

  • ▲ Link appears as he did in the Minish Cap (ghillie)
  • ▲ Ocean area requires combination to proceed (Euclid)
  • ▲ Pressing the L button during monologue allows it to be skipped (Conn)
  • ▲ Goldstar ball-and-chain weapon (Conn)
  • ▲ Ice Rod freezes water, allowing it to be walked on with a slippery tile effect (Conn)

FAQ

Where do I get the base ROM?
Dump your own US The Legend of Zelda: A Link to the Past (v1.0) cartridge. No ROMs are hosted or linked here — patches only.

Is Oracle of Secrets a fangame engine or a real SNES ROM?
It is a real 4 MB Super Nintendo ROM hack written in 65816 assembly and playable on SNES emulators and original hardware via flash cart.

Disclaimer:
Fan project. Not affiliated with Nintendo. No ROMs provided; patches only.