From 89dcc996054fa07f4da72f32d25cb89012b2a111 Mon Sep 17 00:00:00 2001
From: jamesbrq <jamesbrq@gmail.com>
Date: Thu, 5 Oct 2023 23:08:39 -0400
Subject: [PATCH] Alpha build

---
 Client.py             | 243 +++++++++++++++++++++++++-----------------
 Items.py              |  14 +--
 Locations.py          | 164 ++++++++++++++++++++--------
 Names/LocationName.py |   1 +
 Rules.py              |   2 +
 StateLogic.py         |   5 +-
 data/basepatch.bsdiff | Bin 15784 -> 16181 bytes
 7 files changed, 276 insertions(+), 153 deletions(-)

diff --git a/Client.py b/Client.py
index cad592a..5567ce4 100644
--- a/Client.py
+++ b/Client.py
@@ -1,7 +1,8 @@
 from typing import TYPE_CHECKING, Optional, Dict, Set
 import struct
 from NetUtils import ClientStatus
-from .Locations import roomCount, nonBlock, beanstones
+from .Locations import roomCount, nonBlock, beanstones, roomException, shop, badge, pants
+from .Items import items_by_id, ItemData
 import sys
 import logging
 import math
@@ -36,110 +37,152 @@
 
 
 class MLSSClient(BizHawkClient):
-        game = "Mario & Luigi Superstar Saga"
-        system = "GBA"
-        local_checked_locations: Set[int]
-        goal_flag: int
-        rom_slot_name: Optional[str]
-        player_name: Optional[str]
-
-        def __init__(self) -> None:
-            super().__init__()
-            self.local_checked_locations = set()
-            self.local_set_events = {}
-            self.local_found_key_items = {}
-            self.rom_slot_name = None
-
-        async def validate_rom(self, ctx: BizHawkClientContext) -> bool:
-            from CommonClient import logger
-
-            try:
-                # Check ROM name/patch version
-                rom_name_bytes = ((await bizhawk.read(ctx.bizhawk_ctx, [(0xA0, 14, "ROM")]))[0])
-                rom_name = bytes([byte for byte in rom_name_bytes if byte != 0]).decode("UTF-8")
-                if not rom_name.startswith("MARIO&LUIGIU"):
-                    return False
-                if rom_name == "MARIO&LUIGIUA8":
-                    logger.info("ERROR: You appear to be running an unpatched version of Mario & Luigi Superstar Saga. "
-                                "You need to generate a patch file and use it to create a patched ROM.")
-                    return False
-                if rom_name != "MARIO&LUIGIUAP":
-                    logger.info(rom_name)
-                    logger.info("ERROR: The patch file used to create this ROM is not compatible with "
-                                "this client. Double check your client version against the version being "
-                                "used by the generator.")
-                    return False
-            except UnicodeDecodeError:
+    game = "Mario & Luigi Superstar Saga"
+    system = "GBA"
+    local_checked_locations: Set[int]
+    goal_flag: int
+    rom_slot_name: Optional[str]
+    player_name: Optional[str]
+
+    def __init__(self) -> None:
+        super().__init__()
+        self.local_checked_locations = set()
+        self.local_set_events = {}
+        self.local_found_key_items = {}
+        self.rom_slot_name = None
+
+    async def validate_rom(self, ctx: BizHawkClientContext) -> bool:
+        from CommonClient import logger
+
+        try:
+            # Check ROM name/patch version
+            rom_name_bytes = ((await bizhawk.read(ctx.bizhawk_ctx, [(0xA0, 14, "ROM")]))[0])
+            rom_name = bytes([byte for byte in rom_name_bytes if byte != 0]).decode("UTF-8")
+            if not rom_name.startswith("MARIO&LUIGIU"):
                 return False
