Overworld Randomizer

This is a overworld randomizer for The Legend of Zelda: A Link to the Past for the SNES based on the Door Randomizer found at Aerinon's Github Project. See https://alttpr.com/ for more details on the normal randomizer.

Trackers & Guides

This is a very new mode of LTTPR so the tools and info is very limited.

• There is an OW Rando Cheat Sheet that shows all the transitions that exist and are candidates for shuffle.
• There is OW tracking capability within the following trackers:
  • Community Tracker
  • CodeTracker, an EmoTracker package for LTTPR
• There is an OW OWG Reference Sheet that shows all the in-logic places where boots/mirror clips and fake flippers are expected from the player.

Known Issues

(Updated 2021-11-06)

If you want to playtest this, know these things:

• If you fake flipper, beware of transitioning south. You could end up at the top of the waterfall in the southeast of either world. If you mistakenly drop down, it is important to know that altho the game may appear as frozen for a bit of time, the game is simply scrolling Link back to the original point of water entry. Upon "landing", you'll be able to S+Q properly. Falling from the waterfall is avoidable but it is super easy to do as it is super close to the transition.
• In Crossed OW, there are some interesting bunny swimming situations that can occur, these ARE in logic currently, just be careful and avoid taking a hit from an enemy.

Known bugs:

• Screens that loop on itself and also have free-standing items, the sprites are duplicated and can cause item duplication
• When OWG are performed to enter mega-tile screens (large OW screens), there is a small chance that an incorrect VRAM reference value causes the map graphics to offset in increments of 16 pixels

Feedback and Bug Reports

All feedback and dev conversation happens in the #ow-rando channel on the ALTTP Randomizer discord.

Installation from Source

Download the source code from the repository directly and put it in a folder of your choosing.

You must have Python installed (version 3.6 - 3.9 supported)

This program requires all python dependencies that are necessary to run Aerinon's Door Randomizer. Try running pip install missingdependency or python -m pip install missingdependency on the command line (replace missingdependency with the specific package that is missing) to install the dependency.

Alternatively, run resources/ci/common/local_install.py to install all the missing dependencies as well.

See the following link if you have additional trouble: https://github.com/codemann8/ALttPDoorRandomizer/blob/OverworldShuffle/docs/BUILDING.md

Running the Program

To use the CLI, run DungeonRandomizer.py.

Alternatively, run Gui.py for a simple graphical user interface.

Settings

Only extra settings are found here. All door and entrance randomizer settings are supported. See their readme

Overworld Layout Shuffle (--ow_shuffle)

Vanilla

OW is not shuffled.

Parallel

OW Transitions are shuffled, but both worlds will have a matching layout.

Full

OW Transitions are shuffled within each world separately.

Crossed Options (--ow_crossed)

This allows OW connections to be shuffled cross-world.

'None (Allowed)' allows entrance connectors and whirlpools to result in cross-world behavior, but edge transitions will not. This isn't a recommended option.

Polar and Grouped both are guaranteed to result in two separated planes of tiles. To navigate to the other plane, you have the following methods: 1) Normal portals 2) Mirroring on DW tiles 3) Fluting to a LW tile that was previously unreachable

Limited and Chaos are not bound to follow a two-plane framework. This means that it could be possible to travel on foot to every tile without entering a normal portal.

See each option to get more details on the differences.

None

Transitions will remain same-world.

Polar

Only effective if Mixed/Tile Swap is enabled. Enabling Polar preserves the original/vanilla connections even when tiles are swapped/mixed. This results in a completely vanilla overworld, except that some tiles will transform Link to a Bunny (as per Mixed swapping some tiles to the other world). This offers an interesting twist on Mixed where you have a pre-conditioned knowledge of the terrain you will encounter, but not necessarily be able to do what you need to do there. (see Tile Swap/Mixed section for more details)

Grouped

This option shuffles connections cross-world in the same manner as Tile Swap/Mixed, the connections leading in and coming out of a group of tiles are crossed. Unlike Polar, this uses a different set of tile groups as a basis of crossing connections, albeit the same rule govern which groups of tiles must cross together (see Tile Swap/Mixed for more details)

Limited

Every transition independently is a candidate to be chosen as a cross-world connection, however only 9 transitions become crossed (in each world). This option abides by the Keep Similar Edges Together option and will guarantee same effect on all edges in a Similar Edge group if enabled. If a Similar Edge group is chosen from the pool of candidates, it only counts as one portal, not multiple.

Note: Only parallel connections (a connection that also exists in the opposite world) are considered for cross-world connections, which means that the same connection in the opposite world will also connect cross-world.

Note: If Whirlpool Shuffle is enabled, those connections can be cross-world but do not count towards the 9 transitions that are crossed.

