From 6a0aa190a9eeff32d5838449e513f28b03ffcbe2 Mon Sep 17 00:00:00 2001 From: aerinon Date: Mon, 8 Dec 2025 16:37:04 -0700 Subject: [PATCH 01/34] fix: issue with keys counts not updating correctly --- PastReleaseNotes.md | 21 ++++++++++++++++++++- RELEASENOTES.md | 18 ++---------------- Rom.py | 2 +- data/base2current.bps | Bin 118398 -> 118425 bytes 4 files changed, 23 insertions(+), 18 deletions(-) diff --git a/PastReleaseNotes.md b/PastReleaseNotes.md index dbdc2f12..adf09b6a 100644 --- a/PastReleaseNotes.md +++ b/PastReleaseNotes.md @@ -1,10 +1,29 @@ # Past Feature Notes -1.4.3: File Select/End Game screen: Mirror Scroll and Pseudoboots added (Thanks Hiimcody!) +1.5.0 +* Enemy Drop: Added "spies" and shadows for hidden enemies when enemy drop shuffled is enabled +* Pottery: Pots will uncolor when the item inside is collected next time the room is loaded + +1.4.3 +* File Select/End Game screen: Mirror Scroll and Pseudoboots added (Thanks Hiimcody!) # Patch Notes Changelog archive +* 1.5.0 + * Logic: Fixed vanilla key logic for GT basement + * Logic (Playthrough): Fixed an issue where enemy kill rules were not applied during playthrough calculation. (Thanks Catobat for the catch) + * Keysanity/Keydrop Menu for DR: + * Map key information is now controlled by the Dungeon Chest Counts setting. If set to always on, this information will be available right away in the menu and will be on the HUD even when the map is not obtained. + * The key counter on the HUD for the current dungeon now accounts for keys from enemies or pots that are from vanilla key locations. + * The first number on the HUD represents all keys collected either in that dungeon or elsewhere. + * The second number on the HUD is the total keys that can be collected either in that dungeon or elsewhere. + * The key counter on inside the Menu is unchanged. (At the bottom near A button items) + * The first number in the Menu is the current number of keys in your inventory + * The second number is how many keys left to find in chests (not those from pots/enemies unless those item pools are enabled) + * Customizer: free_lamp_cone option added. The logic will account for this, and place the lamp without regard to dark rooms. + * Customizer: force_enemy option added that makes all enemies the specified type if possible. There are known gfx glitches in the overworld. + * Optimization: Improved generation performance (Thanks Catobat!) * 1.4.11 * Rom fixes (all thanks to Codemann, I believe) * Pot bug when at sprite limit diff --git a/RELEASENOTES.md b/RELEASENOTES.md index b614f702..07edbb58 100644 --- a/RELEASENOTES.md +++ b/RELEASENOTES.md @@ -1,18 +1,4 @@ # Patch Notes -* 1.5.0 - * Logic: Fixed vanilla key logic for GT basement - * Logic (Playthrough): Fixed an issue where enemy kill rules were not applied during playthrough calculation. (Thanks Catobat for the catch) - * Enemy Drop: Added "spies" and shadows for hidden enemies when enemy drop shuffled is enabled - * Pottery: Pots will uncolor when the item inside is collected next time the room is loaded - * Keysanity/Keydrop Menu for DR: - * Map key information is now controlled by the Dungeon Chest Counts setting. If set to always on, this information will be available right away in the menu and will be on the HUD even when the map is not obtained. - * The key counter on the HUD for the current dungeon now accounts for keys from enemies or pots that are from vanilla key locations. - * The first number on the HUD represents all keys collected either in that dungeon or elsewhere. - * The second number on the HUD is the total keys that can be collected either in that dungeon or elsewhere. - * The key counter on inside the Menu is unchanged. (At the bottom near A button items) - * The first number in the Menu is the current number of keys in your inventory - * The second number is how many keys left to find in chests (not those from pots/enemies unless those item pools are enabled) - * Customizer: free_lamp_cone option added. The logic will account for this, and place the lamp without regard to dark rooms. - * Customizer: force_enemy option added that makes all enemies the specified type if possible. There are known gfx glitches in the overworld. - * Optimization: Improved generation performance (Thanks Catobat!) +* 1.5.1 + * Bugfix: Fixed an issue with keys not counting correctly diff --git a/Rom.py b/Rom.py index f71b43c4..6b8198b2 100644 --- a/Rom.py +++ b/Rom.py @@ -42,7 +42,7 @@ from source.enemizer.Enemizer import write_enemy_shuffle_settings JAP10HASH = '03a63945398191337e896e5771f77173' -RANDOMIZERBASEHASH = '98131bfbcb4f2f305befa7a0ae7dc44d' +RANDOMIZERBASEHASH = '71dcfe005725a2afcaf45698eaee971f' class JsonRom(object): diff --git a/data/base2current.bps b/data/base2current.bps index fb4e4e514484792328e6b83dc0ba822036337a57..53a2b5636037e8862dc71e10e4439cc65f0d20a3 100644 GIT binary patch delta 1685 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 R5lku+TXu0h{(lyV{tqH*%e?>q From cfa448947d1b804daef6e8ee2e908bd1d63bc81b Mon Sep 17 00:00:00 2001 From: aerinon Date: Tue, 9 Dec 2025 08:09:52 -0700 Subject: [PATCH 02/34] chore: bump version --- Main.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Main.py b/Main.py index 5a67ca15..fe98b9d8 100644 --- a/Main.py +++ b/Main.py @@ -38,7 +38,7 @@ from source.enemizer.DamageTables import DamageTable from source.enemizer.Enemizer import randomize_enemies from source.rom.DataTables import init_data_tables -version_number = '1.5.0' +version_number = '1.5.1' version_branch = '-u' __version__ = f'{version_number}{version_branch}' From bb2228d70a670a6886a862f1327a2b79c9f219fa Mon Sep 17 00:00:00 2001 From: aerinon Date: Tue, 9 Dec 2025 11:20:34 -0700 Subject: [PATCH 03/34] fix: keys --- Main.py | 2 +- Rom.py | 2 +- data/base2current.bps | Bin 118425 -> 118474 bytes 3 files changed, 2 insertions(+), 2 deletions(-) diff --git a/Main.py b/Main.py index fe98b9d8..2f1cb6a4 100644 --- a/Main.py +++ b/Main.py @@ -38,7 +38,7 @@ from source.enemizer.DamageTables import DamageTable from source.enemizer.Enemizer import randomize_enemies from source.rom.DataTables import init_data_tables -version_number = '1.5.1' +version_number = '1.5.2' version_branch = '-u' __version__ = f'{version_number}{version_branch}' diff --git a/Rom.py b/Rom.py index 6b8198b2..d4c3c894 100644 --- a/Rom.py +++ b/Rom.py @@ -42,7 +42,7 @@ from source.enemizer.Enemizer import write_enemy_shuffle_settings JAP10HASH = '03a63945398191337e896e5771f77173' -RANDOMIZERBASEHASH = '71dcfe005725a2afcaf45698eaee971f' +RANDOMIZERBASEHASH = '3f033ac891acfcedce26c00d5cd880ed' class JsonRom(object): diff --git a/data/base2current.bps b/data/base2current.bps index 53a2b5636037e8862dc71e10e4439cc65f0d20a3..d13f4483e65f1b2935b0d6fac0e3a117e44cbc60 100644 GIT binary patch delta 3853 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 delta 3919 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 Date: Wed, 7 Jan 2026 10:59:36 -0700 Subject: [PATCH 04/34] fix: specific fix for vanilla entrance shuffle with no doors to properly process dungeon in the correct order for key logic --- BaseClasses.py | 10 ++++++++++ DoorShuffle.py | 42 +++++++++++++++++++++++++++++++++++++++++- 2 files changed, 51 insertions(+), 1 deletion(-) diff --git a/BaseClasses.py b/BaseClasses.py index 3d7e80b5..b16f456b 100644 --- a/BaseClasses.py +++ b/BaseClasses.py @@ -284,6 +284,16 @@ class World(object): return portal raise RuntimeError('No such portal %s for player %d' % (portal_name, player)) + def get_portal_unsafe(self, portal_name, player): + if (portal_name, player) in self._portal_cache: + return self._portal_cache[(portal_name, player)] + else: + for portal in self.dungeon_portals[player]: + if portal.name == portal_name and portal.player == player: + self._portal_cache[(portal_name, player)] = portal + return portal + return None + def is_atgt_swapped(self, player): return self.mode[player] == 'inverted' diff --git a/DoorShuffle.py b/DoorShuffle.py index 32b15ec5..793e5ead 100644 --- a/DoorShuffle.py +++ b/DoorShuffle.py @@ -104,6 +104,9 @@ def link_doors_prep(world, player): world.get_portal('Turtle Rock Eye Bridge', player).destination = True else: analyze_portals(world, player) + if world.doorShuffle[player] == 'vanilla': # these are always not destinations + world.get_portal('Desert Back', player).destination = False + world.get_portal('Skull 3', player).destination = False for portal in world.dungeon_portals[player]: connect_portal(portal, world, player) @@ -233,11 +236,21 @@ def vanilla_key_logic(world, player): enabled_entrances = world.enabled_entrances[player] = {} builder_queue = deque(builders) last_key, loops = None, 0 + + # --- Precompute all potential portals for each builder using dungeon_portals --- + from DungeonGenerator import dungeon_portals + all_potential_portals_map = {} + for builder in builders: + portal_names = list(dungeon_portals.get(builder.name, [])) + all_potential_portals_map[builder.name] = set(world.get_portal(portal_name, player).door.entrance.parent_region.name for portal_name in portal_names) + while len(builder_queue) > 0: builder = builder_queue.popleft() origin_list = entrances_map[builder.name] find_enabled_origins(builder.sectors, enabled_entrances, origin_list, entrances_map, builder.name) - if len(origin_list) <= 0: + all_potential_origins = all_potential_portals_map[builder.name] + enabled = entrances_map[builder.name] + if len(origin_list) <= 0 or should_delay_processing(enabled, all_potential_origins, potentials, connections, world, player): if last_key == builder.name or loops > 1000: origin_name = (world.get_region(origin_list[0], player).entrances[0].parent_region.name if len(origin_list) > 0 else 'no origin') @@ -310,6 +323,33 @@ def validate_vanilla_reservation(dungeon, world, player): return validate_key_layout(world.key_layout[player][dungeon.name], world, player) +def should_delay_processing(enabled_origins, potential_origins, potentials, connections, world, player): + disabled_origins = potential_origins.difference(set(enabled_origins)) + main_targets = [] + for do in disabled_origins: + region = world.get_region(do, player) + portal = _find_portal_for_region(region, world, player) + if portal and not portal.destination: + main_targets.append(region) + if not main_targets: + return False # No non-destination disabled origins found + enabling_regions = {connections[r.name] for r in main_targets} + for enabling_region in enabling_regions: + dungeon_names = { + portal.door.entrance.parent_region.dungeon.name + for dungeon_r in potentials[enabling_region] + if (portal := _find_portal_for_region(world.get_region(dungeon_r, player), world, player)) + } + if len(dungeon_names) > 1: + return True + return False + + +def _find_portal_for_region(region, world, player): + return next((p for ent in region.entrances + if (p := world.get_portal_unsafe(ent.parent_region.name.rstrip(' Portal'), player))), None) + + # some useful functions oppositemap = { Direction.South: Direction.North, From 3fab26f42328a5bbc347217fab580fab889eae98 Mon Sep 17 00:00:00 2001 From: aerinon Date: Thu, 15 Jan 2026 14:56:03 -0700 Subject: [PATCH 05/34] fix: prevent locked location from being moved by rupee balancing --- Fill.py | 2 ++ 1 file changed, 2 insertions(+) diff --git a/Fill.py b/Fill.py index 70864fce..d466f044 100644 --- a/Fill.py +++ b/Fill.py @@ -936,6 +936,8 @@ def balance_money_progression(world): return [loc for loc in locations if sphere_state.can_reach(loc) and sphere_state.not_flooding_a_key(sphere_state.world, loc)] def interesting_item(location, item, world, player): + if location.event or location.locked: + return True if item.advancement: return True if item.type is not None or item.name.startswith('Rupee'): From a2b23110c4dd7310dbe53e6d1b76d00e83014925 Mon Sep 17 00:00:00 2001 From: aerinon Date: Fri, 16 Jan 2026 15:46:37 -0700 Subject: [PATCH 06/34] fix: started using the map_hud_mode flag (somewhat against my better judgement, there's some crufty asm lying about) --- PastReleaseNotes.md | 2 ++ RELEASENOTES.md | 5 +++-- Rom.py | 40 ++++++++++++++++++++------------- data/base2current.bps | Bin 118474 -> 118471 bytes resources/app/gui/lang/en.json | 4 ++-- 5 files changed, 32 insertions(+), 19 deletions(-) diff --git a/PastReleaseNotes.md b/PastReleaseNotes.md index adf09b6a..7890e51f 100644 --- a/PastReleaseNotes.md +++ b/PastReleaseNotes.md @@ -10,6 +10,8 @@ # Patch Notes Changelog archive +* 1.5.1 + * Bugfix: Fixed an issue with keys not counting correctly * 1.5.0 * Logic: Fixed vanilla key logic for GT basement * Logic (Playthrough): Fixed an issue where enemy kill rules were not applied during playthrough calculation. (Thanks Catobat for the catch) diff --git a/RELEASENOTES.md b/RELEASENOTES.md index 07edbb58..98c16bcc 100644 --- a/RELEASENOTES.md +++ b/RELEASENOTES.md @@ -1,4 +1,5 @@ # Patch Notes -* 1.5.1 - * Bugfix: Fixed an issue with keys not counting correctly +* Logic: Key logic fix for part of a dungeon located at Skull 3 (or other similar restricted entrancs). Appropriate key logic was not being applied, causing progression issues. This mostly affect crosskey style seeds. +* Standard: Rupee balancing algorithm can no longer switch out the weapon on uncle for money. +* Dungeon Counters: Some fixes for inconsistent tracking and display of dungeon counters on the keysanity menu. \ No newline at end of file diff --git a/Rom.py b/Rom.py index d4c3c894..e56b6985 100644 --- a/Rom.py +++ b/Rom.py @@ -42,7 +42,7 @@ from source.enemizer.Enemizer import write_enemy_shuffle_settings JAP10HASH = '03a63945398191337e896e5771f77173' -RANDOMIZERBASEHASH = '3f033ac891acfcedce26c00d5cd880ed' +RANDOMIZERBASEHASH = '794b7cd02f429873c3ad6dc74490279c' class JsonRom(object): @@ -465,9 +465,9 @@ def patch_rom(world, rom, player, team, is_mystery=False): itemid = 0x5A if not location.locked and ((location.item.smallkey and world.keyshuffle[player] == 'none') or ( - location.item.bigkey and world.bigkeyshuffle[player] == 'none') or ( - location.item.map and world.mapshuffle[player] == 'none') or ( - location.item.compass and world.compassshuffle[player] == 'none')): + location.item.bigkey and world.bigkeyshuffle[player] == 'none') or ( + location.item.map and world.mapshuffle[player] == 'none') or ( + location.item.compass and world.compassshuffle[player] == 'none')): itemid = handle_native_dungeon(location, itemid) rom.write_byte(location.address, itemid) @@ -556,15 +556,15 @@ def patch_rom(world, rom, player, team, is_mystery=False): if world.mirrorscroll[player] or world.doorShuffle[player] != 'vanilla': dr_flags |= DROptions.Town_Portal if world.doorShuffle[player] == 'vanilla': - dr_flags |= DROptions.Eternal_Mini_Bosses + dr_flags |= DROptions.Eternal_Mini_Bosses if world.doorShuffle[player] not in ['vanilla', 'basic']: dr_flags |= DROptions.Map_Info if ((world.collection_rate[player] or world.goal[player] == 'completionist') - and world.goal[player] not in ['triforcehunt', 'trinity', 'ganonhunt']): + and world.goal[player] not in ['triforcehunt', 'trinity', 'ganonhunt']): dr_flags |= DROptions.Debug rom.write_byte(snes_to_pc(0x308039), 1) - if world.doorShuffle[player] not in ['vanilla', 'basic'] and world.logic[player] != 'nologic'\ - and world.mixed_travel[player] == 'prevent': + if world.doorShuffle[player] not in ['vanilla', 'basic'] and world.logic[player] != 'nologic' \ + and world.mixed_travel[player] == 'prevent': # PoD Falling Bridge or Hammjump # 1FA607: db $2D, $79, $69 ; 0x0069: Vertical Rail ↕ | { 0B, 1E } | Size: 05 # 1FA60A: db $14, $99, $5D ; 0x005D: Large Horizontal Rail ↔ | { 05, 26 } | Size: 01 @@ -649,9 +649,9 @@ def patch_rom(world, rom, player, team, is_mystery=False): if world.doorShuffle[player] == 'basic': rom.write_byte(0x138002, 1) for door in world.doors: - if door.dest is not None and isinstance(door.dest, Door) and\ - door.player == player and door.type in [DoorType.Normal, DoorType.SpiralStairs, - DoorType.Open, DoorType.StraightStairs, DoorType.Ladder]: + if door.dest is not None and isinstance(door.dest, Door) and \ + door.player == player and door.type in [DoorType.Normal, DoorType.SpiralStairs, + DoorType.Open, DoorType.StraightStairs, DoorType.Ladder]: rom.write_bytes(door.getAddress(), door.dest.getTarget(door)) for paired_door in world.paired_doors[player]: rom.write_bytes(paired_door.address_a(world, player), paired_door.rom_data_a(world, player)) @@ -1108,7 +1108,7 @@ def patch_rom(world, rom, player, team, is_mystery=False): gametype = 0x04 # item if (world.shuffle[player] != 'vanilla' or world.doorShuffle[player] != 'vanilla' - or world.dropshuffle[player] != 'none' or world.pottery[player] != 'none'): + or world.dropshuffle[player] != 'none' or world.pottery[player] != 'none'): gametype |= 0x02 # entrance/door rom.write_byte(0x180211, gametype) # Game type @@ -1201,8 +1201,18 @@ def patch_rom(world, rom, player, team, is_mystery=False): | (0x02 if world.compassshuffle[player] else 0x00) | (0x04 if world.mapshuffle[player] else 0x00) | (0x08 if world.bigkeyshuffle[player] else 0x00))) # free roaming item text boxes - rom.write_byte(0x18003B, 0x01 if world.mapshuffle[player] else 0x00) # maps showing crystals on overworld + map_hud_mode = 0x00 + if world.dungeon_counters[player] == 'on': + map_hud_mode = 0x02 # always on + elif world.dungeon_counters[player] == 'off': + pass + elif world.keyshuffle[player] != 'universal' and (world.mapshuffle[player] != 'none' or world.doorShuffle[player] != 'vanilla' + or world.dropshuffle[player] != 'none' or world.pottery[player] not in ['none', 'cave'] or world.dungeon_counters[player] == 'pickup'): + map_hud_mode = 0x01 # show on pickup + rom.write_byte(0x18003A, map_hud_mode) + + rom.write_byte(0x18003B, 0x01 if world.mapshuffle[player] else 0x00) # maps showing crystals on overworld # compasses showing dungeon count compass_mode = 0x00 if world.clock_mode != 'none' or world.dungeon_counters[player] == 'off': @@ -1408,7 +1418,7 @@ def patch_rom(world, rom, player, team, is_mystery=False): write_enemy_shuffle_settings(world, player, rom) if (world.doorShuffle[player] != 'vanilla' or world.dropshuffle[player] != 'none' - or world.pottery[player] != 'none'): + or world.pottery[player] != 'none'): for room in world.rooms: if room.player == player and room.modified: if room.index in world.data_tables[player].room_list: @@ -1453,7 +1463,7 @@ def patch_rom(world, rom, player, team, is_mystery=False): (hashint >> 10) & 0x1F, (hashint >> 5) & 0x1F, hashint & 0x1F, - ] + ] rom.write_bytes(0x180215, code) rom.hash = code diff --git a/data/base2current.bps b/data/base2current.bps index d13f4483e65f1b2935b0d6fac0e3a117e44cbc60..b499ded82f8231c4e574e1c36ca11b7618fe370b 100644 GIT binary patch delta 7225 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 delta 7122 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 diff --git a/resources/app/gui/lang/en.json b/resources/app/gui/lang/en.json index 92318d72..bd8f9fa6 100644 --- a/resources/app/gui/lang/en.json +++ b/resources/app/gui/lang/en.json @@ -92,11 +92,11 @@ "randomizer.dungeon.experimental": "Enable Experimental Features", - "randomizer.dungeon.dungeon_counters": "Dungeon Chest Counters", + "randomizer.dungeon.dungeon_counters": "Dungeon Counters", "randomizer.dungeon.dungeon_counters.default": "Auto", "randomizer.dungeon.dungeon_counters.off": "Off", "randomizer.dungeon.dungeon_counters.on": "On", - "randomizer.dungeon.dungeon_counters.pickup": "On Compass Pickup", + "randomizer.dungeon.dungeon_counters.pickup": "On Item Pickup", "randomizer.dungeon.mixed_travel": "Mixed Dungeon Travel ", "randomizer.dungeon.mixed_travel.prevent": "Prevent Mixed Dungeon Travel", From fabad625d2aa9c88dd6702202a053d2e24169655 Mon Sep 17 00:00:00 2001 From: theclearmouse <105736589+theclearmouse@users.noreply.github.com> Date: Sun, 25 Jan 2026 22:28:19 -0500 Subject: [PATCH 07/34] add main tournament 2025 winner --- Text.py | 1 + 1 file changed, 1 insertion(+) diff --git a/Text.py b/Text.py index 016bb0b0..90aa3fbf 100644 --- a/Text.py +++ b/Text.py @@ -1795,6 +1795,7 @@ class TextTable(object): text['telepathic_tile_ice_stalfos_knights_room'] = CompressedTextMapper.convert("{NOBORDER}\nKnock 'em down and then bomb them dead.") text['telepathic_tile_tower_of_hera_entrance'] = CompressedTextMapper.convert("{NOBORDER}\nThis is a bad place, with a guy who will make you fall…\n\n\na lot.") text['houlihan_room'] = CompressedTextMapper.convert("Randomizer tournament winners\n{HARP}\n" + " ~~~2025~~~\nGammachuu\n\n" " ~~~2024~~~\nGammachuu\n\n" " ~~~2023~~~\nGanonsGoneWild\n\n" " ~~~2022~~~\nObscure\n\n" From 31682fb8a245d35a8441ad08277038153b67c491 Mon Sep 17 00:00:00 2001 From: aerinon Date: Mon, 26 Jan 2026 14:58:17 -0700 Subject: [PATCH 08/34] doc: update release note --- RELEASENOTES.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/RELEASENOTES.md b/RELEASENOTES.md index 98c16bcc..4e3ee4a8 100644 --- a/RELEASENOTES.md +++ b/RELEASENOTES.md @@ -2,4 +2,5 @@ * Logic: Key logic fix for part of a dungeon located at Skull 3 (or other similar restricted entrancs). Appropriate key logic was not being applied, causing progression issues. This mostly affect crosskey style seeds. * Standard: Rupee balancing algorithm can no longer switch out the weapon on uncle for money. -* Dungeon Counters: Some fixes for inconsistent tracking and display of dungeon counters on the keysanity menu. \ No newline at end of file +* Dungeon Counters: Some fixes for inconsistent tracking and display of dungeon counters on the keysanity menu. +* Text: Updated main tournament winner (Thanks clearmouse!) \ No newline at end of file From eda03d865779d257912e3b58ce3ef280db680702 Mon Sep 17 00:00:00 2001 From: aerinon Date: Mon, 26 Jan 2026 15:10:51 -0700 Subject: [PATCH 09/34] chore: version bump --- Main.py | 2 +- RELEASENOTES.md | 9 +++++---- 2 files changed, 6 insertions(+), 5 deletions(-) diff --git a/Main.py b/Main.py index 2f1cb6a4..00efbacc 100644 --- a/Main.py +++ b/Main.py @@ -38,7 +38,7 @@ from source.enemizer.DamageTables import DamageTable from source.enemizer.Enemizer import randomize_enemies from source.rom.DataTables import init_data_tables -version_number = '1.5.2' +version_number = '1.5.3' version_branch = '-u' __version__ = f'{version_number}{version_branch}' diff --git a/RELEASENOTES.md b/RELEASENOTES.md index 4e3ee4a8..4b522d5f 100644 --- a/RELEASENOTES.md +++ b/RELEASENOTES.md @@ -1,6 +1,7 @@ # Patch Notes -* Logic: Key logic fix for part of a dungeon located at Skull 3 (or other similar restricted entrancs). Appropriate key logic was not being applied, causing progression issues. This mostly affect crosskey style seeds. -* Standard: Rupee balancing algorithm can no longer switch out the weapon on uncle for money. -* Dungeon Counters: Some fixes for inconsistent tracking and display of dungeon counters on the keysanity menu. -* Text: Updated main tournament winner (Thanks clearmouse!) \ No newline at end of file +* 1.5.3 + * Logic: Key logic fix for part of a dungeon located at Skull 3 (or other similar restricted entrancs). Appropriate key logic was not being applied, causing progression issues. This mostly affect crosskey style seeds. + * Standard: Rupee balancing algorithm can no longer switch out the weapon on uncle for money. + * Dungeon Counters: Some fixes for inconsistent tracking and display of dungeon counters on the keysanity menu. + * Text: Updated main tournament winner (Thanks clearmouse!) \ No newline at end of file From bf92fe91c2f2858ab718ed75d00139fab9eaa65a Mon Sep 17 00:00:00 2001 From: aerinon Date: Fri, 30 Jan 2026 10:05:29 -0700 Subject: [PATCH 10/34] doc: new documentation helps fix: issue with blank shop items --- CLAUDE.md | 257 ++++++++++ Fill.py | 2 +- Main.py | 2 +- PastReleaseNotes.md | 5 + RELEASENOTES.md | 9 +- _config.yml | 140 +++++- .../2026-01-30-welcome-to-door-randomizer.md | 74 +++ blog/index.md | 100 ++++ features.md | 473 ++++++++++++++++++ index.md | 81 +++ installation.md | 369 ++++++++++++++ known-issues.md | 373 ++++++++++++++ roadmap.md | 234 +++++++++ 13 files changed, 2111 insertions(+), 8 deletions(-) create mode 100644 CLAUDE.md create mode 100644 _posts/2026-01-30-welcome-to-door-randomizer.md create mode 100644 blog/index.md create mode 100644 features.md create mode 100644 index.md create mode 100644 installation.md create mode 100644 known-issues.md create mode 100644 roadmap.md diff --git a/CLAUDE.md b/CLAUDE.md new file mode 100644 index 00000000..a67098ad --- /dev/null +++ b/CLAUDE.md @@ -0,0 +1,257 @@ +# CLAUDE.md + +This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository. + +## Project Overview + +**ALttPDoorRandomizer** is a sophisticated dungeon and door randomizer for *The Legend of Zelda: A Link to the Past* (SNES). It extends the standard ALTTP Entrance Randomizer with advanced dungeon shuffling capabilities that can rearrange dungeon interiors at the door and sector level. + +- **Repository**: https://github.com/aerinon/ALttPDoorRandomizer +- **Python Version**: 3.10+ +- **Current Branch**: DoorDevUnstable (dev branch: NewGeneration) +- **Discord**: #door-rando and #bug-reports channels at ALTTP Randomizer discord + +## Development Commands + +### Running the Randomizer +```bash +# CLI interface +python DungeonRandomizer.py + +# GUI interface +python Gui.py + +``` + +### Dependencies +```bash +# Install platform-specific dependencies +python resources/ci/common/local_install.py + +# For multiworld server/client +# Run the same command to install multiworld dependencies +``` + +### Testing +```bash +# Run test suite +python TestSuite.py + +# Run test suite with specific door shuffle mode +python TestSuite.py --dr basic --count 10 --tense 2 + +# Individual test files (unittest-based) +python -m pytest test/ +python -m pytest test/dungeons/TestDarkPalace.py +``` + +### ROM Generation +```bash +# Basic door shuffle seed +python DungeonRandomizer.py --doorShuffle crossed --intensity 2 + +# Suppress ROM output (for testing) +python DungeonRandomizer.py --suppress_rom --spoiler none + +# Create BPS patch +python DungeonRandomizer.py --bps +``` + +## Architecture Overview + +### Generation Pipeline + +The randomizer follows this high-level flow (orchestrated in `Main.py`): + +1. **World Setup** → Initialize World object, parse settings, set seed +2. **Region Creation** → Build game regions, locations, entrances (`Regions.py`) +3. **Dungeon Structure** → Create dungeon objects and rooms (`Dungeons.py`, `RoomData.py`) +4. **Door/Entrance Shuffling** → Shuffle dungeon interiors and/or overworld entrances +5. **Logic Rules** → Set access requirements for all locations (`Rules.py`) +6**Item Placement** → Generate item pool and place items with logic constraints (`Fill.py`) +7. **ROM Patching** → Apply changes to base ROM (`Rom.py`) +8. **Output** → Generate ROM file, spoiler log, and/or multiworld data + +### Core Data Structures (BaseClasses.py) + +- **World**: Container for all game state, regions, dungeons, items, and settings +- **Region**: Geographic area with locations and exits +- **Location**: Item placement spot with access rules +- **Item**: Game items with advancement/priority flags +- **Entrance**: Connections between regions with conditional access +- **CollectionState**: Tracks player's collected items for logic evaluation + +### Dungeon Generation System + +The dungeon shuffling system uses a three-stage algorithm: + +#### 1. DungeonGenLocalSearch (source/dungeon/DungeonGenLocalSearch.py) +**Purpose**: Assigns dungeon sectors to dungeons using constraint satisfaction + +**Balancing Constraints**: +- **Polarity**: North/South and East/West door balance +- **Crystal Balance**: Blue/orange barriers must have matching switches +- **Portal Balance**: Entrance distribution +- **Location Balance**: Ensures dungeons have accessible non-big-key locations +- **Branching**: Dead ends vs branches ratio (insufficient branches = unreachable areas) +- **Transitivity**: Validates that doors can actually connect + +**Algorithm**: Local search with greedy constraint satisfaction, prioritizing crystal switches → portals → locations → branching → polarity → transitivity + +#### 2. DungeonGenTransitivity (source/dungeon/DungeonGenTransitivity.py) +**Purpose**: Validates that door connections are possible for a given sector assignment + +**Key Features**: +- Verifies all doors can be validly connected (e.g., North↔South, East↔West, Stairs↔Stairs) +- Propagates crystal switch states through connections +- Detects forced connections and impossible layouts +- Uses depth-first search with constraint propagation +- Handles special mechanics (portals, crystal barriers, special rooms) + +#### 3. DungeonStitcherV2 (source/dungeon/DungeonStitcherV2.py) +**Purpose**: Realizes actual door connections from validated sector assignments + +**Key Features**: +- Generates random valid door pairings +- Assigns portal connections (dungeon entrances) +- Simulates player traversal to verify connectivity +- Manages crystal barrier state propagation + +### Key Logic Components + +**Rules.py** (~7000 lines): Sets logical requirements for accessing locations +- Supports multiple logic modes: noglitches, owglitches, hybridglitches, nologic +- Handles multiple key logic algorithms: partial, strict, dangerous, experimental +- Manages dungeon-specific access rules and boss requirements + +**Fill.py** (~2000 lines): Item placement algorithms +- **Balanced**: Random distribution +- **Vanilla Fill**: Attempts vanilla item locations when possible +- **Major Location Restriction**: Major items → major locations +- **Dungeon Restriction**: Major items → dungeons +- **District Restriction**: Items distributed by geographic region + +**KeyPlacement.py** / **NewKeyLogic.py**: Advanced key door logic +- Handles small key placement with multiple satisfiability algorithms +- Prevents self-locking situations +- Manages big key placement rules +- Validates minimum key requirements for dungeon completion + +### Source Module Organization + +``` +source/ +├── dungeon/ # Dungeon generation algorithms and key logic +├── overworld/ # Entrance shuffling (EntranceShuffle2.py) +├── item/ # Item placement utilities (FillUtil.py, District.py) +├── enemizer/ # Enemy randomization system +├── gui/ # GUI components (tkinter-based) +├── rom/ # ROM patching utilities +├── classes/ # Utility classes (BabelFish, CustomSettings) +├── meta/ # Metadata and build tools +└── limited/ # Limited run coordination +``` + +### Important Files by Size/Complexity + +- **DoorShuffle.py** (~8500 lines): Door shuffling orchestration +- **Rules.py** (~7000 lines): Location access logic +- **EnemyList.py** (~6000 lines): Enemy definitions +- **Doors.py** (~5500 lines): Door object definitions +- **Rom.py** (~5500 lines): ROM patching +- **Regions.py** (~5000 lines): World region creation +- **DungeonGenerator.py** (~5000 lines): Legacy dungeon generation +- **EntranceShuffle2.py** (~5000 lines): Entrance shuffling logic +- **BaseClasses.py** (~4000 lines): Core data structures +- **KeyDoorShuffle.py** (~3500 lines): Key door logic +- **PotShuffle.py** (~3500 lines): Pot randomization + +## Key Concepts + +### Door Shuffle Modes +- **Vanilla**: No shuffling +- **Basic**: Shuffle within each dungeon +- **Partitioned**: Shuffle in pools (Light World, Early Dark World, Late Dark World) +- **Crossed**: Full shuffle between all dungeons + +### Intensity Levels +- **Level 1**: Normal doors and spiral staircases +- **Level 2**: + open edges and straight staircases +- **Level 3**: + dungeon lobbies + +### Key Shuffle Modes +- **In Dungeon** (keyshuffle=none): Keys restricted to their dungeon +- **Randomized** (keyshuffle=wild): Keys can be anywhere +- **Universal** (keyshuffle=universal): Keys work in any dungeon + +### Fill Algorithms (--algorithm) +See Fill.py for implementation details. The algorithm affect where item may be placed. + +### Logic Modes +- **noglitches**: Standard logic +- **owglitches**: Overworld glitches (OOB, clips, superbunny) +- **hybridglitches**: + major underworld glitches (not compatible with door shuffle) +- **nologic**: No logical constraints + +## Testing Strategy + +Tests verify location accessibility with various item combinations: +- **test/dungeons/**: Per-dungeon location access tests +- **test/vanilla/**: Vanilla world logic tests +- **test/owg/**: Overworld glitch logic tests +- **test/inverted/**: Inverted mode tests +- **TestBase.py**: Base test class with utility methods + +Use `TestSuite.py` for batch generation testing across modes (Open/Standard/Inverted) and settings. + +## Important Development Notes + +### Starting Items & Special Items +- **Mirror Scroll**: Dungeon-only mirror (starting item in door shuffle) +- **Bomb Bag**: Optional item that gates bomb usage +- **Pseudo Boots**: Allows dashing but gates certain sequence breaks + +### Branch Structure +- **DoorDev**: Main development branch (use for PRs) +- **DoorDevUnstable**: Current working branch +- **Dev/Master**: Do NOT use for PRs + +### Git Workflow +Recent commits show work on: +- Limited run coordination +- Custom rooms support +- Key logic improvements (transitivity, portal checks, placement rules) +- Isolated region detection fixes +- Big key placement satisfiability + +### Documentation Resources +- **Algorithm.md**: Detailed dungeon generation algorithm documentation +- **docs/ai_context/**: Comprehensive architectural documentation by topic +- **docs/Customizer.md**: Custom seed configuration guide +- **docs/DR_hint_reference.md**: Hint system documentation +- **docs/BUILDING.md**: Build and installation instructions +- **README.md**: User-facing feature documentation + +## Common Gotchas + +1. **Transitivity Checks**: Most expensive constraint check - always run last +2. **Self-Locking Keys**: Key logic must prevent situations where players cannot access the rest of the dungeon +3. **Crystal Barriers**: Blue/orange barriers require matching switches in dungeon +4. **Portal Distribution**: Each dungeon needs at least one entrance +5. **Branching Balance**: Too many dead ends without branches = unreachable areas +6**Polarity Balance**: N/S and E/W door counts must allow valid connections + +## CLI Argument Reference + +Key arguments from `resources/app/cli/args.json`: +- `--doorShuffle [vanilla|basic|partitioned|crossed]` +- `--intensity [1|2|3]` +- `--keyshuffle [none|wild|universal]` +- `--key_logic [partial|strict|dangerous|experimental]` +- `--algorithm [balanced|vanilla_fill|major_only|dungeon_only|district]` +- `--logic [noglitches|owglitches|hybridglitches|nologic]` +- `--mode [open|standard|inverted]` +- `--shuffle`: Entrance randomizer options (vanilla, simple, restricted, full, crossed, insanity, etc.) +- `--pottery`: Pot shuffling modes +- `--shopsanity`: Enable shop item randomization +- `--enemizer`: Enemy randomization options diff --git a/Fill.py b/Fill.py index d466f044..349ff83e 100644 --- a/Fill.py +++ b/Fill.py @@ -980,7 +980,7 @@ def balance_money_progression(world): slot = shop_to_location_table[location.parent_region.name].index(location.name) shop = location.parent_region.shop shop_item = shop.inventory[slot] - if location.item and interesting_item(location, location.item, world, location.item.player): + if shop_item and location.item and interesting_item(location, location.item, world, location.item.player): if location.item.name.startswith('Rupee') and loc_player == location.item.player: if shop_item['price'] < rupee_chart[location.item.name]: wallet[loc_player] -= shop_item['price'] # will get picked up in the location_free block diff --git a/Main.py b/Main.py index 00efbacc..3099c0b0 100644 --- a/Main.py +++ b/Main.py @@ -38,7 +38,7 @@ from source.enemizer.DamageTables import DamageTable from source.enemizer.Enemizer import randomize_enemies from source.rom.DataTables import init_data_tables -version_number = '1.5.3' +version_number = '1.5.4' version_branch = '-u' __version__ = f'{version_number}{version_branch}' diff --git a/PastReleaseNotes.md b/PastReleaseNotes.md index 7890e51f..7cae577d 100644 --- a/PastReleaseNotes.md +++ b/PastReleaseNotes.md @@ -10,6 +10,11 @@ # Patch Notes Changelog archive +* 1.5.3 + * Logic: Key logic fix for part of a dungeon located at Skull 3 (or other similar restricted entrancs). Appropriate key logic was not being applied, causing progression issues. This mostly affect crosskey style seeds. + * Standard: Rupee balancing algorithm can no longer switch out the weapon on uncle for money. + * Dungeon Counters: Some fixes for inconsistent tracking and display of dungeon counters on the keysanity menu. + * Text: Updated main tournament winner (Thanks clearmouse!) * 1.5.1 * Bugfix: Fixed an issue with keys not counting correctly * 1.5.0 diff --git a/RELEASENOTES.md b/RELEASENOTES.md index 4b522d5f..ae96add3 100644 --- a/RELEASENOTES.md +++ b/RELEASENOTES.md @@ -1,7 +1,6 @@ # Patch Notes -* 1.5.3 - * Logic: Key logic fix for part of a dungeon located at Skull 3 (or other similar restricted entrancs). Appropriate key logic was not being applied, causing progression issues. This mostly affect crosskey style seeds. - * Standard: Rupee balancing algorithm can no longer switch out the weapon on uncle for money. - * Dungeon Counters: Some fixes for inconsistent tracking and display of dungeon counters on the keysanity menu. - * Text: Updated main tournament winner (Thanks clearmouse!) \ No newline at end of file +* 1.5.4 + * Documentation: New AI-assisted documentation [Site (I really hope this works)](https//aerinon.github.io/ALttPDoorRandomizer) + * Generation Error: Fixed Issue with Shop Code and Take Any Caves (thanks Codemann for assistance) + diff --git a/_config.yml b/_config.yml index c7418817..33a55de0 100644 --- a/_config.yml +++ b/_config.yml @@ -1 +1,139 @@ -theme: jekyll-theme-slate \ No newline at end of file +# Site settings +title: ALttP Dungeon Randomizer +description: Advanced dungeon randomization for The Legend of Zelda - A Link to the Past +baseurl: "/ALttPDoorRandomizer" +url: "https://aerinon.github.io" + +# Theme +theme: jekyll-theme-slate +remote_theme: just-the-docs/just-the-docs + +# Logo and branding +# logo: "/assets/images/logo.png" + +# Navigation +nav_enabled: true +nav_external_links: + - title: GitHub + url: https://github.com/aerinon/ALttPDoorRandomizer + - title: Discord + url: https://discordapp.com/invite/alttprandomizer + - title: Download + url: https://github.com/aerinon/ALttPDoorRandomizer/releases + +# Search +search_enabled: true +search: + heading_level: 2 + previews: 3 + preview_words_before: 5 + preview_words_after: 10 + tokenizer_separator: /[\s/]+/ + rel_url: true + button: true + +# Heading anchors +heading_anchors: true + +# Aux links +aux_links: + "Door Randomizer on GitHub": + - "https://github.com/aerinon/ALttPDoorRandomizer" + "ALTTP Rando Discord": + - "https://discordapp.com/invite/alttprandomizer" + +aux_links_new_tab: true + +# Footer +footer_content: "Copyright © 2026 ALttP Door Randomizer Team. Based on ALttP Entrance Randomizer." + +# Back to top link +back_to_top: true +back_to_top_text: "Back to top" + +# Collections for blog posts +collections: + posts: + output: true + permalink: /blog/:year/:month/:day/:title/ + +# Defaults +defaults: + - scope: + path: "" + type: "posts" + values: + layout: "default" + - scope: + path: "" + values: + layout: "default" + +# Build settings +markdown: kramdown +kramdown: + input: GFM + syntax_highlighter: rouge + syntax_highlighter_opts: + css_class: 'highlight' + +plugins: + - jekyll-feed + - jekyll-seo-tag + - jekyll-sitemap + +# Exclude from processing +exclude: + - .git/ + - .github/ + - .gitignore + - .gitattributes + - source/ + - test/ + - resources/ + - data/ + - debug/ + - analysis/ + - analysis2/ + - alttp_dungeon_randomizer.egg-info/ + - DR/ + - "*.py" + - "*.pyc" + - "*.pyd" + - "*.pyo" + - "*.egg-info" + - "*.spec" + - requirements*.txt + - setup.py + - TestSuite.py + - DungeonRandomizer.py + - Gui.py + - MultiServer.py + - MultiClient.py + - CLAUDE.md + - LICENSE + - libbz2-dev + - tlogbfs.txt + +# Include files +include: + - _posts + - blog + - docs/Customizer.md + - docs/BUILDING.md + - docs/DR_hint_reference.md + +# Color scheme (for just-the-docs theme) +color_scheme: dark + +# Google Analytics (optional - add your tracking ID) +# ga_tracking: UA-XXXXXXXX-X + +# Compress HTML +compress_html: + clippings: all + comments: all + endings: all + startings: [] + blanklines: false + profile: false diff --git a/_posts/2026-01-30-welcome-to-door-randomizer.md b/_posts/2026-01-30-welcome-to-door-randomizer.md new file mode 100644 index 00000000..fbe4eb23 --- /dev/null +++ b/_posts/2026-01-30-welcome-to-door-randomizer.md @@ -0,0 +1,74 @@ +--- +layout: default +title: "Welcome to the ALttP Door Randomizer Blog" +date: 2026-01-26 +author: Door Randomizer Team +category: development +excerpt: "Introducing the new Door Randomizer documentation site and blog. Learn about what's new, what's coming, and how to get involved." +--- + +# Welcome to the ALttP Door Randomizer Blog + +We're excited to launch the official documentation site and development blog for ALttP Door Randomizer! This site serves as a central hub for all things Door Rando - from comprehensive feature documentation to release notes and development updates. + +## What's New Here? + +### Comprehensive Documentation + +We've reorganized and expanded our documentation to make it easier to find what you need: + +- **[Features Guide](/features)** - Complete reference for all randomizer settings and modes +- **[Installation & Usage](/installation)** - Step-by-step setup instructions for all platforms +- **[Known Issues](/known-issues)** - Tracking current bugs and limitations +- **[Roadmap](/roadmap)** - Our vision for the future of Door Randomizer + +### Development Blog + +This blog will be your source for: + +- **Feature highlights** - Deep dives into specific features +- **Development updates** - Behind-the-scenes looks at ongoing work +- **Technical articles** - How the randomizer works under the hood + +## What is Door Randomizer? + +If you're new here, Door Randomizer takes the ALttP randomizer experience to the next level by shuffling the connections between rooms within dungeons. Walk through a door in Eastern Palace and you might end up in Tower of Hera, Ice Palace, or anywhere else! + +Key features include: + +- **Four shuffle modes** - From basic (within dungeon) to crossed (full chaos) +- **Three intensity levels** - Control how thoroughly dungeons are shuffled +- **Advanced key logic** - Multiple algorithms to prevent self-locking +- **Pottery shuffle** - Randomize items under pots with multiple modes +- **Shopsanity** - 32+ shop locations with intelligent pricing +- **Enemizer integration** - Enemy and boss randomization with logic +- **Custom seeds** - Create your own dungeons and rooms + +[Learn more about features →](/features) + +[Read the Customizer guide →](https://github.com/aerinon/ALttPDoorRandomizer/blob/DoorDev/docs/Customizer.md) + +## What's Coming Next? + +We have plans for Door Randomizer's future. Check out our [Roadmap](/roadmap) for details. (Still very much a work in progress!) + +## Community + +Join the Door Randomizer community: + +- **Discord**: [ALTTP Randomizer Discord](https://discordapp.com/invite/alttprandomizer) + - `#door-rando` - General discussion and help + - `#bug-reports` - Report bugs and issues +- **GitHub**: [aerinon/ALttPDoorRandomizer](https://github.com/aerinon/ALttPDoorRandomizer) + +## Stay Tuned + +We'll be posting irregular updates here as development continues. + +Thank you to everyone who has contributed to Door Randomizer through code, testing, feedback, and community support. We're excited about the future and can't wait to see what lies in store! + +Happy randomizing! + +--- + +*Have questions or feedback about the new documentation site? Let us know in Discord!* diff --git a/blog/index.md b/blog/index.md new file mode 100644 index 00000000..392cc00d --- /dev/null +++ b/blog/index.md @@ -0,0 +1,100 @@ +--- +layout: default +title: Blog +nav_order: 6 +has_children: false +--- + +# Development Blog +{: .no_toc } + +Latest updates, release notes, and development insights for ALttP Door Randomizer. +{: .fs-6 .fw-300 } + +--- + +## Recent Posts + +{% assign posts = site.posts | sort: 'date' | reverse %} +{% for post in posts limit:10 %} +
+