-            except bizhawk.RequestFailedError:
-                return False  # Should verify on the next pass
-
-            ctx.game = self.game
-            ctx.items_handling = 0b001
-            ctx.want_slot_data = True
-            ctx.watcher_timeout = 0.125
-            self.rom_slot_name = rom_name
-            name_bytes = ((await bizhawk.read(ctx.bizhawk_ctx, [(0xB0, 16, "ROM")]))[0])
-            name = bytes([byte for byte in name_bytes if byte != 0]).decode("UTF-8")
-            self.player_name = name
-
-            return True
-
-        async def set_auth(self, ctx: BizHawkClientContext) -> None:
-            ctx.auth = self.player_name
-
-        async def game_watcher(self, ctx: BizHawkClientContext) -> None:
-            from CommonClient import logger
-            try:
-                read_state = await bizhawk.read(ctx.bizhawk_ctx, [(0x4564, 59, "EWRAM")])
-                flags = read_state[0]
-
-
-                # TODO Confirm a save has been made
-
-                locs_to_send = set()
-
-                # Check for set location flags.
-                for byte_i, byte in enumerate(bytearray(flags)):
-                    for i in range(8):
-                        and_value = 1 << i
-                        if byte & and_value != 0:
-                            flag_id = byte_i * 8 + (i + 1)
-                            room, item = find_key(roomCount, flag_id)
-                            pointer_arr = await bizhawk.read(ctx.bizhawk_ctx, [(ROOM_ARRAY_POINTER + ((room - 1) * 4), 4, "ROM")])
-                            pointer = (struct.unpack('<I', pointer_arr[0])[0])
-                            pointer = pointer & 0xFFFFFF
-                            offset = await bizhawk.read(ctx.bizhawk_ctx, [(pointer, 1, "ROM")])
-                            offset = offset[0][0]
-                            if offset != 0:
-                                offset = 2
-                            pointer += (item * 8) + 1 + offset
-                            if pointer in beanstones:
-                                pointer = beanstones[pointer]
-                            if pointer in ctx.server_locations:
-                                locs_to_send.add(pointer)
-
-                for item in nonBlock:
-                    address, mask, location = item
-                    flag_byte = await bizhawk.read(ctx.bizhawk_ctx, [(address, 1, "ROM")])
-                    flag_byte = flag_byte[0][0]
-                    if flag_byte & mask != 0:
+            if rom_name == "MARIO&LUIGIUA8":
+                logger.info("ERROR: You appear to be running an unpatched version of Mario & Luigi Superstar Saga. "
+                            "You need to generate a patch file and use it to create a patched ROM.")
+                return False
+            if rom_name != "MARIO&LUIGIUAP":
+                logger.info(rom_name)
+                logger.info("ERROR: The patch file used to create this ROM is not compatible with "
+                            "this client. Double check your client version against the version being "
+                            "used by the generator.")
+                return False
+        except UnicodeDecodeError:
+            return False
+        except bizhawk.RequestFailedError:
+            return False  # Should verify on the next pass
+
+        ctx.game = self.game
+        ctx.items_handling = 0b001
+        ctx.want_slot_data = True
+        ctx.watcher_timeout = 0.125
+        self.rom_slot_name = rom_name
+        name_bytes = ((await bizhawk.read(ctx.bizhawk_ctx, [(0xB0, 16, "ROM")]))[0])
+        name = bytes([byte for byte in name_bytes if byte != 0]).decode("UTF-8")
+        self.player_name = name
+
+        return True
+
+    async def set_auth(self, ctx: BizHawkClientContext) -> None:
+        ctx.auth = self.player_name
+
+    async def game_watcher(self, ctx: BizHawkClientContext) -> None:
+        from CommonClient import logger
+        try:
+            read_state = await bizhawk.read(ctx.bizhawk_ctx, [(0x4564, 59, "EWRAM"),
+                                                              (0x2330, 2, "IWRAM"), (0x3FE0, 1, "IWRAM"), (0x3FE4, 1, "IWRAM"), (0x304B, 1, "EWRAM"), (0x304C, 4, "EWRAM"), (0x3058, 6, "EWRAM")])
+            flags = read_state[0]
+            room = (read_state[1][1] << 8) + read_state[1][0]
+            shop_init = read_state[2][0]
+            shop_scroll = read_state[3][0]
+            is_buy = (read_state[4][0] != 0)
+            shop_address = (struct.unpack('<I', read_state[5])[0]) & 0xFFFFFF
+            logo = bytes([byte for byte in read_state[6] if byte != 0]).decode("UTF-8")
+
+            if logo != "MLSSAP":
+                return
+            # TODO Confirm a save has been made
+
+            locs_to_send = set()
+            location = 0
+
+            for item in ctx.items_received:
+                item_data = items_by_id[item.item]
+                b = await bizhawk.read(ctx.bizhawk_ctx, [(0x3057, 1, "EWRAM")])
+                if b[0][0] == 0:
+                    await bizhawk.write(ctx.bizhawk_ctx, [(0x3057, [item_data.itemID], "EWRAM")])
+                else:
+                    break
+
+
+            if is_buy:
+                is_buy = False
+                if shop_address != 0x3c0618 and shop_address != 0x3c0684:
+                    location = shop[shop_address][shop_scroll]
+                else:
+                    if shop_init & 0x1 != 0:
+                        location = badge[shop_address][shop_scroll & 0x1F]
+                    else:
+                        location = pants[shop_address][shop_scroll & 0x1F]
+                await bizhawk.write(ctx.bizhawk_ctx, [(0x304B, [0x0], "EWRAM")])
+
+            if location in ctx.server_locations:
+                locs_to_send.add(location)
+
+            # Check for set location flags.
+            for byte_i, byte in enumerate(bytearray(flags)):
+                for i in range(8):
+                    and_value = 1 << i
+                    if byte & and_value != 0:
+                        flag_id = byte_i * 8 + (i + 1)
+                        room, item = find_key(roomCount, flag_id)
+                        pointer_arr = await bizhawk.read(ctx.bizhawk_ctx,
+                                                         [(ROOM_ARRAY_POINTER + ((room - 1) * 4), 4, "ROM")])
+                        pointer = (struct.unpack('<I', pointer_arr[0])[0])
+                        pointer = pointer & 0xFFFFFF
+                        offset = await bizhawk.read(ctx.bizhawk_ctx, [(pointer, 1, "ROM")])
+                        offset = offset[0][0]
+                        if offset != 0:
+                            offset = 2
+                        pointer += (item * 8) + 1 + offset
+                        for key, value in beanstones.items():
+                            if pointer == value:
+                                pointer = key
+                                break
+                        if pointer in ctx.server_locations:
+                            locs_to_send.add(pointer)
+
+            for item in nonBlock:
+                address, mask, location = item
+                flag_bytes = await bizhawk.read(ctx.bizhawk_ctx, [(address, 1, "EWRAM")])
+                flag_byte = flag_bytes[0][0]
+                if flag_byte & mask != 0:
+                    if location in roomException:
+                        if roomException[location] == room:
+                            exception = True
+                        else:
+                            exception = False
+                    else:
+                        exception = True
+                    if location in ctx.server_locations and exception:
                         locs_to_send.add(location)
 
