Skip to content
tetralyPublic

About

Zelda One Randomizer App

Resources

Stars

1 star

Watchers

1 watching

Forks

Latest commit

 

History

19 Commits

Folders and files

Repository files navigation

ZORA

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.

What it is

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.

Who it's for

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.

ZORA's values

  • 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.

What comes next

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.

Known limitations (2.0.0)

  • 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).

Developer notes

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.

License

ZORA is released under the MIT license; see LICENSE. Third-party material (community features, fonts, the NES palette) is credited in docs/credits.md.

Credits

See docs/credits.md for details.

AI Disclosure

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.

About

Zelda One Randomizer App

Resources

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages