{"id":21938023,"url":"https://github.com/jangler/oracles-randomizer","last_synced_at":"2025-04-22T12:26:41.976Z","repository":{"id":50956702,"uuid":"142613350","full_name":"jangler/oracles-randomizer","owner":"jangler","description":"Randomizer for Zelda: Oracle of Seasons and Oracle of Ages","archived":false,"fork":false,"pushed_at":"2024-01-11T14:28:48.000Z","size":2326,"stargazers_count":76,"open_issues_count":15,"forks_count":18,"subscribers_count":14,"default_branch":"master","last_synced_at":"2024-06-18T23:03:16.666Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jangler.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-07-27T18:54:01.000Z","updated_at":"2024-06-11T22:05:49.000Z","dependencies_parsed_at":"2024-01-11T16:34:28.159Z","dependency_job_id":"a360373d-06f1-4768-838b-4d90af099fc6","html_url":"https://github.com/jangler/oracles-randomizer","commit_stats":null,"previous_names":[],"tags_count":125,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jangler%2Foracles-randomizer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jangler%2Foracles-randomizer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jangler%2Foracles-randomizer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jangler%2Foracles-randomizer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jangler","download_url":"https://codeload.github.com/jangler/oracles-randomizer/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":227019089,"owners_count":17718008,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-29T01:27:27.932Z","updated_at":"2024-11-29T01:27:29.071Z","avatar_url":"https://github.com/jangler.png","language":"Go","readme":"# Zelda Oracles Randomizer\n\n\u003e Summary of different randomizer versions and links to their web interfaces:\n\u003e\n\u003e - [This version](https://cemulate.github.io/oracles-randomizer-web/), which supports multiworld\n\u003e - [vinheim3's version](https://cemulate.github.io/oracles-randomizer-web/), which supports full entrance randomization\n\u003e - [Stewmath's version](https://oosarando2.zeldahacking.net/), which supports keysanity and cross items\n\u003e - [karafruit's version](https://oracles-dev.gwaa.kiwi/generate), which supports Stewmath's features plus some goodies\n\nThis program reads a Zelda: Oracle of Seasons or Oracle of Ages ROM (US\nversions only), shuffles the locations of (most) items and mystical seeds, and\nwrites the modified ROM to a new file. In Seasons, the default seasons for each\narea are also randomized. Most arbitrary overworld checks for essences and\nother game flags are removed, so the dungeons and other checks can be done in\nany order that the randomized items facilitate. However, you do need to collect\nall 8 essences to get the Maku Seed and finish the game.\n\n\n## Usage\n\nYou probably want the\n[web interface](https://cemulate.github.io/oracles-randomizer-web),\ncontributed by [cemulate](https://github.com/cemulate).\n\nOtherwise, there are three ways to use the randomizer:\n\n1. Place the randomizer in the same directory as your vanila ROM(s) (or vice\n   versa), and run it. The randomizer will automatically find your vanilla\n   ROM(s) and prompt for further options.\n2. In Windows, drag your vanilla ROM onto the executable. Same deal as above,\n   except that the ROM and randomizer don't have to be in the same folder.\n3. Use the command line. Type `./oracles-randomizer -h` to view the usage\n   summary.\n\nYou may also be interested in\n[Oracles Randomizer Extras](https://jangler.github.io/oracles-randomizer-extras/).\n\n\n## Download\n\nYou can download executables for Windows, macOS, and Linux from the\n[releases](https://github.com/jangler/oracles-randomizer/releases) page. Don't\nuse the \"Download ZIP\" link on the main page; that only contains the source\ncode. The download also contains a rudimentary location checklist and item\ntracker. If you're looking for a more detailed item and map tracker,\n[EmoTracker](https://emotracker.net/) has a pack developed by Herreteman.\n\nSee\n[contributing.md](https://github.com/jangler/oracles-randomizer/blob/master/doc/contributing.md)\nfor instructions on building the randomizer from source.\n\n\n## Randomization notes\n\nGeneral details common to both games:\n\n- Items and chests are randomized, with these exceptions:\n    - Renewable shop and business scrub items (bombs, shield, hearts, etc.)\n\t- Gasha seeds and pieces of heart outside of chests\n\t- NPCs that give non-progression items in the vanilla game\n\t- Gasha nut contents\n\t- Fixed drops (from bushes, pots, etc.)\n\t- Maple drops\n\t- Linked secrets\n- Mystical seed trees are randomized, with no more than two trees of each type.\n  Items that use seeds for ammunition start with the type of seed that's on the\n  Horon Village or Lynna City tree.\n- For items that have two levels, the first you obtain will be L-1, and the\n  second will be L-2, regardless of the order in which you obtain them. The L-2\n  shield is an exception.\n- There is one flute in the game for a random animal companion, and it's\n  identified and usable as soon as you get it. Only the 150-rupee item in the\n  shop is randomized; the other two usual means of getting a strange flute\n  don't give anything special. The animal companion regions (Natzu in Seasons\n  and Nuun in Ages) match whatever flute is in the seed.\n- Rings are instantly appraised when you get them, and the ring list can be\n  accessed from the inventory ring box icon. For convenience, the L-3 ring box\n  is given at the start. The punch rings can be used with only one equip slot\n  empty.\n- Select+right on the file select screen toggles music. Select+left on the file\n  select screen toggles between GBC palettes (default) and lighter GBA\n  palettes; this will only have an effect if you're playing on or emulating a\n  GBA.\n- If tree warp is enabled, holding start while closing the map screen outdoors\n  warps to the seed tree in Horon Village or Lynna City. Tree warp comes with\n  no warranty and is not supported as a \"feature\", so think carefully before\n  using it.\n- If hard difficulty is enabled, speedrun-level tricks may be required to\n  complete the game. Use normal difficulty if you just want to do a casual\n  playthrough!\n\nFor game-specific notes on randomization and logic, see\n[seasons_notes.md](https://github.com/jangler/oracles-randomizer/blob/master/doc/seasons_notes.md)\nand\n[ages_notes.md](https://github.com/jangler/oracles-randomizer/blob/master/doc/ages_notes.md).\n\nSee\n[multiworld.md](https://github.com/jangler/oracles-randomizer/blob/master/doc/multiworld.md)\nfor information on multiworld seeds.\n\nSee\n[plan.md](https://github.com/jangler/oracles-randomizer/blob/master/doc/plan.md)\nfor information on plando generation.\n\n\n## FAQ\n\n**Q: Is there a place to discuss the randomizer?**\n\nA: Yes, the [Oracles Discord server](https://discord.gg/pyBEbz5). The server is\nmainly focused on speedrunning, but randomizer-specific channels exist as well.\n\n**Q: I found a problem. What do I do?**\n\nA: Open an issue about it on GitHub or bring it up in a randomizer channel in\nthe Oracles discord. Provide your seed's log file either way.\n\n**Q: Will you make a cross-game randomizer that combines Ages and Seasons into\none ROM?**\n\nA: no\n\n**Q: Can I at least do a linked game?**\n\nA: You can try, as long as you're not doing multiworld, but the consensus seems\nto be that it's not worthwhile. Linked content is unrandomized and sometimes\ninaccessible. Linked Ages seeds also have a chance to be uncompletable due to\nhow Sea of Storms works.\n\n**Q: What emulator would you recommend for playing the randomizer?**\n\nA: If you want to play multiworld, you must use Bizhawk. BGB and mGBA are good\nchoices otherwise. Avoid VisualBoyAdvance and its variants; they have serious\nemulation bugs that can cause crashes and other problems.\n\n\n## Thanks to:\n\n- Stewmath for [oracles-disasm](https://github.com/Stewmath/oracles-disasm) and\n  additional code.\n- Herreteman, dragonc0, Phoenomenom714, and jaysee87 for help with logic,\n  playtesting, design, and \"customer support\".\n- Everyone who helped playtest prerelease versions of the randomizer.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjangler%2Foracles-randomizer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjangler%2Foracles-randomizer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjangler%2Foracles-randomizer/lists"}