+            # Send locations if there are any to send.
+            if locs_to_send != self.local_checked_locations:
+                self.local_checked_locations = locs_to_send
 
-                # Send locations if there are any to send.
-                if locs_to_send != self.local_checked_locations:
-                    self.local_checked_locations = locs_to_send
-
-                    if locs_to_send is not None:
-                        await ctx.send_msgs([{
-                            "cmd": "LocationChecks",
-                            "locations": list(locs_to_send)
-                        }])
+                if locs_to_send is not None:
+                    await ctx.send_msgs([{
+                        "cmd": "LocationChecks",
+                        "locations": list(locs_to_send)
+                    }])
 
-            except bizhawk.RequestFailedError:
-                # Exit handler and return to main loop to reconnect.
-                pass
+        except bizhawk.RequestFailedError:
+            # Exit handler and return to main loop to reconnect.
+            pass
 
 
 def find_key(dictionary, target):
diff --git a/Items.py b/Items.py
index 49387b8..5c5fc06 100644
--- a/Items.py
+++ b/Items.py
@@ -58,13 +58,13 @@ class MLSSItem(Item):
     ItemData(0x2A, "Fake Beanstar", ItemClassification.progression, 0x43),
     ItemData(0x2B, "Red Pearl Bean", ItemClassification.progression, 0x45),
     ItemData(0x2C, "Green Pearl Bean", ItemClassification.progression, 0x46),
