Beta settings. Settings marked "(beta)" on the page are less tested, so expect bugs with them; they stay locked until you turn on Enable Beta Flags. If something looks wrong, report it with the seed, flags and version in the ZORA Discord.
ZORA (Zelda One Randomizer App) is an open-source randomizer for The Legend of Zelda.
Play it: https://zora.gg/
ZORA is built on the notion that there isn't one right way to play a game. It aims to support as many ways to reimagine, randomize, and replay Zelda 1 as possible.
ZORA is a clean-room reconstruction of the core randomization features the Zelda 1 community has come to expect from over a decade of Zelda 1 randomization, along with new options, flags, and ways to experience the game. It's designed to decouple game data and logic from technical ROM details, so adding a new feature doesn't require being an expert programmer.
ZORA is currently maintained by Tetra and welcomes new contributors.
ZORA is for gamers who want to try new flags and features, for contributors who want to shape what the randomizer becomes, and for anyone who's wanted a way to change the game that didn't exist yet.
It's not for everyone. Some players will prefer other randomizers for their stability, polish, or original vision, and that's okay. ZORA exists alongside those projects, not in opposition to them.
- Zelda for all. ZORA belongs to everyone who plays it and everyone who shapes it. No single person should be indispensable, and no one who participates in good faith should be excluded.
- Openness. Open source, open governance, open reasoning. Decisions are made as transparently as possible.
- Room for growth. Zelda 1 can be reimagined in countless ways. Limits exist, but ZORA aims to support as many features as it can hold coherently.
- Accessibility. The codebase, the community, and the decision-making are all intended to welcome a wide range of skill levels.
ZORA is still experimental. The framework exists, the core features are in place, and the foundation is laid for the community to shape what it becomes. If you want to play, contribute, suggest, or just watch it develop, you're welcome here.
It's dangerous to go alone. Take this.
- Some flag values are not made yet: the page shows them grayed out as "Not yet implemented".
- Beta settings: Universal Drops v2.0, and Spoiler Log Detail Level's Basic, Medium and Full (with the tracker file that comes with a log). Any Random that can pick one of them is beta too.
- To report a bug, give the seed, the flags and the version (the page's "Copy bug report info" button copies them).
The code is a Python package, zora/, with its tests in tests/ (sh scripts/verify.sh runs
them). The web page lives in web/, and the ROM patches in asm/. Further docs: the flag names
(docs/flag-names.md), the seed document and spoiler log (docs/seed-format/) and the notes for
beta testers (docs/beta-testers.md). A public developer guide is still to be written.
ZORA is released under the MIT license; see LICENSE. Third-party material (community
features, fonts, the NES palette) is credited in docs/credits.md.
See docs/credits.md for details.
ZORA is developed with extensive use of AI coding assistants, primarily Anthropic's Claude. They write most of its code, tests, and documentation under my direction. I make most design and behavior decisions, review each session's reports, and play-test. Code is checked by an extensive automated test suite, by statistical comparison against thousands of seeds from the original randomizer, and by separate AI review sessions. I don't review every line of code myself and instead rely on playtesting seeds to verify accuracy like I would non-AI randomizer code.