+ {{ post.title }} +

+

+ {{ post.date | date: "%B %d, %Y" }} + {% if post.author %} • by {{ post.author }}{% endif %} +

+

{{ post.excerpt | strip_html | truncatewords: 50 }}

+

Read more →

+
+{% endfor %} + +--- + +## Categories + +Browse posts by category: + +- [Release Notes](#release-notes) +- [Development Updates](#development-updates) +- [Feature Highlights](#feature-highlights) +- [Technical Deep Dives](#technical-deep-dives) + +### Release Notes + +{% assign release_posts = site.posts | where: "category", "release" %} +{% for post in release_posts limit:5 %} +- [{{ post.title }}]({{ post.url | relative_url }}) - {{ post.date | date: "%B %d, %Y" }} +{% endfor %} + +### Development Updates + +{% assign dev_posts = site.posts | where: "category", "development" %} +{% for post in dev_posts limit:5 %} +- [{{ post.title }}]({{ post.url | relative_url }}) - {{ post.date | date: "%B %d, %Y" }} +{% endfor %} + +### Feature Highlights + +{% assign feature_posts = site.posts | where: "category", "features" %} +{% for post in feature_posts limit:5 %} +- [{{ post.title }}]({{ post.url | relative_url }}) - {{ post.date | date: "%B %d, %Y" }} +{% endfor %} + +### Technical Deep Dives + +{% assign feature_posts = site.posts | where: "category", "features" %} +{% for post in feature_posts limit:5 %} +- [{{ post.title }}]({{ post.url | relative_url }}) - {{ post.date | date: "%B %d, %Y" }} + {% endfor %} + +--- + +## Subscribe + +Stay up to date with Door Randomizer development: + +- **Discord**: Join [ALTTP Randomizer Discord](https://discordapp.com/invite/alttprandomizer) in `#door-rando` + +--- + +## Archive + +View all posts by year: + +{% assign posts_by_year = site.posts | group_by_exp: "post", "post.date | date: '%Y'" %} +{% for year in posts_by_year %} +### {{ year.name }} +{% for post in year.items %} +- [{{ post.title }}]({{ post.url | relative_url }}) - {{ post.date | date: "%B %d, %Y" }} +{% endfor %} +{% endfor %} + +--- + +## Contributing to the Blog + +Want to write a guest post or contribute content? + +Contact us on Discord to discuss your ideas! diff --git a/features.md b/features.md new file mode 100644 index 00000000..2a404b18 --- /dev/null +++ b/features.md @@ -0,0 +1,473 @@ +--- +layout: default +title: Features +nav_order: 2 +--- + +# Features Guide +{: .no_toc } + +Comprehensive documentation of all Door Randomizer features and settings. +{: .fs-6 .fw-300 } + +## Table of contents +{: .no_toc .text-delta } + +1. TOC +{:toc} + +--- + +## Important Differences from Other Randomizers + +Most of these apply only when door shuffle is not vanilla. + +### Starting Item + +You start with a **Mirror Scroll** (looks like a map), a simplified mirror that only works in dungeons, not the overworld, and can't erase blocks like the Mirror. + +### Navigation Changes + +- Holes in Mire Torches Top and Mire Torches Bottom fall through to rooms below (you only need fire to get the chest) +- You can Hookshot from the left Mire wooden Bridge to the right one +- In the PoD Arena, you can bonk with Boots between the two blue crystal barriers against the ladder to reach the Arena Bridge chest and door (Bomb Jump also possible but not in logic - Boots are required) +- Flooded Rooms in Swamp can be traversed backward and may be required. Flippers are needed to get out of the water + +### Logic Differences + +- The chest in southeast Skull Woods that is traditionally a guaranteed Small Key in ER is not guaranteed here +- Fire Rod is not in logic for dark rooms (hard enough to figure out which dark room you are in) +- The hammerjump (and some other skips) are not in logic by default (see the mixed_travel setting for details). Doing so in a crossed dungeon seed can put you into another dungeon with the wrong dungeon id + +### Boss Differences + +- You have to find the attic floor and bomb it open and bring the maiden to the light to fight Blind. In cross dungeon door shuffle, the attic can be in any dungeon. If you bring the maiden to the boss arena, she will hint where the cracked floor can be found +- GT Bosses do not respawn after killing them in this mode +- Enemizer change: The attic/maiden sequence is now active and required when Blind is the boss of Thieves' Town even when bosses are shuffled + +### Crystal Switches + +- You can hit the PoD crystal switch in the Sexy Statue room with a bomb from the balcony above without jumping down +- GT Crystal Conveyor room (it has gibdos) - You can hit the crystal switch with a bomb when the blue barrier is up from the far side so you can leave the room to the left with blue barriers down +- PoD Arena Bridge - If entering from the bridge, you can circle round and hit the switch, then fall into the hole to respawn at the bridge again with the crystal barriers different + +--- + +## Dungeon Settings + +### Door Shuffle + +Controls how dungeon doors are shuffled: + +- **Vanilla** - Doors are not shuffled +- **Basic** - Doors are shuffled only within a single dungeon +- **Partitioned** - Dungeons are shuffled in 3 pools: Light World, Early Dark World, Late Dark World (Late Dark are the four dungeons that require Mitts in vanilla, including Ganon's Tower) +- **Crossed** - Doors are shuffled between dungeons as well + +CLI: `--doorShuffle [vanilla|basic|partitioned|crossed]` + +### Intensity + +Controls which types of connections are shuffled: + +- **Level 1** - Normal doors and spiral staircases are shuffled +- **Level 2** - Same as Level 1 plus open edges and both types of straight staircases are shuffled +- **Level 3** - Same as Level 2 plus Dungeon Lobbies are shuffled + +CLI: `--intensity [1|2|3]` + +### Door Type Shuffle + +Controls which types of doors can be shuffled (only active if door shuffle is not vanilla): + +- **Small Key Doors, Bomb Doors, Dash Doors** - Standard shuffled doors +- **Adds Big Key Doors** - Big key doors are now shuffled in addition to those above +- **Adds Trap Doors** - All trap doors that are permanently shut in vanilla are shuffled, excluding boss trap doors +- **Increases all Door Types** - Chaos mode where each door type per dungeon is randomized between 1 less and 4 more + +CLI: `--door_type_mode [original|big|all|chaos]` + +### Trap Door Removal + +Options for making dungeon traversal more convenient: + +- **No Removal** - Does not remove any trap doors +- **Removed If Blocking Path** - Dungeon generation removes annoying trap doors if necessary (boss trap doors never shuffled) +- **Remove Boss Traps** - Boss traps are removed, including the one near Mothula +- **Remove All Annoying Traps** - Removes all trap doors that are annoying, including boss traps + +CLI: `--trap_door_mode [vanilla|optional|boss|oneway]` + +### Dungeon Items + +#### Small Keys + +- **In Dungeon** - Small keys are restricted to their own dungeon +- **Randomized** - Small keys can be found anywhere +- **Universal** - Small keys work in any dungeon, can be found anywhere, and at least one shop will sell keys (like original Legend of Zelda) + +CLI: `--keyshuffle [none|wild|universal]` + +All other dungeon items (maps, compasses, Big Keys) can be restricted to their own dungeon or shuffled in the general pool. + +### Key Logic Algorithm + +Determines how small key door logic works: + +- **Partial Protection** - Assumes you always have full inventory and worst case usage. Accounts for dark room and bunny revival glitches +- **Strict** - Small key doors require all small keys to be available to be in logic +- **Dangerous** - Assumes you never use keys out of logic (not recommended) + +CLI: `--key_logic [partial|strict|dangerous]` + +### Decouple Doors + +Similar to insanity mode in ER where door entrances and exits are not paired anymore. Tends to remove more logic from dungeons as many rooms will not be required to traverse. + +CLI: `--decoupledoors` + +### Allow Self-Looping Spiral Stairs + +If enabled, spiral stairs are allowed to lead to themselves. + +CLI: `--door_self_loops` + +### Experimental Features + +You will start as a bunny if your spawn point is in the dark world. + +CLI: `--experimental` + +### Crossed Dungeon Specific Settings + +#### Dungeon Chest Counters + +- **Auto** - Picks an appropriate setting based on other settings +- **On** - Dungeon counters on HUD always displayed +- **Off** - Dungeon counters on HUD never displayed +- **On Compass Pickup** - Dungeons with a compass item will display the counter once the compass is found + +CLI: `--dungeon_counters [auto|on|off|pickup]` + +#### Mixed Travel + +Controls Hammerjump, PoD Arena hovering, and Mire Big Key Chest bomb jump: + +- **Prevent (default)** - Rails are added to prevent these tricks. Recommended for those learning crossed dungeon mode +- **Allow** - Rooms are left alone and it is up to player discretion whether to use these tricks +- **Force** - The two disjointed sections are forced to be in the same dungeon but the glitches are never logically required + +CLI: `--mixed_travel [prevent|allow|force]` + +#### Standardize Palettes + +- **Standardize (default)** - Rooms in the same dungeon have their palettes changed to match +- **Original** - Rooms/supertiles keep their original palettes + +CLI: `--standardize_palettes` + +--- + +## Pool Expansions + +### Pottery + +Controls which pots (and large blocks) are in the locations pool: + +- **None** - No pots are in the pool, like normal randomizer +- **Key Pots** - The pots that have keys are in the pool +- **Cave Pots** - The pots that are not found in dungeons are in the pool (includes Spike Cave large block) +- **Cave + Keys Pots** - Both non-dungeon pots and pots that used to have keys +- **Reduced Dungeon Pots** - Cave+Keys plus roughly 25% of dungeon pots (dynamic mode with colored pots) +- **Clustered Dungeon Pots** - Like reduced but pots grouped by logical sets, roughly 50% chosen (dynamic mode) +- **Excludes Empty Pots** - All pots that had some sort of objects under them +- **Dungeon Pots** - The pots that are in dungeons +- **Lottery** - All pots and large blocks are in the pool + +CLI: `--pottery [none|keys|cave|cavekeys|reduced|clustered|nonempty|dungeon|lottery]` + +#### Colorize Pots + +Colors the pots that have been chosen to be part of the location pool. Forced on for dynamic modes (clustered and reduced). + +CLI: `--colorizepots` + +### Shuffle Enemy Drops + +Controls whether enemies that drop items are randomized: + +- **None** - Special enemies drop keys normally +- **Keys** - Enemies that drop keys are added to the randomization pool (includes Hyrule Castle Big Key) +- **Underworld** - Enemies in the underworld are added to the randomization pool. Blue square indicates if there are any enemies on the supertile that still have an available drop + +CLI: `--dropshuffle [none|keys|underworld]` + +### Shopsanity + +Adds 32 shop locations (9 more in retro) to the general location pool. Multi-world supported. + +Shop locations include: +- Lake Hylia Cave Shop (3 items) +- Kakariko Village Shop (3 items) +- Potion Shop (3 new items) +- Paradox Cave Shop (3 items) +- Capacity Upgrade Fairy (2 items) +- Dark Lake Hylia Shop (3 items) +- Curiosity/Red Shield Shop (3 items) +- Dark Lumberjack Shop (3 items) +- Dark Potion Shop (3 items) +- Village of Outcast Hammer Peg Shop (3 items) +- Dark Death Mountain Shop (3 items) + +[See README for complete pricing guide and mechanics](/README#shopsanity) + +### Take Any Caves + +Three options: None, Random, and Fixed. Fixed means take any caves replace specific fairy caves: + +- Desert Healer Fairy +- Swamp Healer Fairy (aka Light Hype Cave) +- Dark Death Mountain Healer Fairy +- Dark Lake Hylia Ledge Healer Fairy (aka Shopping Mall Bomb) +- Bonk Fairy (Dark) + +--- + +## Item Randomization + +### New "Items" + +#### Bomb Bag + +Two bomb bags are added to the item pool (look like +10 Capacity upgrades). Bombs are unable to be used until one is found. + +CLI: `--bombbag` + +#### Pseudo Boots + +Dashing is allowed without the boots item however doors and certain rocks remain unopenable until boots are found. Specific sequence breaks like hovering and water-walking are not allowed until boots are found. + +CLI: `--pseudoboots` + +#### Mirror Scroll + +Mirror is usable inside dungeons. Locations that require the mirror are still unattainable. + +CLI: `--mirrorscroll` + +#### Flute Mode + +- **Normal** - Need to activate it at the village statue after finding it +- **Activated** - Can use it immediately upon finding it + +CLI: `--flute_mode` + +#### Bow Mode + +- **Progressive** - Standard progressive bows +- **Silvers separate** - One bow in the pool and silvers are a separate item +- **Retro (progressive)** - Arrows cost rupees, need to purchase single arrow item at shop +- **Retro + Silvers** - Arrows cost rupees, one bow, silvers are separate item + +CLI: `--bow_mode [progressive|silvers|retro|retro_silvers]` + + + +### Goal Options + +- **Trinity** - Find one of 3 triforces to win (pedestal, Ganon, or Murahdahla with 8 of 10 pieces) +- **Ganonhunt** - Collect the requisite triforce pieces, then defeat Ganon (Aga2 not required) +- **Completionist** - Obtain every item in the game and defeat Ganon (forces 100% accessibility) + +### Item Sorting (Fill Algorithms) + +Controls how items are placed in the world: + +#### Balanced + +Most random distribution of items (recommended). + +#### Vanilla Fill + +Attempts to place all items in their vanilla locations when possible. If not possible, prefers "major" locations, then heart piece locations, then the rest. + +#### Major Location Restriction + +Attempts to place major items in major locations. Major locations are where major items are found in the vanilla game. + +#### Dungeon Restriction + +Attempts to place all major items in dungeons. Overflows to overworld if necessary. + +#### District Restriction + +The world is divided into different regions/districts. Districts are chosen at random and filled with major items. Single green rupees indicate chosen districts. + +CLI: `--algorithm [balanced|vanilla_fill|major_only|dungeon_only|district]` + +### Forbidden Boss Items + +Restrict items that can appear on bosses: + +- **None** - Boss may have any item +- **MapCompass** - Map and compass are logically required to defeat a boss (currently bugged) +- **Dungeon** - Small keys and big keys of the dungeon are not allowed on a boss + +CLI: `--restrict_boss_items [none|mapcompass|dungeon]` + +--- + +## Entrance Randomization + +### New Modes + +- **Lite** - Non item entrances are vanilla, dungeons/caves grouped with restrictions +- **Lean** - Same grouping as Lite but cross-world connections allowed +- **Swapped** - Entrances are swapped with each other + +### Shuffle Links House + +In certain ER shuffles (not dungeonssimple or dungeonsfulls), control whether Links House is shuffled or remains vanilla. + +### Skull Woods Shuffle + +Options to reduce annoying Skull Woods layouts: + +- **Original** - Skull woods shuffles classically amongst itself unless insanity mode +- **Restricted** - Skull woods drops are vanilla, entrances stay in skull woods and are shuffled +- **Loose** - Skull woods drops are vanilla, main ER mode's pool determines handling +- **Followlinked** - Follows Linked Drops setting + +### Linked Drops Override + +Controls whether drops should be linked to nearby entrances: + +- **Unset** - Uses the mode's default (linked for all modes except insanity) +- **Linked** - Forces drops to be linked to their entrances +- **Independent** - Decouples drops from entrances + +### Overworld Map + +Option to move indicators on overworld map to reference dungeon location: + +- **Default** - Showing only the prize markers on vanilla dungeon locations +- **Compass** - Compass item controls whether marker is moved to dungeon locations +- **Map** - Map item shows both prize and location of the dungeon + +CLI: `--overworld_map [default|compass|map]` + +--- + +## Enemizer + +Enemizer has been incorporated into the generator. See [Enemizer in DR documentation](https://docs.google.com/document/d/1iwY7Gy50DR3SsdXVaLFIbx4xRBqo9a-e1_jAl5LMCX8/edit?usp=sharing) for extensive details. + +### Enemy Shuffle + +Enemies are shuffled with an enemy ban list that prevents problematic placements (blocking paths, unavoidable damage, glitches). + +### Enemy Damage + +The shuffled setting actually shuffles the damage table unlike the original enemizer. + +### Boss Shuffle: Unique + +Bosses are shuffled with some exceptions: +- Trinexx is not allowed on GT basement when DR is enabled +- Harder bosses in GT basement have logic concessions for low percentage requirements + +New variant: At least one boss of each type for prize bosses will be present guarding prizes. + +### Enemy Health + +Health is taken into account for challenge rooms if magic or ammo is required. + +### Enemy Logic + +Can account for logical access to challenge rooms and item/key drops when enemies are shuffled: + +- **Forbid special enemies** - Special enemies disallowed from drops and challenge rooms +- **Item drops may have special enemies** - Challenge rooms won't have special enemies, but drops may +- **Allow special enemies anywhere** - Both challenge rooms and enemy drops can have special requirements + +--- + +## Glitched Logic + +CLI: `--logic [noglitches|owglitches|hybridglitches|nologic]` + +### Overworld Glitches + +Includes overworld teleports, clips, superbunny, mirror to access Desert Palace East Entrance, bunny pocket access, etc. + +### Hybrid Major Glitches + +**Not compatible with Door Shuffle** + +Includes all Overworld Glitches logic plus: +- Kikiskip to access PoD without MP or DW access +- IP Lobby clip to skip fire requirement +- Various traversals between dungeons (TT ↔ Desert, Spec rock, Paradox, Mire ↔ Hera ↔ Swamp) +- Stealing SK from Mire to open SP +- Using Mire big key to open Hera doors + +--- + +## Game Options + +### MSU Resume + +Turns on MSU resume support. + +CLI: `--msu_resume` + +### Collection Rate + +Display the collection rate unless the triforce piece counter is needed. + +CLI: `--collection_rate` + +### Reduce Flashing + +Accessibility option to reduce some flashing animations in the game. + +CLI: `--reduce_flashing` + +### Shuffle Sound Effects + +Shuffles a large portion of the sound effects. Can be used with the adjuster. + +CLI: `--shuffle_sfx` + +--- + +## Customizer + +Create custom seeds with custom dungeons and rooms. + +See [Customizer documentation](Customizer.md) for details. + +--- + +## Generation Setup & Miscellaneous + +### Create BPS Patches + +Create BPS patch(es) instead of generating ROM(s) for distribution. + +CLI: `--bps` + +### Triforce Hunt Settings + +Controls for triforce piece pool: +- `--triforce_goal_min` / `--triforce_goal_max` - Pieces to collect to win +- `--triforce_pool_min` / `--triforce_pool_max` - Pieces in item pool +- `--triforce_min_difference` / `--triforce_max_difference` - Difference between pool and goal + +### Seed + +Set a seed number to generate. Same seed with same settings on same version will always yield identical output. + +### Count + +Batch generate multiple seeds with same settings. If seed number provided, it will be used to derive subsequent seeds. diff --git a/index.md b/index.md new file mode 100644 index 00000000..a7b5e9fe --- /dev/null +++ b/index.md @@ -0,0 +1,81 @@ +--- +layout: default +title: Home +nav_order: 1 +--- + +# ALttP Dungeon Randomizer + +**A dungeon randomizer for The Legend of Zelda: A Link to the Past** + +Door Randomizer extends the standard ALttP Entrance Randomizer with advanced dungeon shuffling capabilities that can rearrange dungeon interiors at the room level, creating entirely new dungeon experiences. + +[Download Latest Release](https://github.com/aerinon/ALttPDoorRandomizer/releases/latest){: .btn .btn-primary .fs-5 .mb-4 .mb-md-0 .mr-2 } +[View on GitHub](https://github.com/aerinon/ALttPDoorRandomizer){: .btn .fs-5 .mb-4 .mb-md-0 } + +--- + +## What is Door Randomizer? + +Door Randomizer takes the dungeon experience in A Link to the Past to the next level by shuffling the connections between rooms within dungeons. Instead of just shuffling dungeon entrances, Door Randomizer can: + +- **Shuffle doors within dungeons** - Rooms connect in completely new ways +- **Cross dungeon boundaries** - Walk through a door in Eastern Palace and end up in Tower of Hera +- **Adjust intensity levels** - From basic door shuffling to complete dungeon lobby randomization + +## Key Features + +### Basic Randomizer Features + +- Supports many standard ALttP Randomizer features without needing more advanced settings. + +### Door Shuffle Modes +- **Vanilla** - No shuffling, classic experience +- **Basic** - Doors shuffled within each dungeon +- **Partitioned** - Shuffle in pools (Light World, Early Dark World, Late Dark World) +- **Crossed** - Full shuffle between all dungeons + +### Intensity Levels +- **Level 1** - Normal doors and spiral staircases +- **Level 2** - + open edges and straight staircases +- **Level 3** - + dungeon lobbies + +### Advanced Features +- **Multiple key shuffle modes** - In dungeon, randomized, or universal keys +- **Pottery shuffle** - Randomize items under pots with multiple modes +- **Shopsanity** - 32 shop locations added to item pool +- **Enemy randomization** - Built-in enemizer with logic-aware placement +- **Custom seeds** - Create your own custom dungeons and rooms +- **Fill algorithms** - Multiple item placement strategies (balanced, vanilla fill, major only, district) + +## Quick Start + +1. [Download the latest release](https://github.com/aerinon/ALttPDoorRandomizer/releases/latest) +2. Extract the archive for your platform (Windows, Mac, or Linux) +3. Run `DungeonRandomizer.exe` (or the appropriate platform executable) +4. Configure your settings and generate a seed +5. Apply the patch to your A Link to the Past ROM (must be JP 1.0 version) + +[See detailed installation instructions →](/installation) + +## Community + +Join the discussion and get help: + +- **Discord**: [ALTTP Randomizer Discord](https://discordapp.com/invite/alttprandomizer) + - `#door-rando` - General discussion and help + - `#bug-reports` - Report bugs and issues + +## Learn More + +- [Features Guide](/features) - Comprehensive feature documentation +- [Installation & Usage](/installation) - Setup and running the randomizer +- [Known Issues](/known-issues) - Current bugs and limitations +- [Roadmap](/roadmap) - Future development plans +- [Blog](/blog) - Latest updates and release notes + +## Credits + +Based on the [ALttP Entrance Randomizer](https://github.com/KevinCathcart/ALttPEntranceRandomizer) by KevinCathcart et al. + +See [alttpr.com](https://alttpr.com/) for more details on the original VT randomizer. diff --git a/installation.md b/installation.md new file mode 100644 index 00000000..0c02b8ec --- /dev/null +++ b/installation.md @@ -0,0 +1,369 @@ +--- +layout: default +title: Installation & Usage +nav_order: 3 +--- + +# Installation & Usage +{: .no_toc } + +Complete guide to installing and running ALttP Door Randomizer. +{: .fs-6 .fw-300 } + +## Table of contents +{: .no_toc .text-delta } + +1. TOC +{:toc} + +--- + +## Requirements + +- Python 3.10 or higher (for running from source) +- A legal copy of The Legend of Zelda: A Link to the Past (JP 1.0 version) ROM + +--- + +## Installation Methods + +### Method 1: Pre-built Releases (Recommended) + +This is the easiest method for most users. + +1. Visit the [Releases page](https://github.com/aerinon/ALttPDoorRandomizer/releases) +2. Download the appropriate build for your system: + - **Windows**: `ALttPDoorRandomizer-{version}-windows.zip` + - **macOS**: `ALttPDoorRandomizer-{version}-osx.tar.gz` + - **Linux**: `ALttPDoorRandomizer-{version}-linux-focal.tar.gz` +3. Extract the archive to a folder of your choice +4. Run the executable: + - **Windows**: `DungeonRandomizer.exe` + - **macOS/Linux**: `./DungeonRandomizer` or `./Gui.py` + +### Method 2: Running from Source + +For developers or users who want to run the latest development version. + +#### Step 1: Clone the Repository + +```bash +git clone https://github.com/aerinon/ALttPDoorRandomizer.git +cd ALttPDoorRandomizer +``` + +For the development branch: +```bash +git checkout DoorDevUnstable +``` + +#### Step 2: Install Python Dependencies + +The project includes a script to install platform-specific dependencies: + +```bash +python resources/ci/common/local_install.py +``` + +This will install all necessary Python packages and platform-specific dependencies. + +#### Step 3: Verify Installation + +Test that everything is working: + +```bash +python DungeonRandomizer.py --help +``` + +You should see the help text with all available options. + +--- + +## Usage + +### GUI (Graphical User Interface) + +The GUI provides an easy-to-use interface for generating seeds. + +#### Starting the GUI + +**Pre-built release:** +- **Windows**: Double-click `DungeonRandomizer.exe` +- **macOS/Linux**: Run `./DungeonRandomizer` from terminal + +**From source:** +```bash +python Gui.py +``` + +#### Using the GUI + +1. **Select your ROM**: Click "Select ROM" and choose your ALttP ROM file +2. **Configure settings**: Use the tabs to adjust: + - **Dungeon Settings**: Door shuffle mode, intensity, key logic + - **Item Settings**: Item placement, shopsanity, pottery + - **Entrance Settings**: Entrance randomization options + - **Enemy Settings**: Enemy shuffle, boss shuffle + - **Game Options**: MSU resume, collection rate, etc. +3. **Generate**: Click "Generate" to create your seed +4. **Output**: The patched ROM will be created in the same directory + +### CLI (Command-Line Interface) + +The CLI offers more control and is useful for batch generation or scripting. + +#### Basic Usage + +```bash +python DungeonRandomizer.py [options] +``` + +#### Common Examples + +**Basic crossed dungeon shuffle:** +```bash +python DungeonRandomizer.py --doorShuffle crossed --intensity 2 +``` + +**With key shuffle and shopsanity:** +```bash +python DungeonRandomizer.py --doorShuffle crossed --keyshuffle wild --shopsanity +``` + +**Pottery and enemy drops:** +```bash +python DungeonRandomizer.py --doorShuffle basic --pottery lottery --dropshuffle underworld +``` + +**Generate without creating ROM (testing):** +```bash +python DungeonRandomizer.py --suppress_rom --spoiler none +``` + +**Create BPS patch instead of ROM:** +```bash +python DungeonRandomizer.py --bps --doorShuffle crossed +``` + +**Batch generation:** +```bash +python DungeonRandomizer.py --doorShuffle crossed --count 10 +``` + +#### Key CLI Arguments + +**Dungeon Settings:** +- `--doorShuffle [vanilla|basic|partitioned|crossed]` - Door shuffle mode +- `--intensity [1|2|3]` - Intensity level +- `--keyshuffle [none|wild|universal]` - Key shuffle mode +- `--key_logic [partial|strict|dangerous]` - Key logic algorithm +- `--door_type_mode [original|big|all|chaos]` - Door type shuffle +- `--trap_door_mode [vanilla|optional|boss|oneway]` - Trap door removal + +**Item Settings:** +- `--algorithm [balanced|vanilla_fill|major_only|dungeon_only|district]` - Item placement +- `--pottery [none|keys|cave|cavekeys|reduced|clustered|nonempty|dungeon|lottery]` - Pot shuffle +- `--dropshuffle [none|keys|underworld]` - Enemy drop shuffle +- `--shopsanity` - Enable shop randomization +- `--bombbag` - Enable bomb bag item +- `--pseudoboots` - Enable pseudo boots + +**Entrance Settings:** +- `--shuffle [vanilla|simple|restricted|full|crossed|insanity|...]` - Entrance shuffle mode +- `--overworld_map [default|compass|map]` - Overworld map mode + +**Enemy Settings:** +- `--enemizercli [none|basic|shuffled]` - Enemy shuffle mode +- `--enemy_damage [default|shuffled|chaos]` - Enemy damage +- `--enemy_health [default|easy|hard]` - Enemy health +- `--shufflebosses [none|basic|normal|chaos|unique]` - Boss shuffle + +**Logic:** +- `--logic [noglitches|owglitches|hybridglitches|nologic]` - Logic mode +- `--mode [open|standard|inverted]` - Game mode +- `--goal [ganon|trinity|ganonhunt|completionist]` - Victory condition + +**Generation:** +- `--seed SEED` - Set seed number +- `--count N` - Generate N seeds +- `--suppress_rom` - Don't create ROM (testing) +- `--bps` - Create BPS patch instead of ROM +- `--spoiler [none|spoiler|playthrough]` - Spoiler log type + +**Game Options:** +- `--msu_resume` - Enable MSU resume +- `--collection_rate` - Display collection rate +- `--reduce_flashing` - Reduce flashing animations +- `--shuffle_sfx` - Shuffle sound effects + +For a complete list of options: +```bash +python DungeonRandomizer.py --help +``` + +--- + +## Multiworld Setup + +Door Randomizer supports multiworld seeds where multiple players play different randomized games with shared item pools. + +### Installing Multiworld Dependencies + +Run the same installation script to install multiworld-specific dependencies: + +```bash +python resources/ci/common/local_install.py +``` + +### Generating Multiworld Seeds + +Create YAML files for each player (see `docs/player1.yml`, `docs/player2.yml`, `docs/player3.yml` for individual examples, or `docs/multi_mystery_example.yaml` for a complete multiworld configuration). + +**Example player configuration:** +```yaml +description: Player 1's World +name: Player1 +doorShuffle: crossed +intensity: 2 +keyshuffle: wild +shopsanity: true +``` + +Generate the multiworld using the multi-mystery configuration file: +```bash +python DungeonRandomizer.py --customizer docs/multi_mystery_example.yaml +``` + +### Running Multiworld Server + +```bash +python MultiServer.py +``` + +It will prompt you for the multidata file created from the multiworld generation step. + +### Connecting with Multiworld Client + +```bash +python MultiClient.py +``` + +Enter the server address and your player name to connect. + +--- + +## Testing & Verification + +### Running the Test Suite + +To verify your installation and test the randomizer logic: + +```bash +python TestSuite.py +``` + +**Test with specific settings:** +```bash +python TestSuite.py --dr basic --count 10 --tense 2 +``` + +**Run specific test modules:** +```bash +python -m pytest test/ +python -m pytest test/dungeons/TestDarkPalace.py +``` + +--- + +## Troubleshooting + +### Common Issues + +#### "Python not found" or "python: command not found" + +- **Windows**: Make sure Python is installed and added to PATH during installation +- **macOS/Linux**: Install Python 3.10+ via your package manager or from [python.org](https://www.python.org/) + +#### "No module named 'yaml'" or similar import errors + +Run the dependency installation script: +```bash +python resources/ci/common/local_install.py +``` + +#### Pre-built executable won't run on macOS + +macOS may block unsigned applications. Right-click the app and select "Open" to bypass the warning. + +#### Pre-built executable won't run on Linux + +Ensure the file has execute permissions: +```bash +chmod +x DungeonRandomizer +``` + +#### GUI window is too small or cut off + +Try running from the command line to see if there are any error messages. Some display scaling settings can cause issues. + +#### Generated ROM doesn't work with emulator + +- Ensure you're using a clean US version of ALttP ROM (Japan 1.0) +- Try a different emulator (recommended: SNES9x, RetroArch with bsnes core) +- Verify the ROM was patched successfully (check file size and modification date) + +### Getting Help + +If you encounter issues: + +1. Check the [Known Issues](/known-issues) page +2. Search [GitHub Issues](https://github.com/aerinon/ALttPDoorRandomizer/issues) +3. Ask in the [ALTTP Randomizer Discord](https://discordapp.com/invite/alttprandomizer): + - `#door-rando` - General help and questions + - `#bug-reports` - Report bugs and issues + +When reporting issues, please include: +- Operating system and version +- Python version (`python --version`) +- Door Randomizer version or commit hash +- Full error message or description of the problem +- Settings used (CLI command or screenshot of GUI) + +--- + +## Advanced Usage + +### Custom Presets + +You can create custom preset files to save your favorite settings combinations. + +See the [Customizer documentation](docs/Customizer.md) for details on creating custom seeds with custom dungeons and rooms. + +### Build from Source (Packaging) + +To create a standalone executable from source: + +See [BUILDING.md](docs/BUILDING.md) for detailed build instructions. + +### Development Workflow + +For contributors: + +1. Fork the repository +2. Create a feature branch from `DoorDevUnstable`: + ```bash + git checkout DoorDevUnstable + git checkout -b my-feature + ``` +3. Make your changes +4. Run tests: `python TestSuite.py` +5. Submit a pull request to `DoorDevUnstable` (not main/master) + +--- + +## Next Steps + +- Read the [Features Guide](/features) for detailed information on all settings +- Check the [Known Issues](/known-issues) page for current limitations +- See the [Roadmap](/roadmap) for upcoming features +- Join the community on [Discord](https://discordapp.com/invite/alttprandomizer) diff --git a/known-issues.md b/known-issues.md new file mode 100644 index 00000000..20093d57 --- /dev/null +++ b/known-issues.md @@ -0,0 +1,373 @@ +--- +layout: default +title: Known Issues +nav_order: 4 +--- + +# Known Issues & Bug Tracking +{: .no_toc } + +Current known issues, bugs, and limitations in ALttP Door Randomizer. +{: .fs-6 .fw-300 } + +## Table of contents +{: .no_toc .text-delta } + +1. TOC +{:toc} + +--- + +## Reporting Bugs + +Before reporting a bug, please: + +1. Check this page to see if the issue is already known +2. Search [existing GitHub issues](https://github.com/aerinon/ALttPDoorRandomizer/issues) +3. Verify you're using the latest version + +### How to Report + +Report bugs in this location: + +- **Discord**: [ALTTP Randomizer Discord](https://discordapp.com/invite/alttprandomizer) in `#bug-reports` or `#door-rando` channels + +### What to Include + +When reporting a bug, please provide: + +- **Spoiler log** if you have one +- If you don't have a spoiler log, include: + - **Seed number** and **settings used** + - **Version** of Door Randomizer (from GUI or `--version`) +- **Website or Platform** (Windows, macOS, Linux) if generator error, or which website was used +- **Description** of the issue +- **Steps to reproduce** the problem +- **Screenshots or videos** (if applicable) +- Optionally, **Save state** (if gameplay issue) (and which emulator/version) + +--- + +## Known Issues + +### Critical Issues + +#### Dungeon Key HUD indicator + +**Status**: Under investigation + +Dungeon Key HUD indicator shows incorrect total number of keys under certain settings. + + +#### Links House on Death Mountain - no logical way off the mountain + +**Status**: Under investigation + +Some ER generations can have Link's House be on Death Mountain and no good way off the mountain. + + +--- + +### Major Issues + +#### Crossed Dungeon Generation Can Be Slow + +**Status**: Performance optimization needed + +Generating crossed dungeon seeds, especially with high intensity and complex settings, can take a significant amount of time (30 seconds to several minutes). + +**Why**: The dungeon generation algorithm uses constraint satisfaction and local search, which can require many attempts to find valid layouts. + +**Workaround**: Be patient, or reduce intensity/complexity of settings. + +#### Rare Impossible Seeds (Generation Failures) + +**Status**: Occasional, investigating + +In rare cases, the generator may fail to place all items or create a valid dungeon layout. This usually happens with very restrictive settings combinations. + +**Workaround**: Try a different seed number, or slightly adjust settings. + +--- + +### Moderate Issues + +#### Some Enemy Placements Can Be Problematic + +**Status**: Ongoing ban list maintenance + +Despite the enemy ban list, some enemy placements can occasionally cause issues: +- Blocking required paths +- Causing unavoidable damage +- Creating glitchy behavior +- Bush enemies not working correctly +- Wallmasters can cause issues in certain locations + +**Workaround**: Report specific problematic enemy locations so they can be added to the ban list. + +**Note**: Thieves are always unkillable and banned from the entire underworld. + + +--- + +### Minor Issues + +#### Forbidden Boss Items "MapCompass" Mode Bugged + +**Status**: Under investigation + +The `mapcompass` option for `--restrict_boss_items` is currently bugged and not recommended for use. + +**Workaround**: Use `dungeon` option instead, or use `none`. + +#### Swamp Trench 2 Keeps Draining + +**Status**: Known issue + +In some configurations, Swamp Trench 2 continues to drain even after the pot is obtained. + +**Workaround**: None currently. This is a known behavior issue. + +#### Killing Certain Red Guards Kills Music + +**Status**: Known issue + +Killing certain red guards in specific locations causes the music to stop playing. + +**Workaround**: None currently. This is a cosmetic issue that doesn't affect gameplay. + +#### Some Lobbies Exitable During Escape (Standard Mode) + +**Status**: Known issue + +In standard mode, some dungeon lobbies can be exited during the escape sequence when they shouldn't be. + +**Workaround**: Avoid leaving during escape if you want to maintain intended flow. + +--- + +### Logic Issues + +These are cases where the logic may not perfectly match what's actually possible in-game: + +#### GT Crystal Paths Room Logic + +**Status**: Under investigation + +Crystal switch logic for GT Crystal Paths room may not properly account for OHKO scenarios when traversing backwards. + +#### OHKO (One-Hit KO) Logic Issues + +**Status**: Under investigation + +In some configurations, unavoidable damage logic or OHKO scenarios may not be properly accounted for. + +#### Hammerjump Logic and Mixed Travel + +**Status**: Configurable behavior + +Hammerjump and similar tricks (PoD Arena hovering, Mire Big Key bomb jump) can unintentionally put you in another dungeon with the wrong dungeon ID. + +**Setting**: Use `--mixed_travel` to control this behavior: +- `prevent`: Adds rails to prevent tricks (default, recommended for learning) +- `allow`: Up to player discretion +- `force`: Sections forced to same dungeon + +--- + +## Mode-Specific Issues + +### Glitched Logic Modes + +Several issues specific to glitched logic modes (OWG, HMG): + +#### Cave State Issues + +**Status**: Under investigation + +Cave state in GT hearts area may not work correctly in glitched modes. + +#### Rain State Issues + +**Status**: Under investigation + +Rain state handling may have issues in glitched logic modes. + +#### Key/Pot SRAM System + +**Status**: Needs restoration + +Old key/pot SRAM system needs to be restored for glitched modes to work properly. + +### Inverted Mode Issues + +#### Dark Sanctuary Inverted Insanity + +**Status**: Under investigation + +Dark Sanctuary with inverted mode and insanity entrance shuffle may have double entrance issues. + +#### Dark Sanctuary at Tavern Error + +**Status**: In progress + +When Dark Sanctuary is at Tavern location, Link's body position may be incorrect. + +### Entrance Randomization Issues + +#### Dungeon Boss Exits in Non-ER + +**Status**: Under investigation + +Dungeon boss exits may not work correctly when entrance randomization is disabled. + +### Decoupled Doors Issues + +#### Sanctuary Palette Detection + +**Status**: Known issue + +In decoupled doors mode, sanctuary palette doesn't correctly identify adjacent rooms. Uses exits instead of entrances for determination. + +**Workaround**: Use coupled doors or original palette mode. + +### Shopsanity Issues + +#### Output YAML: Shopsanity Potions Missing + +**Status**: Under investigation + +When outputting to YAML format, shopsanity potions may not be correctly included in the item pool representation. + +**Workaround**: Check spoiler log for actual item locations. + +--- + +## Known Limitations & Design Decisions + +These items are **not planned to be fixed** as they are either fundamental limitations, intentional design choices, or affect all ALttP randomizers. + +### Game Engine Limitations + +#### Compass Count Stops Working After Triforce + +After obtaining the Triforce, compass counts no longer function correctly. This is true in all ALttP randomizers and is a base game limitation. + +**Workaround**: Complete dungeon exploration before finishing the game if you need counts. + +#### GT Bosses Don't Respawn + +GT bosses don't respawn after killing them. This is intentional base game behavior. + +### Door Randomizer Design Decisions + +#### Hybrid Major Glitches Not Compatible with Door Shuffle + +Hybrid major glitches logic is not compatible with door shuffle modes. This is a fundamental limitation due to how glitch logic interacts with shuffled dungeon interiors. + +**Workaround**: Use Overworld Glitches logic instead, or disable door shuffle. + +#### Fire Rod Not in Logic for Dark Rooms + +Fire Rod is not in logic for dark rooms in door shuffle mode, as it's too difficult to determine which dark room you're in after doors are shuffled. + +**Note**: This is different from Advanced mode in the vanilla randomizer. + +#### Hammerjump Requiring Mixed Travel Settings + +Hammerjump and similar tricks (PoD Arena hovering, Mire Big Key bomb jump) require `--mixed_travel` settings in crossed mode to allow unintended dungeon transitions. + +#### Blind Maiden/Attic Sequence Always Required + +Blind maiden/attic sequence is required even when boss is shuffled. This maintains story consistency. + +#### Southeast Skull Woods Chest Not Guaranteed Key + +In Entrance Randomizer, the southeast Skull Woods chest is guaranteed to be a small key. In Door Randomizer, this is not guaranteed. This is an intentional change from ER. + +### Technical Limitations + +#### Pottery Lottery Mode: Multiworld Item Limit + +In pottery lottery mode, only 256 items for other players can be placed under pots in your world due to technical constraints in how the game tracks items. + +--- + +## Feature Limitations + +See the [Roadmap](/roadmap) for planned features. + +--- + +## Recently Fixed Issues + +See RELEASENOTES.md for the latest fixes. + +And PastReleaseNotes.md for older fixes. + +--- + +## Performance Issues + +### Memory Usage + +**Issue**: Generator can use significant memory for complex seeds. + +**Most affected by**: +- Multiworld with many players +- Pottery lottery mode + +**Workaround**: Close other applications, or increase available RAM. + +--- + +## Emulator Compatibility + +### Known Issues with Emulators + +#### Older SNES9x versions + +Some older versions (< 1.55) may have graphical glitches with certain custom graphics. + +#### ZSNES + +**Not recommended**: ZSNES is outdated and has known accuracy issues. + +--- + +## Workarounds & Tips + +### If Generation Keeps Failing + +1. Switch to a different door shuffle mode +4. Disable some restrictive settings (strict key logic, dungeon item restrictions) +5. Use balanced fill algorithm instead of district restriction + +### If Seed Seems Impossible + +1. Check spoiler log to verify it's beatable +2. Remember new logic differences (see Features guide) +3. Check for required techniques (boots bonking, crystal switch bombs, etc.) +4. Ask for help in Discord with spoiler log + +### If Performance Is Poor + +1. Use pre-built executable instead of running from source +2. Close other applications +3. Update to latest version +4. Use simpler settings combinations + + +--- + +## Issue Status Tracking + +For real-time status of known issues, check: + +- Discord `#bug-reports` and `#door-rando` channels + +--- + +Last updated: 2026-01-30 + +This page is maintained as issues are discovered and fixed. If you notice an issue not listed here, please report it! diff --git a/roadmap.md b/roadmap.md new file mode 100644 index 00000000..9aaef290 --- /dev/null +++ b/roadmap.md @@ -0,0 +1,234 @@ +--- +layout: default +title: Roadmap +nav_order: 5 +--- + +# Development Roadmap +{: .no_toc } + +Future plans and upcoming features for ALttP Door Randomizer. +{: .fs-6 .fw-300 } + +## Table of contents +{: .no_toc .text-delta } + +1. TOC +{:toc} + +--- + +## Project Vision + +Door Randomizer aims to provide the most comprehensive and flexible dungeon randomization experience for A Link to the Past while maintaining playability and logical consistency. Our focus is on: + +1. **Robust Generation** - Ensuring seeds are always completable and logical +2. **Feature Richness** - Providing extensive customization options +3. **Community Engagement** - Responding to player feedback and needs +4. **Performance** - Improving generation speed and reliability + +--- + +## Bug Fixes + +Critical and important bugs that need to be addressed: + +### Critical Bugs +- Dungeon Key HUD indicator issue (total is incorrect) +- Links House on DM pathing issues (See OWR solution) + +### Minor Bugs +- Resolve Swamp Trench 2 draining issue (pot obtained but still drains) +- Fix OHKO logic issues - Crystal Path backwards in GT +- Fix MapCompass forbidden boss items mode (currently bugged) +- Killing Certain Red Guards Kills Music + +--- + +## Logic & Generation Improvements + +Improving dungeon generation algorithms and logic: + +- Enhanced key logic algorithms (experimental mode in New Generation) +- Rework Uncle weapon/Escape small key +- Make Sanctuary heart the logical one (simplify sanctuary heart logic) +- Investigate rupee balancing issues causing failed generations + +--- + +## New Features + +New functionality and game modes, mostly planned for the NewGeneration branch: + +- Portal placement flexibility (customizability and mixed dungeon pools) +- Smarter trap door placement (reduce forced mirroring) +- DR Keysanity menu improvements +- PitWarp feature +- Door Type pooling customizations +- OWR ER standardization (District ER, Links on Death Mountain issue) +- NewSwappedAlgorithm integration +- Bonk Item Pool from Overworld Randomizer (downstream integration) +- A better hint system +- Prize Shuffle from Overworld Randomizer (downstream integration) +- Map Screen from GK Randomizer (need to investigate) +- Other downstream integrations? (custom goals, follower shuffle, flute shuffle?) + +--- + +## Quality of Life Enhancements + +Improving user experience and usability: + +- Preferred location groups (control item placement with warnings/failures/retries) +- Preset support +- Control output ROM name (customize generated ROM filename) +- Progress indicators for generations +- Better entrance tracking for trackers (investigate race legality) +- Super-tile split palettes (reduce hinting from palette colors) +- Turn off Bob by default for enemizer (fewer graphical glitches) + +--- + +## Performance Improvements + +Making generation faster and more efficient: + +- Reduce memory footprint + +--- + +## Customization & Content Creation + +Tools and features for creating custom content: + +- Re-design customizer file format (improved YAML structure) +- Presets for customizer (start from predefined base) +- Easier enemy customization (simpler interface for customizing specific enemies - better integration with customization system) + +--- + +## Multiworld + +Enhancements for multiplayer seeds: + +- Multiworld documentation +- Ability to have similar randomizations across multiworlds (makes parts of it co-op) + +--- + +## External Tools & Integration + +Integration with external tools and platforms: + +- Tracker integration features +- Web-based API + +--- + +## Technical Debt & Refactoring + +Behind-the-scenes code improvements: + +- Modernize Rules.py (improve readability and maintainability) +- Python upgrade (3.10 deprecated in 2026) + +--- + +## Research & Exploration + +Experimental ideas that may or may not be implemented: + +### Dungeon Randomization Ideas + +- **Subroom randomization** - Randomize smaller rooms within a larger room (subtile vs. supertile doors) +- **Euclidean dungeon layouts** - Dungeon randomization that makes spatial sense (rooms connected geographically) +- **Swapped dungeon generation** - Create dungeons by swapping door destinations (requires new algorithms) + +--- + +## Branch Strategy + +### Current Branches + +- **NewGeneration** - Active development branch for new generation system +- **NewSwappedAlgorithm** - Experimental branch for swapped item algorithm +- **DoorDevUnstable** - Main branch, maintenance mode - only bug fixes and patches (ready to be moved to official stable) +- **DoorDev** - Stale development branch (needs update) +- **Dev/Master** - Do NOT use for PRs. Used by upstream only. + +### Planned Branch Changes + +- Transition from DoorDevUnstable to DoorDev as main maintenance branch +- Transition NewGeneration to main development branch + +--- + +## Completed Features + +Recent accomplishments: + +- ✅ Dynamic colored pots +- ✅ Free lamp cone +- ✅ Experimental key logic improvements + +--- + +## How to Contribute + +Want to help shape the future of Door Randomizer? + +### For Players +- **Test seeds** - Play with different settings and report issues +- **Provide feedback** - Share what you like and what could be better +- **Suggest features** - Tell us what you want to see + +### For Developers +- **Submit PRs to DoorDevUnstable** +- **Join Discord** - Discuss development in `#door-rando` +- **Write tests** - Improve test coverage +- **Improve documentation** - Help others understand the code + +### For Creators +- **Custom rooms** - Design interesting custom rooms +- **Presets** - Create balanced preset configurations +- **Tutorials** - Teach others how to use Door Rando +- **Tools** - Build complementary tools (trackers, analyzers) + +--- + +## Release Schedule + +### Regular Releases +- **Unstable builds** - Automated on every push to DoorDevUnstable +- **Hotfixes** - As needed for critical bugs + +### Upcoming Releases (Tentative) +- **v1.5.x** (Q2 2026) - DoorDevUnstable becomes DoorDev +- **v1.6** (Q3 2026) - Python upgrade +- **v2.0** (Q4 2026) - New Generation branch release + +--- + +## Success Metrics + +How we measure progress: + +### Technical Metrics +- Generation success rate (target: >95%) +- Average generation time (target: <10s for crossed seeds) +- Memory usage (start measuring) +- Test coverage (start measuring) + +--- + +## Feedback & Discussion + +Have thoughts on the roadmap? + +- **Discord**: Join `#door-rando` to discuss + +--- + +*This roadmap is a living document and will be updated regularly as priorities shift and progress is made.* + +Last updated: 2026-01-30 From e27fb51dc9280242608f2b31a9895ccb19dce15a Mon Sep 17 00:00:00 2001 From: aerinon Date: Fri, 30 Jan 2026 10:09:22 -0700 Subject: [PATCH 11/34] deploy: github action site deploy --- .github/workflows/deploy-pages.yml | 81 ++++++++++++++++++++++++++++++ 1 file changed, 81 insertions(+) create mode 100644 .github/workflows/deploy-pages.yml diff --git a/.github/workflows/deploy-pages.yml b/.github/workflows/deploy-pages.yml new file mode 100644 index 00000000..23a1ada4 --- /dev/null +++ b/.github/workflows/deploy-pages.yml @@ -0,0 +1,81 @@ +# GitHub Pages Deployment Workflow +name: 📄 Deploy GitHub Pages + +# Deploy on push to DoorDevUnstable branch +on: + push: + branches: + - DoorDevUnstable + # Allow manual trigger + workflow_dispatch: + +# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages +permissions: + contents: read + pages: write + id-token: write + +# Allow only one concurrent deployment +concurrency: + group: "pages" + cancel-in-progress: true + +jobs: + # Build job + build: + name: 🔨 Build Site + runs-on: ubuntu-latest + steps: + - name: ✔️ Checkout + uses: actions/checkout@v4 + + - name: 💎 Setup Ruby + uses: ruby/setup-ruby@v1 + with: + ruby-version: '3.1' + bundler-cache: false + + - name: 💿 Install dependencies + run: | + gem install bundler + bundle config set --local path 'vendor/bundle' + # Create Gemfile if it doesn't exist + if [ ! -f Gemfile ]; then + cat > Gemfile << 'EOF' + source 'https://rubygems.org' + gem 'github-pages', group: :jekyll_plugins + gem 'jekyll-feed' + gem 'jekyll-seo-tag' + gem 'jekyll-sitemap' + gem 'just-the-docs' + EOF + fi + bundle install + + - name: 🔨 Build with Jekyll + run: bundle exec jekyll build --baseurl "/ALttPDoorRandomizer" + env: + JEKYLL_ENV: production + + - name: 📤 Upload artifact + uses: actions/upload-pages-artifact@v3 + with: + path: ./_site + + # Deployment job + deploy: + name: 🚀 Deploy to GitHub Pages + environment: + name: github-pages + url: ${{ steps.deployment.outputs.page_url }} + runs-on: ubuntu-latest + needs: build + steps: + - name: 🚀 Deploy to GitHub Pages + id: deployment + uses: actions/deploy-pages@v4 + + - name: ✅ Deployment complete + run: | + echo "🎉 GitHub Pages deployed successfully!" + echo "📄 Site URL: ${{ steps.deployment.outputs.page_url }}" From 87ba33852f84a13f64b1392f8c8343d4cb4caec4 Mon Sep 17 00:00:00 2001 From: Catobat <69204835+Catobat@users.noreply.github.com> Date: Sun, 1 Feb 2026 12:15:08 +0100 Subject: [PATCH 12/34] Refactor how large screen quadrants are stored in grids --- source/overworld/LayoutGenerator.py | 174 ++++++++------- source/overworld/LayoutVisualizer.py | 307 +++++++++++++-------------- 2 files changed, 252 insertions(+), 229 deletions(-) diff --git a/source/overworld/LayoutGenerator.py b/source/overworld/LayoutGenerator.py index 467941ab..d2245ac7 100644 --- a/source/overworld/LayoutGenerator.py +++ b/source/overworld/LayoutGenerator.py @@ -1,4 +1,3 @@ -import copy import logging import RaceRandom as random import random as _random @@ -8,7 +7,7 @@ from OverworldShuffle import connect_two_way, validate_layout ENABLE_KEEP_SIMILAR_SPECIAL_HANDLING = False PREVENT_WRAPPED_LARGE_SCREENS = False -DRAW_IMAGE = False +DRAW_IMAGE = True large_screen_ids = [0x00, 0x03, 0x05, 0x18, 0x1B, 0x1E, 0x30, 0x35] + [0x40, 0x43, 0x45, 0x58, 0x5B, 0x5E, 0x70, 0x75] @@ -49,7 +48,7 @@ class WorldPiece: def __init__( self, - screens: List[List[Optional[Screen]]], + screens: Optional[List[List[Optional[Screen]]]] = None, grid: Optional[List[List[int]]] = None, width: int = 0, height: int = 0, @@ -62,7 +61,7 @@ class WorldPiece: west_edges_water: Optional[List[List[List[OWEdge]]]] = None, east_edges_water: Optional[List[List[List[OWEdge]]]] = None ): - self.screens = screens + self.screens = screens if screens is not None else [] self.grid = grid if grid is not None else [] self.width = width self.height = height @@ -154,7 +153,7 @@ class LayoutGeneratorOptions: """ Configuration options for layout generation. """ - __slots__ = ('horizontal_wrap', 'vertical_wrap', + __slots__ = ('horizontal_wrap', 'vertical_wrap', 'split_large_screens', 'large_screen_pool', 'distortion_chance', 'random_order', 'multi_choice', 'max_delay', 'first_ignore_bonus_points', 'penalty_full_edge_mismatch', 'penalty_partial_edge_mismatch', 'bonus_partial_edge_match', @@ -168,6 +167,7 @@ class LayoutGeneratorOptions: self, horizontal_wrap: bool = True, vertical_wrap: bool = True, + split_large_screens = False, large_screen_pool: bool = False, distortion_chance: float = 0.0, random_order: int = 0, @@ -194,6 +194,7 @@ class LayoutGeneratorOptions: ): self.horizontal_wrap = horizontal_wrap self.vertical_wrap = vertical_wrap + self.split_large_screens = split_large_screens self.large_screen_pool = large_screen_pool self.distortion_chance = distortion_chance self.random_order = random_order @@ -418,8 +419,8 @@ def create_piece_list(world: World, player: int, options: LayoutGeneratorOptions if castle_screen and central_bonk_screen and links_house_screen: piece = create_piece(world, player, [ - [0x1B, 0x1B], - [0x1B, 0x1B], + [0x1B, 0x1C], + [0x23, 0x24], [0x2B, 0x2C] ], overworld_screens) @@ -439,10 +440,18 @@ def create_piece_list(world: World, player: int, options: LayoutGeneratorOptions # Add large screens for screen in all_large_screens: if screen not in used_screens_set: - piece = create_piece(world, player, [[screen.id, screen.id], [screen.id, screen.id]], overworld_screens) - if options.large_screen_pool: - piece.restriction = [0x00, 0x03, 0x05, 0x18, 0x1B, 0x1E, 0x30, 0x35] - piece_list.append(piece) + base_id = screen.id + if options.split_large_screens: + for quadrant_offset in [0x00, 0x01, 0x08, 0x09]: + piece = create_piece(world, player, [[base_id + quadrant_offset]], overworld_screens) + if options.large_screen_pool: + piece.restriction = [large_screen_id + quadrant_offset for large_screen_id in [0x00, 0x03, 0x05, 0x18, 0x1B, 0x1E, 0x30, 0x35]] + piece_list.append(piece) + else: + piece = create_piece(world, player, [[base_id, base_id + 0x01], [base_id + 0x08, base_id + 0x09]], overworld_screens) + if options.large_screen_pool: + piece.restriction = [0x00, 0x03, 0x05, 0x18, 0x1B, 0x1E, 0x30, 0x35] + piece_list.append(piece) used_screens_set.add(screen) if world.owParallel[player]: used_screens_set.add(screen.parallel) @@ -478,43 +487,50 @@ def create_piece_list(world: World, player: int, options: LayoutGeneratorOptions for k in range(piece.height): for l in range(piece.width): piece.crossed_groups[k].append(-1) - screen_id = piece.main.grid[k][l] - if screen_id != -1: - piece.crossed_groups[k][l] = 1 if screen_id in crossed_group_b else 0 + screen = piece.main.screens[k][l] + if screen: + piece.crossed_groups[k][l] = 1 if screen.id in crossed_group_b else 0 else: if piece.parallel and piece.parallel.screens[k][l]: - piece.crossed_groups[k][l] = 1 if piece.parallel.grid[k][l] in crossed_group_b else 0 + piece.crossed_groups[k][l] = 1 if piece.parallel.screens[k][l].id in crossed_group_b else 0 return piece_list def create_piece(world: World, player: int, grid: List[List[int]], overworld_screens: Dict[int, Screen]) -> Piece: """ - Create piece from grid of screen IDs - Takes 2D array of screen IDs and creates main and parallel pieces + Create piece from grid of cell IDs + Takes 2D array of cell IDs and creates main and parallel pieces """ piece = Piece( - main=WorldPiece(screens=[]), + main=WorldPiece(), width=len(grid[0]), height=len(grid) ) if world.owParallel[player]: - piece.parallel = WorldPiece(screens=[]) + piece.parallel = WorldPiece() found_screens = set() for i in range(piece.height): new_row = [] + new_screen_row = [] new_row_parallel = [] - piece.main.screens.append(new_row) + new_screen_row_parallel = [] + piece.main.grid.append(new_row) + piece.main.screens.append(new_screen_row) if world.owParallel[player]: - piece.parallel.screens.append(new_row_parallel) + piece.parallel.grid.append(new_row_parallel) + piece.parallel.screens.append(new_screen_row_parallel) for j in range(piece.width): - screen = overworld_screens.get(grid[i][j]) - new_row.append(screen) - if world.owParallel[player]: - new_row_parallel.append(screen.parallel if screen else None) + cell_id = grid[i][j] + new_row.append(cell_id) + screen = overworld_screens.get(get_screen_id_from_cell(cell_id)) + new_screen_row.append(screen) + if world.owParallel[player] and screen: + new_row_parallel.append(cell_id - screen.id + screen.parallel.id) + new_screen_row_parallel.append(screen.parallel) if screen and screen not in found_screens: found_screens.add(screen) @@ -532,14 +548,14 @@ def create_piece(world: World, player: int, grid: List[List[int]], overworld_scr def add_piece_data(world: World, player: int, piece: Piece, large_screen_quadrant_info: Dict[int, Dict], large_screen_quadrant_info_land: Dict[int, Dict], large_screen_quadrant_info_water: Dict[int, Dict]) -> None: """ Add computed data to piece - Calls add_piece_grid_info for main and parallel pieces + Calls add_world_piece_edge_info for main and parallel pieces """ num_pieces = 2 if piece.parallel else 1 for p in range(num_pieces): world_piece = piece.main if p == 0 else piece.parallel - world_piece.width = len(world_piece.screens[0]) - world_piece.height = len(world_piece.screens) - add_piece_grid_info(world, player, world_piece, large_screen_quadrant_info, large_screen_quadrant_info_land, large_screen_quadrant_info_water) + world_piece.width = piece.width + world_piece.height = piece.height + add_world_piece_edge_info(world, player, world_piece, large_screen_quadrant_info, large_screen_quadrant_info_land, large_screen_quadrant_info_water) piece.width = piece.main.width piece.height = piece.main.height @@ -572,12 +588,11 @@ def add_piece_data(world: World, player: int, piece: Piece, large_screen_quadran piece.edge_sides = 0 piece.max_edges_per_side = 0 -def add_piece_grid_info(world: World, player: int, piece: WorldPiece, large_screen_quadrant_info: Dict[int, Dict], large_screen_quadrant_info_land: Dict[int, Dict], large_screen_quadrant_info_water: Dict[int, Dict]) -> None: +def add_world_piece_edge_info(world: World, player: int, piece: WorldPiece, large_screen_quadrant_info: Dict[int, Dict], large_screen_quadrant_info_land: Dict[int, Dict], large_screen_quadrant_info_water: Dict[int, Dict]) -> None: """ Populate piece edge information Initializes 8x8 edge arrays and extracts edges from screens """ - piece.grid = [[] for _ in range(8)] piece.north_edges = [[] for _ in range(8)] piece.south_edges = [[] for _ in range(8)] piece.west_edges = [[] for _ in range(8)] @@ -591,7 +606,6 @@ def add_piece_grid_info(world: World, player: int, piece: WorldPiece, large_scre for k in range(piece.height): for l in range(piece.width): - piece.grid[k].append(piece.screens[k][l].id if piece.screens[k][l] else -1) piece.north_edges[k].append([]) piece.south_edges[k].append([]) piece.west_edges[k].append([]) @@ -603,38 +617,41 @@ def add_piece_grid_info(world: World, player: int, piece: WorldPiece, large_scre piece.west_edges_water[k].append([]) piece.east_edges_water[k].append([]) - done_large = set() for k in range(piece.height): for l in range(piece.width): screen = piece.screens[k][l] if not screen: continue + cell_id = piece.grid[k][l] + if screen.big: - if screen.id not in done_large: - done_large.add(screen.id) - quadrant_info = (large_screen_quadrant_info[screen.id] if world.owTerrain[player] - else large_screen_quadrant_info_land[screen.id]) + # Determine quadrant by subtracting cell ID from screen ID + # 0x00 = NW (top-left), 0x01 = NE (top-right), 0x08 = SW (bottom-left), 0x09 = SE (bottom-right) + quadrant_offset = cell_id - screen.id + if quadrant_offset == 0x00: + quadrant_name = "NW" + elif quadrant_offset == 0x01: + quadrant_name = "NE" + elif quadrant_offset == 0x08: + quadrant_name = "SW" + else: + quadrant_name = "SE" - piece.north_edges[k][l] = [e for e in quadrant_info["NW"][Direction.North] if not e.dest] - piece.north_edges[k][l + 1] = [e for e in quadrant_info["NE"][Direction.North] if not e.dest] - piece.south_edges[k + 1][l] = [e for e in quadrant_info["SW"][Direction.South] if not e.dest] - piece.south_edges[k + 1][l + 1] = [e for e in quadrant_info["SE"][Direction.South] if not e.dest] - piece.west_edges[k][l] = [e for e in quadrant_info["NW"][Direction.West] if not e.dest] - piece.west_edges[k + 1][l] = [e for e in quadrant_info["SW"][Direction.West] if not e.dest] - piece.east_edges[k][l + 1] = [e for e in quadrant_info["NE"][Direction.East] if not e.dest] - piece.east_edges[k + 1][l + 1] = [e for e in quadrant_info["SE"][Direction.East] if not e.dest] + quadrant_info = (large_screen_quadrant_info[screen.id] if world.owTerrain[player] + else large_screen_quadrant_info_land[screen.id]) - if not world.owTerrain[player]: - quadrant_info = large_screen_quadrant_info_water[screen.id] - piece.north_edges_water[k][l] = [e for e in quadrant_info["NW"][Direction.North] if not e.dest] - piece.north_edges_water[k][l + 1] = [e for e in quadrant_info["NE"][Direction.North] if not e.dest] - piece.south_edges_water[k + 1][l] = [e for e in quadrant_info["SW"][Direction.South] if not e.dest] - piece.south_edges_water[k + 1][l + 1] = [e for e in quadrant_info["SE"][Direction.South] if not e.dest] - piece.west_edges_water[k][l] = [e for e in quadrant_info["NW"][Direction.West] if not e.dest] - piece.west_edges_water[k + 1][l] = [e for e in quadrant_info["SW"][Direction.West] if not e.dest] - piece.east_edges_water[k][l + 1] = [e for e in quadrant_info["NE"][Direction.East] if not e.dest] - piece.east_edges_water[k + 1][l + 1] = [e for e in quadrant_info["SE"][Direction.East] if not e.dest] + piece.north_edges[k][l] = [e for e in quadrant_info[quadrant_name][Direction.North] if not e.dest] + piece.south_edges[k][l] = [e for e in quadrant_info[quadrant_name][Direction.South] if not e.dest] + piece.west_edges[k][l] = [e for e in quadrant_info[quadrant_name][Direction.West] if not e.dest] + piece.east_edges[k][l] = [e for e in quadrant_info[quadrant_name][Direction.East] if not e.dest] + + if not world.owTerrain[player]: + quadrant_info_water = large_screen_quadrant_info_water[screen.id] + piece.north_edges_water[k][l] = [e for e in quadrant_info_water[quadrant_name][Direction.North] if not e.dest] + piece.south_edges_water[k][l] = [e for e in quadrant_info_water[quadrant_name][Direction.South] if not e.dest] + piece.west_edges_water[k][l] = [e for e in quadrant_info_water[quadrant_name][Direction.West] if not e.dest] + piece.east_edges_water[k][l] = [e for e in quadrant_info_water[quadrant_name][Direction.East] if not e.dest] else: for edge in sorted(screen.edges.values(), key=lambda e: e.midpoint): if not edge.dest: @@ -651,6 +668,19 @@ def add_piece_grid_info(world: World, player: int, piece: WorldPiece, large_scre target = piece.east_edges[k][l] if world.owTerrain[player] or edge.terrain != Terrain.Water else piece.east_edges_water[k][l] target.append(edge) +def get_screen_id_from_cell(cell_id: int) -> int: + """Get the base screen ID from a cell ID. + + For large screens, returns the top-left corner ID. + For small screens, returns the cell ID unchanged. + """ + base_id = cell_id & 0xBF # Remove world bit if present + # Check if this is a quadrant of a large screen + for large_id in large_screen_ids: + if base_id in [large_id, large_id + 0x01, large_id + 0x08, large_id + 0x09]: + return large_id | (cell_id & 0x40) # Preserve world bit + return cell_id + # ============================================================================ # PLACEMENT ALGORITHM # ============================================================================ @@ -1316,11 +1346,22 @@ def format_grid_for_spoiler(grid: List[List[int]]) -> str: return "\n".join(lines) def is_same_large_screen(grid: List[List[int]], row1: int, col1: int, row2: int, col2: int) -> bool: - id1 = grid[row1 % 8][col1 % 8] - id2 = grid[row2 % 8][col2 % 8] + """Checks if two adjacent cells belong to the same large screen with correct quadrant positions.""" + id1, id2 = grid[row1 % 8][col1 % 8], grid[row2 % 8][col2 % 8] if id1 == -1 or id2 == -1: return False - return id1 == id2 and id1 in large_screen_ids + base1, base2 = get_screen_id_from_cell(id1), get_screen_id_from_cell(id2) + if base1 != base2 or base1 not in large_screen_ids: + return False + # Get quadrant offsets (0x00=NW, 0x01=NE, 0x08=SW, 0x09=SE) + q1, q2 = (id1 & 0xBF) - (base1 & 0xBF), (id2 & 0xBF) - (base2 & 0xBF) + # Swap if cell2 is before cell1 + if col1 > col2 or row1 > row2: + q1, q2 = q2, q1 + # Check valid adjacency: east (0x00->0x01, 0x08->0x09) or south (0x00->0x08, 0x01->0x09) + if col1 != col2: + return (q1, q2) in [(0x00, 0x01), (0x08, 0x09)] + return (q1, q2) in [(0x00, 0x08), (0x01, 0x09)] # ============================================================================ # MAIN EXECUTION @@ -1347,6 +1388,7 @@ def generate_random_grid_layout(world: World, player: int, connected_edges: List options = LayoutGeneratorOptions( horizontal_wrap=horizontal_wrap, vertical_wrap=vertical_wrap, + split_large_screens=False, large_screen_pool=False, distortion_chance=0.0, random_order=6 if world.owParallel[player] else 12, @@ -1385,19 +1427,9 @@ def generate_random_grid_layout(world: World, player: int, connected_edges: List connect_edges_for_screen_layout(world, player, result.grid_info, options, connected_edges, prio_edges, overworld_screens, True) grid = result.grid_info.grid - # Make new grid containing cell IDs for the overworld map - map_grid = copy.deepcopy(grid) - for w in range(2): - for i in range(8): - for j in range(8): - screen_id = map_grid[w][i][j] - if screen_id in large_screen_ids and map_grid[w][i][(j + 1) % 8] == screen_id and map_grid[w][(i + 1) % 8][j] == screen_id and map_grid[w][(i + 1) % 8][(j + 1) % 8] == screen_id: - map_grid[w][i][(j + 1) % 8] = screen_id + 0x01 - map_grid[w][(i + 1) % 8][j] = screen_id + 0x08 - map_grid[w][(i + 1) % 8][(j + 1) % 8] = screen_id + 0x09 - world.owgrid[player] = map_grid - world.owlayoutmap_lw[player] = {id & 0xBF: i for i, id in enumerate(sum(map_grid[0], []))} - world.owlayoutmap_dw[player] = {id & 0xBF: i for i, id in enumerate(sum(map_grid[1], []))} + world.owgrid[player] = grid + world.owlayoutmap_lw[player] = {id & 0xBF: i for i, id in enumerate(sum(grid[0], []))} + world.owlayoutmap_dw[player] = {id & 0xBF: i for i, id in enumerate(sum(grid[1], []))} world.spoiler.set_map('layout_grid_lw', format_grid_for_spoiler(grid[0]), grid[0], player) if not world.owParallel[player]: diff --git a/source/overworld/LayoutVisualizer.py b/source/overworld/LayoutVisualizer.py index 8dbdea34..f76ddc58 100644 --- a/source/overworld/LayoutVisualizer.py +++ b/source/overworld/LayoutVisualizer.py @@ -4,7 +4,18 @@ from datetime import datetime from typing import Dict, List from PIL import Image, ImageDraw from BaseClasses import Direction, OWEdge -from source.overworld.LayoutGenerator import Screen +from source.overworld.LayoutGenerator import Screen, get_screen_id_from_cell + +def get_quadrant_from_cell_id(cell_id: int, screen_id: int) -> str: + offset = (cell_id & 0xBF) - (screen_id & 0xBF) + if offset == 0x00: + return "NW" + elif offset == 0x01: + return "NE" + elif offset == 0x08: + return "SW" + else: + return "SE" def get_edge_lists(grid: List[List[List[int]]], overworld_screens: Dict[int, Screen], @@ -13,7 +24,7 @@ def get_edge_lists(grid: List[List[List[int]]], Get list of edges for each cell and direction. Args: - grid: 3D list [world][row][col] containing screen IDs + grid: 3D list [world][row][col] containing cell IDs overworld_screens: Dict of screen_id -> Screen objects large_screen_quadrant_info: Dict of screen_id -> quadrant info for large screens @@ -24,47 +35,27 @@ def get_edge_lists(grid: List[List[List[int]]], GRID_SIZE = 8 edge_lists = {} - # Large screen base IDs - large_screen_base_ids = [0x00, 0x03, 0x05, 0x18, 0x1B, 0x1E, 0x30, 0x35, - 0x40, 0x43, 0x45, 0x58, 0x5B, 0x5E, 0x70, 0x75] - for world_idx in range(2): - # Build a map of screen_id -> list of (row, col) positions for large screens - large_screen_positions = {} for row in range(GRID_SIZE): for col in range(GRID_SIZE): - screen_id = grid[world_idx][row][col] - if screen_id != -1 and screen_id in large_screen_base_ids: - if screen_id not in large_screen_positions: - large_screen_positions[screen_id] = [] - large_screen_positions[screen_id].append((row, col)) + cell_id = grid[world_idx][row][col] - for row in range(GRID_SIZE): - for col in range(GRID_SIZE): - screen_id = grid[world_idx][row][col] - - if screen_id == -1: + if cell_id == -1: # Empty cell - no edges for direction in [Direction.North, Direction.South, Direction.East, Direction.West]: edge_lists[(world_idx, row, col, direction)] = [] continue + screen_id = get_screen_id_from_cell(cell_id) screen = overworld_screens.get(screen_id) if not screen: for direction in [Direction.North, Direction.South, Direction.East, Direction.West]: edge_lists[(world_idx, row, col, direction)] = [] continue - is_large = screen_id in large_screen_base_ids - - if is_large: - # For large screens, determine which quadrant this cell is - # Find all positions of this large screen and determine quadrant - positions = large_screen_positions.get(screen_id, [(row, col)]) - - # Determine quadrant by finding relative position - # The quadrant is determined by which cells are adjacent - quadrant = determine_large_screen_quadrant(row, col, positions, GRID_SIZE) + if screen.big: + # For large screens, determine quadrant from cell ID + quadrant = get_quadrant_from_cell_id(cell_id, screen_id) # Get edges for this quadrant if screen_id in large_screen_quadrant_info: @@ -85,45 +76,6 @@ def get_edge_lists(grid: List[List[List[int]]], return edge_lists -def determine_large_screen_quadrant(row: int, col: int, positions: List[tuple], grid_size: int) -> str: - """ - Determine which quadrant (NW, NE, SW, SE) a cell is in for a large screen. - Handles wrapping correctly by checking adjacency patterns. - - Args: - row: Current cell row - col: Current cell column - positions: List of all (row, col) positions for this large screen - grid_size: Size of the grid (8) - - Returns: - Quadrant string: "NW", "NE", "SW", or "SE" - """ - positions_set = set(positions) - - # Check which adjacent cells also belong to this large screen - has_right = ((row, (col + 1) % grid_size) in positions_set) - has_below = (((row + 1) % grid_size, col) in positions_set) - has_left = ((row, (col - 1) % grid_size) in positions_set) - has_above = (((row - 1) % grid_size, col) in positions_set) - - # Determine quadrant based on adjacency - # NW: has right and below neighbors - # NE: has left and below neighbors - # SW: has right and above neighbors - # SE: has left and above neighbors - - if has_right and has_below: - return "NW" - elif has_left and has_below: - return "NE" - elif has_right and has_above: - return "SW" - elif has_left and has_above: - return "SE" - else: - raise Exception("?") - def is_crossed_edge(edge: OWEdge, overworld_screens: Dict[int, Screen]) -> bool: if edge.dest is None: return False @@ -132,6 +84,40 @@ def is_crossed_edge(edge: OWEdge, overworld_screens: Dict[int, Screen]) -> bool: dest_screen = overworld_screens.get(edge.dest.owIndex) return source_screen.dark_world != dest_screen.dark_world +def are_large_screen_cells_connected(cell_id1: int, cell_id2: int, quadrant1: str, quadrant2: str, direction: str) -> bool: + """ + Check if two cells of a large screen are connected (should have no border between them). + + For cells to be connected: + 1. They must be from the same large screen (same base screen ID) + 2. Their quadrants must be adjacent in the expected direction + + Args: + cell_id1: Cell ID of the first cell + cell_id2: Cell ID of the second cell + quadrant1: Quadrant of the first cell ("NW", "NE", "SW", "SE") + quadrant2: Quadrant of the second cell + direction: Direction from cell1 to cell2 ("east", "south") + + Returns: + True if the cells should have no border between them + """ + # Must be from the same large screen + screen_id1 = get_screen_id_from_cell(cell_id1) + screen_id2 = get_screen_id_from_cell(cell_id2) + if screen_id1 != screen_id2: + return False + + # Check if quadrants are properly adjacent + if direction == "east": + # For east connection: NW->NE or SW->SE + return (quadrant1 == "NW" and quadrant2 == "NE") or (quadrant1 == "SW" and quadrant2 == "SE") + elif direction == "south": + # For south connection: NW->SW or NE->SE + return (quadrant1 == "NW" and quadrant2 == "SW") or (quadrant1 == "NE" and quadrant2 == "SE") + + return False + def visualize_layout(grid: List[List[List[int]]], output_dir: str, overworld_screens: Dict[int, Screen], large_screen_quadrant_info: Dict[int, Dict]) -> None: @@ -162,78 +148,42 @@ def visualize_layout(grid: List[List[List[int]]], output_dir: str, output_height = world_height output_img = Image.new('RGB', (output_width, output_height), color='black') - # Large screen base IDs (defined once for reuse) - large_screen_base_ids = [0x00, 0x03, 0x05, 0x18, 0x1B, 0x1E, 0x30, 0x35, - 0x40, 0x43, 0x45, 0x58, 0x5B, 0x5E, 0x70, 0x75] - # Process both worlds for world_idx in range(2): x_offset = 0 if world_idx == 0 else (world_width + gap) - # Build a map of screen_id -> list of (row, col) positions for large screens - large_screen_positions = {} - for row in range(GRID_SIZE): - for col in range(GRID_SIZE): - screen_id = grid[world_idx][row][col] - if screen_id != -1 and screen_id in large_screen_base_ids: - if screen_id not in large_screen_positions: - large_screen_positions[screen_id] = [] - large_screen_positions[screen_id].append((row, col)) - # Process each cell in the grid individually - # This handles wrapped large screens correctly by drawing each quadrant separately for row in range(GRID_SIZE): for col in range(GRID_SIZE): - screen_id = grid[world_idx][row][col] + cell_id = grid[world_idx][row][col] - if screen_id == -1: + if cell_id == -1: # Empty cell - fill with black (already black from initialization) continue - is_large = screen_id in large_screen_base_ids + screen_id = get_screen_id_from_cell(cell_id) + screen = overworld_screens.get(screen_id) + if not screen: + continue - # Calculate source position in the world image - source_row = (screen_id % 0x40) >> 3 - source_col = screen_id % 0x08 - world_img = lightworld_img if screen_id < 0x40 else darkworld_img + is_large = screen.big - if is_large: - # For large screens, determine which quadrant this cell represents - positions = large_screen_positions.get(screen_id, [(row, col)]) - quadrant = determine_large_screen_quadrant(row, col, positions, GRID_SIZE) + # Calculate source position in the world image based on cell_id + # For large screens, cell_id already encodes the quadrant position + source_row = (cell_id % 0x40) >> 3 + source_col = cell_id % 0x08 + world_img = lightworld_img if cell_id < 0x40 else darkworld_img - # Map quadrant to source offset within the 2x2 large screen - quadrant_offsets = { - "NW": (0, 0), - "NE": (1, 0), - "SW": (0, 1), - "SE": (1, 1) - } - q_col_offset, q_row_offset = quadrant_offsets[quadrant] + source_x = source_col * SOURCE_CELL_SIZE + source_y = source_row * SOURCE_CELL_SIZE - # Calculate source position for this quadrant - source_x = (source_col + q_col_offset) * SOURCE_CELL_SIZE - source_y = (source_row + q_row_offset) * SOURCE_CELL_SIZE - - # Crop single cell from source (the specific quadrant) - cropped = world_img.crop(( - source_x, - source_y, - source_x + SOURCE_CELL_SIZE, - source_y + SOURCE_CELL_SIZE - )) - else: - # Small screen (1x1) - source_x = source_col * SOURCE_CELL_SIZE - source_y = source_row * SOURCE_CELL_SIZE - - # Crop single cell from source - cropped = world_img.crop(( - source_x, - source_y, - source_x + SOURCE_CELL_SIZE, - source_y + SOURCE_CELL_SIZE - )) + # Crop single cell from source + cropped = world_img.crop(( + source_x, + source_y, + source_x + SOURCE_CELL_SIZE, + source_y + SOURCE_CELL_SIZE + )) # Resize to output size (64x64 pixels) resized = cropped.resize( @@ -257,52 +207,93 @@ def visualize_layout(grid: List[List[List[int]]], output_dir: str, for world_idx in range(2): x_offset = 0 if world_idx == 0 else (world_width + gap) - # Build large screen positions map for this world - large_screen_positions = {} - for row in range(GRID_SIZE): - for col in range(GRID_SIZE): - screen_id = grid[world_idx][row][col] - if screen_id != -1 and screen_id in large_screen_base_ids: - if screen_id not in large_screen_positions: - large_screen_positions[screen_id] = [] - large_screen_positions[screen_id].append((row, col)) - # Draw borders for each cell + # For large screens, only draw borders where cells are not connected for row in range(GRID_SIZE): for col in range(GRID_SIZE): - screen_id = grid[world_idx][row][col] + cell_id = grid[world_idx][row][col] - if screen_id == -1: + if cell_id == -1: continue - is_large = screen_id in large_screen_base_ids + screen_id = get_screen_id_from_cell(cell_id) + screen = overworld_screens.get(screen_id) + if not screen: + continue + + is_large = screen.big dest_x = x_offset + col * OUTPUT_CELL_SIZE dest_y = row * OUTPUT_CELL_SIZE if is_large: - # For large screens, determine which quadrant this cell is - positions = large_screen_positions.get(screen_id, [(row, col)]) - quadrant = determine_large_screen_quadrant(row, col, positions, GRID_SIZE) + quadrant = get_quadrant_from_cell_id(cell_id, screen_id) - # Draw border only on the outer edges of the large screen - # (not on internal edges between quadrants) - # NW: draw top and left borders - # NE: draw top and right borders - # SW: draw bottom and left borders - # SE: draw bottom and right borders - - if quadrant in ["NW", "NE"]: - # Draw top border - draw.line([(dest_x, dest_y), (dest_x + OUTPUT_CELL_SIZE - 1, dest_y)], fill='black', width=BORDER_WIDTH) + # Check each border direction + # Top border: draw if this is a north quadrant OR if the cell above is not connected + draw_top = True if quadrant in ["SW", "SE"]: - # Draw bottom border - draw.line([(dest_x, dest_y + OUTPUT_CELL_SIZE - 1), (dest_x + OUTPUT_CELL_SIZE - 1, dest_y + OUTPUT_CELL_SIZE - 1)], fill='black', width=BORDER_WIDTH) - if quadrant in ["NW", "SW"]: - # Draw left border - draw.line([(dest_x, dest_y), (dest_x, dest_y + OUTPUT_CELL_SIZE - 1)], fill='black', width=BORDER_WIDTH) + # Check if cell above is connected + above_row = (row - 1) % GRID_SIZE + above_cell_id = grid[world_idx][above_row][col] + if above_cell_id != -1: + above_screen_id = get_screen_id_from_cell(above_cell_id) + above_screen = overworld_screens.get(above_screen_id) + if above_screen and above_screen.big: + above_quadrant = get_quadrant_from_cell_id(above_cell_id, above_screen_id) + if are_large_screen_cells_connected(above_cell_id, cell_id, above_quadrant, quadrant, "south"): + draw_top = False + + # Bottom border: draw if this is a south quadrant OR if the cell below is not connected + draw_bottom = True + if quadrant in ["NW", "NE"]: + # Check if cell below is connected + below_row = (row + 1) % GRID_SIZE + below_cell_id = grid[world_idx][below_row][col] + if below_cell_id != -1: + below_screen_id = get_screen_id_from_cell(below_cell_id) + below_screen = overworld_screens.get(below_screen_id) + if below_screen and below_screen.big: + below_quadrant = get_quadrant_from_cell_id(below_cell_id, below_screen_id) + if are_large_screen_cells_connected(cell_id, below_cell_id, quadrant, below_quadrant, "south"): + draw_bottom = False + + # Left border: draw if this is a west quadrant OR if the cell to the left is not connected + draw_left = True if quadrant in ["NE", "SE"]: - # Draw right border + # Check if cell to the left is connected + left_col = (col - 1) % GRID_SIZE + left_cell_id = grid[world_idx][row][left_col] + if left_cell_id != -1: + left_screen_id = get_screen_id_from_cell(left_cell_id) + left_screen = overworld_screens.get(left_screen_id) + if left_screen and left_screen.big: + left_quadrant = get_quadrant_from_cell_id(left_cell_id, left_screen_id) + if are_large_screen_cells_connected(left_cell_id, cell_id, left_quadrant, quadrant, "east"): + draw_left = False + + # Right border: draw if this is an east quadrant OR if the cell to the right is not connected + draw_right = True + if quadrant in ["NW", "SW"]: + # Check if cell to the right is connected + right_col = (col + 1) % GRID_SIZE + right_cell_id = grid[world_idx][row][right_col] + if right_cell_id != -1: + right_screen_id = get_screen_id_from_cell(right_cell_id) + right_screen = overworld_screens.get(right_screen_id) + if right_screen and right_screen.big: + right_quadrant = get_quadrant_from_cell_id(right_cell_id, right_screen_id) + if are_large_screen_cells_connected(cell_id, right_cell_id, quadrant, right_quadrant, "east"): + draw_right = False + + # Draw the borders + if draw_top: + draw.line([(dest_x, dest_y), (dest_x + OUTPUT_CELL_SIZE - 1, dest_y)], fill='black', width=BORDER_WIDTH) + if draw_bottom: + draw.line([(dest_x, dest_y + OUTPUT_CELL_SIZE - 1), (dest_x + OUTPUT_CELL_SIZE - 1, dest_y + OUTPUT_CELL_SIZE - 1)], fill='black', width=BORDER_WIDTH) + if draw_left: + draw.line([(dest_x, dest_y), (dest_x, dest_y + OUTPUT_CELL_SIZE - 1)], fill='black', width=BORDER_WIDTH) + if draw_right: draw.line([(dest_x + OUTPUT_CELL_SIZE - 1, dest_y), (dest_x + OUTPUT_CELL_SIZE - 1, dest_y + OUTPUT_CELL_SIZE - 1)], fill='black', width=BORDER_WIDTH) else: # Small screen - draw border around single cell @@ -315,8 +306,8 @@ def visualize_layout(grid: List[List[List[int]]], output_dir: str, # Draw edge connection indicators for each cell for row in range(GRID_SIZE): for col in range(GRID_SIZE): - screen_id = grid[world_idx][row][col] - if screen_id == -1: + cell_id = grid[world_idx][row][col] + if cell_id == -1: continue dest_x = x_offset + col * OUTPUT_CELL_SIZE From d3f8e5fd58859713d6d528e82e88f3099a94cede Mon Sep 17 00:00:00 2001 From: aerinon Date: Tue, 3 Feb 2026 13:17:42 -0700 Subject: [PATCH 13/34] fix: key counts when door shuffle is off --- Main.py | 2 +- PastReleaseNotes.md | 3 +++ RELEASENOTES.md | 6 +++--- Rom.py | 6 ++++++ index.md | 10 +++++----- 5 files changed, 18 insertions(+), 9 deletions(-) diff --git a/Main.py b/Main.py index 3099c0b0..3e3a3952 100644 --- a/Main.py +++ b/Main.py @@ -38,7 +38,7 @@ from source.enemizer.DamageTables import DamageTable from source.enemizer.Enemizer import randomize_enemies from source.rom.DataTables import init_data_tables -version_number = '1.5.4' +version_number = '1.5.5' version_branch = '-u' __version__ = f'{version_number}{version_branch}' diff --git a/PastReleaseNotes.md b/PastReleaseNotes.md index 7cae577d..e2915b60 100644 --- a/PastReleaseNotes.md +++ b/PastReleaseNotes.md @@ -10,6 +10,9 @@ # Patch Notes Changelog archive +* 1.5.4 + * Documentation: New AI-assisted documentation [Site](https://aerinon.github.io/ALttPDoorRandomizer) + * Generation Error: Fixed Issue with Shop Code and Take Any Caves (thanks Codemann for assistance) * 1.5.3 * Logic: Key logic fix for part of a dungeon located at Skull 3 (or other similar restricted entrancs). Appropriate key logic was not being applied, causing progression issues. This mostly affect crosskey style seeds. * Standard: Rupee balancing algorithm can no longer switch out the weapon on uncle for money. diff --git a/RELEASENOTES.md b/RELEASENOTES.md index ae96add3..55a2d0b3 100644 --- a/RELEASENOTES.md +++ b/RELEASENOTES.md @@ -1,6 +1,6 @@ # Patch Notes -* 1.5.4 - * Documentation: New AI-assisted documentation [Site (I really hope this works)](https//aerinon.github.io/ALttPDoorRandomizer) - * Generation Error: Fixed Issue with Shop Code and Take Any Caves (thanks Codemann for assistance) +* 1.5.5 + * HUD: Key counters are correct even when door shuffle is off + diff --git a/Rom.py b/Rom.py index e56b6985..66436210 100644 --- a/Rom.py +++ b/Rom.py @@ -646,6 +646,12 @@ def patch_rom(world, rom, player, team, is_mystery=False): for room in world.rooms: if room.player == player and room.palette is not None: rom.write_byte(0x13f200+room.index, room.palette) + else: + if world.keyshuffle[player] != 'universal': + for name, layout in world.key_layout[player].items(): + offset = compass_data[name][4]//2 + rom.write_byte(0x13f020+offset, layout.max_chests + layout.max_drops) # not currently used + rom.write_byte(0x187010+offset, layout.max_chests) if world.doorShuffle[player] == 'basic': rom.write_byte(0x138002, 1) for door in world.doors: diff --git a/index.md b/index.md index a7b5e9fe..8e3843ae 100644 --- a/index.md +++ b/index.md @@ -68,11 +68,11 @@ Join the discussion and get help: ## Learn More -- [Features Guide](/features) - Comprehensive feature documentation -- [Installation & Usage](/installation) - Setup and running the randomizer -- [Known Issues](/known-issues) - Current bugs and limitations -- [Roadmap](/roadmap) - Future development plans -- [Blog](/blog) - Latest updates and release notes +- [Features Guide](/features.html) - Comprehensive feature documentation +- [Installation & Usage](/installation.html) - Setup and running the randomizer +- [Known Issues](/known-issues.html) - Current bugs and limitations +- [Roadmap](/roadmap.html) - Future development plans +- [Blog](/blog.html) - Latest updates and release notes ## Credits From 27acabadeff3edd05e76faad65c0da5aff440770 Mon Sep 17 00:00:00 2001 From: aerinon Date: Tue, 3 Feb 2026 13:22:02 -0700 Subject: [PATCH 14/34] doc: update known issues --- known-issues.md | 7 ------- 1 file changed, 7 deletions(-) diff --git a/known-issues.md b/known-issues.md index 20093d57..15b3daeb 100644 --- a/known-issues.md +++ b/known-issues.md @@ -52,13 +52,6 @@ When reporting a bug, please provide: ### Critical Issues -#### Dungeon Key HUD indicator - -**Status**: Under investigation - -Dungeon Key HUD indicator shows incorrect total number of keys under certain settings. - - #### Links House on Death Mountain - no logical way off the mountain **Status**: Under investigation From 0133bd1da78e679347797023078a11e5f65f11de Mon Sep 17 00:00:00 2001 From: Catobat <69204835+Catobat@users.noreply.github.com> Date: Tue, 3 Feb 2026 22:46:58 +0100 Subject: [PATCH 15/34] Implement piece merging --- source/overworld/LayoutGenerator.py | 368 +++++++++++++++++++++------- 1 file changed, 274 insertions(+), 94 deletions(-) diff --git a/source/overworld/LayoutGenerator.py b/source/overworld/LayoutGenerator.py index d2245ac7..8f87f098 100644 --- a/source/overworld/LayoutGenerator.py +++ b/source/overworld/LayoutGenerator.py @@ -1,4 +1,5 @@ import logging +from DungeonGenerator import GenerationException import RaceRandom as random import random as _random from typing import List, Dict, Optional, Set, Tuple @@ -6,7 +7,6 @@ from BaseClasses import OWEdge, World, Direction, Terrain from OverworldShuffle import connect_two_way, validate_layout ENABLE_KEEP_SIMILAR_SPECIAL_HANDLING = False -PREVENT_WRAPPED_LARGE_SCREENS = False DRAW_IMAGE = True large_screen_ids = [0x00, 0x03, 0x05, 0x18, 0x1B, 0x1E, 0x30, 0x35] + [0x40, 0x43, 0x45, 0x58, 0x5B, 0x5E, 0x70, 0x75] @@ -78,8 +78,7 @@ class Piece: """ Represents a piece consisting of a main and optionally a parallel world piece. """ - __slots__ = ('main', 'parallel', 'world', 'width', 'height', - 'invalid_wrap_row', 'invalid_wrap_column', 'restriction', + __slots__ = ('main', 'parallel', 'world', 'width', 'height', 'restriction', 'crossed_groups', 'delay', 'order', 'edge_sides', 'max_edges_per_side') def __init__( @@ -89,8 +88,6 @@ class Piece: world: int = 0, width: int = 0, height: int = 0, - invalid_wrap_row: Optional[List[int]] = None, - invalid_wrap_column: Optional[List[int]] = None, restriction: Optional[List[int]] = None, crossed_groups: Optional[List[List[int]]] = None, delay: int = 0, @@ -103,8 +100,6 @@ class Piece: self.world = world # 0 or 1 self.width = width self.height = height - self.invalid_wrap_row = invalid_wrap_row if invalid_wrap_row is not None else [] - self.invalid_wrap_column = invalid_wrap_column if invalid_wrap_column is not None else [] self.restriction = restriction self.crossed_groups = crossed_groups if crossed_groups is not None else [] self.delay = delay @@ -400,74 +395,42 @@ def define_large_screen_quadrants( def create_piece_list(world: World, player: int, options: LayoutGeneratorOptions, crossed_group_b: List[int], overworld_screens: Dict[int, Screen], large_screen_quadrant_info: Dict[int, Dict], large_screen_quadrant_info_land: Dict[int, Dict], large_screen_quadrant_info_water: Dict[int, Dict]) -> List[Piece]: piece_list: List[Piece] = [] - used_screens_set = set() - - all_large_screens = [s for s in overworld_screens.values() if s.big] - all_small_screens = [s for s in overworld_screens.values() if not s.big] + # Determine which screens to process + all_screens = list(overworld_screens.values()) if world.owParallel[player]: # In Parallel, only use light world screens # Each piece will automatically handle both worlds through parallel mechanism - all_large_screens = [s for s in all_large_screens if not s.dark_world] - all_small_screens = [s for s in all_small_screens if not s.dark_world] + all_screens = [s for s in all_screens if not s.dark_world] - # In Standard mode, screens 0x1B, 0x2B, 0x2C are glued together as a single piece - if world.mode[player] == 'standard': - castle_screen = overworld_screens.get(0x1B) - central_bonk_screen = overworld_screens.get(0x2B) - links_house_screen = overworld_screens.get(0x2C) - - if castle_screen and central_bonk_screen and links_house_screen: - piece = create_piece(world, player, [ - [0x1B, 0x1C], - [0x23, 0x24], - [0x2B, 0x2C] - ], overworld_screens) - - if options.large_screen_pool: - piece.restriction = [0x00, 0x03, 0x05, 0x18, 0x1B, 0x1E, 0x30, 0x35] - - piece_list.append(piece) - used_screens_set.add(castle_screen) - used_screens_set.add(central_bonk_screen) - used_screens_set.add(links_house_screen) - - if world.owParallel[player]: - used_screens_set.add(castle_screen.parallel) - used_screens_set.add(central_bonk_screen.parallel) - used_screens_set.add(links_house_screen.parallel) - - # Add large screens - for screen in all_large_screens: - if screen not in used_screens_set: - base_id = screen.id - if options.split_large_screens: - for quadrant_offset in [0x00, 0x01, 0x08, 0x09]: - piece = create_piece(world, player, [[base_id + quadrant_offset]], overworld_screens) - if options.large_screen_pool: - piece.restriction = [large_screen_id + quadrant_offset for large_screen_id in [0x00, 0x03, 0x05, 0x18, 0x1B, 0x1E, 0x30, 0x35]] - piece_list.append(piece) - else: - piece = create_piece(world, player, [[base_id, base_id + 0x01], [base_id + 0x08, base_id + 0x09]], overworld_screens) + # Phase 1: Create individual 1x1 pieces for all cells + for screen in all_screens: + if screen.big: + # Create 4 pieces for large screen quadrants + for offset in [0x00, 0x01, 0x08, 0x09]: + piece = create_piece(world, player, [[screen.id + offset]], overworld_screens) if options.large_screen_pool: - piece.restriction = [0x00, 0x03, 0x05, 0x18, 0x1B, 0x1E, 0x30, 0x35] + piece.restriction = [large_id + offset for large_id in [0x00, 0x03, 0x05, 0x18, 0x1B, 0x1E, 0x30, 0x35]] piece_list.append(piece) - used_screens_set.add(screen) - if world.owParallel[player]: - used_screens_set.add(screen.parallel) - - # Add small screens - for screen in all_small_screens: - if screen not in used_screens_set: + else: piece = create_piece(world, player, [[screen.id]], overworld_screens) if options.large_screen_pool: piece.restriction = [s.id for s in overworld_screens.values() if not s.big] piece_list.append(piece) - used_screens_set.add(screen) - if world.owParallel[player]: - used_screens_set.add(screen.parallel) - # Add piece data + # Phase 2: Apply options via merging + + # Merge large screens if not split + if not options.split_large_screens: + for large_id in large_screen_ids: + if large_id in [s.id for s in all_screens if s.big]: + piece_list = merge_pieces(piece_list, [[large_id, large_id + 0x01], [large_id + 0x08, large_id + 0x09]], world, player, overworld_screens) + + # Standard mode: merge castle area + if world.mode[player] == 'standard': + piece_list = merge_pieces(piece_list, [[0x23, 0x24], [0x2B, 0x2C]], world, player, overworld_screens) + + # Phase 3: Add piece data for piece in piece_list: add_piece_data(world, player, piece, large_screen_quadrant_info, large_screen_quadrant_info_land, large_screen_quadrant_info_water) # Handle crossed groups @@ -502,13 +465,13 @@ def create_piece(world: World, player: int, grid: List[List[int]], overworld_scr Takes 2D array of cell IDs and creates main and parallel pieces """ piece = Piece( - main=WorldPiece(), + main=WorldPiece(width=len(grid[0]), height=len(grid)), width=len(grid[0]), height=len(grid) ) if world.owParallel[player]: - piece.parallel = WorldPiece() + piece.parallel = WorldPiece(width=len(grid[0]), height=len(grid)) found_screens = set() @@ -526,25 +489,254 @@ def create_piece(world: World, player: int, grid: List[List[int]], overworld_scr for j in range(piece.width): cell_id = grid[i][j] new_row.append(cell_id) - screen = overworld_screens.get(get_screen_id_from_cell(cell_id)) - new_screen_row.append(screen) - if world.owParallel[player] and screen: - new_row_parallel.append(cell_id - screen.id + screen.parallel.id) - new_screen_row_parallel.append(screen.parallel) - - if screen and screen not in found_screens: + screen = None if cell_id == -1 else overworld_screens.get(get_screen_id_from_cell(cell_id)) + if screen: found_screens.add(screen) - piece.world = 1 if screen.dark_world else 0 - if screen.big and PREVENT_WRAPPED_LARGE_SCREENS: - # For large screens, prevent wrapping at the second row/column - # This ensures the 2x2 piece doesn't split across the grid boundary - if (i + 1) not in piece.invalid_wrap_row: - piece.invalid_wrap_row.append(i + 1) - if (j + 1) not in piece.invalid_wrap_column: - piece.invalid_wrap_column.append(j + 1) + new_screen_row.append(screen) + if world.owParallel[player]: + if screen: + new_row_parallel.append(cell_id - screen.id + screen.parallel.id) + new_screen_row_parallel.append(screen.parallel) + else: + new_row_parallel.append(-1) + new_screen_row_parallel.append(None) + + worlds = set(s.dark_world for s in found_screens if s is not None) + if len(worlds) != 1: + raise GenerationException("Piece contains screens from both Light World and Dark World") + piece.world = 1 if True in worlds else 0 return piece +def get_piece_cells(piece: Piece) -> Set[int]: + """Get all cell IDs contained in a piece.""" + cells = set() + for row in piece.main.grid: + for cell in row: + if cell != -1: + cells.add(cell) + return cells + +def expand_arrangement(arrangement: List[List[int]], pieces: List[Piece]) -> List[List[int]]: + """ + Expand an arrangement to include all cells from the pieces being merged. + + When merging pieces, if a piece contains cells not in the original arrangement, + we need to expand the arrangement to include those cells in their correct + relative positions. + + Raises an exception if the relative positions of cells within pieces conflict + with the requested arrangement (e.g., contradictory merge operations). + """ + # Build a mapping of cell_id -> (row, col) for all cells in all pieces + # relative to a common coordinate system + cell_positions: Dict[int, Tuple[int, int]] = {} + # Also track position -> cell_id to detect when two cells would occupy the same position + position_to_cell: Dict[Tuple[int, int], int] = {} + + # First, map cells from the original arrangement + for i, row in enumerate(arrangement): + for j, cell in enumerate(row): + if cell != -1: + cell_positions[cell] = (i, j) + position_to_cell[(i, j)] = cell + + # For each piece, determine where its cells should go + for piece in pieces: + # Find a cell that's already in our arrangement to anchor this piece + anchor_cell = None + anchor_piece_pos = None + for i, row in enumerate(piece.main.grid): + for j, cell in enumerate(row): + if cell != -1 and cell in cell_positions: + anchor_cell = cell + anchor_piece_pos = (i, j) + break + if anchor_cell is not None: + break + + # Calculate offset between piece coordinates and arrangement coordinates + anchor_arr_pos = cell_positions[anchor_cell] + offset_row = anchor_arr_pos[0] - anchor_piece_pos[0] + offset_col = anchor_arr_pos[1] - anchor_piece_pos[1] + + # Add all cells from this piece to cell_positions, checking for conflicts + for i, row in enumerate(piece.main.grid): + for j, cell in enumerate(row): + if cell != -1: + new_pos = (i + offset_row, j + offset_col) + if cell in cell_positions: + # Cell already has a position - verify it's consistent + if cell_positions[cell] != new_pos: + raise GenerationException( + f"Cannot merge: cell 0x{cell:02X} has conflicting positions. " + f"Existing position {cell_positions[cell]} conflicts with " + f"position {new_pos} from piece containing cells " + f"{[c for row in piece.main.grid for c in row if c != -1]}. " + f"This indicates contradictory merge operations." + ) + elif new_pos in position_to_cell: + # Position is already occupied by a different cell + existing_cell = position_to_cell[new_pos] + raise GenerationException( + f"Cannot merge: cell 0x{cell:02X} would be placed at position {new_pos}, " + f"but that position is already occupied by cell 0x{existing_cell:02X}. " + f"This indicates contradictory merge operations." + ) + else: + cell_positions[cell] = new_pos + position_to_cell[new_pos] = cell + + # Find the bounding box of all cells + if not cell_positions: + return arrangement + + min_row = min(pos[0] for pos in cell_positions.values()) + max_row = max(pos[0] for pos in cell_positions.values()) + min_col = min(pos[1] for pos in cell_positions.values()) + max_col = max(pos[1] for pos in cell_positions.values()) + + # Create new arrangement with normalized coordinates + new_height = max_row - min_row + 1 + new_width = max_col - min_col + 1 + new_arrangement = [[-1] * new_width for _ in range(new_height)] + + for cell, (row, col) in cell_positions.items(): + new_arrangement[row - min_row][col - min_col] = cell + + return new_arrangement + +def calculate_merged_restrictions(pieces: List[Piece], arrangement: List[List[int]]) -> Optional[List[int]]: + """ + Calculate restrictions for the merged piece. + + For each piece with restrictions, we translate the restrictions to account + for the piece's position in the merged arrangement. The final restriction + is the intersection of all translated restrictions. + + For example, when merging 4 quadrant pieces into a 2x2: + - NW piece (at position 0,0) has restrictions like [0x00, 0x03, ...] - no translation needed + - NE piece (at position 0,1) has restrictions like [0x01, 0x04, ...] - translate left by 1 + - SW piece (at position 1,0) has restrictions like [0x08, 0x0B, ...] - translate up by 1 + - SE piece (at position 1,1) has restrictions like [0x09, 0x0C, ...] - translate up and left by 1 + + After translation, all should give [0x00, 0x03, 0x05, 0x18, 0x1B, 0x1E, 0x30, 0x35] + """ + if not any(p.restriction for p in pieces): + return None + + # Build mapping from cell to position in arrangement + cell_to_new_pos = {} + for i, row in enumerate(arrangement): + for j, cell in enumerate(row): + if cell != -1: + cell_to_new_pos[cell] = (i, j) + + # For each piece, translate its restrictions + translated_restrictions = [] + for piece in pieces: + if piece.restriction is None: + continue + + # Find the first cell in this piece and its position in the arrangement + piece_cell = None + piece_old_pos = None + for i, row in enumerate(piece.main.grid): + for j, cell in enumerate(row): + if cell != -1 and cell in cell_to_new_pos: + piece_cell = cell + piece_old_pos = (i, j) + break + if piece_cell is not None: + break + + if piece_cell is None: + continue + + new_pos = cell_to_new_pos[piece_cell] + # The offset is how much we need to shift the restriction positions + # to get the top-left corner position of the merged piece + offset_row = new_pos[0] - piece_old_pos[0] + offset_col = new_pos[1] - piece_old_pos[1] + + # Translate restrictions: shift each restriction position back by the offset + # to get the position where the merged piece's top-left corner would be + translated = [] + for r in piece.restriction: + r_row = r // 8 + r_col = r % 8 + new_r_row = r_row - offset_row + new_r_col = r_col - offset_col + if 0 <= new_r_row < 8 and 0 <= new_r_col < 8: + translated.append(new_r_row * 8 + new_r_col) + translated_restrictions.append(set(translated)) + + # Intersection of all translated restrictions + result = translated_restrictions[0] + for tr in translated_restrictions[1:]: + result &= tr + + return list(result) + +def merge_pieces(piece_list: List[Piece], arrangement: List[List[int]], world: World, player: int, overworld_screens: Dict[int, Screen]) -> List[Piece]: + """ + Merge pieces according to the specified arrangement. + + The arrangement is a 2D list where: + - Positive values are cell IDs that must be included + - -1 indicates a flexible/empty position + + Example: [[0x00, 0x01], [0x08, 0x09]] merges 4 pieces into a 2x2 piece + + If a piece being merged contains additional cells not in the arrangement, + the arrangement is automatically expanded to include all cells from all + pieces being merged. + """ + # Collect all cell IDs from arrangement, excluding -1 + target_cells = set() + for row in arrangement: + for cell in row: + if cell != -1: + target_cells.add(cell) + + # Find all pieces containing any of the target cells + pieces_to_merge = [] + remaining_pieces = [] + + for piece in piece_list: + piece_cells = get_piece_cells(piece) + if piece_cells & target_cells: + pieces_to_merge.append(piece) + else: + remaining_pieces.append(piece) + + # Validate: all target cells must be found + found_cells = set() + for piece in pieces_to_merge: + piece_cells = get_piece_cells(piece) + # Check for overlapping cells between pieces (indicates contradictory merges) + overlap = found_cells & piece_cells + if overlap: + raise GenerationException(f"Cannot merge: cells {overlap} appear in multiple pieces (contradictory merge operations)") + found_cells.update(piece_cells) + + if not target_cells.issubset(found_cells): + missing = target_cells - found_cells + raise GenerationException(f"Cannot merge: cells {missing} not found in any piece") + + # If pieces contain additional cells not in the arrangement, expand the arrangement + if found_cells != target_cells: + arrangement = expand_arrangement(arrangement, pieces_to_merge) + + # Create the merged piece + merged_piece = create_piece(world, player, arrangement, overworld_screens) + + # Calculate merged restrictions + merged_piece.restriction = calculate_merged_restrictions(pieces_to_merge, arrangement) + + remaining_pieces.append(merged_piece) + return remaining_pieces + def add_piece_data(world: World, player: int, piece: Piece, large_screen_quadrant_info: Dict[int, Dict], large_screen_quadrant_info_land: Dict[int, Dict], large_screen_quadrant_info_water: Dict[int, Dict]) -> None: """ Add computed data to piece @@ -553,13 +745,8 @@ def add_piece_data(world: World, player: int, piece: Piece, large_screen_quadran num_pieces = 2 if piece.parallel else 1 for p in range(num_pieces): world_piece = piece.main if p == 0 else piece.parallel - world_piece.width = piece.width - world_piece.height = piece.height add_world_piece_edge_info(world, player, world_piece, large_screen_quadrant_info, large_screen_quadrant_info_land, large_screen_quadrant_info_water) - piece.width = piece.main.width - piece.height = piece.main.height - # Calculate edge_sides and max_edges_per_side: 0 for multi-cell pieces if piece.width == 1 and piece.height == 1: edge_sides = 0 @@ -739,8 +926,6 @@ def random_place_piece( piece_main = piece.main piece_parallel = piece.parallel wrld = piece.world - invalid_wrap_row = piece.invalid_wrap_row - invalid_wrap_column = piece.invalid_wrap_column restriction = piece.restriction piece_width = piece.width piece_height = piece.height @@ -751,13 +936,8 @@ def random_place_piece( i_range = height if vertical_wrap else height - piece_height + 1 for i in range(i_range): - if i >= height - piece_height + 1 and (height - i) in invalid_wrap_row: - continue - j_range = width if horizontal_wrap else width - piece_width + 1 for j in range(j_range): - if j >= width - piece_width + 1 and (width - j) in invalid_wrap_column: - continue if restriction and (i * 8 + j) not in restriction: continue @@ -1268,7 +1448,7 @@ def connect_edge_sets(world: World, player: int, edge_set_1: List[OWEdge], edge_ for k in range(len(edge_set_2)): connect_two_way(world, edges_to_connect[k].name, edge_set_2[k].name, player, connected_edges, final_placement) else: - raise Exception("There should never be multiple edges with high priority in an edge set") + raise GenerationException("There should never be multiple edges with high priority in an edge set") # ============================================================================ # GRID FORMATTING @@ -1452,4 +1632,4 @@ def generate_random_grid_layout(world: World, player: int, connected_edges: List except Exception as e: logger.warning(f"Warning: Could not create visualization: {e}") else: - raise Exception(f"Layout generation FAILED after {result.failures} attempts and {elapsed_time:.3f} seconds") \ No newline at end of file + raise GenerationException(f"Layout generation FAILED after {result.failures} attempts and {elapsed_time:.3f} seconds") \ No newline at end of file From 086d1bbc8505569f43ee1a5320bf042b884747ec Mon Sep 17 00:00:00 2001 From: Catobat <69204835+Catobat@users.noreply.github.com> Date: Wed, 4 Feb 2026 23:10:04 +0100 Subject: [PATCH 16/34] Place pieces with only one possible position first --- source/overworld/LayoutGenerator.py | 156 +++++++++++++++++++++++++++- 1 file changed, 153 insertions(+), 3 deletions(-) diff --git a/source/overworld/LayoutGenerator.py b/source/overworld/LayoutGenerator.py index 8f87f098..2764cb25 100644 --- a/source/overworld/LayoutGenerator.py +++ b/source/overworld/LayoutGenerator.py @@ -273,6 +273,25 @@ def create_empty_grid_info(edge_connection_seed: float) -> GridInfo: edge_connection_seed=edge_connection_seed ) +def copy_grid_info(source: GridInfo, edge_connection_seed: float) -> GridInfo: + """ + Create a deep copy of a GridInfo object with a new edge_connection_seed. + Only copies the grid data structures, not the OWEdge references (which are shared). + """ + return GridInfo( + grid=[[row[:] for row in world_grid] for world_grid in source.grid], + north_edges_grid=[[[cell[:] for cell in row] for row in world_grid] for world_grid in source.north_edges_grid], + south_edges_grid=[[[cell[:] for cell in row] for row in world_grid] for world_grid in source.south_edges_grid], + west_edges_grid=[[[cell[:] for cell in row] for row in world_grid] for world_grid in source.west_edges_grid], + east_edges_grid=[[[cell[:] for cell in row] for row in world_grid] for world_grid in source.east_edges_grid], + north_edges_water_grid=[[[cell[:] for cell in row] for row in world_grid] for world_grid in source.north_edges_water_grid], + south_edges_water_grid=[[[cell[:] for cell in row] for row in world_grid] for world_grid in source.south_edges_water_grid], + west_edges_water_grid=[[[cell[:] for cell in row] for row in world_grid] for world_grid in source.west_edges_water_grid], + east_edges_water_grid=[[[cell[:] for cell in row] for row in world_grid] for world_grid in source.east_edges_water_grid], + crossed_groups=[row[:] for row in source.crossed_groups], + edge_connection_seed=edge_connection_seed + ) + def initialize_screens(world: World, player: int) -> Dict[int, Screen]: overworld_screens: Dict[int, Screen] = {} screen_edges_map = group_owedges_by_screens(world, player) @@ -1171,21 +1190,152 @@ def random_place_piece( return PiecePlacementResult(success=True, piece=piece, score_major=used_score_major, score_minor=used_score_minor) +def place_single_restriction_pieces( + world: World, + player: int, + grid_info: GridInfo, + options: LayoutGeneratorOptions, + pieces: List[Piece] +) -> Tuple[List[Piece], int]: + """ + Place pieces that have a restriction list with only a single element. + These pieces are forced into a single position, so we can place them deterministically. + + This function iteratively: + 1. Validates restriction lists against current grid state and grid bounds + 2. Places pieces with single-element restrictions + 3. Repeats until no more pieces can be placed + + Returns a tuple of (remaining_pieces, count_of_placed_pieces). + """ + use_crossed_groups = (world.owCrossed[player] == 'polar' and world.owMixed[player]) or world.owCrossed[player] == 'grouped' + + remaining_pieces = list(pieces) + placed_count = 0 + + placed_this_iteration = True + while placed_this_iteration: + placed_this_iteration = False + + # Validate and update restriction lists for all remaining pieces + for piece in remaining_pieces: + if piece.restriction is None: + continue + + valid_positions = [] + for position in piece.restriction: + row = position // 8 + column = position % 8 + wrld = piece.world + piece_crossed_groups = piece.crossed_groups + + # Check if this position is valid + is_valid = True + + # Check if piece would go outside grid bounds when wrapping is disabled + if not options.horizontal_wrap and column + piece.width > 8: + is_valid = False + if not options.vertical_wrap and row + piece.height > 8: + is_valid = False + + # Check for overlap with already placed pieces + if is_valid: + for k in range(piece.height): + if not is_valid: + break + row_idx = (row + k) % 8 + for l in range(piece.width): + col_idx = (column + l) % 8 + + # Check main world overlap + if grid_info.grid[wrld][row_idx][col_idx] != -1 and piece.main.screens[k][l]: + is_valid = False + break + + # Check parallel world overlap + if piece.parallel and grid_info.grid[1 - wrld][row_idx][col_idx] != -1 and piece.parallel.screens[k][l]: + is_valid = False + break + + # Check crossed groups + if use_crossed_groups and grid_info.crossed_groups[row_idx][col_idx] != -1 and grid_info.crossed_groups[row_idx][col_idx] != piece_crossed_groups[k][l]: + is_valid = False + break + + if is_valid: + valid_positions.append(position) + + # Update the restriction list + if len(valid_positions) == 0: + raise GenerationException(f"No valid positions remaining for piece with restriction list (original: {piece.restriction})") + + piece.restriction = valid_positions + + # Place pieces with single-element restrictions + new_remaining_pieces = [] + for piece in remaining_pieces: + # Check if this piece has exactly one restriction position + if piece.restriction is not None and len(piece.restriction) == 1: + position = piece.restriction[0] + row = position // 8 + column = position % 8 + wrld = piece.world + piece_crossed_groups = piece.crossed_groups + + # Place the piece on the grid + for k in range(piece.height): + row_idx = (row + k) % 8 + for l in range(piece.width): + col_idx = (column + l) % 8 + num_pieces = 2 if piece.parallel else 1 + for p in range(num_pieces): + world_piece = piece.main if p == 0 else piece.parallel + w = wrld if p == 0 else 1 - wrld + + grid_info.grid[w][row_idx][col_idx] = world_piece.grid[k][l] + grid_info.north_edges_grid[w][row_idx][col_idx] = world_piece.north_edges[k][l] + grid_info.south_edges_grid[w][row_idx][col_idx] = world_piece.south_edges[k][l] + grid_info.west_edges_grid[w][row_idx][col_idx] = world_piece.west_edges[k][l] + grid_info.east_edges_grid[w][row_idx][col_idx] = world_piece.east_edges[k][l] + + if not world.owTerrain[player]: + grid_info.north_edges_water_grid[w][row_idx][col_idx] = world_piece.north_edges_water[k][l] + grid_info.south_edges_water_grid[w][row_idx][col_idx] = world_piece.south_edges_water[k][l] + grid_info.west_edges_water_grid[w][row_idx][col_idx] = world_piece.west_edges_water[k][l] + grid_info.east_edges_water_grid[w][row_idx][col_idx] = world_piece.east_edges_water[k][l] + + if use_crossed_groups: + grid_info.crossed_groups[row_idx][col_idx] = piece_crossed_groups[k][l] + + placed_count += 1 + placed_this_iteration = True + else: + new_remaining_pieces.append(piece) + + remaining_pieces = new_remaining_pieces + + return remaining_pieces, placed_count + def get_random_layout(world: World, player: int, connected_edges_cache: List[str], pieces_to_place: List[Piece], options: LayoutGeneratorOptions, prio_edges: List[str], overworld_screens: Dict[int, Screen]) -> LayoutGeneratorResult: total_score = 0 best_score = -1000000 worst_score = 1000000 best_grid_info = None + # Pre-place pieces with single-element restriction lists + base_grid_info = create_empty_grid_info(0.0) + remaining_pieces, preplaced_count = place_single_restriction_pieces(world, player, base_grid_info, options, pieces_to_place) + successes = 0 failures = 0 run = 0 while run < options.min_runs or (run * successes < options.target_runs_times_successes and run < options.max_runs): run += 1 connected_edges = connected_edges_cache.copy() - piece_list = pieces_to_place.copy() + piece_list = remaining_pieces.copy() - grid_info = create_empty_grid_info(random.random()) + # Copy the pre-placed grid with a new random seed for edge connections + grid_info = copy_grid_info(base_grid_info, random.random()) for piece in piece_list: piece.delay = 0 @@ -1212,7 +1362,7 @@ def get_random_layout(world: World, player: int, connected_edges_cache: List[str for i in range(1, min(options.multi_choice, len(piece_list))): pieces.append(piece_list[i]) - result = random_place_piece(world, player, grid_info, options, pieces, len(placed_pieces) < options.first_ignore_bonus_points) + result = random_place_piece(world, player, grid_info, options, pieces, len(placed_pieces) + preplaced_count < options.first_ignore_bonus_points) if not result.success: failures += 1 From f5d547cc5e47b57d288dd0988ade1a7fb27623bd Mon Sep 17 00:00:00 2001 From: Catobat <69204835+Catobat@users.noreply.github.com> Date: Thu, 5 Feb 2026 21:11:24 +0100 Subject: [PATCH 17/34] Handle trimming and wrapping for large pieces --- source/overworld/LayoutGenerator.py | 161 ++++++++++++++++++++++++---- 1 file changed, 143 insertions(+), 18 deletions(-) diff --git a/source/overworld/LayoutGenerator.py b/source/overworld/LayoutGenerator.py index 2764cb25..8b86e516 100644 --- a/source/overworld/LayoutGenerator.py +++ b/source/overworld/LayoutGenerator.py @@ -449,6 +449,12 @@ def create_piece_list(world: World, player: int, options: LayoutGeneratorOptions if world.mode[player] == 'standard': piece_list = merge_pieces(piece_list, [[0x23, 0x24], [0x2B, 0x2C]], world, player, overworld_screens) + # Trim pieces by removing empty rows/columns on edges + piece_list = [trim_piece(piece) for piece in piece_list] + + # Validate piece sizes and apply wrapping if needed + piece_list = validate_and_wrap_pieces(piece_list, options, world, player, overworld_screens) + # Phase 3: Add piece data for piece in piece_list: add_piece_data(world, player, piece, large_screen_quadrant_info, large_screen_quadrant_info_land, large_screen_quadrant_info_water) @@ -536,6 +542,59 @@ def get_piece_cells(piece: Piece) -> Set[int]: cells.add(cell) return cells +def trim_piece(piece: Piece) -> Piece: + """ + Trim a piece by removing any full rows or columns on the edges that only consist of -1. + Adjusts position restrictions when present. + """ + # Find the bounds of non-empty cells + min_row, max_row = piece.height, -1 + min_col, max_col = piece.width, -1 + + for i in range(piece.height): + for j in range(piece.width): + has_content = piece.main.grid[i][j] != -1 + if piece.parallel: + has_content = has_content or piece.parallel.grid[i][j] != -1 + if has_content: + min_row = min(min_row, i) + max_row = max(max_row, i) + min_col = min(min_col, j) + max_col = max(max_col, j) + + if max_row < 0 or (min_row == 0 and max_row == piece.height - 1 and min_col == 0 and max_col == piece.width - 1): + return piece + + new_height = max_row - min_row + 1 + new_width = max_col - min_col + 1 + piece.width = new_width + piece.height = new_height + + # Trim piece + piece.main.grid = [row[min_col:max_col + 1] for row in piece.main.grid[min_row:max_row + 1]] + piece.main.screens = [row[min_col:max_col + 1] for row in piece.main.screens[min_row:max_row + 1]] + piece.main.width = new_width + piece.main.height = new_height + + if piece.parallel: + piece.parallel.grid = [row[min_col:max_col + 1] for row in piece.parallel.grid[min_row:max_row + 1]] + piece.parallel.screens = [row[min_col:max_col + 1] for row in piece.parallel.screens[min_row:max_row + 1]] + piece.parallel.width = new_width + piece.parallel.height = new_height + + # Adjust restrictions if present + if piece.restriction is not None: + adjusted_restrictions = [] + for pos in piece.restriction: + old_row = pos // 8 + old_col = pos % 8 + new_row = (old_row + min_row) % 8 + new_col = (old_col + min_col) % 8 + adjusted_restrictions.append(new_row * 8 + new_col) + piece.restriction = adjusted_restrictions + + return piece + def expand_arrangement(arrangement: List[List[int]], pieces: List[Piece]) -> List[List[int]]: """ Expand an arrangement to include all cells from the pieces being merged. @@ -546,19 +605,25 @@ def expand_arrangement(arrangement: List[List[int]], pieces: List[Piece]) -> Lis Raises an exception if the relative positions of cells within pieces conflict with the requested arrangement (e.g., contradictory merge operations). + + Note: This function uses wrap-aware position checking. Positions that differ + by multiples of 8 are considered equivalent (for wrapping support). This allows + arrangements like [[0x10, 0x11, 0x12, 0x13, 0x14]] and [[0x14, 0x15, 0x16, 0x17, 0x10]] + to be merged into a valid horizontal loop. """ # Build a mapping of cell_id -> (row, col) for all cells in all pieces # relative to a common coordinate system cell_positions: Dict[int, Tuple[int, int]] = {} - # Also track position -> cell_id to detect when two cells would occupy the same position - position_to_cell: Dict[Tuple[int, int], int] = {} + # Track wrapped_position -> cell_id to detect when two different cells would occupy the same position after wrapping + wrapped_position_to_cell: Dict[Tuple[int, int], int] = {} # First, map cells from the original arrangement for i, row in enumerate(arrangement): for j, cell in enumerate(row): if cell != -1: cell_positions[cell] = (i, j) - position_to_cell[(i, j)] = cell + wrapped_pos = (i % 8, j % 8) + wrapped_position_to_cell[wrapped_pos] = cell # For each piece, determine where its cells should go for piece in pieces: @@ -584,27 +649,33 @@ def expand_arrangement(arrangement: List[List[int]], pieces: List[Piece]) -> Lis for j, cell in enumerate(row): if cell != -1: new_pos = (i + offset_row, j + offset_col) + # Normalize position for wrapping (positions differing by 8 are equivalent) + wrapped_pos = (new_pos[0] % 8, new_pos[1] % 8) + if cell in cell_positions: - # Cell already has a position - verify it's consistent - if cell_positions[cell] != new_pos: + # Cell already has a position - verify it's consistent after wrapping + existing_pos = cell_positions[cell] + existing_wrapped = (existing_pos[0] % 8, existing_pos[1] % 8) + if existing_wrapped != wrapped_pos: raise GenerationException( f"Cannot merge: cell 0x{cell:02X} has conflicting positions. " - f"Existing position {cell_positions[cell]} conflicts with " - f"position {new_pos} from piece containing cells " + f"Existing position {existing_pos} (wrapped: {existing_wrapped}) conflicts with " + f"position {new_pos} (wrapped: {wrapped_pos}) from piece containing cells " f"{[c for row in piece.main.grid for c in row if c != -1]}. " f"This indicates contradictory merge operations." ) - elif new_pos in position_to_cell: - # Position is already occupied by a different cell - existing_cell = position_to_cell[new_pos] + # Same cell at same wrapped position - this is fine (loop detected) + elif wrapped_pos in wrapped_position_to_cell: + # Position is already occupied by a different cell after wrapping + existing_cell = wrapped_position_to_cell[wrapped_pos] raise GenerationException( - f"Cannot merge: cell 0x{cell:02X} would be placed at position {new_pos}, " - f"but that position is already occupied by cell 0x{existing_cell:02X}. " - f"This indicates contradictory merge operations." + f"Cannot merge: cell 0x{cell:02X} would be placed at position {new_pos} " + f"(wrapped: {wrapped_pos}), but that position is already occupied by " + f"cell 0x{existing_cell:02X}. This indicates contradictory merge operations." ) else: cell_positions[cell] = new_pos - position_to_cell[new_pos] = cell + wrapped_position_to_cell[wrapped_pos] = cell # Find the bounding box of all cells if not cell_positions: @@ -684,10 +755,9 @@ def calculate_merged_restrictions(pieces: List[Piece], arrangement: List[List[in for r in piece.restriction: r_row = r // 8 r_col = r % 8 - new_r_row = r_row - offset_row - new_r_col = r_col - offset_col - if 0 <= new_r_row < 8 and 0 <= new_r_col < 8: - translated.append(new_r_row * 8 + new_r_col) + new_r_row = (r_row - offset_row) % 8 + new_r_col = (r_col - offset_col) % 8 + translated.append(new_r_row * 8 + new_r_col) translated_restrictions.append(set(translated)) # Intersection of all translated restrictions @@ -756,6 +826,61 @@ def merge_pieces(piece_list: List[Piece], arrangement: List[List[int]], world: W remaining_pieces.append(merged_piece) return remaining_pieces +def validate_and_wrap_pieces(piece_list: List[Piece], options: LayoutGeneratorOptions, world: World, player: int, overworld_screens: Dict[int, Screen]) -> List[Piece]: + """ + Validate that all pieces are at most 8x8 in size. + If a piece is too large, attempt to reduce its size using wrapping. + """ + result_pieces = [] + + for piece in piece_list: + if piece.width <= 8 and piece.height <= 8: + result_pieces.append(piece) + continue + + # Piece is too large, need to apply wrapping + if piece.width > 8 and not options.horizontal_wrap: + raise GenerationException( + f"Piece has width {piece.width} which exceeds 8, but horizontal wrapping is not enabled. " + f"Cells: {[c for row in piece.main.grid for c in row if c != -1]}" + ) + + if piece.height > 8 and not options.vertical_wrap: + raise GenerationException( + f"Piece has height {piece.height} which exceeds 8, but vertical wrapping is not enabled. " + f"Cells: {[c for row in piece.main.grid for c in row if c != -1]}" + ) + + # Calculate wrapped dimensions + wrapped_width = min(piece.width, 8) + wrapped_height = min(piece.height, 8) + + # Create new wrapped grid, checking for conflicts + wrapped_grid = [[-1] * wrapped_width for _ in range(wrapped_height)] + + for i in range(piece.height): + wrapped_i = i % 8 + for j in range(piece.width): + wrapped_j = j % 8 + cell = piece.main.grid[i][j] + + if cell != -1: + existing = wrapped_grid[wrapped_i][wrapped_j] + if existing != -1 and existing != cell: + raise GenerationException( + f"Wrapping conflict: cell 0x{cell:02X} at position ({i}, {j}) " + f"would wrap to ({wrapped_i}, {wrapped_j}) which already contains cell 0x{existing:02X}. " + f"Piece cells: {[c for row in piece.main.grid for c in row if c != -1]}" + ) + wrapped_grid[wrapped_i][wrapped_j] = cell + + # Create the wrapped piece + wrapped_piece = create_piece(world, player, wrapped_grid, overworld_screens) + wrapped_piece.restriction = piece.restriction + result_pieces.append(wrapped_piece) + + return result_pieces + def add_piece_data(world: World, player: int, piece: Piece, large_screen_quadrant_info: Dict[int, Dict], large_screen_quadrant_info_land: Dict[int, Dict], large_screen_quadrant_info_water: Dict[int, Dict]) -> None: """ Add computed data to piece From 78c389e2d50f671dee736930bb5797871d32787e Mon Sep 17 00:00:00 2001 From: Catobat <69204835+Catobat@users.noreply.github.com> Date: Sun, 8 Feb 2026 21:57:46 +0100 Subject: [PATCH 18/34] Add Grid Layout Shuffle Customizer options for custom arrangements, restricted positions and split large screens --- docs/Customizer.md | 35 +++++ source/classes/CustomSettings.py | 54 ++++++- source/overworld/LayoutGenerator.py | 234 ++++++++++++++++++++++++++-- 3 files changed, 312 insertions(+), 11 deletions(-) diff --git a/docs/Customizer.md b/docs/Customizer.md index 5d5e083d..5ac2e080 100644 --- a/docs/Customizer.md +++ b/docs/Customizer.md @@ -257,10 +257,45 @@ someDescription: `grid` contains additional options that only have an effect when `ow_layout` is set to `grid`. +#### fixed_arrangements + +Use this to dictate the relative positioning between multiple screens (or quadrants of large screens). Screens and quadrants are addressed by their OW Slot ID (independently of their world), ranging from 0x00 to 0x3F. An `arrangement` is given as a list of rows with equal lenghts. If you do not want to specify a full rectangle of screens, you can use `.` as a placeholder to allow the generator to place any screen there. The `world` property can be set to `light`, `dark` or `both` (default value) and determines for which worlds the arrangement applies. + +This example forces Death Mountain to stay connected the same as vanilla in both worlds: +``` +fixed_arrangements: + - arrangement: + - 0x03 0x04 0x05 0x06 0x07 + - 0x0B 0x0C 0x0D 0x0E . + world: both +``` + +#### restricted_positions + +Use this to restrict cells to a specified set of possible positions. The `world` property can be set to `light`, `dark` or `both` (default value) and determines for which worlds the restriction applies. + +This example forces the Sanctuary and Link's House screens in both worlds to get placed in corners of the grid: +``` +restricted_positions: + - cells: + - 0x13 + - 0x2C + positions: + - 0x00 + - 0x07 + - 0x38 + - 0x3F + world: both +``` + #### wrap_horizontal / wrap_vertical Set these to `true` to allow for overworld edge transitions to wrap from one side of a world to the opposite side. With `wrap_horizontal`, there can be east transitions on the eastern edge of the world map that send the player to the western edge of the world. With `wrap_vertical`, there can be south transitions on the southern edge of the world map that send the player to the northern edge of the world. +#### split_large_screens + +When set to `true`, the four quadrants of each large screen are placed on the grid independently of each other. + ### ow-crossed This must be defined by player. Each player number should be listed with the appropriate sections and each of these players MUST have `ow_crossed` enabled in the `settings` section in order for any values here to take effect. This section has four primary subsections: `force_crossed`, `force_noncrossed`, `limit_crossed`, and `undefined_chance`. There are also diff --git a/source/classes/CustomSettings.py b/source/classes/CustomSettings.py index 0e66b2de..d31ef546 100644 --- a/source/classes/CustomSettings.py +++ b/source/classes/CustomSettings.py @@ -504,6 +504,7 @@ class CustomSettings(object): self.world_rep['ow-whirlpools'] = whirlpools = {} self.world_rep['ow-tileflips'] = flips = {} self.world_rep['ow-flutespots'] = flute = {} + self.world_rep['ow-grid'] = owgrid = {} for p in self.player_range: connections = edges[p] = {} connections['two-way'] = {} @@ -524,6 +525,57 @@ class CustomSettings(object): else: flute[p]['force'] = list(HexInt(id) for id in sorted(default_flute_connections)) flute[p]['forbid'] = [] + # layout grid + owgrid[p] = {} + grid = world.owgrid[p] + if grid is None: + grid = [ + [[HexInt(row * 8 + col) for col in range(8)] for row in range(8)], + [[HexInt(row * 8 + col) for col in range(8)] for row in range(8)] + ] + else: + grid = [ + [[HexInt(cell & 0xBF) for cell in row] for row in grid[0]], + [[HexInt(cell & 0xBF) for cell in row] for row in grid[1]] + ] + # Create fixed_arrangements for both worlds + owgrid[p]['fixed_arrangements'] = [ + { + 'arrangement': [' '.join(f'0x{cell:02X}' for cell in row) for row in grid[0]], + 'world': 'light' + }, + { + 'arrangement': [' '.join(f'0x{cell:02X}' for cell in row) for row in grid[1]], + 'world': 'dark' + } + ] + # Pin top left corners to position 0x00 + owgrid[p]['restricted_positions'] = [ + { + 'cells': [HexInt(grid[0][0][0])], + 'positions': [HexInt(0x00)], + 'world': 'light' + }, + { + 'cells': [HexInt(grid[1][0][0])], + 'positions': [HexInt(0x00)], + 'world': 'dark' + } + ] + # Set advanced grid options + horizontal_wrap = False + vertical_wrap = False + split_large_screens = False + if world.customizer: + grid_options = world.customizer.get_owgrid() + if grid_options and p in grid_options: + grid_options = grid_options[p] + horizontal_wrap = 'wrap_horizontal' in grid_options and grid_options['wrap_horizontal'] == True + vertical_wrap = 'wrap_vertical' in grid_options and grid_options['wrap_vertical'] == True + split_large_screens = 'split_large_screens' in grid_options and grid_options['split_large_screens'] == True + owgrid[p]['wrap_horizontal'] = horizontal_wrap + owgrid[p]['wrap_vertical'] = vertical_wrap + owgrid[p]['split_large_screens'] = split_large_screens for key, data in world.spoiler.overworlds.items(): player = data['player'] if 'player' in data else 1 connections = edges[player] @@ -531,7 +583,7 @@ class CustomSettings(object): connections[sub][data['entrance']] = data['exit'] for key, data in world.spoiler.whirlpools.items(): player = data['player'] if 'player' in data else 1 - whirlconnects = whirlconnects[player] + whirlconnects = whirlpools[player] sub = 'two-way' if data['direction'] == 'both' else 'one-way' whirlconnects[sub][data['entrance']] = data['exit'] diff --git a/source/overworld/LayoutGenerator.py b/source/overworld/LayoutGenerator.py index 8b86e516..56b28bd1 100644 --- a/source/overworld/LayoutGenerator.py +++ b/source/overworld/LayoutGenerator.py @@ -148,8 +148,7 @@ class LayoutGeneratorOptions: """ Configuration options for layout generation. """ - __slots__ = ('horizontal_wrap', 'vertical_wrap', 'split_large_screens', - 'large_screen_pool', 'distortion_chance', 'random_order', + __slots__ = ('horizontal_wrap', 'vertical_wrap', 'split_large_screens', 'distortion_chance', 'random_order', 'multi_choice', 'max_delay', 'first_ignore_bonus_points', 'penalty_full_edge_mismatch', 'penalty_partial_edge_mismatch', 'bonus_partial_edge_match', 'bonus_full_edge_match', 'bonus_crossed_group_match', 'bonus_fill_parallel', @@ -163,7 +162,6 @@ class LayoutGeneratorOptions: horizontal_wrap: bool = True, vertical_wrap: bool = True, split_large_screens = False, - large_screen_pool: bool = False, distortion_chance: float = 0.0, random_order: int = 0, multi_choice: int = 1, @@ -190,7 +188,6 @@ class LayoutGeneratorOptions: self.horizontal_wrap = horizontal_wrap self.vertical_wrap = vertical_wrap self.split_large_screens = split_large_screens - self.large_screen_pool = large_screen_pool self.distortion_chance = distortion_chance self.random_order = random_order self.multi_choice = multi_choice @@ -428,15 +425,14 @@ def create_piece_list(world: World, player: int, options: LayoutGeneratorOptions # Create 4 pieces for large screen quadrants for offset in [0x00, 0x01, 0x08, 0x09]: piece = create_piece(world, player, [[screen.id + offset]], overworld_screens) - if options.large_screen_pool: - piece.restriction = [large_id + offset for large_id in [0x00, 0x03, 0x05, 0x18, 0x1B, 0x1E, 0x30, 0x35]] piece_list.append(piece) else: piece = create_piece(world, player, [[screen.id]], overworld_screens) - if options.large_screen_pool: - piece.restriction = [s.id for s in overworld_screens.values() if not s.big] piece_list.append(piece) + # Apply position restrictions from Customizer + piece_list = apply_position_restrictions(world, player, piece_list, overworld_screens) + # Phase 2: Apply options via merging # Merge large screens if not split @@ -449,6 +445,9 @@ def create_piece_list(world: World, player: int, options: LayoutGeneratorOptions if world.mode[player] == 'standard': piece_list = merge_pieces(piece_list, [[0x23, 0x24], [0x2B, 0x2C]], world, player, overworld_screens) + # Apply fixed arrangement restrictions from Customizer + piece_list = apply_arrangement_restrictions(world, player, piece_list, overworld_screens) + # Trim pieces by removing empty rows/columns on edges piece_list = [trim_piece(piece) for piece in piece_list] @@ -533,6 +532,211 @@ def create_piece(world: World, player: int, grid: List[List[int]], overworld_scr return piece +def apply_position_restrictions(world: World, player: int, piece_list: List[Piece], overworld_screens: Dict[int, Screen]) -> List[Piece]: + """ + Apply position restrictions from Customizer to pieces at the end of phase 1. + + Position restrictions specify that certain cells can only be placed at certain positions. + The Customizer format is: + restricted_positions: + - cells: [0x13, 0x2C] + positions: [0x00, 0x07, 0x38, 0x3F] + world: both # or 'light' or 'dark' + + Note: At the end of phase 1, all pieces are 1x1 (one piece per cell). + + The world bit (0x40) in user input is ignored. The actual cell ID is determined by: + - The world where the restriction applies (light=0, dark=1) + - The mixed_state of the screen containing that cell (swapped screens flip the world bit) + """ + if not world.customizer: + return piece_list + + grid_options = world.customizer.get_owgrid() + if not grid_options or player not in grid_options: + return piece_list + + grid_options = grid_options[player] + restricted_positions = grid_options.get('restricted_positions', []) + if not restricted_positions: + return piece_list + + # Build a mapping from cell ID to piece for quick lookup + cell_to_piece = {piece.main.grid[0][0]: piece for piece in piece_list} + + for restriction_idx, restriction in enumerate(restricted_positions): + cells = restriction.get('cells', []) + positions = restriction.get('positions', []) + restriction_world = restriction.get('world', 'both') + + # Validate input + if not cells: + raise GenerationException(f"Invalid restriction in restricted_positions[{restriction_idx}]: No cells provided") + for cell_id in cells: + validate_cell_id(cell_id, f"restricted_positions[{restriction_idx}].cells") + if not positions: + raise GenerationException(f"Invalid restriction in restricted_positions[{restriction_idx}]: No positions provided") + for pos in positions: + validate_cell_id(pos, f"restricted_positions[{restriction_idx}].positions") + validate_world_value(restriction_world, f"restricted_positions[{restriction_idx}]") + + position_set = set(positions) + + for user_cell_id in cells: + # Ignore the world bit in user input + base_cell_id = user_cell_id & 0xBF + + # Determine which worlds this restriction applies to + worlds_to_check = [] + if restriction_world == 'light' or restriction_world == 'both': + worlds_to_check.append(0) # Light World + if restriction_world == 'dark' or restriction_world == 'both': + worlds_to_check.append(1) # Dark World + + for target_world in worlds_to_check: + # Determine the actual cell ID based on the target world and mixed state + screen_id = get_screen_id_from_cell(base_cell_id) + screen = overworld_screens.get(screen_id) + is_swapped = screen.mixed_state == "swapped" + + # Calculate the actual cell ID: + # - In Light World (target_world=0): use base_cell_id if normal, base_cell_id|0x40 if swapped + # - In Dark World (target_world=1): use base_cell_id|0x40 if normal, base_cell_id if swapped + if target_world == 0: + # Light World + actual_cell_id = (base_cell_id | 0x40) if is_swapped else base_cell_id + else: + # Dark World + actual_cell_id = base_cell_id if is_swapped else (base_cell_id | 0x40) + + piece = cell_to_piece.get(actual_cell_id) + + # Apply the position restriction + if piece.restriction is None: + piece.restriction = list(position_set) + else: + # Intersect with existing restrictions + piece.restriction = [p for p in piece.restriction if p in position_set] + + return piece_list + +def apply_arrangement_restrictions(world: World, player: int, piece_list: List[Piece], overworld_screens: Dict[int, Screen]) -> List[Piece]: + """ + Apply fixed arrangement restrictions from Customizer to pieces at the end of phase 2. + + Fixed arrangements specify the relative positioning between multiple screens. + The Customizer format is: + fixed_arrangements: + - arrangement: + - 0x03 0x04 0x05 0x06 0x07 + - 0x0B 0x0C 0x0D 0x0E . + world: both # or 'light' or 'dark' + + The '.' character is a placeholder that allows any screen to be placed there. + + The world bit (0x40) in user input is ignored. The actual cell ID is determined by: + - The world where the restriction applies (light=0, dark=1) + - The mixed_state of the screen containing that cell (swapped screens flip the world bit) + """ + if not world.customizer: + return piece_list + + grid_options = world.customizer.get_owgrid() + if not grid_options or player not in grid_options: + return piece_list + + grid_options = grid_options[player] + fixed_arrangements = grid_options.get('fixed_arrangements', []) + if not fixed_arrangements: + return piece_list + + for arrangement_idx, arrangement_config in enumerate(fixed_arrangements): + arrangement_rows = arrangement_config.get('arrangement', []) + arrangement_world = arrangement_config.get('world', 'both') + + # Validate world value + validate_world_value(arrangement_world, f"fixed_arrangements[{arrangement_idx}]") + + if not arrangement_rows: + raise GenerationException(f"Invalid arrangement in fixed_arrangements[{arrangement_idx}]: No arrangement provided") + + # Pre-validate the arrangement: check row lengths and entry validity + expected_row_length = None + for row_idx, row_str in enumerate(arrangement_rows): + parts = str(row_str).split() + if expected_row_length is None: + expected_row_length = len(parts) + elif len(parts) != expected_row_length: + raise GenerationException(f"Invalid arrangement in fixed_arrangements[{arrangement_idx}]: row {row_idx} has {len(parts)} entries but expected {expected_row_length} (all rows must have the same number of entries)") + + # Validate each entry + for part_idx, part in enumerate(parts): + part = part.strip() + if part == '.': + continue + # Try to parse as cell ID + try: + if part.startswith('0x') or part.startswith('0X'): + cell_id = int(part, 16) + else: + cell_id = int(part) + validate_cell_id(cell_id, f"fixed_arrangements[{arrangement_idx}].arrangement[{row_idx}][{part_idx}]") + except ValueError: + raise GenerationException(f"Invalid entry '{part}' in fixed_arrangements[{arrangement_idx}].arrangement[{row_idx}][{part_idx}]: must be a cell ID (0x00-0x7F) or '.'") + + # Determine which worlds this arrangement applies to + worlds_to_apply = [] + if arrangement_world == 'light' or arrangement_world == 'both': + worlds_to_apply.append(0) # Light World + if arrangement_world == 'dark' or arrangement_world == 'both': + worlds_to_apply.append(1) # Dark World + + for target_world in worlds_to_apply: + # Parse the arrangement into a 2D list of cell IDs, translating based on world and mixed state + # Each row is a string like "0x03 0x04 0x05 0x06 0x07" or contains '.' for wildcards + arrangement = [] + for row_str in arrangement_rows: + row = [] + # Split by whitespace + parts = str(row_str).split() + for part in parts: + part = part.strip() + if part == '.': + row.append(-1) # -1 represents wildcard + else: + # Parse as hex or decimal (already validated above) + if part.startswith('0x') or part.startswith('0X'): + user_cell_id = int(part, 16) + else: + user_cell_id = int(part) + + # Ignore the world bit in user input + base_cell_id = user_cell_id & 0xBF + + # Get the screen that contains this cell + screen_id = get_screen_id_from_cell(base_cell_id) + screen = overworld_screens.get(screen_id) + is_swapped = screen.mixed_state == "swapped" + + # Calculate the actual cell ID: + # - In Light World (target_world=0): use base_cell_id if normal, base_cell_id|0x40 if swapped + # - In Dark World (target_world=1): use base_cell_id|0x40 if normal, base_cell_id if swapped + if target_world == 0: + # Light World + actual_cell_id = (base_cell_id | 0x40) if is_swapped else base_cell_id + else: + # Dark World + actual_cell_id = base_cell_id if is_swapped else (base_cell_id | 0x40) + + row.append(actual_cell_id) + if row: + arrangement.append(row) + + # Merge the pieces according to the arrangement + piece_list = merge_pieces(piece_list, arrangement, world, player, overworld_screens) + + return piece_list + def get_piece_cells(piece: Piece) -> Set[int]: """Get all cell IDs contained in a piece.""" cells = set() @@ -542,6 +746,15 @@ def get_piece_cells(piece: Piece) -> Set[int]: cells.add(cell) return cells +def validate_cell_id(cell_id: int, context: str) -> None: + if not isinstance(cell_id, int) or cell_id < 0x00 or cell_id > 0x7F: + raise GenerationException(f"Invalid cell ID 0x{cell_id:02X} in {context}: must be in range 0x00-0x7F") + +def validate_world_value(world_value: str, context: str) -> None: + allowed_values = {'light', 'dark', 'both'} + if world_value not in allowed_values: + raise GenerationException(f"Invalid world value '{world_value}' in {context}: must be one of {allowed_values}") + def trim_piece(piece: Piece) -> Piece: """ Trim a piece by removing any full rows or columns on the edges that only consist of -1. @@ -1828,12 +2041,14 @@ def generate_random_grid_layout(world: World, player: int, connected_edges: List horizontal_wrap = False vertical_wrap = False + split_large_screens = False if world.customizer: grid_options = world.customizer.get_owgrid() if grid_options and player in grid_options: grid_options = grid_options[player] horizontal_wrap = 'wrap_horizontal' in grid_options and grid_options['wrap_horizontal'] == True vertical_wrap = 'wrap_vertical' in grid_options and grid_options['wrap_vertical'] == True + split_large_screens = 'split_large_screens' in grid_options and grid_options['split_large_screens'] == True first_ignore_bonus = 2 if not world.owParallel[player]: @@ -1843,8 +2058,7 @@ def generate_random_grid_layout(world: World, player: int, connected_edges: List options = LayoutGeneratorOptions( horizontal_wrap=horizontal_wrap, vertical_wrap=vertical_wrap, - split_large_screens=False, - large_screen_pool=False, + split_large_screens=split_large_screens, distortion_chance=0.0, random_order=6 if world.owParallel[player] else 12, multi_choice=1, From 40260c4fd445e5741cf4685d83607e49ffd87913 Mon Sep 17 00:00:00 2001 From: aerinon Date: Wed, 11 Feb 2026 10:20:39 -0700 Subject: [PATCH 19/34] fix: logic issue in PoD Arena (too stringent requirements) --- DoorShuffle.py | 2 +- RELEASENOTES.md | 1 + 2 files changed, 2 insertions(+), 1 deletion(-) diff --git a/DoorShuffle.py b/DoorShuffle.py index 793e5ead..8833a28b 100644 --- a/DoorShuffle.py +++ b/DoorShuffle.py @@ -3713,7 +3713,7 @@ logical_connections = [ ('PoD Pit Room Block Path S', 'PoD Pit Room'), ('PoD Arena Landing Bonk Path', 'PoD Arena Bridge'), ('PoD Arena North Drop Down', 'PoD Arena Main'), - ('PoD Arena Bridge Drop Down', 'PoD Arena Main'), + ('PoD Arena Bridge Drop Down', 'PoD Arena Landing'), ('PoD Arena North to Landing Barrier - Orange', 'PoD Arena Landing'), ('PoD Arena Main to Ranged Crystal', 'PoD Arena Main - Ranged Crystal'), ('PoD Arena Main to Landing Barrier - Blue', 'PoD Arena Landing'), diff --git a/RELEASENOTES.md b/RELEASENOTES.md index 55a2d0b3..86d2c0f2 100644 --- a/RELEASENOTES.md +++ b/RELEASENOTES.md @@ -1,6 +1,7 @@ # Patch Notes * 1.5.5 + * Logic: Fixed an issue where PoD Bridge lead to Arena Main instead of Arena Landing Area. (Potentially unnecessarily requiring bombs or Somaria to progress) * HUD: Key counters are correct even when door shuffle is off From 0e432106d5ec121a8b35456e30bc95bf89d802f0 Mon Sep 17 00:00:00 2001 From: aerinon Date: Wed, 11 Feb 2026 10:49:33 -0700 Subject: [PATCH 20/34] fix: handle universal keys issue --- Rom.py | 2 +- data/base2current.bps | Bin 118471 -> 118478 bytes 2 files changed, 1 insertion(+), 1 deletion(-) diff --git a/Rom.py b/Rom.py index 66436210..6d52e6c8 100644 --- a/Rom.py +++ b/Rom.py @@ -42,7 +42,7 @@ from source.enemizer.Enemizer import write_enemy_shuffle_settings JAP10HASH = '03a63945398191337e896e5771f77173' -RANDOMIZERBASEHASH = '794b7cd02f429873c3ad6dc74490279c' +RANDOMIZERBASEHASH = 'a882ed16dce1cb84f366afd69788e8f2' class JsonRom(object): diff --git a/data/base2current.bps b/data/base2current.bps index b499ded82f8231c4e574e1c36ca11b7618fe370b..6fc4741bddd675783c00d568226a21826521eb8f 100644 GIT binary patch delta 2140 zcmW+#3s4l<746%@Fv9@DFhpfXgto~7t;0`|pRmI6_Y+aX4-PsiDr90%H!7|O-M}aa z0}Q?Lppc(5tH3H^@7Vqp5L7^o!7?gpX%s8FL{fq)vSN}Y?Vft?+|Rl1)vJ2<_SMSn z*2>B~VXfKA3tY{sbkZ0LM`oMPlTg+1z#F%E^ubHUTT52rI6UCjNoPnPh}|W>4+0-) zvmJ-C{3+WU8(7AB%m|c%norf>R&bTqyG}{qb2f#X55epaveG`biz_LvDvGXcC@DU` zQ|{X&kj$Grj^Ma=K0AYQ!vpg9KEFx?USm}_WFkL4DIG{qTC^hua9yKf)T#+>+wi< z%eG(L0XO-XKNLHF9eeUlD0J}8?%e#HZAmAmCvSZsIe+%$8!K4G*8X_G-uwecE6Bfz zY(?7h`k&Mi2Ew!R}wDAfbLhfG2330VMJP_Y+8Kqk851qqIizv&w$^zEVax$(gE zz0A2mL{KnWRKqBkKXdXHw^W2p`ROt({g`sFDR0%2spv2T8d>J~9>O4AUPplkY(qCF z2=^sNs%;vH3LDy??ccQxqBHE*W@wB17lW1MF@`qfNO2wu!N#_fAfr9)_7~(o4_3{| zO)Nw?iG@temAsbd-Q%)DWiKVWX(bwEB3O4+KM&kt2kM;%@0ZKS=a&o?F5kkPv~W!q zxJwr}AuPX0UBy*qe{V4mJwjT4+5ma`0yk*OI_DpsLF~Sznrd~cY*}!zd6H6%ONg9H z=wNWiJ)#&{X~8{Gm8_y`t;U_22b?o(dYc$|*_oQm*wIsejvZyC)Z1Omif;$HaxZYI z`2*vFRzEt@F#~T0r9|;1I$+>u(aAySS_pFUyF~o+Vr6(pWBvY^zcb@?|>fJ(&%pmfJtlB^mIl}+6AR+}#dqcQZzo*-B_#)?=QJ^0! z!yU2afl5zF!I|1msirNXWok#P@~b6RjAgFu4z$w;p4xlDgX-pf4dr0$ua6d1`od0J zy>DN`84TZYl9ph&Xq#)iP`^J^!3wlx0sP)NMMWpmA5ifEX!cF(B7d5wBe<@5hwQ34 zyX__B0;9a8t4nR4R}r@7=_yCQUgks77vz&t^)9+*723QI_IO&l%dIsU4fX4^v42?X zfaLDe1%5=F$o_^W$DA_=thE6n)}db(f~&7stfr=?RkjJ!(;9{16YCWUy;$zNeb_ks z>9q6q5#xxVSu?C6EGRkv;@~nW34mNUfb155v)#s?vpDf0$$MO~yao9!0v)K4X%V=B z0e!a!O5`cq=+ce7jR7bk5SG}b?vv4#NxvF8$3`%Ff0Olv_BZK!GhieLo#@ygbfYhkrlQbK3hQM50?uuT9z$|!+rb6Hvb+4Zrx4xzNjIUY41PWf&KXP-35mFPb)5Cn(N!dTeiQ~HQ2 z0&H;3$LE;e@%Or($7$ZIY%IlBxtfOh6M;iwfK)(=o14=^XIB0`;C_EnOVI6uF5B}1Ctnw?X1*ZhK zj>DH|Xc^RemVKbGQPTXz&_(t#2IQ1gXjY~V+Qrwb7D|>wt^@**T_U(al%P!ncZKxp z8RmLNVND9?tsoj%Hi3_mqrZ|aO2#%;Y7>ep4)!x!Yqp}vO=8o9prp+(CJ%_lX$D98 zgr$1eVC#x!%V?9~#0lGqF9K=HxNZ6;v>b__*gI@MF~T(i>;**}Xj delta 2212 zcmW+#2~ZPh7Vg(MI8+i)6yrhDC=d)75xJBSL=KTrTtyM0;(@|4Iv%Uys?Z$`cer}Y zkBbnH&LA=vw1w71NkkY3x^Ao)FJ?#GILmP<#GP5H2)-SPYz4uoB1r^BuQNjBIy;bliVbPSM)k$4`=>W;SK;`h8j*Lu<)0GuxykX)~*G1U}5U*oPkCAy!J! zl{e{1Dcw-frz9DsamjWFW<+s8%NE>apLNpIcn7=ouT81c@8&Tl6PDc9l5g&^qsFG8 zp6B;p{Gd9nRW;sa^VRzP6B;*_-#zvUUHRqjswmT{{=giL^Mz6=l|&i!!nn@Qt}df6TK?R)msOnAY|Tp$4803YWH`65`yUy;DKIJBc`4+sSV8t{O3Fu-4#2(=!P z+zS;MgO#emKB8mGYoZu!@Pmtx%X|1kK0qca4}ciRMK=Rrng6vf2W>=_F^cN6D@$?f zxIRLksDA2WBYLbbdiC*}B$IMYA(4xg$YD;neV9#lh)eaEDuQ|-m$+1)%_7$gvwcdV zFtyO7x>_SNiqVD3;x=rSqbrenp^wOO%xC4`2kX!cIYiH$JbKclnW%N4B<=rdXmU6< zWqV%x!e3~tN=@gr(9K%MF)I5T4DaMpyMV~Qj1EPdzfEY6s{(vug=tc%L1>?7uz2OVTyLSBt2*kpCXBUi zNf=`e1-#rzfA*Edbf}w^&av37!k^r!c*{$xh|pZ7LM^WxPCnYDfN<}?%fzEgy6DJe z{ek%JXnP}>+(N%>r07?T)PvXL0P0tOV&Xo2So%iq9jT$M$S<~TJw@d6f*^3n8YBva z=sA9du7j6YuiWEVV^z32X0YfcCH8cnPpOv8V^tpRm~P+V9!=FuCIjsXhVLg#gF7b; zLo&HUGo+8;*Up6e3}wqxWgLir=!2mgF1*sIUz7hyh2K)QLj*K2pHyW zG?72QX(Sp=dcl#p#_`z|H3b^yHj~L?g1UCmp6^@TmDlNCTSCZ@N{^jXeLUJeANKeg z&DCO=OeX*EQ8Q$7+%e(=BV}H>1a`IwBUYgg^I;|!(Tq@-G9}jRm2K15 zK9Rk$M>V5)2ANGt7}4@jNQ8@s35CMhd-~Z91z4Qz?narq)9P$I+*@GzU=^gK^_|0s z$E$jL{@LzyMUI+D{Sq5M0>3oXu8U$hBv3!uVz#a5~^ z^LleIN(_U=@>TntDBbE0nm*~E^iNJyi=lB=_UZbyMO`YLT5ZIsR{Jb6zqA$2K*lgo zxyf>+)Je?lW<1ziz=+V)a3JvmaVR<*Zjbwixq3|>VJz%L*=TA61c3}CM!*7aLPsOu zh-2s9A|MU?QEDX2a74QzVUAn;))x&pCCaf8ZGgn6^;1cL1|q>nc4S6T$D_sfJMChV z1F6^b=~|0c0ZHVTE()&6Zw#?^@v!vYWmJC~rS8P2}Ml^Vf+fK0gheS_sKOT7tEA(V})WEktVM z%dc4k(_COF+8qy`GYXSO9+($lo$jXpKDsc{qfa*%{5Co|G(Tez}TuYOt$#rv|qv4Vb2Bo09?L5b?Cl z>Runt&rbzkSJ5ud8oh|m%z!K*M4&4hA$X!_o*Pw~hGps$%gSpH4bfZb*P{Pz1Qi6K zj7{*uIbbPH(KyQGS7pKaarlA5=<7U~29f+w9_$6zO=L~X4&(ClQ(pYiop91kv?J>5 zi)7w*7~TosAbL>f;KuN83&97Z*-;gSRogJ9j~Ir*>iQ_&j|P`$NJ7e9@SB_y)!z}2 zQ{IMQnW{S!mGs(IIlx4s&mA@A^pBdHyf3J|{9k(Ef|E<)>e5;_&@mhMv~NHqk}ePr f7#3nju`DbGn~rfJ{@M)?37mr)@FDwf`kem*T#|}r From f04ede1e217cd392f59e243420faa49b04825860 Mon Sep 17 00:00:00 2001 From: aerinon Date: Wed, 11 Feb 2026 12:22:44 -0700 Subject: [PATCH 21/34] doc: fix broken links --- index.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/index.md b/index.md index 8e3843ae..f8ba5794 100644 --- a/index.md +++ b/index.md @@ -56,7 +56,7 @@ Door Randomizer takes the dungeon experience in A Link to the Past to the next l 4. Configure your settings and generate a seed 5. Apply the patch to your A Link to the Past ROM (must be JP 1.0 version) -[See detailed installation instructions →](/installation) +[See detailed installation instructions →](installation.html) ## Community @@ -68,11 +68,11 @@ Join the discussion and get help: ## Learn More -- [Features Guide](/features.html) - Comprehensive feature documentation -- [Installation & Usage](/installation.html) - Setup and running the randomizer -- [Known Issues](/known-issues.html) - Current bugs and limitations -- [Roadmap](/roadmap.html) - Future development plans -- [Blog](/blog.html) - Latest updates and release notes +- [Features Guide](features.html) - Comprehensive feature documentation +- [Installation & Usage](installation.html) - Setup and running the randomizer +- [Known Issues](known-issues.html) - Current bugs and limitations +- [Roadmap](roadmap.html) - Future development plans +- [Blog](blog.html) - Latest updates and release notes ## Credits From b8884e90109fc9400fa9a035229e28cbb3d39cca Mon Sep 17 00:00:00 2001 From: Catobat <69204835+Catobat@users.noreply.github.com> Date: Sun, 8 Feb 2026 22:07:08 +0100 Subject: [PATCH 22/34] Add and update presets for Grid Layout Shuffle --- presets/world/owr_blockshuffle.yaml | 5 +- presets/world/owr_checkerboardshuffle.yaml | 140 ++++++++++++++++ .../world/owr_quadrantshuffle-diagonal.yaml | 3 + presets/world/owr_quadrantshuffle-full.yaml | 3 + presets/world/owr_quadrantshuffle-grid.yaml | 147 +++++++++++++++++ .../owr_quadrantshuffle-vanillaborders.yaml | 1 + presets/world/owr_ringshuffle-borders.yaml | 3 + presets/world/owr_ringshuffle-full.yaml | 3 + presets/world/owr_ringshuffle-grid.yaml | 147 +++++++++++++++++ presets/world/owr_ringshuffle-interiors.yaml | 3 + presets/world/owr_shuffle-dark.yaml | 20 +++ presets/world/owr_shuffle-horizontal.yaml | 3 + .../owr_shuffle-horizontalbycolumns.yaml | 3 + .../world/owr_shuffle-largescreenpool.yaml | 149 ++++++++++++++++++ presets/world/owr_shuffle-largescreens.yaml | 3 + presets/world/owr_shuffle-light.yaml | 22 +++ .../world/owr_shuffle-separatemountain.yaml | 3 + presets/world/owr_shuffle-smallscreens.yaml | 3 + presets/world/owr_shuffle-splitsimilar.yaml | 1 + .../owr_shuffle-splitsimilarterrain.yaml | 1 + presets/world/owr_shuffle-vanillaloop.yaml | 3 + .../world/owr_shuffle-vanillamountain.yaml | 16 ++ presets/world/owr_shuffle-vertical.yaml | 3 + presets/world/owr_shuffle-verticalbyrows.yaml | 3 + presets/world/owr_shuffle-wrappedgrid.yaml | 7 + presets/world/owr_vanilla.yaml | 19 +++ 26 files changed, 712 insertions(+), 2 deletions(-) create mode 100644 presets/world/owr_checkerboardshuffle.yaml create mode 100644 presets/world/owr_quadrantshuffle-grid.yaml create mode 100644 presets/world/owr_ringshuffle-grid.yaml create mode 100644 presets/world/owr_shuffle-largescreenpool.yaml create mode 100644 presets/world/owr_shuffle-vanillamountain.yaml create mode 100644 presets/world/owr_shuffle-wrappedgrid.yaml diff --git a/presets/world/owr_blockshuffle.yaml b/presets/world/owr_blockshuffle.yaml index 55f27c87..8da580cc 100644 --- a/presets/world/owr_blockshuffle.yaml +++ b/presets/world/owr_blockshuffle.yaml @@ -1,5 +1,6 @@ -meta: - players: 1 +settings: + 1: + ow_layout: wild ow-edges: 1: two-way: diff --git a/presets/world/owr_checkerboardshuffle.yaml b/presets/world/owr_checkerboardshuffle.yaml new file mode 100644 index 00000000..b173f67d --- /dev/null +++ b/presets/world/owr_checkerboardshuffle.yaml @@ -0,0 +1,140 @@ +settings: + 1: + ow_layout: grid +ow-grid: + 1: + restricted_positions: + - cells: + - 0x00 + - 0x02 + - 0x04 + - 0x06 + - 0x09 + - 0x0B + - 0x0D + - 0x0F + - 0x10 + - 0x12 + - 0x14 + - 0x16 + - 0x19 + - 0x1B + - 0x1D + - 0x1F + - 0x20 + - 0x22 + - 0x24 + - 0x26 + - 0x29 + - 0x2B + - 0x2D + - 0x2F + - 0x30 + - 0x32 + - 0x34 + - 0x36 + - 0x39 + - 0x3B + - 0x3D + - 0x3F + positions: + - 0x00 + - 0x02 + - 0x04 + - 0x06 + - 0x09 + - 0x0B + - 0x0D + - 0x0F + - 0x10 + - 0x12 + - 0x14 + - 0x16 + - 0x19 + - 0x1B + - 0x1D + - 0x1F + - 0x20 + - 0x22 + - 0x24 + - 0x26 + - 0x29 + - 0x2B + - 0x2D + - 0x2F + - 0x30 + - 0x32 + - 0x34 + - 0x36 + - 0x39 + - 0x3B + - 0x3D + - 0x3F + world: both + - cells: + - 0x01 + - 0x03 + - 0x05 + - 0x07 + - 0x08 + - 0x0A + - 0x0C + - 0x0E + - 0x11 + - 0x13 + - 0x15 + - 0x17 + - 0x18 + - 0x1A + - 0x1C + - 0x1E + - 0x21 + - 0x23 + - 0x25 + - 0x27 + - 0x28 + - 0x2A + - 0x2C + - 0x2E + - 0x31 + - 0x33 + - 0x35 + - 0x37 + - 0x38 + - 0x3A + - 0x3C + - 0x3E + positions: + - 0x01 + - 0x03 + - 0x05 + - 0x07 + - 0x08 + - 0x0A + - 0x0C + - 0x0E + - 0x11 + - 0x13 + - 0x15 + - 0x17 + - 0x18 + - 0x1A + - 0x1C + - 0x1E + - 0x21 + - 0x23 + - 0x25 + - 0x27 + - 0x28 + - 0x2A + - 0x2C + - 0x2E + - 0x31 + - 0x33 + - 0x35 + - 0x37 + - 0x38 + - 0x3A + - 0x3C + - 0x3E + world: both \ No newline at end of file diff --git a/presets/world/owr_quadrantshuffle-diagonal.yaml b/presets/world/owr_quadrantshuffle-diagonal.yaml index 010d9e3c..56209a63 100644 --- a/presets/world/owr_quadrantshuffle-diagonal.yaml +++ b/presets/world/owr_quadrantshuffle-diagonal.yaml @@ -1,3 +1,6 @@ +settings: + 1: + ow_layout: wild ow-edges: 1: groups: diff --git a/presets/world/owr_quadrantshuffle-full.yaml b/presets/world/owr_quadrantshuffle-full.yaml index 6dabad7c..f230cdca 100644 --- a/presets/world/owr_quadrantshuffle-full.yaml +++ b/presets/world/owr_quadrantshuffle-full.yaml @@ -1,3 +1,6 @@ +settings: + 1: + ow_layout: wild ow-edges: 1: groups: diff --git a/presets/world/owr_quadrantshuffle-grid.yaml b/presets/world/owr_quadrantshuffle-grid.yaml new file mode 100644 index 00000000..c655fa49 --- /dev/null +++ b/presets/world/owr_quadrantshuffle-grid.yaml @@ -0,0 +1,147 @@ +settings: + 1: + ow_layout: grid +ow-grid: + 1: + restricted_positions: + - cells: + - 0x00 + - 0x01 + - 0x02 + - 0x03 + - 0x08 + - 0x09 + - 0x0A + - 0x0B + - 0x10 + - 0x11 + - 0x12 + - 0x13 + - 0x18 + - 0x19 + - 0x1A + - 0x1B + positions: + - 0x00 + - 0x01 + - 0x02 + - 0x03 + - 0x08 + - 0x09 + - 0x0A + - 0x0B + - 0x10 + - 0x11 + - 0x12 + - 0x13 + - 0x18 + - 0x19 + - 0x1A + - 0x1B + world: both + - cells: + - 0x20 + - 0x21 + - 0x22 + - 0x23 + - 0x28 + - 0x29 + - 0x2A + - 0x2B + - 0x30 + - 0x31 + - 0x32 + - 0x33 + - 0x38 + - 0x39 + - 0x3A + - 0x3B + positions: + - 0x20 + - 0x21 + - 0x22 + - 0x23 + - 0x28 + - 0x29 + - 0x2A + - 0x2B + - 0x30 + - 0x31 + - 0x32 + - 0x33 + - 0x38 + - 0x39 + - 0x3A + - 0x3B + world: both + - cells: + - 0x04 + - 0x05 + - 0x06 + - 0x07 + - 0x0C + - 0x0D + - 0x0E + - 0x0F + - 0x14 + - 0x15 + - 0x16 + - 0x17 + - 0x1C + - 0x1D + - 0x1E + - 0x1F + positions: + - 0x04 + - 0x05 + - 0x06 + - 0x07 + - 0x0C + - 0x0D + - 0x0E + - 0x0F + - 0x14 + - 0x15 + - 0x16 + - 0x17 + - 0x1C + - 0x1D + - 0x1E + - 0x1F + world: both + - cells: + - 0x24 + - 0x25 + - 0x26 + - 0x27 + - 0x2C + - 0x2D + - 0x2E + - 0x2F + - 0x34 + - 0x35 + - 0x36 + - 0x37 + - 0x3C + - 0x3D + - 0x3E + - 0x3F + positions: + - 0x24 + - 0x25 + - 0x26 + - 0x27 + - 0x2C + - 0x2D + - 0x2E + - 0x2F + - 0x34 + - 0x35 + - 0x36 + - 0x37 + - 0x3C + - 0x3D + - 0x3E + - 0x3F + world: both + split_large_screens: true \ No newline at end of file diff --git a/presets/world/owr_quadrantshuffle-vanillaborders.yaml b/presets/world/owr_quadrantshuffle-vanillaborders.yaml index 22f9e8fb..41c6b7c8 100644 --- a/presets/world/owr_quadrantshuffle-vanillaborders.yaml +++ b/presets/world/owr_quadrantshuffle-vanillaborders.yaml @@ -1,5 +1,6 @@ settings: 1: + ow_layout: wild ow_whirlpool: false ow-edges: 1: diff --git a/presets/world/owr_ringshuffle-borders.yaml b/presets/world/owr_ringshuffle-borders.yaml index 3cbdb28f..8c96582b 100644 --- a/presets/world/owr_ringshuffle-borders.yaml +++ b/presets/world/owr_ringshuffle-borders.yaml @@ -1,3 +1,6 @@ +settings: + 1: + ow_layout: wild ow-edges: 1: two-way: diff --git a/presets/world/owr_ringshuffle-full.yaml b/presets/world/owr_ringshuffle-full.yaml index c271befe..e113aa2d 100644 --- a/presets/world/owr_ringshuffle-full.yaml +++ b/presets/world/owr_ringshuffle-full.yaml @@ -1,3 +1,6 @@ +settings: + 1: + ow_layout: wild ow-edges: 1: groups: diff --git a/presets/world/owr_ringshuffle-grid.yaml b/presets/world/owr_ringshuffle-grid.yaml new file mode 100644 index 00000000..ded19fe2 --- /dev/null +++ b/presets/world/owr_ringshuffle-grid.yaml @@ -0,0 +1,147 @@ +settings: + 1: + ow_layout: grid +ow-grid: + 1: + restricted_positions: + - cells: + - 0x00 + - 0x01 + - 0x02 + - 0x03 + - 0x04 + - 0x05 + - 0x06 + - 0x07 + - 0x08 + - 0x0F + - 0x10 + - 0x17 + - 0x18 + - 0x1F + - 0x20 + - 0x27 + - 0x28 + - 0x2F + - 0x30 + - 0x37 + - 0x38 + - 0x39 + - 0x3A + - 0x3B + - 0x3C + - 0x3D + - 0x3E + - 0x3F + positions: + - 0x00 + - 0x01 + - 0x02 + - 0x03 + - 0x04 + - 0x05 + - 0x06 + - 0x07 + - 0x08 + - 0x0F + - 0x10 + - 0x17 + - 0x18 + - 0x1F + - 0x20 + - 0x27 + - 0x28 + - 0x2F + - 0x30 + - 0x37 + - 0x38 + - 0x39 + - 0x3A + - 0x3B + - 0x3C + - 0x3D + - 0x3E + - 0x3F + world: both + - cells: + - 0x09 + - 0x0A + - 0x0B + - 0x0C + - 0x0D + - 0x0E + - 0x11 + - 0x16 + - 0x19 + - 0x1E + - 0x21 + - 0x26 + - 0x29 + - 0x2E + - 0x31 + - 0x32 + - 0x33 + - 0x34 + - 0x35 + - 0x36 + positions: + - 0x09 + - 0x0A + - 0x0B + - 0x0C + - 0x0D + - 0x0E + - 0x11 + - 0x16 + - 0x19 + - 0x1E + - 0x21 + - 0x26 + - 0x29 + - 0x2E + - 0x31 + - 0x32 + - 0x33 + - 0x34 + - 0x35 + - 0x36 + world: both + - cells: + - 0x12 + - 0x13 + - 0x14 + - 0x15 + - 0x1A + - 0x1D + - 0x22 + - 0x25 + - 0x2A + - 0x2B + - 0x2C + - 0x2D + positions: + - 0x12 + - 0x13 + - 0x14 + - 0x15 + - 0x1A + - 0x1D + - 0x22 + - 0x25 + - 0x2A + - 0x2B + - 0x2C + - 0x2D + world: both + - cells: + - 0x1B + - 0x1C + - 0x23 + - 0x24 + positions: + - 0x1B + - 0x1C + - 0x23 + - 0x24 + world: both + split_large_screens: true \ No newline at end of file diff --git a/presets/world/owr_ringshuffle-interiors.yaml b/presets/world/owr_ringshuffle-interiors.yaml index 0dcfbaa7..d63655ad 100644 --- a/presets/world/owr_ringshuffle-interiors.yaml +++ b/presets/world/owr_ringshuffle-interiors.yaml @@ -1,3 +1,6 @@ +settings: + 1: + ow_layout: wild ow-edges: 1: two-way: diff --git a/presets/world/owr_shuffle-dark.yaml b/presets/world/owr_shuffle-dark.yaml index 3b27e6d2..e6e7bf48 100644 --- a/presets/world/owr_shuffle-dark.yaml +++ b/presets/world/owr_shuffle-dark.yaml @@ -1,5 +1,6 @@ settings: 1: + ow_parallel: false ow_whirlpool: false ow-edges: 1: @@ -77,6 +78,25 @@ ow-edges: Desert Pass EC*: Dam WC* Desert Pass ES*: Dam WS* Dam EC*: South Pass WC* +ow-grid: + 1: + fixed_arrangements: + - arrangement: + - 0x00 0x01 0x02 0x03 0x04 0x05 0x06 0x07 + - 0x08 0x09 0x0A 0x0B 0x0C 0x0D 0x0E 0x0F + - 0x10 0x11 0x12 0x13 0x14 0x15 0x16 0x17 + - 0x18 0x19 0x1A 0x1B 0x1C 0x1D 0x1E 0x1F + - 0x20 0x21 0x22 0x23 0x24 0x25 0x26 0x27 + - 0x28 0x29 0x2A 0x2B 0x2C 0x2D 0x2E 0x2F + - 0x30 0x31 0x32 0x33 0x34 0x35 0x36 0x37 + - 0x38 0x39 0x3A 0x3B 0x3C 0x3D 0x3E 0x3F + world: light + restricted_positions: + - cells: + - 0x00 + positions: + - 0x00 + world: light ow-whirlpools: 1: two-way: diff --git a/presets/world/owr_shuffle-horizontal.yaml b/presets/world/owr_shuffle-horizontal.yaml index 9eba3118..7fead28b 100644 --- a/presets/world/owr_shuffle-horizontal.yaml +++ b/presets/world/owr_shuffle-horizontal.yaml @@ -1,3 +1,6 @@ +settings: + 1: + ow_layout: wild ow-edges: 1: two-way: diff --git a/presets/world/owr_shuffle-horizontalbycolumns.yaml b/presets/world/owr_shuffle-horizontalbycolumns.yaml index 117b81d5..f56e5696 100644 --- a/presets/world/owr_shuffle-horizontalbycolumns.yaml +++ b/presets/world/owr_shuffle-horizontalbycolumns.yaml @@ -1,3 +1,6 @@ +settings: + 1: + ow_layout: wild ow-edges: 1: two-way: diff --git a/presets/world/owr_shuffle-largescreenpool.yaml b/presets/world/owr_shuffle-largescreenpool.yaml new file mode 100644 index 00000000..600493b8 --- /dev/null +++ b/presets/world/owr_shuffle-largescreenpool.yaml @@ -0,0 +1,149 @@ +settings: + 1: + ow_layout: grid +ow-grid: + 1: + restricted_positions: + - cells: + - 0x00 + - 0x03 + - 0x05 + - 0x18 + - 0x1B + - 0x1E + - 0x30 + - 0x35 + positions: + - 0x00 + - 0x03 + - 0x05 + - 0x18 + - 0x1B + - 0x1E + - 0x30 + - 0x35 + world: both + - cells: + - 0x01 + - 0x04 + - 0x06 + - 0x19 + - 0x1C + - 0x1F + - 0x31 + - 0x36 + positions: + - 0x01 + - 0x04 + - 0x06 + - 0x19 + - 0x1C + - 0x1F + - 0x31 + - 0x36 + world: both + - cells: + - 0x08 + - 0x0B + - 0x0D + - 0x20 + - 0x23 + - 0x26 + - 0x38 + - 0x3D + positions: + - 0x08 + - 0x0B + - 0x0D + - 0x20 + - 0x23 + - 0x26 + - 0x38 + - 0x3D + world: both + - cells: + - 0x09 + - 0x0C + - 0x0E + - 0x21 + - 0x24 + - 0x27 + - 0x39 + - 0x3E + positions: + - 0x09 + - 0x0C + - 0x0E + - 0x21 + - 0x24 + - 0x27 + - 0x39 + - 0x3E + world: both + - cells: + - 0x02 + - 0x07 + - 0x0A + - 0x0F + - 0x10 + - 0x11 + - 0x12 + - 0x13 + - 0x14 + - 0x15 + - 0x16 + - 0x17 + - 0x1A + - 0x1D + - 0x22 + - 0x25 + - 0x28 + - 0x29 + - 0x2A + - 0x2B + - 0x2C + - 0x2D + - 0x2E + - 0x2F + - 0x32 + - 0x33 + - 0x34 + - 0x37 + - 0x3A + - 0x3B + - 0x3C + - 0x3F + positions: + - 0x02 + - 0x07 + - 0x0A + - 0x0F + - 0x10 + - 0x11 + - 0x12 + - 0x13 + - 0x14 + - 0x15 + - 0x16 + - 0x17 + - 0x1A + - 0x1D + - 0x22 + - 0x25 + - 0x28 + - 0x29 + - 0x2A + - 0x2B + - 0x2C + - 0x2D + - 0x2E + - 0x2F + - 0x32 + - 0x33 + - 0x34 + - 0x37 + - 0x3A + - 0x3B + - 0x3C + - 0x3F + world: both \ No newline at end of file diff --git a/presets/world/owr_shuffle-largescreens.yaml b/presets/world/owr_shuffle-largescreens.yaml index 47798cfa..9bc37ecf 100644 --- a/presets/world/owr_shuffle-largescreens.yaml +++ b/presets/world/owr_shuffle-largescreens.yaml @@ -1,3 +1,6 @@ +settings: + 1: + ow_layout: wild settings: 1: ow_whirlpool: false diff --git a/presets/world/owr_shuffle-light.yaml b/presets/world/owr_shuffle-light.yaml index 4feaa75e..9b532c9a 100644 --- a/presets/world/owr_shuffle-light.yaml +++ b/presets/world/owr_shuffle-light.yaml @@ -1,3 +1,6 @@ +settings: + 1: + ow_parallel: false ow-edges: 1: two-way: @@ -69,6 +72,25 @@ ow-edges: Swamp Nook EC*: Swamp WC* Swamp Nook ES*: Swamp WS* Swamp EC*: Dark South Pass WC* +ow-grid: + 1: + fixed_arrangements: + - arrangement: + - 0x00 0x01 0x02 0x03 0x04 0x05 0x06 0x07 + - 0x08 0x09 0x0A 0x0B 0x0C 0x0D 0x0E 0x0F + - 0x10 0x11 0x12 0x13 0x14 0x15 0x16 0x17 + - 0x18 0x19 0x1A 0x1B 0x1C 0x1D 0x1E 0x1F + - 0x20 0x21 0x22 0x23 0x24 0x25 0x26 0x27 + - 0x28 0x29 0x2A 0x2B 0x2C 0x2D 0x2E 0x2F + - 0x30 0x31 0x32 0x33 0x34 0x35 0x36 0x37 + - 0x38 0x39 0x3A 0x3B 0x3C 0x3D 0x3E 0x3F + world: dark + restricted_positions: + - cells: + - 0x00 + positions: + - 0x00 + world: dark ow-whirlpools: 1: two-way: diff --git a/presets/world/owr_shuffle-separatemountain.yaml b/presets/world/owr_shuffle-separatemountain.yaml index 02a53d9c..0f07f4e6 100644 --- a/presets/world/owr_shuffle-separatemountain.yaml +++ b/presets/world/owr_shuffle-separatemountain.yaml @@ -1,3 +1,6 @@ +settings: + 1: + ow_layout: wild ow-edges: 1: groups: diff --git a/presets/world/owr_shuffle-smallscreens.yaml b/presets/world/owr_shuffle-smallscreens.yaml index a12ad95d..ab0af00b 100644 --- a/presets/world/owr_shuffle-smallscreens.yaml +++ b/presets/world/owr_shuffle-smallscreens.yaml @@ -1,3 +1,6 @@ +settings: + 1: + ow_layout: wild ow-edges: 1: two-way: diff --git a/presets/world/owr_shuffle-splitsimilar.yaml b/presets/world/owr_shuffle-splitsimilar.yaml index bf1dde3d..825aa744 100644 --- a/presets/world/owr_shuffle-splitsimilar.yaml +++ b/presets/world/owr_shuffle-splitsimilar.yaml @@ -1,5 +1,6 @@ settings: 1: + ow_layout: wild ow_terrain: false ow-edges: 1: diff --git a/presets/world/owr_shuffle-splitsimilarterrain.yaml b/presets/world/owr_shuffle-splitsimilarterrain.yaml index 2ade18e4..0e97404a 100644 --- a/presets/world/owr_shuffle-splitsimilarterrain.yaml +++ b/presets/world/owr_shuffle-splitsimilarterrain.yaml @@ -1,5 +1,6 @@ settings: 1: + ow_layout: wild ow_terrain: true ow-edges: 1: diff --git a/presets/world/owr_shuffle-vanillaloop.yaml b/presets/world/owr_shuffle-vanillaloop.yaml index bc4223fb..7a31c031 100644 --- a/presets/world/owr_shuffle-vanillaloop.yaml +++ b/presets/world/owr_shuffle-vanillaloop.yaml @@ -1,3 +1,6 @@ +settings: + 1: + ow_layout: wild ow-edges: 1: two-way: diff --git a/presets/world/owr_shuffle-vanillamountain.yaml b/presets/world/owr_shuffle-vanillamountain.yaml new file mode 100644 index 00000000..33cf3f3c --- /dev/null +++ b/presets/world/owr_shuffle-vanillamountain.yaml @@ -0,0 +1,16 @@ +ow-edges: + 1: + two-way: + West Death Mountain EN*: East Death Mountain WN* + West Death Mountain ES*: East Death Mountain WS* + East Death Mountain EN*: Death Mountain TR Pegs WN* + West Dark Death Mountain EN*: East Dark Death Mountain WN* + West Dark Death Mountain ES*: East Dark Death Mountain WS* + East Dark Death Mountain EN*: Turtle Rock WN* +ow-grid: + 1: + fixed_arrangements: + - arrangement: + - 0x03 0x04 0x05 0x06 0x07 + - 0x0B 0x0C 0x0D 0x0E . + world: both \ No newline at end of file diff --git a/presets/world/owr_shuffle-vertical.yaml b/presets/world/owr_shuffle-vertical.yaml index d037f0c7..6994698e 100644 --- a/presets/world/owr_shuffle-vertical.yaml +++ b/presets/world/owr_shuffle-vertical.yaml @@ -1,3 +1,6 @@ +settings: + 1: + ow_layout: wild ow-edges: 1: two-way: diff --git a/presets/world/owr_shuffle-verticalbyrows.yaml b/presets/world/owr_shuffle-verticalbyrows.yaml index 25650d60..44948112 100644 --- a/presets/world/owr_shuffle-verticalbyrows.yaml +++ b/presets/world/owr_shuffle-verticalbyrows.yaml @@ -1,3 +1,6 @@ +settings: + 1: + ow_layout: wild ow-edges: 1: two-way: diff --git a/presets/world/owr_shuffle-wrappedgrid.yaml b/presets/world/owr_shuffle-wrappedgrid.yaml new file mode 100644 index 00000000..537498e3 --- /dev/null +++ b/presets/world/owr_shuffle-wrappedgrid.yaml @@ -0,0 +1,7 @@ +settings: + 1: + ow_layout: grid +ow-grid: + 1: + wrap_horizontal: true + wrap_vertical: true \ No newline at end of file diff --git a/presets/world/owr_vanilla.yaml b/presets/world/owr_vanilla.yaml index 9c86cc79..992aaa0f 100644 --- a/presets/world/owr_vanilla.yaml +++ b/presets/world/owr_vanilla.yaml @@ -144,6 +144,25 @@ ow-edges: Swamp EC*: Dark South Pass WC* South Pass ES*: Lake Hylia WS* Dark South Pass ES*: Ice Lake WS* +ow-grid: + 1: + fixed_arrangements: + - arrangement: + - 0x00 0x01 0x02 0x03 0x04 0x05 0x06 0x07 + - 0x08 0x09 0x0A 0x0B 0x0C 0x0D 0x0E 0x0F + - 0x10 0x11 0x12 0x13 0x14 0x15 0x16 0x17 + - 0x18 0x19 0x1A 0x1B 0x1C 0x1D 0x1E 0x1F + - 0x20 0x21 0x22 0x23 0x24 0x25 0x26 0x27 + - 0x28 0x29 0x2A 0x2B 0x2C 0x2D 0x2E 0x2F + - 0x30 0x31 0x32 0x33 0x34 0x35 0x36 0x37 + - 0x38 0x39 0x3A 0x3B 0x3C 0x3D 0x3E 0x3F + world: both + restricted_positions: + - cells: + - 0x00 + positions: + - 0x00 + world: both ow-whirlpools: 1: two-way: From 6a59f582306d1a317323305d3d227a9859c9b992 Mon Sep 17 00:00:00 2001 From: Catobat <69204835+Catobat@users.noreply.github.com> Date: Sat, 21 Feb 2026 21:19:16 +0100 Subject: [PATCH 23/34] Consider number of separate overworld areas when picking a grid layout --- OverworldShuffle.py | 57 +++++++++++++++++++++++++---- source/overworld/LayoutGenerator.py | 44 ++++++++++++++-------- 2 files changed, 79 insertions(+), 22 deletions(-) diff --git a/OverworldShuffle.py b/OverworldShuffle.py index b1eca427..6a9dd637 100644 --- a/OverworldShuffle.py +++ b/OverworldShuffle.py @@ -567,7 +567,7 @@ def link_overworld(world, player): remove_connected(forward_edge_sets, back_edge_sets) assert len(connected_edges) == len(default_connections) * 2, connected_edges - valid_layout = validate_layout(world, player) + valid_layout = world.accessibility[player] == 'none' or validate_layout(world, player) tries -= 1 assert valid_layout, 'Could not find a valid OW layout' @@ -1369,9 +1369,6 @@ def build_accessible_region_list(world, start_region, player, build_copy_world=F return explored_regions def validate_layout(world, player): - if world.accessibility[player] == 'none': - return True - entrance_connectors = { 'East Death Mountain (Bottom)': ['East Death Mountain (Top East)'], 'Kakariko Suburb Area': ['Maze Race Ledge'], @@ -1458,7 +1455,7 @@ def validate_layout(world, player): while unreachable_count != len(unreachable_regions): # find unreachable regions unreachable_regions = {} - for region_name in list(OWTileRegions.copy().keys()): + for region_name in list(OWTileRegions.keys()): if region_name not in explored_regions and region_name not in isolated_regions: region = world.get_region(region_name, player) unreachable_regions[region_name] = region @@ -1501,9 +1498,55 @@ def validate_layout(world, player): if len(unreachable_regions): return False - + return True - + +def get_separate_ow_areas(world, player): + """ + Returns a list of separated areas in the overworld layout. + It looks at the distinct connected components when only considering + OW edge and whirlpool connections (no entrances, portals, mirror, or flute). + Uses Union-Find to handle directed edges properly (treats them as undirected). + """ + parent = {} + + def find(x): + if x not in parent: + parent[x] = x + if parent[x] != x: + parent[x] = find(parent[x]) # Path compression + return parent[x] + + def union(x, y): + root_x = find(x) + root_y = find(y) + if root_x != root_y: + parent[root_y] = root_x + + all_regions = set(OWTileRegions.keys()) - set(isolated_regions) + considered_exit_spot_types = set(['OpenTerrain', 'OWTerrain', 'Ledge', 'OWEdge', 'Whirlpool']) + + # Initialize all regions in Union-Find + for region_name in all_regions: + find(region_name) + + # Build connections by examining all edges (treating directed as undirected) + for region_name in all_regions: + region = world.get_region(region_name, player) + for exit in region.exits: + if exit.spot_type in considered_exit_spot_types and exit.connected_region is not None and exit.connected_region.name in all_regions: + union(region_name, exit.connected_region.name) + + # Group regions by their root + areas = {} + for region_name in all_regions: + root = find(region_name) + if root not in areas: + areas[root] = [] + areas[root].append(region_name) + + return list(areas.values()) + test_connections = [ #('Links House ES', 'Octoballoon WS'), #('Links House NE', 'Lost Woods Pass SW') diff --git a/source/overworld/LayoutGenerator.py b/source/overworld/LayoutGenerator.py index 56b28bd1..7e6a05bc 100644 --- a/source/overworld/LayoutGenerator.py +++ b/source/overworld/LayoutGenerator.py @@ -4,7 +4,7 @@ import RaceRandom as random import random as _random from typing import List, Dict, Optional, Set, Tuple from BaseClasses import OWEdge, World, Direction, Terrain -from OverworldShuffle import connect_two_way, validate_layout +from OverworldShuffle import connect_two_way, get_separate_ow_areas, validate_layout ENABLE_KEEP_SIMILAR_SPECIAL_HANDLING = False DRAW_IMAGE = True @@ -155,7 +155,7 @@ class LayoutGeneratorOptions: 'forced_non_crossed_edges', 'forced_crossed_edges', 'check_reachability', 'crossed_chance', 'crossed_limit', 'sort_by_edge_sides', 'sort_by_max_edges_per_side', 'sort_by_piece_size', - 'min_runs', 'max_runs', 'target_runs_times_successes') + 'min_runs', 'max_runs', 'target_runs_times_successes', 'score_mult_separate_areas') def __init__( self, @@ -183,7 +183,8 @@ class LayoutGeneratorOptions: sort_by_piece_size: bool = False, min_runs: int = 100, max_runs: int = 10000, - target_runs_times_successes: int = 5000 + target_runs_times_successes: int = 5000, + score_mult_separate_areas: float = 4 ): self.horizontal_wrap = horizontal_wrap self.vertical_wrap = vertical_wrap @@ -210,6 +211,7 @@ class LayoutGeneratorOptions: self.min_runs = min_runs self.max_runs = max_runs self.target_runs_times_successes = target_runs_times_successes + self.score_mult_separate_areas = score_mult_separate_areas class LayoutGeneratorResult: """ @@ -1655,14 +1657,18 @@ def place_single_restriction_pieces( return remaining_pieces, placed_count def get_random_layout(world: World, player: int, connected_edges_cache: List[str], pieces_to_place: List[Piece], options: LayoutGeneratorOptions, prio_edges: List[str], overworld_screens: Dict[int, Screen]) -> LayoutGeneratorResult: + skip_validate_layout = world.accessibility[player] == 'none' + score_mult_separate_areas = options.score_mult_separate_areas total_score = 0 best_score = -1000000 worst_score = 1000000 best_grid_info = None + separate_areas = None # Pre-place pieces with single-element restriction lists base_grid_info = create_empty_grid_info(0.0) remaining_pieces, preplaced_count = place_single_restriction_pieces(world, player, base_grid_info, options, pieces_to_place) + logger = logging.getLogger('') successes = 0 failures = 0 @@ -1716,21 +1722,18 @@ def get_random_layout(world: World, player: int, connected_edges_cache: List[str # Successfully placed all pieces if options.check_reachability: disabled_count = connect_edges_for_screen_layout(world, player, grid_info, options, connected_edges, prio_edges, overworld_screens, False) - valid_layout = validate_layout(world, player) - # Clean up connected entrances and edges - for edge_name in connected_edges: - if edge_name not in connected_edges_cache: - entrance = world.get_entrance(edge_name, player) - entrance.connected_region.entrances.remove(entrance) - entrance.connected_region = None - edge = world.get_owedge(edge_name, player) - edge.dest = None + valid_layout = skip_validate_layout or validate_layout(world, player) if not valid_layout: + clean_up_connected_edges(world, player, connected_edges_cache, connected_edges) failures += 1 continue - logging.getLogger('').debug("Found valid layout with " + str(disabled_count)+ " disabled edges") - successes += 1 score = -disabled_count + if score_mult_separate_areas > 0: + separate_areas = len(get_separate_ow_areas(world, player)) + score -= score_mult_separate_areas * separate_areas + logger.debug("Found valid layout with " + str(disabled_count) + " disabled edges and " + str(separate_areas) + " separate areas") + clean_up_connected_edges(world, player, connected_edges_cache, connected_edges) + successes += 1 else: successes += 1 score = major_score @@ -1759,6 +1762,15 @@ def get_random_layout(world: World, player: int, connected_edges_cache: List[str failures=failures ) +def clean_up_connected_edges(world: World, player: int, connected_edges_cache: List[str], connected_edges: List[str]) -> None: + for edge_name in connected_edges: + if edge_name not in connected_edges_cache: + entrance = world.get_entrance(edge_name, player) + entrance.connected_region.entrances.remove(entrance) + entrance.connected_region = None + edge = world.get_owedge(edge_name, player) + edge.dest = None + def get_prioritized_edges(world: World, player: int) -> List[str]: prio_edges = [] if world.accessibility[player] != 'none': @@ -2080,7 +2092,8 @@ def generate_random_grid_layout(world: World, player: int, connected_edges: List sort_by_piece_size=True, min_runs=100, max_runs=10000, - target_runs_times_successes=5000 + target_runs_times_successes=5000, + score_mult_separate_areas=4 ) overworld_screens = initialize_screens(world, player) @@ -2112,6 +2125,7 @@ def generate_random_grid_layout(world: World, player: int, connected_edges: List logger.debug(f" Successes: {result.successes}") logger.debug(f" Failures: {result.failures}") logger.debug(f" Generation time: {elapsed_time:.3f}s") + logger.debug(f" Layouts per second: {(result.successes+result.failures)/elapsed_time:.3f}") if DRAW_IMAGE: logger.debug("Creating layout visualization...") From 54e4176311419053d4056f9551865ba3774817a2 Mon Sep 17 00:00:00 2001 From: Catobat <69204835+Catobat@users.noreply.github.com> Date: Sun, 22 Feb 2026 23:06:47 +0100 Subject: [PATCH 24/34] Consider distance between starting locations when picking a grid layout --- source/overworld/LayoutGenerator.py | 49 ++++++++++++++++++++++++++--- 1 file changed, 44 insertions(+), 5 deletions(-) diff --git a/source/overworld/LayoutGenerator.py b/source/overworld/LayoutGenerator.py index 7e6a05bc..26666a47 100644 --- a/source/overworld/LayoutGenerator.py +++ b/source/overworld/LayoutGenerator.py @@ -7,7 +7,7 @@ from BaseClasses import OWEdge, World, Direction, Terrain from OverworldShuffle import connect_two_way, get_separate_ow_areas, validate_layout ENABLE_KEEP_SIMILAR_SPECIAL_HANDLING = False -DRAW_IMAGE = True +DRAW_IMAGE = False large_screen_ids = [0x00, 0x03, 0x05, 0x18, 0x1B, 0x1E, 0x30, 0x35] + [0x40, 0x43, 0x45, 0x58, 0x5B, 0x5E, 0x70, 0x75] @@ -155,7 +155,8 @@ class LayoutGeneratorOptions: 'forced_non_crossed_edges', 'forced_crossed_edges', 'check_reachability', 'crossed_chance', 'crossed_limit', 'sort_by_edge_sides', 'sort_by_max_edges_per_side', 'sort_by_piece_size', - 'min_runs', 'max_runs', 'target_runs_times_successes', 'score_mult_separate_areas') + 'min_runs', 'max_runs', 'target_runs_times_successes', 'score_mult_separate_areas', + 'start_loc_min_distance', 'score_mult_start_loc_distance') def __init__( self, @@ -184,7 +185,9 @@ class LayoutGeneratorOptions: min_runs: int = 100, max_runs: int = 10000, target_runs_times_successes: int = 5000, - score_mult_separate_areas: float = 4 + score_mult_separate_areas: float = 4, + start_loc_min_distance: int = 4, + score_mult_start_loc_distance: float = 3 ): self.horizontal_wrap = horizontal_wrap self.vertical_wrap = vertical_wrap @@ -212,6 +215,8 @@ class LayoutGeneratorOptions: self.max_runs = max_runs self.target_runs_times_successes = target_runs_times_successes self.score_mult_separate_areas = score_mult_separate_areas + self.start_loc_min_distance = start_loc_min_distance + self.score_mult_start_loc_distance = score_mult_start_loc_distance class LayoutGeneratorResult: """ @@ -1659,11 +1664,13 @@ def place_single_restriction_pieces( def get_random_layout(world: World, player: int, connected_edges_cache: List[str], pieces_to_place: List[Piece], options: LayoutGeneratorOptions, prio_edges: List[str], overworld_screens: Dict[int, Screen]) -> LayoutGeneratorResult: skip_validate_layout = world.accessibility[player] == 'none' score_mult_separate_areas = options.score_mult_separate_areas + apply_start_loc_penalty = options.score_mult_start_loc_distance > 0 and world.shuffle[player] == 'vanilla' and (world.is_dark_chapel_start(player) or world.doorShuffle[player] == 'vanilla' or world.intensity[player] < 3 or world.mode[player] == 'standard') total_score = 0 best_score = -1000000 worst_score = 1000000 best_grid_info = None separate_areas = None + start_loc_distance = None # Pre-place pieces with single-element restriction lists base_grid_info = create_empty_grid_info(0.0) @@ -1731,7 +1738,12 @@ def get_random_layout(world: World, player: int, connected_edges_cache: List[str if score_mult_separate_areas > 0: separate_areas = len(get_separate_ow_areas(world, player)) score -= score_mult_separate_areas * separate_areas - logger.debug("Found valid layout with " + str(disabled_count) + " disabled edges and " + str(separate_areas) + " separate areas") + if apply_start_loc_penalty: + start_loc_distance = get_start_loc_distance(world, player, grid_info.grid, options) + min_dist = options.start_loc_min_distance + if start_loc_distance < min_dist: + score -= options.score_mult_start_loc_distance * (min_dist - start_loc_distance) + logger.debug("Found valid layout with " + str(disabled_count) + " disabled edges and " + str(separate_areas) + " separate areas and distance " + str(start_loc_distance) + " between start locations") clean_up_connected_edges(world, player, connected_edges_cache, connected_edges) successes += 1 else: @@ -1771,6 +1783,31 @@ def clean_up_connected_edges(world: World, player: int, connected_edges_cache: L edge = world.get_owedge(edge_name, player) edge.dest = None +def find_cell_position(grid: List[List[List[int]]], cell_id: int) -> Optional[Tuple[int, int, int]]: + """Find the position of a cell in the grid, returning (world, row, col) or None if not found.""" + for w in range(2): + for row in range(8): + for col in range(8): + if grid[w][row][col] == cell_id: + return (w, row, col) + return None + +def get_start_loc_distance(world: World, player: int, grid: List[List[List[int]]], options: LayoutGeneratorOptions) -> float: + """Computes the starting location Manhattan distance on the grid, treating the world as a third dimension (switching world adds 1 to the distance).""" + pos_lh = find_cell_position(grid, 0x6C if world.is_bombshop_start(player) else 0x2C) + pos_sanc = find_cell_position(grid, 0x53 if world.is_dark_chapel_start(player) else 0x13) + if pos_lh is None or pos_sanc is None: + raise GenerationException("Could not find starting location cells, something went wrong with grid layout generation!") + w1, row1, col1 = pos_lh + w2, row2, col2 = pos_sanc + row_diff = abs(row1 - row2) + col_diff = abs(col1 - col2) + if options.horizontal_wrap: + col_diff = min(col_diff, 8 - col_diff) + if options.vertical_wrap: + row_diff = min(row_diff, 8 - row_diff) + return row_diff + col_diff + abs(w1 - w2) + def get_prioritized_edges(world: World, player: int) -> List[str]: prio_edges = [] if world.accessibility[player] != 'none': @@ -2093,7 +2130,9 @@ def generate_random_grid_layout(world: World, player: int, connected_edges: List min_runs=100, max_runs=10000, target_runs_times_successes=5000, - score_mult_separate_areas=4 + score_mult_separate_areas=4, + start_loc_min_distance=4, + score_mult_start_loc_distance=3 ) overworld_screens = initialize_screens(world, player) From af9b61ad7dd04ba00e724c576fd1646071faa823 Mon Sep 17 00:00:00 2001 From: aerinon Date: Wed, 11 Mar 2026 10:08:54 -0600 Subject: [PATCH 25/34] fix: beemizer + pottery + multiworld generation issue --- Fill.py | 9 +++++++-- Main.py | 2 +- PastReleaseNotes.md | 3 +++ RELEASENOTES.md | 5 ++--- 4 files changed, 13 insertions(+), 6 deletions(-) diff --git a/Fill.py b/Fill.py index 349ff83e..935dad37 100644 --- a/Fill.py +++ b/Fill.py @@ -608,8 +608,13 @@ def fast_fill_pot_for_multiworld(world, item_pool, fill_locations): flex = 256 - world.data_tables[player].pot_secret_table.multiworld_count fill_count = len(pot_fill_locations[player]) - flex if fill_count > 0: - fill_spots = random.sample(pot_fill_locations[player], fill_count) - fill_items = random.sample(pot_item_pool[player], fill_count) + first_count = min(fill_count, len(pot_item_pool[player])) + fill_items = random.sample(pot_item_pool[player], first_count) + remaining = fill_count - first_count + if remaining > 0: + other_items = [i for i in item_pool if i.player == player and i not in pot_item_pool[player]] + fill_items += random.sample(other_items, min(remaining, len(other_items))) + fill_spots = random.sample(pot_fill_locations[player], len(fill_items)) for x in fill_items: item_pool.remove(x) for x in fill_spots: diff --git a/Main.py b/Main.py index 3e3a3952..d6925fbd 100644 --- a/Main.py +++ b/Main.py @@ -38,7 +38,7 @@ from source.enemizer.DamageTables import DamageTable from source.enemizer.Enemizer import randomize_enemies from source.rom.DataTables import init_data_tables -version_number = '1.5.5' +version_number = '1.5.6' version_branch = '-u' __version__ = f'{version_number}{version_branch}' diff --git a/PastReleaseNotes.md b/PastReleaseNotes.md index e2915b60..d7984bec 100644 --- a/PastReleaseNotes.md +++ b/PastReleaseNotes.md @@ -10,6 +10,9 @@ # Patch Notes Changelog archive +* 1.5.5 + * Logic: Fixed an issue where PoD Bridge lead to Arena Main instead of Arena Landing Area. (Potentially unnecessarily requiring bombs or Somaria to progress) + * HUD: Key counters are correct even when door shuffle is off * 1.5.4 * Documentation: New AI-assisted documentation [Site](https://aerinon.github.io/ALttPDoorRandomizer) * Generation Error: Fixed Issue with Shop Code and Take Any Caves (thanks Codemann for assistance) diff --git a/RELEASENOTES.md b/RELEASENOTES.md index 86d2c0f2..0a098615 100644 --- a/RELEASENOTES.md +++ b/RELEASENOTES.md @@ -1,7 +1,6 @@ # Patch Notes -* 1.5.5 - * Logic: Fixed an issue where PoD Bridge lead to Arena Main instead of Arena Landing Area. (Potentially unnecessarily requiring bombs or Somaria to progress) - * HUD: Key counters are correct even when door shuffle is off +* 1.5.6 + * Multiworld: Fixed a generation crash when beemizer is active and pottery is enabled. Pot locations are now properly filled with same-player items when the MW limit is hit even when beemizer has replaced native pot items. From b2b775e243f41244eef11f8b8a54f3a10549d42f Mon Sep 17 00:00:00 2001 From: aerinon Date: Wed, 11 Mar 2026 15:22:11 -0600 Subject: [PATCH 26/34] feat: item_pool_adjust added to customizer --- ItemList.py | 47 ++++++++++++++++++++++++-------- RELEASENOTES.md | 1 + docs/Customizer.md | 24 ++++++++++++++-- docs/customizer_example.yaml | 5 ++++ source/classes/CustomSettings.py | 5 ++++ 5 files changed, 69 insertions(+), 13 deletions(-) diff --git a/ItemList.py b/ItemList.py index 32da56cc..ecff7555 100644 --- a/ItemList.py +++ b/ItemList.py @@ -287,6 +287,42 @@ def generate_itempool(world, player): for _ in range(0, amt): pool.append('Rupees (20)') + if world.shopsanity[player] and not skip_pool_adjustments: + for shop in world.shops[player]: + if shop.region.name in shop_to_location_table: + for index, slot in enumerate(shop.inventory): + if slot: + item = slot['item'] + if shop.region.name == 'Capacity Upgrade' and world.difficulty[player] != 'normal': + pool.append('Rupees (20)') + else: + pool.append(item) + + if (world.customizer and world.customizer.get_item_pool_adjust() + and player in world.customizer.get_item_pool_adjust()): + diff = difficulties[world.difficulty[player]] + for item_name, delta in world.customizer.get_item_pool_adjust()[player].items(): + if not isinstance(delta, int): + continue + if delta > 0: + if item_name == 'Bottle (Random)': + for _ in range(delta): + pool.append(random.choice(diff.bottles)) + else: + pool.extend([item_name] * delta) + elif delta < 0: + remove_count = abs(delta) + if item_name == 'Bottle (Random)': + bottle_names = set(diff.bottles) + for _ in range(remove_count): + bottle = next((x for x in pool if x in bottle_names), None) + if bottle: + pool.remove(bottle) + else: + for _ in range(remove_count): + if item_name in pool: + pool.remove(item_name) + if world.logic[player] == 'hybridglitches' and world.pottery[player] not in ['none', 'cave']: # In HMG force swamp smalls in pots to allow getting out of swamp palace placed_items['Swamp Palace - Trench 1 Pot Key'] = 'Small Key (Swamp Palace)' @@ -329,17 +365,6 @@ def generate_itempool(world, player): world.get_location(location, player).event = True world.get_location(location, player).locked = True - if world.shopsanity[player] and not skip_pool_adjustments: - for shop in world.shops[player]: - if shop.region.name in shop_to_location_table: - for index, slot in enumerate(shop.inventory): - if slot: - item = slot['item'] - if shop.region.name == 'Capacity Upgrade' and world.difficulty[player] != 'normal': - pool.append('Rupees (20)') - else: - pool.append(item) - items = ItemFactory(pool, player) if world.shopsanity[player]: for potion in ['Green Potion', 'Blue Potion', 'Red Potion']: diff --git a/RELEASENOTES.md b/RELEASENOTES.md index 0a098615..af6ac06b 100644 --- a/RELEASENOTES.md +++ b/RELEASENOTES.md @@ -2,5 +2,6 @@ * 1.5.6 * Multiworld: Fixed a generation crash when beemizer is active and pottery is enabled. Pot locations are now properly filled with same-player items when the MW limit is hit even when beemizer has replaced native pot items. + * Customizer: Added `item_pool_adjust` section to apply additive/subtractive deltas to the base item pool rather than replacing it entirely. diff --git a/docs/Customizer.md b/docs/Customizer.md index 2c76da96..b8b7af28 100644 --- a/docs/Customizer.md +++ b/docs/Customizer.md @@ -64,10 +64,30 @@ Then each player can have the entire item pool defined. The name of item should `Bottle (Random)` is supported to randomize bottle contents according to those allowed by difficulty. Pendants and crystals are supported here. -##### Caveat - +**Note**: `item_pool` is a **full replacement** of the base item pool. Every item the player will receive must be listed. If you only want to tweak the default pool, use `item_pool_adjust` instead. + +##### Caveat + Dungeon items amount can be increased (but not decreased as the minimum of each dungeon item is either pre-determined or calculated by door rando) if the type of dungeon item is not shuffled then it is attempted to be placed in the dungeon. Extra item beyond dungeon capacity not be confined to the dungeon. +### item_pool_adjust + +This must be defined by player. Each player number should be listed with the appropriate adjustments. + +Unlike `item_pool`, this section **adjusts** the base item pool generated by the randomizer settings rather than replacing it. Use positive values to add items and negative values to remove items. + +```yaml +item_pool_adjust: + 1: + Bottle (Random): 2 # add 2 extra random bottles + Rupees (300): 1 # add 1 extra rupee pack + Boss Heart Container: -3 # remove 3 heart containers from the base pool +``` + +`Bottle (Random)` follows the same bottle randomization rules as in `item_pool`. When removing bottles with `Bottle (Random): -N`, any bottle (regardless of contents) will be removed. + +Removals that exceed the number of that item currently in the pool are silently ignored. Item pool adjustments are applied after beemizer but before the standard-mode Link's Uncle weapon selection, so weapons added here are eligible for that placement. + ### placements This must be defined by player. Each player number should be listed with the appropriate placement list. diff --git a/docs/customizer_example.yaml b/docs/customizer_example.yaml index 82f3fb7b..17c6f90c 100644 --- a/docs/customizer_example.yaml +++ b/docs/customizer_example.yaml @@ -60,6 +60,11 @@ item_pool: Green Potion: 1 Blue Potion: 1 Red Potion: 1 +item_pool_adjust: + 1: + Bottle (Random): 2 # add 2 extra random bottles on top of the base pool + Magic Upgrade (1/2): 1 # add 1 extra half-magic + Boss Heart Container: -3 # remove 3 heart containers from the base pool placements: 1: Palace of Darkness - Big Chest: Hammer diff --git a/source/classes/CustomSettings.py b/source/classes/CustomSettings.py index a9ef34d9..80b25d44 100644 --- a/source/classes/CustomSettings.py +++ b/source/classes/CustomSettings.py @@ -202,6 +202,11 @@ class CustomSettings(object): return self.file_source['item_pool'] return None + def get_item_pool_adjust(self): + if 'item_pool_adjust' in self.file_source: + return self.file_source['item_pool_adjust'] + return None + def get_placements(self): if 'placements' in self.file_source: return self.file_source['placements'] From a4d7d632355ee453b7251a3bd85b065cf3617a9a Mon Sep 17 00:00:00 2001 From: aerinon Date: Wed, 11 Mar 2026 15:29:09 -0600 Subject: [PATCH 27/34] fix: disable pikit drops due to vanilla steal failure bug --- RELEASENOTES.md | 1 + source/dungeon/EnemyList.py | 2 +- source/enemizer/SpriteSheets.py | 2 +- 3 files changed, 3 insertions(+), 2 deletions(-) diff --git a/RELEASENOTES.md b/RELEASENOTES.md index af6ac06b..2aa01541 100644 --- a/RELEASENOTES.md +++ b/RELEASENOTES.md @@ -3,5 +3,6 @@ * 1.5.6 * Multiworld: Fixed a generation crash when beemizer is active and pottery is enabled. Pot locations are now properly filled with same-player items when the MW limit is hit even when beemizer has replaced native pot items. * Customizer: Added `item_pool_adjust` section to apply additive/subtractive deltas to the base item pool rather than replacing it entirely. + * Enemy Drops: Pikit are no longer eligible for dropped items due to a vanilla bug where a failed steal can overwrite the assigned drop. diff --git a/source/dungeon/EnemyList.py b/source/dungeon/EnemyList.py index 2ce45a26..896c17b1 100644 --- a/source/dungeon/EnemyList.py +++ b/source/dungeon/EnemyList.py @@ -449,7 +449,7 @@ def init_enemy_stats(): EnemySprite.Stalfos: EnemyStats(EnemySprite.Stalfos, False, True, 6, health=4, dmg=1), EnemySprite.GreenZirro: EnemyStats(EnemySprite.GreenZirro, False, False, 1, health=4, dmg=5, dmask=0x80), EnemySprite.BlueZirro: EnemyStats(EnemySprite.BlueZirro, False, False, 7, health=8, dmg=3, dmask=0x80), - EnemySprite.Pikit: EnemyStats(EnemySprite.Pikit, False, True, 2, health=12, dmg=5), + EnemySprite.Pikit: EnemyStats(EnemySprite.Pikit, False, False, 2, health=12, dmg=5), EnemySprite.OldMan: EnemyStats(EnemySprite.OldMan, True, dmg=0), EnemySprite.PipeDown: EnemyStats(EnemySprite.PipeDown, True, dmg=0), diff --git a/source/enemizer/SpriteSheets.py b/source/enemizer/SpriteSheets.py index 7de739f3..e2abaa7d 100644 --- a/source/enemizer/SpriteSheets.py +++ b/source/enemizer/SpriteSheets.py @@ -329,7 +329,7 @@ def init_sprite_requirements(): SpriteRequirement(EnemySprite.Stalfos).sub_group(0, 0x1f), SpriteRequirement(EnemySprite.GreenZirro).no_drop().sub_group(3, 0x1b).exclude(NoFlyingRooms), SpriteRequirement(EnemySprite.BlueZirro).no_drop().sub_group(3, 0x1b).exclude(NoFlyingRooms), - SpriteRequirement(EnemySprite.Pikit).sub_group(3, 0x1b), + SpriteRequirement(EnemySprite.Pikit).no_drop().sub_group(3, 0x1b), SpriteRequirement(EnemySprite.CrystalMaiden).affix(), SpriteRequirement(EnemySprite.OldMan).affix().sub_group(2, 0x1c), SpriteRequirement(EnemySprite.PipeDown).affix(), From 4da73127a224ec86e762c1f838d8d9c3f9735845 Mon Sep 17 00:00:00 2001 From: aerinon Date: Thu, 12 Mar 2026 12:59:58 -0600 Subject: [PATCH 28/34] fix: reworked spawn refills for standard + enemy drop --- RELEASENOTES.md | 7 ++++--- Rom.py | 30 +++++++++++++++--------------- 2 files changed, 19 insertions(+), 18 deletions(-) diff --git a/RELEASENOTES.md b/RELEASENOTES.md index 2aa01541..a43e0725 100644 --- a/RELEASENOTES.md +++ b/RELEASENOTES.md @@ -1,8 +1,9 @@ # Patch Notes * 1.5.6 - * Multiworld: Fixed a generation crash when beemizer is active and pottery is enabled. Pot locations are now properly filled with same-player items when the MW limit is hit even when beemizer has replaced native pot items. - * Customizer: Added `item_pool_adjust` section to apply additive/subtractive deltas to the base item pool rather than replacing it entirely. * Enemy Drops: Pikit are no longer eligible for dropped items due to a vanilla bug where a failed steal can overwrite the assigned drop. - + * Standard Mode: Reworked spawn refills to be more generous for enemy drop modes. + * Customizer: Added `item_pool_adjust` section to apply additive/subtractive deltas to the base item pool rather than replacing it entirely. + * Multiworld: Fixed a generation crash when beemizer is active and pottery is enabled. Pot locations are now properly filled with same-player items when the MW limit is hit even when beemizer has replaced native pot items. + diff --git a/Rom.py b/Rom.py index 6d52e6c8..4a88b1f5 100644 --- a/Rom.py +++ b/Rom.py @@ -1348,38 +1348,38 @@ def patch_rom(world, rom, player, team, is_mystery=False): rom.write_bytes(0x180188, [0, 0, 0]) # Zelda respawn refills (magic, bombs, arrows) rom.write_bytes(0x18018B, [0, 0, 0]) # Mantle respawn refills (magic, bombs, arrows) bow_max, bomb_max, magic_max = 0, 0, 0 - bow_small, magic_small = 0, 0 + bow_small, bomb_small, magic_small = 10, 3, 0x20 if world.mode[player] == 'standard': if uncle_location.item is not None and uncle_location.item.name in ['Bow', 'Progressive Bow']: rom.write_byte(0x18004E, 1) # Escape Fill (arrows) write_int16(rom, 0x180183, 300) # Escape fill rupee bow rom.write_bytes(0x180185, [0, 0, 70]) # Uncle respawn refills (magic, bombs, arrows) - rom.write_bytes(0x180188, [0, 0, 10]) # Zelda respawn refills (magic, bombs, arrows) - rom.write_bytes(0x18018B, [0, 0, 10]) # Mantle respawn refills (magic, bombs, arrows) - bow_max, bow_small = 70, 10 + rom.write_bytes(0x180188, [0, 0, 70]) # Zelda respawn refills (magic, bombs, arrows) + rom.write_bytes(0x18018B, [0, 0, 70]) # Mantle respawn refills (magic, bombs, arrows) + bow_max = 70 elif uncle_location.item is not None and uncle_location.item.name in ['Bomb Upgrade (+10)' if world.bombbag[player] else 'Bombs (10)']: rom.write_byte(0x18004E, 2) # Escape Fill (bombs) rom.write_bytes(0x180185, [0, 50, 0]) # Uncle respawn refills (magic, bombs, arrows) - rom.write_bytes(0x180188, [0, 3, 0]) # Zelda respawn refills (magic, bombs, arrows) - rom.write_bytes(0x18018B, [0, 3, 0]) # Mantle respawn refills (magic, bombs, arrows) + rom.write_bytes(0x180188, [0, 50, 0]) # Zelda respawn refills (magic, bombs, arrows) + rom.write_bytes(0x18018B, [0, 50, 0]) # Mantle respawn refills (magic, bombs, arrows) bomb_max = 50 elif uncle_location.item is not None and uncle_location.item.name in ['Cane of Somaria', 'Cane of Byrna', 'Fire Rod']: rom.write_byte(0x18004E, 4) # Escape Fill (magic) rom.write_bytes(0x180185, [0x80, 0, 0]) # Uncle respawn refills (magic, bombs, arrows) - rom.write_bytes(0x180188, [0x20, 0, 0]) # Zelda respawn refills (magic, bombs, arrows) - rom.write_bytes(0x18018B, [0x20, 0, 0]) # Mantle respawn refills (magic, bombs, arrows) - magic_max, magic_small = 0x80, 0x20 + rom.write_bytes(0x180188, [0x80, 0, 0]) # Zelda respawn refills (magic, bombs, arrows) + rom.write_bytes(0x18018B, [0x80, 0, 0]) # Mantle respawn refills (magic, bombs, arrows) + magic_max = 0x80 if world.doorShuffle[player] not in ['vanilla', 'basic']: # Uncle respawn refills (magic, bombs, arrows) - rom.write_bytes(0x180185, [max(0x20, magic_max), max(3, bomb_max), max(10, bow_max)]) + rom.write_bytes(0x180185, [max(magic_small, magic_max), max(bomb_small, bomb_max), max(bow_small, bow_max)]) # Zelda respawn refills (magic, bombs, arrows) - rom.write_bytes(0x180188, [max(0x20, magic_max), max(3, bomb_max), max(10, bow_max)]) + rom.write_bytes(0x180188, [max(magic_small, magic_max), max(bomb_small, bomb_max), max(bow_small, bow_max)]) # Mantle respawn refills (magic, bombs, arrows) - rom.write_bytes(0x18018B, [max(0x20, magic_max), max(3, bomb_max), max(10, bow_max)]) + rom.write_bytes(0x18018B, [max(magic_small, magic_max), max(bomb_small, bomb_max), max(bow_small, bow_max)]) elif world.doorShuffle[player] == 'basic': # just in case a bomb is needed to get to a chest - rom.write_bytes(0x180185, [max(0x00, magic_max), max(3, bomb_max), max(0, bow_max)]) - rom.write_bytes(0x180188, [magic_small, 3, bow_small]) # Zelda respawn refills (magic, bombs, arrows) - rom.write_bytes(0x18018B, [magic_small, 3, bow_small]) # Mantle respawn refills (magic, bombs, arrows) + rom.write_bytes(0x180185, [max(magic_small, magic_max), max(bomb_small, bomb_max), max(bow_small, bow_max)]) + rom.write_bytes(0x180188, [magic_small, max(bomb_small, bomb_max), bow_small]) # Zelda respawn refills (magic, bombs, arrows) + rom.write_bytes(0x18018B, [magic_small, max(bomb_small, bomb_max), bow_small]) # Mantle respawn refills (magic, bombs, arrows) # patch swamp: Need to enable permanent drain of water as dam or swamp were moved rom.write_byte(0x18003D, 0x01 if world.swamp_patch_required[player] else 0x00) From b45ebdc2ab33a66c1ae139ea3055539038e4eee2 Mon Sep 17 00:00:00 2001 From: theclearmouse <105736589+theclearmouse@users.noreply.github.com> Date: Mon, 26 Jan 2026 18:54:01 -0500 Subject: [PATCH 29/34] add crosskeys winners --- Rom.py | 3 +++ 1 file changed, 3 insertions(+) diff --git a/Rom.py b/Rom.py index b5cce11a..2fd16ffa 100644 --- a/Rom.py +++ b/Rom.py @@ -2244,6 +2244,9 @@ def write_strings(rom, world, player, team): " Crosskeys\n" " Tournament\n" " Winners\n{HARP}\n" + " ~~~2025~~~\n humbugh\n\n" + " ~~~2024~~~\n Gammachuu\n\n" + " ~~~2023~~~\n WallKicks\n\n" " ~~~2022~~~\n Schulzer\n\n" " ~~~2021~~~\n Goomba\n\n" " ~~~2020~~~\n Linlinlin\n\n" From 3547aef480784c6df3a1d658e22db408d4f03435 Mon Sep 17 00:00:00 2001 From: Esme Date: Sat, 2 Nov 2024 19:27:06 +0000 Subject: [PATCH 30/34] Account for failure to determine locale. --- source/classes/BabelFish.py | 2 ++ 1 file changed, 2 insertions(+) diff --git a/source/classes/BabelFish.py b/source/classes/BabelFish.py index 40b6463f..58d26670 100644 --- a/source/classes/BabelFish.py +++ b/source/classes/BabelFish.py @@ -5,6 +5,8 @@ import os class BabelFish(): def __init__(self,subpath=["resources","app","meta"],lang=None): localization_string = locale.getdefaultlocale()[0] #get set localization + if localization_string is None: + localization_string = "en" self.locale = localization_string[:2] if lang is None else lang #let caller override localization self.langs = ["en"] #start with English if(not self.locale == "en"): #add localization From 0dbae8e21ec46b12ac46b81a88c3f65dbacb9e37 Mon Sep 17 00:00:00 2001 From: codemann8 Date: Sun, 15 Mar 2026 16:32:54 -0500 Subject: [PATCH 31/34] Fixed bug/oversight with vanilla_fill and prize_shuffle --- Fill.py | 17 +++++++++++++++-- source/item/FillUtil.py | 3 --- 2 files changed, 15 insertions(+), 5 deletions(-) diff --git a/Fill.py b/Fill.py index 83d7a737..04ab18ee 100644 --- a/Fill.py +++ b/Fill.py @@ -111,7 +111,7 @@ def fill_dungeons_restrictive(world, shuffled_locations): for attempt in range(15): try: for player in range(1, world.players + 1): - if world.prizeshuffle[player] == 'nearby': + if world.prizeshuffle[player] == 'nearby' and world.algorithm != 'vanilla_fill': dungeon_pool = [] for dungeon in world.dungeons: from Dungeons import dungeon_table @@ -143,6 +143,14 @@ def fill_dungeons_restrictive(world, shuffled_locations): else: raise FillError(f'Unable to place dungeon prizes: {", ".join(list(map(lambda d: d.name, prizes)))}') + if world.algorithm == 'vanilla_fill': + for prize in prizes_copy: + if prize.is_near_dungeon_item(world): + if prize.location and prize.location.parent_region.dungeon: + dungeon = prize.location.parent_region.dungeon + dungeon.prize = prize + prize.dungeon_object = dungeon + random.shuffle(shuffled_locations) fill(all_state_base, others, shuffled_locations) @@ -234,7 +242,8 @@ def verify_spot_to_fill(location, item_to_place, max_exp_state, single_player_pl test_state.sweep_for_events() if location.can_fill(test_state, item_to_place, perform_access_check): if valid_key_placement(item_to_place, location, key_pool, test_state, world): - if (item_to_place.prize and world.prizeshuffle[item_to_place.player] == 'none') \ + if (item_to_place.prize and (world.prizeshuffle[item_to_place.player] == 'none' \ + or (world.algorithm == 'vanilla_fill' and item_to_place.is_near_dungeon_item(world)))) \ or valid_dungeon_placement(item_to_place, location, world): return location if item_to_place.smallkey or item_to_place.bigkey or item_to_place.prize: @@ -330,6 +339,10 @@ def track_dungeon_items(item, location, world): if item.prize: location.parent_region.dungeon.prize = item item.dungeon_object = location.parent_region.dungeon + elif world.algorithm == 'vanilla_fill' and item.prize and location.parent_region.dungeon: + dungeon = location.parent_region.dungeon + dungeon.prize = item + item.dungeon_object = dungeon def is_dungeon_item(item, world): diff --git a/source/item/FillUtil.py b/source/item/FillUtil.py index 25bebbcd..6f1016fa 100644 --- a/source/item/FillUtil.py +++ b/source/item/FillUtil.py @@ -120,9 +120,6 @@ def create_item_pool_config(world): LocationGroup('bkgt').locs(mode_grouping['GT Trash'])] for loc_name in mode_grouping['Big Chests'] + mode_grouping['Heart Containers']: config.reserved_locations[player].add(loc_name) - if world.prizeshuffle[player] != 'none': - for loc_name in mode_grouping['Prizes']: - config.reserved_locations[player].add(loc_name) elif world.algorithm == 'major_only': config.location_groups = [ LocationGroup('MajorItems'), From 3ce66a4952f98f62ef02e901d7de8b06317b37ed Mon Sep 17 00:00:00 2001 From: codemann8 Date: Sun, 15 Mar 2026 16:46:07 -0500 Subject: [PATCH 32/34] Changed big bomb shop vendor text to be follower agnostic --- Rom.py | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/Rom.py b/Rom.py index 2fd16ffa..ac28fbc7 100644 --- a/Rom.py +++ b/Rom.py @@ -2579,16 +2579,19 @@ def write_strings(rom, world, player, team): loc.item = i return loc (crystal5, crystal6, greenpendant) = tuple([x[0] if x else missing_prize() for x in [crystal5, crystal6, greenpendant]]) + bigbomb_follower = 'Big Bomb?\n' + if world.shuffle_followers[player]: + bigbomb_follower = '' if world.prizeshuffle[player] in ['none', 'dungeon']: (crystal5, crystal6, greenpendant) = tuple([x.parent_region.dungeon.name for x in [crystal5, crystal6, greenpendant]]) - tt['bomb_shop'] = 'Big Bomb?\nMy supply is blocked until you clear %s and %s.' % (crystal5, crystal6) + tt['bomb_shop'] = f'{bigbomb_follower}My supply is blocked until you clear %s and %s.' % (crystal5, crystal6) tt['sahasrahla_bring_courage'] = 'I lost my family heirloom in %s' % greenpendant elif world.prizeshuffle[player] == 'nearby': (crystal5, crystal6, greenpendant) = tuple([x.item.dungeon_object.name for x in [crystal5, crystal6, greenpendant]]) - tt['bomb_shop'] = 'Big Bomb?\nThe crystals can be found near %s and %s.' % (crystal5, crystal6) + tt['bomb_shop'] = f'{bigbomb_follower}The crystals can be found near %s and %s.' % (crystal5, crystal6) tt['sahasrahla_bring_courage'] = 'I lost my family heirloom near %s' % greenpendant else: - tt['bomb_shop'] = 'Big Bomb?\nThe crystals can be found %s and %s.' % (crystal5.hint_text, crystal6.hint_text) + tt['bomb_shop'] = f'{bigbomb_follower}The crystals can be found %s and %s.' % (crystal5.hint_text, crystal6.hint_text) tt['sahasrahla_bring_courage'] = 'My family heirloom can be found %s' % greenpendant.hint_text tt['sign_ganons_tower'] = ('You need %d crystal to enter.' if world.crystals_needed_for_gt[player] == 1 else 'You need %d crystals to enter.') % world.crystals_needed_for_gt[player] From a3adb1242225cf53356b9d1b88b202063075d84c Mon Sep 17 00:00:00 2001 From: codemann8 Date: Sun, 15 Mar 2026 17:01:50 -0500 Subject: [PATCH 33/34] Various baserom fixes - Fix buffer sword slash when dashing into water - Fixed bug with MSU-1 GT2 track not falling back to GT track - Fix for Kiki unfollowing after certain entrance transition conditions --- Rom.py | 2 +- data/base2current.bps | Bin 139245 -> 139250 bytes 2 files changed, 1 insertion(+), 1 deletion(-) diff --git a/Rom.py b/Rom.py index ac28fbc7..bb4ce2ff 100644 --- a/Rom.py +++ b/Rom.py @@ -43,7 +43,7 @@ from source.enemizer.Enemizer import write_enemy_shuffle_settings JAP10HASH = '03a63945398191337e896e5771f77173' -RANDOMIZERBASEHASH = '69578b6039ebd80d4213823127b29194' +RANDOMIZERBASEHASH = '767da6cf86c6e7163ae59b2cd8a7305d' class JsonRom(object): diff --git a/data/base2current.bps b/data/base2current.bps index fce5484c234236fa1b7abf99a88d797868d56b26..bb2486998bbbd0c9bc7e0e28890a7e61e9a9aaf4 100644 GIT binary patch delta 239 zcmVRgfvk-prL$Qic4+}kv(Sx+K@Rb2rA_b|$pY{br4Y#vlVQ&+2F~h* z2C3eYlh1ttQj-zTA^|^>G|=t|DtRgfvk-ppR-vcc4+}lv(Sx+K?vDvrA_b?$pVvS&nyPW>V*cW*pr#h zeE~+37tkUBSCcx>?g>L8fLtxgQ=2xkG11*f0V9_W8UYsp7q=%G0b+9o1OS1TcW}3l zjR8Fl0SK4Pn*k~Udvmw>n*oXh1#U>#n_stxpaGjN4XR5a-;)yqxqpB}f4G+~&;cz0 TR<~Wy0gX=xew+D{|Emq7Fy&et From a663ab892d67e3b1b286bbdec519be60eda7904a Mon Sep 17 00:00:00 2001 From: codemann8 Date: Sun, 15 Mar 2026 17:08:18 -0500 Subject: [PATCH 34/34] Version bump 0.7.0.3 --- CHANGELOG.md | 12 ++++++++++++ OverworldShuffle.py | 2 +- 2 files changed, 13 insertions(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 5fe8b5e9..e30bdb7f 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,17 @@ # Changelog +# 0.7.0.3 +- Further updates and new yamls for Grid OW Shuffle +- Further customizer options for Grid OW Shuffle like defining screens that should stay together +- Fix buffer sword slash when dashing into water +- Fixed bug with MSU-1 GT2 track not falling back to GT track +- Fix for Kiki unfollowing after certain entrance transition conditions +- Fixed bug/oversight with vanilla_fill and prize_shuffle +- Changed big bomb shop vendor text to be follower agnostic +- Updated crosskeys winners (thanks clearmouse) +- Fixed bug with potential locale determination (thanks Esme) +- \~Merged in DR v1.5.6~ + # 0.7.0.2 - Fixed money error for bombbag/take-anys - Fixed palette issue for map check/flute menu diff --git a/OverworldShuffle.py b/OverworldShuffle.py index 6a9dd637..f3079f52 100644 --- a/OverworldShuffle.py +++ b/OverworldShuffle.py @@ -9,7 +9,7 @@ from OWEdges import OWTileRegions, OWEdgeGroups, OWEdgeGroupsTerrain, OWExitType from OverworldGlitchRules import create_owg_connections from Utils import bidict -version_number = '0.7.0.2' +version_number = '0.7.0.3' # branch indicator is intentionally different across branches version_branch = '-u'