-    ItemData(0x2D, "Bean Fruit 1", ItemClassification.progression, 0x47),
-    ItemData(0x2E, "Bean Fruit 2", ItemClassification.progression, 0x50),
-    ItemData(0x2F, "Bean Fruit 3", ItemClassification.progression, 0x51),
-    ItemData(0x30, "Bean Fruit 4", ItemClassification.progression, 0x52),
-    ItemData(0x31, "Bean Fruit 5", ItemClassification.progression, 0x53),
-    ItemData(0x32, "Bean Fruit 6", ItemClassification.progression, 0x54),
-    ItemData(0x33, "Bean Fruit 7", ItemClassification.progression, 0x55),
+    ItemData(0x2D, "Bean Fruit 1", ItemClassification.progression_skip_balancing, 0x47),
+    ItemData(0x2E, "Bean Fruit 2", ItemClassification.progression_skip_balancing, 0x50),
+    ItemData(0x2F, "Bean Fruit 3", ItemClassification.progression_skip_balancing, 0x51),
+    ItemData(0x30, "Bean Fruit 4", ItemClassification.progression_skip_balancing, 0x52),
+    ItemData(0x31, "Bean Fruit 5", ItemClassification.progression_skip_balancing, 0x53),
+    ItemData(0x32, "Bean Fruit 6", ItemClassification.progression_skip_balancing, 0x54),
+    ItemData(0x33, "Bean Fruit 7", ItemClassification.progression_skip_balancing, 0x55),
     ItemData(0x34, "Blue Neon Egg", ItemClassification.progression, 0x56),
     ItemData(0x35, "Red Neon Egg", ItemClassification.progression, 0x57),
     ItemData(0x36, "Green Neon Egg", ItemClassification.progression, 0x60),
diff --git a/Locations.py b/Locations.py
index 83c358a..8ebb86d 100644
--- a/Locations.py
+++ b/Locations.py
@@ -258,8 +258,8 @@ class MLSSLocation(Location):
     LocationData("Beanbean Outskirts Chateau Entrance Digspot 2", 0x39e983, 0, 0x02000000, 0x00),
     LocationData("Chateau Green Goblet", 0x24e628, 1, 0x02000000, 0x00),
     LocationData("Chateau Red Goblet", 0x1e943e, 2, 0x02000000, 0x00),
-    LocationData("Chucklehuck Woods Red Chuckola Fruit", 0x250621, 1, 0x02000000, 0x00),
-    LocationData("Chucklehuck Woods White Chuckola Fruit", 0x24ff18, 1, 0x02000000, 0x00),
+    LocationData("Chucklehuck Woods Red Chuckola Fruit", 0x250621, 2, 0x02000000, 0x00),
+    LocationData("Chucklehuck Woods White Chuckola Fruit", 0x24ff18, 2, 0x02000000, 0x00),
     LocationData("Chucklehuck Woods Purple Chuckola Fruit", 0x24ed74, 1, 0x02000000, 0x00)
 ]
 
@@ -471,8 +471,8 @@ class MLSSLocation(Location):
     LocationData("Gwarhar Lagoon First Underwater Area Room 1 Block", 0x39e438, 0, 0x02000000, 0x00),
     LocationData("Gwarhar Lagoon First Underwater Area Room 2 Block 1", 0x39e445, 0, 0x02000000, 0x00),
     LocationData("Gwarhar Lagoon First Underwater Area Room 2 Block 2", 0x39e44d, 0, 0x02000000, 0x00),