Motive: Why 9 connections? To imitate the effect of the 9 standard portals that exist.

Chaos

Same as Limited, except that there is no limit to the number of cross-world connections that are made. Each transition has an equal 50/50 chance of being a crossed connection.

Keep Similar Edges Together (--ow_keepsimilar)

This keeps similar edge transitions together. ie. The 2 west edges of Potion Shop will be paired to another set of two similar edges

Note: This affects OW Layout Shuffle mostly, but also affects Limited and Chaos modes in Crossed OW.

Tile Swap / Mixed Overworld (--ow_mixed)

OW tiles are randomly chosen to become a part of the opposite world. When on the Overworld, there will be an L or D in the upper left corner, indicating which world you are currently in. Mirroring still works the same, you must be in the DW to mirror to the LW.

Note: Tiles are put into groups that must be shuffled together when certain settings are enabled. For instance, if ER is disabled, then any tiles that have a connector cave that leads to another tile, those tiles must swap together; (an exception to this is the Old Man Rescue cave which has been modified similar to how Inverted modifies it, Old Man Rescue is ALWAYS accessible from the Light World)

Whirlpool Shuffle (--ow_whirlpool)

When enabled, the whirlpool connections are shuffled. If Crossed OW is enabled, the whirlpools can also be cross-world as well. For Limited Crossed OW, this doesn't count towards the limited number of crossed edge transitions.

Flute Shuffle (--ow_fluteshuffle)

When enabled, new flute spots are generated and gives the player the option to cancel out of the flute menu by pressing X.

Note: Desert Teleporter Ledge is always guaranteed to be chosen. One of the three Mountain tiles are guaranteed if OW Layout Shuffle is set to Vanilla.

Vanilla

Flute spots remain unchanged.

Balanced

New flute spots are chosen at random, with restrictions that limit the promixity between other chosen flute spots.

Random

New flute spots are chosen at random with minimum bias.

New Goal Options (--goal)

Trinity

This goal gives you the choice between 3 goals, only one of which the player needs to complete: Defeat Ganon (no Aga2), Pulling Pedestal, or turn in TF pieces to Murahdulah. By default, you need to find 8 of 10 total TF pieces but this can be changed with a Custom Item Pool. It is recommended to set GT Entry to 7 crystals and Ganon to 5 crystals or Random crystals, although the player can flexibly change these settings as they seem fit.

New Entrance Shuffle Options (--shuffle)

Lite

This mode is intended to be a beginner-friendly introduction to playing ER. It focuses on reducing low% world traversal in late-game dungeons while reducing the number of entrances needing to be checked.

This mode groups entrances into types and shuffles them freely within those groups.

• Dungeons and Connectors (Multi-Entrance Caves)
• Item Locations (Single-Entrance Caves with an item, includes Potion Shop and Red Bomb Shop, includes Shops only if Shopsanity is enabled)
• Dropdowns and their associated exits (Skull Woods dropdowns are handled the same as in Crossed)
• Non-item locations (junk locations) all remain vanilla

Lite mode shuffles all connectors same-world, to limit bunny traversal. And to prevent Low% enemy and boss combat, some dungeons are confined to specific worlds.

The following dungeons are guaranteed to be in the Light World:

• Hyrule Castle
• Eastern Palace
• Desert Palace
• Tower of Hera
• Agahnim's Tower

The following are guaranteed to be in the Dark World:

• Ice Palace
• Misery Mire
• Turtle Rock
• Ganon's Tower

Lean

This mode is intended to be a more refined and more competitive format to Crossed ER. It focuses on reducing the number of entrances needing to be checked, while giving the player unique routing options based on the entrance pools defined below, as opposed to mindlessly checking all the remaining entrances. The Dungeons/Connectors can connect cross-world.

This mode groups entrances into types and shuffles them freely within those groups.

• Dungeons and Connectors (Multi-Entrance Caves)
• Item Locations (Single-Entrance Caves with an item, includes Potion Shop and Red Bomb Shop, includes Shops only if Shopsanity is enabled)
• Dropdowns and their associated exits (Skull Woods dropdowns are handled the same as in Crossed)
• Non-item locations (junk locations) all remain vanilla

Command Line Options

-h, --help

Show the help message and exit.

--ow_shuffle <mode>

For specifying the overworld layout shuffle you want as above. (default: vanilla)

--ow_crossed <mode>

For specifying the type of cross-world connections you want on the overworld

--ow_keepsimilar

This keeps similar edge transitions paired together with other pairs of transitions

--ow_mixed

This gives each OW tile a random chance to be swapped to the opposite world

--ow_fluteshuffle <mode>

For randomizing the flute spots around the overworld