-    LocationData("Gwarhar Lagoon Red Pearl Bean", 0x235c1c, 2, 0x02000000, 0x00),
-    LocationData("Gwarhar Lagoon Green Pearl Bean", 0x235a5b, 2, 0x02000000, 0x00)
+    LocationData("Gwarhar Lagoon Red Pearl Bean", 0x235c1c, 1, 0x02000000, 0x00),
+    LocationData("Gwarhar Lagoon Green Pearl Bean", 0x235a5b, 1, 0x02000000, 0x00)
 ]
 
 gwarharMain: typing.List[LocationData] = [
@@ -565,7 +565,7 @@ class MLSSLocation(Location):
     LocationData("Bowser's Castle Lemmy Room 1 Block", 0x39ea9c, 0, 0x02000000, 0x00),
     LocationData("Bowser's Castle Lemmy Room 1 Digspot", 0x39eaa4, 0, 0x02000000, 0x00),
     LocationData("Bowser's Castle Ludwig Room 1 Block", 0x39eaba, 0, 0x02000000, 0x00),
-    LocationData("Bowser's Castle Lemmy Room Mole", 0x277b1f, 2, 0x02000000, 0x00)
+    LocationData("Bowser's Castle Lemmy Room Mole", 0x277b1f, 1, 0x02000000, 0x00)
 ]
 
 bowsersMini: typing.List[LocationData] = [
@@ -596,8 +596,8 @@ class MLSSLocation(Location):
     LocationData("Jokes End Second Floor West Room Block 2", 0x39e769, 0, 0x02000000, 0x00),
     LocationData("Jokes End Second Floor West Room Block 3", 0x39e779, 0, 0x02000000, 0x00),
     LocationData("Jokes End Second Floor West Room Block 4", 0x39e781, 0, 0x02000000, 0x00),
-    LocationData("Jokes End Mole Reward 1", 0x27788e, 0, 0x02000000, 0x00),
-    LocationData("Jokes End Mole Reward 2", 0x2778d2, 0, 0x02000000, 0x00)
+    LocationData("Jokes End Mole Reward 1", 0x27788e, 1, 0x02000000, 0x00),
+    LocationData("Jokes End Mole Reward 2", 0x2778d2, 1, 0x02000000, 0x00)
 ]
 
 jokesMain: typing.List[LocationData] = [
@@ -640,13 +640,13 @@ class MLSSLocation(Location):
 ]
 
 theater: typing.List[LocationData] = [
-    LocationData("Yoshi Theater Blue Yoshi", 0x241155, 2, 0x02000000, 0x00),
-    LocationData("Yoshi Theater Red Yoshi", 0x240ebe, 2, 0x02000000, 0x00),
-    LocationData("Yoshi Theater Green Yoshi", 0x241afa, 2, 0x02000000, 0x00),
-    LocationData("Yoshi Theater Yellow Yoshi", 0x241c3c, 2, 0x02000000, 0x00),
-    LocationData("Yoshi Theater Purple Yoshi", 0x241297, 2, 0x02000000, 0x00),
-    LocationData("Yoshi Theater Orange Yoshi", 0x241000, 2, 0x02000000, 0x00),
-    LocationData("Yoshi Theater Azure Yoshi", 0x241d7e, 2, 0x02000000, 0x00),
+    LocationData("Yoshi Theater Blue Yoshi", 0x241155, 1, 0x02000000, 0x00),
+    LocationData("Yoshi Theater Red Yoshi", 0x240ebe, 1, 0x02000000, 0x00),
+    LocationData("Yoshi Theater Green Yoshi", 0x241afa, 1, 0x02000000, 0x00),
+    LocationData("Yoshi Theater Yellow Yoshi", 0x241c3c, 1, 0x02000000, 0x00),
+    LocationData("Yoshi Theater Purple Yoshi", 0x241297, 1, 0x02000000, 0x00),
+    LocationData("Yoshi Theater Orange Yoshi", 0x241000, 1, 0x02000000, 0x00),
+    LocationData("Yoshi Theater Azure Yoshi", 0x241d7e, 1, 0x02000000, 0x00),
     LocationData("Beanstar Piece Yoshi Theater", 0x1e9442, 2, 0x02000000, 0x00)
 ]
 
@@ -662,31 +662,95 @@ class MLSSLocation(Location):
 ]
 
 nonBlock: list[(int, int, int)] = [
-    (0x434B, 0x1, 0x243844),
-    (0x434B, 0x1, 0x24387d),
-    (0x4373, 0x8, 0x2779C8),
-    (0x42F9, 0x4, 0x1E9403),
-    (0x434B, 0x10, 0x1E9435),
-    (0x434B, 0x20, 0x1E9436),
-    (0x433E, 0x20, 0x1E9404),
-    (0x433E, 0x40, 0x1E9405),
-    (0x42F9, 0x2, 0x1E9430),
-    (0x434B, 0x4, 0x242888),
-    (0x4373, 0x20, 0x277ab2),
-    (0x432D, 0x20, 0x1e9431),
-    (0x434E, 0x2, 0x1e9411),
-    (0x434E, 0x4, 0x1e9412),
-    (0x4375, 0x8, 0x243844),
+    (0x434B, 0x1, 0x243844),  # Farm Mole 1
+    (0x434B, 0x1, 0x24387d),  # Farm Mole 2
+    (0x4373, 0x8, 0x2779C8),  # Simulblock Mole
+    (0x42F9, 0x4, 0x1E9403),  # Hammers
+    (0x434B, 0x10, 0x1E9435),  # Solo Mario Mole 1
+    (0x434B, 0x20, 0x1E9436),  # Solo Mario Mole 2
+    (0x433E, 0x20, 0x1E9404),  # Super Hammers
+    (0x433E, 0x40, 0x1E9405),  # Ultra Hammers
+    (0x42F9, 0x2, 0x1E9430),  # Rose
+    (0x434B, 0x4, 0x242888),  # Solo Luigi Cave Mole
+    (0x4373, 0x20, 0x277ab2),  # Hoohoo Village Turtle Mole
+    (0x432D, 0x20, 0x1e9431),  # Piranha Bean
+    (0x434E, 0x2, 0x1e9411),  # Secret Scroll 1
+    (0x434E, 0x4, 0x1e9412),  # Secret Scroll 2
+    (0x4375, 0x8, 0x243844),  # Membership Card
+    (0x4373, 0x10, 0x277a45),  # Teehee Valley Mole
+    (0x434D, 0x8, 0x1E9444),  # Harhall's Pants
+    (0x432E, 0x10, 0x1e9441),  # Harhall Beanstar Piece
+    (0x434B, 0x8, 0x1e9434),  # Outskirts Boo Statue Mole
+    (0x42FE, 0x2, 0x1e943E),  # Red Goblet
+    (0x42FE, 0x4, 0x24e628),  # Green Goblet
+    (0x4301, 0x10, 0x250621),  # Red Chuckola Fruit
+    (0x42FE, 0x80, 0x24ed74),  # Purple Chuckola Fruit
+    (0x4302, 0x4, 0x24ff18),  # White Chuckola Fruit
+    (0x42FF, 0x8, 0x251347),  # Beanlet 1
+    (0x42FF, 0x20, 0x2513fb),  # Beanlet 2
+    (0x42FF, 0x10, 0x2513a1),  # Beanlet 3
+    (0x42FF, 0x4, 0x251988),  # Beanlet 4
+    (0x42FF, 0x2, 0x25192e),  # Beanlet 5
+    (0x42FF, 0x1, 0x2515eb),  # Beanlet Reward
+    (0x4371, 0x40, 0x253515),  # Espresso 1
+    (0x4371, 0x80, 0x253776),  # Espresso 2
+    (0x4372, 0x1, 0x253c70),  # Espresso 3
+    (0x4372, 0x2, 0x254324),  # Espresso 4
+    (0x4372, 0x4, 0x254718),  # Espresso 5
+    (0x4372, 0x8, 0x254a34),  # Espresso 6
+    (0x4372, 0x10, 0x254e24),  # Espresso 7
+    (0x472F, 0x1, 0x252d07),  # Woohoo Blend
+    (0x472F, 0x2, 0x252d28),  # Hoohoo Blend
+    (0x472F, 0x4, 0x252d49),  # Chuckle Blend
+    (0x472F, 0x8, 0x252d6a),  # Teehee Blend
+    (0x472F, 0x10, 0x252d8b),  # Hoolumbian
+    (0x472F, 0x20, 0x252dac),  # Chuckoccino
+    (0x472F, 0x40, 0x252dcd),  # Teeheespresso
+    (0x430B, 0x10, 0x1e9433),  # Extra Dress
+    (0x430B, 0x10, 0x1e9432),  # Fake Beanstar
+    (0x430F, 0x1, 0x1e9440),  # Popple Beanstar Piece
+    (0x430C, 0x80, 0x261658),  # Winkle Card
+    (0x4741, 0x1, 0x2578e7),  # Brooch
+    (0x4375, 0x2, 0x2753ea),  # Surf Minigame
+    (0x4373, 0x1, 0x277956),  # North Whirlpool Mole
+    (0x4346, 0x40, 0x235a5b),  # Green Pearl Bean
+    (0x4346, 0x80, 0x235c1c),  # Red Pearl Bean
+    (0x4340, 0x20, 0x1e9443),  # Hermie Beanstar Piece
+    (0x434A, 0x40, 0x1e9437),  # Spangle
+    (0x434A, 0x80, 0x236e73),  # Spangle Reward
+    (0x4373, 0x40, 0x277b1f),  # Bowser's Castle Mole
+    (0x4372, 0x80, 0x27788e),  # Jokes end Mole 1
+    (0x4372, 0x80, 0x2778d2),  # Jokes end Mole 2
+    (0x434C, 0x80, 0x241000),  # Orange Neon Egg
+    (0x434D, 0x1, 0x240ebe),  # Red Neon Egg
+    (0x434C, 0x40, 0x241155),  # Blue Neon Egg
+    (0x434D, 0x2, 0x241297),  # Purple Neon Egg
+    (0x434C, 0x8, 0x241afa),  # Green Neon Egg
+    (0x434C, 0x10, 0x241d7e),  # Azure Neon Egg
+    (0x434C, 0x20, 0x241c3c),  # Yellow Neon Egg
+    (0x434D, 0x40, 0x1e9442),  # Yellow Neon Egg
+    (0x4345, 0x8, 0x1e9408),  # Firebrand
+    (0x4345, 0x4, 0x1e9409),  # Thunder Hand
 ]
 
+roomException: dict[int, int] = {
+    0x1e9437: 0x10A,
+    0x24ed74: 0x8C,
+    0x250621: 0x9B,
+    0x24ff18: 0x98,
+    0x261658: 0x181,
+    0x260637: 0x137,
+    0x1E9403: 0x27
+}
+
 beanstones: dict[int, int] = {
-    0x229345: 0x39dc72,
+    0x229345: 0x39dc72,  # Bean fruit 1 - 6
     0x22954D: 0x39dcb4,
     0x228A17: 0x39dbd1,
     0x22913A: 0x39dc10,
     0x22890E: 0x39dba4,
     0x228775: 0x39db7f,
-    0x25117D: 0x39d73e,
+    0x25117D: 0x39d73e,  # Beanstone 1 - 10
     0x2511D6: 0x39d746,
     0x25122F: 0x39d74e,
     0x251288: 0x39d756,
@@ -840,6 +904,7 @@ class MLSSLocation(Location):
     0x122: 6,
     0x123: 1,
     0x126: 2,
+    0x128: 1,
     0x12A: 1,
     0x12B: 1,
     0x12E: 4,
@@ -887,19 +952,34 @@ class MLSSLocation(Location):
     0x19C: 1,
     0x19E: 2,
     0x1A0: 2,
-    0x1A4: 1,
-    0x1A7: 2,
-    0x1AB: 1,
+    0x1A3: 1,
+    0x1A6: 2,
+    0x1AA: 1,
+    0x1B0: 2,
     0x1B1: 2,
-    0x1B2: 2,
-    0x1B9: 2,
-    0x1CB: 2,
-    0x1D2: 2,
-    0x1D3: 3,
-    0x1D5: 1,
-    0x1EC: 3,
+    0x1B8: 2,
+    0x1CA: 2,
+    0x1D1: 2,
+    0x1D2: 3,
+    0x1D4: 1,
+    0x1EB: 3,
+    0x1F6: 1,
     0x1F7: 1,
-    0x1F8: 1,
+}
+
+shop: dict[int, []] = {
+    0x3c05f0: [0x3c05f0, 0x3c05f2, 0x3c05f4, 0x3c05f8, 0x3c05fc, 0x3c05fe, 0x3c0600, 0x3c0602, 0x3c0606, 0x3c0608, 0x3c060c, 0x3c060e, 0x3c0610, 0x3c0614],
+    0x3c066a: [0x3c066a, 0x3c066c, 0x3c066e, 0x3c0670, 0x3c0672, 0x3c0674, 0x3c0676, 0x3c0678, 0x3c067c, 0x3c0680]
+}
+
+badge: dict[int, []] = {
+    0x3c0618: [0x3c0618, 0x3c061a, 0x3c0624, 0x3c0626, 0x3c0628, 0x3c0632, 0x3c0634, 0x3c0636, 0x3c0640, 0x3c0642, 0x3c0644, 0x3c064e, 0x3c0650, 0x3c0652, 0x3c065c, 0x3c065e, 0x3c0660],
+    0x3c0684: [0x3c0684, 0x3c0686, 0x3c0688, 0x3c0692, 0x3c0694, 0x3c069c, 0x3c069e]
+}
+
+pants: dict[int, []] = {
+    0x3c0618: [0x3c061C, 0x3c061E, 0x3c0620, 0x3c0626, 0x3c062a, 0x3c062c, 0x3c062e, 0x3c0638, 0x3c063a, 0x3c063c, 0x3c0646, 0x3c0648, 0x3c064a, 0x3c0654, 0x3c0656, 0x3c0658, 0x3c0662, 0x3c0664, 0x3c0666],
+    0x3c0684: [0x3c068a, 0x3c068c, 0x3c068e, 0x3c0696, 0x3c0698, 0x3c06a0, 0x3c06a2]
 }
 
 all_locations: typing.List[LocationData] = mainArea + booStatue + chucklehuck + castleTown + startingFlag + \
diff --git a/Names/LocationName.py b/Names/LocationName.py
index 1b64712..300899e 100644
--- a/Names/LocationName.py
+++ b/Names/LocationName.py
@@ -59,6 +59,7 @@ class LocationName():
     HoohooMountainBaseBoostatueRoomDigspot1 = "Hoohoo Mountain Base Boostatue Room Digspot 1"
     HoohooMountainBaseBoostatueRoomDigspot2 = "Hoohoo Mountain Base Boostatue Room Digspot 2"
     HoohooMountainBaseBoostatueRoomDigspot3 = "Hoohoo Mountain Base Boostatue Room Digspot 3"
+    BeanbeanOutskirtsBooStatueMole = "Beanbean Outskirts Boo Statue Mole"
     HoohooMountainBaseGrassyAreaBlock1 = "Hoohoo Mountain Base Grassy Area Block 1"
     HoohooMountainBaseGrassyAreaBlock2 = "Hoohoo Mountain Base Grassy Area Block 2"
     HoohooMountainBaseGuffawhaRuinsEntranceDigspot = "Hoohoo Mountain Base Guffawha Ruins Entrance Digspot"
diff --git a/Rules.py b/Rules.py
index 235433e..5a391a7 100644
--- a/Rules.py
+++ b/Rules.py
@@ -16,6 +16,8 @@ def set_rules(world: MultiWorld, player: int):
              lambda state: StateLogic.hammers(state, player))
     add_rule(world.get_location(LocationName.HoohooMountainBaseBoostatueRoomBlock2, player),
              lambda state: StateLogic.canCrash(state, player) or StateLogic.super(state, player))
+    add_rule(world.get_location(LocationName.BeanbeanOutskirtsBooStatueMole, player),
+             lambda state: StateLogic.canMini(state, player) and StateLogic.canDig(state, player))
     add_rule(world.get_location(LocationName.HoohooMountainBaseBoostatueRoomDigspot2, player),
              lambda state: StateLogic.canCrash(state, player) or StateLogic.super(state, player))
     add_rule(world.get_location(LocationName.HoohooVillageSuperHammerCaveBlock, player),
diff --git a/StateLogic.py b/StateLogic.py
index c869465..8d8f3cc 100644
--- a/StateLogic.py
+++ b/StateLogic.py
@@ -77,10 +77,7 @@ def winkle(state, player):
 
 
 def beanFruit(state, player):
-    return state.has("Beanfruit 1", player) or state.has("Beanfruit 2", player) or state.has("Beanfruit 3",
-                                                                                             player) or state.has(
-        "Beanfruit 4", player) or state.has("Beanfruit 5", player) or state.has("Beanfruit 6", player) or state.has(
-        "Beanfruit 7", player)
+    return state.has("Beanfruit 1", player) and state.has("Beanfruit 2", player) and state.has("Beanfruit 3", player) and state.has("Beanfruit 4", player) and state.has("Beanfruit 5", player) and state.has("Beanfruit 6", player) and state.has("Beanfruit 7", player)
 
 
 def surfable(state, player):
diff --git a/data/basepatch.bsdiff b/data/basepatch.bsdiff
index dd90e870472e4b8cc90f91766462868b7aaf606c..640aa25532ba4eef1e75460568a8575281ba94e9 100644
GIT binary patch
literal 16181
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

literal 15784
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