10 files changed, 510 insertions, 143 deletions

@@ -130,6 +130,7 @@ class Lingo2World(World):
         slot_options = [
             "cyan_door_behavior",
             "daedalus_roof_access",
+            "enable_gift_maps",
             "enable_icarus",
             "keyholder_sanity",
             "shuffle_control_center_colors",
@@ -25,6 +25,7 @@ var _slot_data = {}
 var _accessible_locations = []
 var _accessible_worldports = []
 var _goal_accessible = false
+var _latched_doors = []
 
 signal could_not_connect
 signal connect_status
@@ -34,6 +35,7 @@ signal location_scout_received(location_id, item_name, player_name, flags, for_s
 signal text_message_received(message)
 signal item_sent_notification(message)
 signal hint_received(message)
+signal door_latched(id)
 signal accessible_locations_updated
 signal checked_locations_updated
 signal checked_worldports_updated
@@ -189,6 +191,14 @@ func _on_web_socket_server_message_received(_peer_id: int, packet: String) -> vo
                                 message["type"], int(message.get("id", null)), message["path"]
                         )
 
+                elif cmd == "UpdateLatches":
+                        for id in message["latches"]:
+                                var iid = int(id)
+                                if not _latched_doors.has(iid):
+                                        _latched_doors.append(iid)
+
+                                door_latched.emit(iid)
+
 
 func connectToServer(server, un, pw):
         sendMessage([{"cmd": "Connect", "server": server, "player": un, "password": pw}])
@@ -255,6 +265,13 @@ func checkWorldport(port_id):
                 sendMessage([{"cmd": "CheckWorldport", "port_id": port_id}])
 
 
+func latchDoor(id):
+        if not _latched_doors.has(id):
+                _latched_doors.append(id)
+
+                sendMessage([{"cmd": "LatchDoor", "door": id}])
+
+
 func getLogicalPath(object_type, object_id):
         var msg = {"cmd": "GetPath", "type": object_type}
         if object_id != null:
@@ -1,7 +1,9 @@
 extends "res://scripts/nodes/door.gd"
 
+var door_id
 var item_id
 var item_amount
+var latched = false
 
 
 func _ready():
@@ -10,7 +12,7 @@ func _ready():
         )
 
         var gamedata = global.get_node("Gamedata")
-        var door_id = gamedata.get_door_for_map_node_path(global.map, node_path)
+        door_id = gamedata.get_door_for_map_node_path(global.map, node_path)
         if door_id != null:
                 var ap = global.get_node("Archipelago")
                 var item_lock = ap.get_item_id_for_door(door_id)
@@ -27,6 +29,12 @@ func _ready():
                         self.excludeSenders = []
 
                         call_deferred("_readier")
+                else:
+                        var door_data = gamedata.objects.get_doors()[door_id]
+                        if door_data.has_latch() and door_data.get_latch():
+                                _check_latched.call_deferred(door_id)
+
+                                latched = true
 
         if global.map == "the_sun_temple":
                 if name == "spe_EndPlatform" or name == "spe_entry_2":
@@ -44,3 +52,24 @@ func _readier():
 
         if ap.client.getItemAmount(item_id) >= item_amount:
                 handleTriggered()
+
+
+func _check_latched(door_id):
+        var ap = global.get_node("Archipelago")
+
+        if ap.client._latched_doors.has(door_id):
+                triggered = total
+                handleTriggered()
+
+
+func handleTriggered():
+        super.handleTriggered()
+
+        if latched and ran:
+                var ap = global.get_node("Archipelago")
+                ap.client.latchDoor(door_id)
+
+
+func handleUntriggered():
+        if not latched or not ran:
+                super.handleUntriggered()
@@ -43,6 +43,7 @@ func _ready():
                 installScriptExtension(runtime.load_script("keyHolderChecker.gd"))
                 installScriptExtension(runtime.load_script("keyHolderResetterListener.gd"))
                 installScriptExtension(runtime.load_script("painting.gd"))
+                installScriptExtension(runtime.load_script("paintingAuto.gd"))
                 installScriptExtension(runtime.load_script("panel.gd"))
                 installScriptExtension(runtime.load_script("pauseMenu.gd"))
                 installScriptExtension(runtime.load_script("player.gd"))
@@ -63,6 +63,8 @@ const kEndingNameByVictoryValue = {
 var apworld_version = [0, 0, 0]
 var cyan_door_behavior = kCYAN_DOOR_BEHAVIOR_H2
 var daedalus_roof_access = false
+var enable_gift_maps = []
+var enable_icarus = false
 var keyholder_sanity = false
 var port_pairings = {}
 var shuffle_control_center_colors = false
@@ -141,6 +143,7 @@ func _ready():
         client.accessible_locations_updated.connect(_on_accessible_locations_updated)
         client.checked_locations_updated.connect(_on_checked_locations_updated)
         client.checked_worldports_updated.connect(_on_checked_worldports_updated)
+        client.door_latched.connect(_on_door_latched)
 
         client.could_not_connect.connect(_client_could_not_connect)
         client.connect_status.connect(_client_connect_status)
@@ -376,6 +379,20 @@ func _on_checked_worldports_updated():
                 textclient_node.update_worldports()
 
 
+func _on_door_latched(door_id):
+        var gamedata = global.get_node("Gamedata")
+        if gamedata.get_door_map_name(door_id) != global.map:
+                return
+
+        var receivers = gamedata.get_door_receivers(door_id)
+        var scene = get_tree().get_root().get_node_or_null("scene")
+        if scene != null:
+                for receiver in receivers:
+                        var rnode = scene.get_node_or_null(receiver)
+                        if rnode != null:
+                                rnode.handleTriggered()
+
+
 func _client_could_not_connect(message):
         could_not_connect.emit(message)
 
@@ -424,6 +441,8 @@ func _client_connected(slot_data):
         # Read slot data.
         cyan_door_behavior = int(slot_data.get("cyan_door_behavior", 0))
         daedalus_roof_access = bool(slot_data.get("daedalus_roof_access", false))
+        enable_gift_maps = slot_data.get("enable_gift_maps", [])
+        enable_icarus = bool(slot_data.get("enable_icarus", false))
         keyholder_sanity = bool(slot_data.get("keyholder_sanity", false))
         shuffle_control_center_colors = bool(slot_data.get("shuffle_control_center_colors", false))
         shuffle_doors = bool(slot_data.get("shuffle_doors", false))
@@ -0,0 +1,43 @@
+extends "res://scripts/nodes/paintingAuto.gd"
+
+var item_id
+var item_amount
+
+
+func _ready():
+        var node_path = String(
+                get_tree().get_root().get_node("scene").get_path_to(self).get_concatenated_names()
+        )
+
+        var gamedata = global.get_node("Gamedata")
+        var door_id = gamedata.get_door_for_map_node_path(global.map, node_path)
+        if door_id != null:
+                var ap = global.get_node("Archipelago")
+                var item_lock = ap.get_item_id_for_door(door_id)
+
+                if item_lock != null:
+                        item_id = item_lock[0]
+                        item_amount = item_lock[1]
+
+                        self.senders = []
+                        self.senderGroup = []
+                        self.nested = false
+                        self.complete_at = 0
+                        self.max_length = 0
+                        self.excludeSenders = []
+
+                        call_deferred("_readier")
+
+        super._ready()
+
+        if item_id != null and activate_on_sender_complete:
+                enabled = false
+                if not hide_particles:
+                        get_node("Hinge/paintingColliders/TeleportParticles").emitting = false
+
+
+func _readier():
+        var ap = global.get_node("Archipelago")
+
+        if ap.client.getItemAmount(item_id) >= item_amount:
+                handleTriggered()
@@ -19,141 +19,6 @@ func _ready():
 
         ap.start_batching_locations()
 
-        # Set up door locations.
-        var map_id = gamedata.map_id_by_name.get(global.map)
-        for door in gamedata.objects.get_doors():
-                if door.get_map_id() != map_id:
-                        continue
-
-                if not door.has_ap_id():
-                        continue
-
-                if (
-                        door.get_type() == gamedata.SCRIPT_proto.DoorType.ITEM_ONLY
-                        or door.get_type() == gamedata.SCRIPT_proto.DoorType.GALLERY_PAINTING
-                        or door.get_type() == gamedata.SCRIPT_proto.DoorType.CONTROL_CENTER_COLOR
-                ):
-                        continue
-
-                var locationListener = ap.SCRIPT_locationListener.new()
-                locationListener.location_id = door.get_ap_id()
-                locationListener.name = "locationListener_%d" % door.get_ap_id()
-
-                for panel_ref in door.get_panels():
-                        var panel_data = gamedata.objects.get_panels()[panel_ref.get_panel()]
-                        var panel_path = panel_data.get_path()
-
-                        if panel_ref.has_answer():
-                                for proxy in panel_data.get_proxies():
-                                        if proxy.get_answer() == panel_ref.get_answer():
-                                                panel_path = proxy.get_path()
-                                                break
-
-                        locationListener.senders.append(NodePath("/root/scene/" + panel_path))
-
-                for keyholder_ref in door.get_keyholders():
-                        var keyholder_data = gamedata.objects.get_keyholders()[keyholder_ref.get_keyholder()]
-
-                        var khl = khl_script.new()
-                        khl.name = (
-                                "location_%d_keyholder_%d" % [door.get_ap_id(), keyholder_ref.get_keyholder()]
-                        )
-                        khl.answer = keyholder_ref.get_key()
-                        khl.senders.append(NodePath("/root/scene/" + keyholder_data.get_path()))
-                        get_parent().add_child.call_deferred(khl)
-
-                        locationListener.senders.append(NodePath("../" + khl.name))
-
-                for sender in door.get_senders():
-                        locationListener.senders.append(NodePath("/root/scene/" + sender))
-
-                if door.has_complete_at():
-                        locationListener.complete_at = door.get_complete_at()
-
-                get_parent().add_child.call_deferred(locationListener)
-
-        # Set up letter locations.
-        for letter in gamedata.objects.get_letters():
-                var room = gamedata.objects.get_rooms()[letter.get_room_id()]
-                if room.get_map_id() != map_id:
-                        continue
-
-                var locationListener = ap.SCRIPT_locationListener.new()
-                locationListener.location_id = letter.get_ap_id()
-                locationListener.name = "locationListener_%d" % letter.get_ap_id()
-                locationListener.senders.append(NodePath("/root/scene/" + letter.get_path()))
-
-                get_parent().add_child.call_deferred(locationListener)
-
-                if (
-                        ap.get_letter_behavior(letter.get_key(), letter.has_level2() and letter.get_level2())
-                        != ap.kLETTER_BEHAVIOR_VANILLA
-                ):
-                        var scout = ap.scout_location(letter.get_ap_id())
-                        if scout != null and not (scout["for_self"] and scout["flags"] & 4 != 0):
-                                var collectable = get_tree().get_root().get_node("scene").get_node_or_null(
-                                        letter.get_path()
-                                )
-                                if collectable != null:
-                                        collectable.setScoutedText.call_deferred(scout["item"])
-
-        # Set up mastery locations.
-        for mastery in gamedata.objects.get_masteries():
-                var room = gamedata.objects.get_rooms()[mastery.get_room_id()]
-                if room.get_map_id() != map_id:
-                        continue
-
-                var locationListener = ap.SCRIPT_locationListener.new()
-                locationListener.location_id = mastery.get_ap_id()
-                locationListener.name = "locationListener_%d" % mastery.get_ap_id()
-                locationListener.senders.append(NodePath("/root/scene/" + mastery.get_path()))
-
-                get_parent().add_child.call_deferred(locationListener)
-
-        # Set up ending locations.
-        for ending in gamedata.objects.get_endings():
-                var room = gamedata.objects.get_rooms()[ending.get_room_id()]
-                if room.get_map_id() != map_id:
-                        continue
-
-                var locationListener = ap.SCRIPT_locationListener.new()
-                locationListener.location_id = ending.get_ap_id()
-                locationListener.name = "locationListener_%d" % ending.get_ap_id()
-                locationListener.senders.append(NodePath("/root/scene/" + ending.get_path()))
-
-                get_parent().add_child.call_deferred(locationListener)
-
-                if ap.kEndingNameByVictoryValue.get(ap.victory_condition, null) == ending.get_name():
-                        var victoryListener = ap.SCRIPT_victoryListener.new()
-                        victoryListener.name = "victoryListener"
-                        victoryListener.senders.append(NodePath("/root/scene/" + ending.get_path()))
-
-                        get_parent().add_child.call_deferred(victoryListener)
-
-        # Set up keyholder locations, in keyholder sanity.
-        if ap.keyholder_sanity:
-                for keyholder in gamedata.objects.get_keyholders():
-                        if not keyholder.has_key():
-                                continue
-
-                        var room = gamedata.objects.get_rooms()[keyholder.get_room_id()]
-                        if room.get_map_id() != map_id:
-                                continue
-
-                        var locationListener = ap.SCRIPT_locationListener.new()
-                        locationListener.location_id = keyholder.get_ap_id()
-                        locationListener.name = "locationListener_%d" % keyholder.get_ap_id()
-
-                        var khl = khl_script.new()
-                        khl.name = "location_%d_keyholder" % keyholder.get_ap_id()
-                        khl.answer = keyholder.get_key()
-                        khl.senders.append(NodePath("/root/scene/" + keyholder.get_path()))
-                        get_parent().add_child.call_deferred(khl)
-
-                        locationListener.senders.append(NodePath("../" + khl.name))
-
-                        get_parent().add_child.call_deferred(locationListener)
-
         # Block off roof access in Daedalus.
         if global.map == "daedalus" and not ap.daedalus_roof_access:
                 _set_up_invis_wall(75.5, 11, -24.5, 1, 10, 49)
@@ -210,6 +75,84 @@ func _ready():
                 sign2.material = load("res://assets/materials/%s.material" % sign2_color)
                 get_parent().add_child.call_deferred(sign2)
 
+                # Add the gift map entry panel if needed.
+                if not ap.enable_gift_maps.is_empty():
+                        var panel_prefab = preload("res://objects/nodes/panel.tscn")
+                        var tpl_prefab = preload("res://objects/nodes/listeners/teleportListener.tscn")
+                        var wpl_prefab = preload("res://objects/nodes/listeners/worldportListener.tscn")
+
+                        var giftmap_parent = Node.new()
+                        giftmap_parent.name = "GiftMapEntrance"
+                        get_node("/root/scene/Components").add_child.call_deferred(giftmap_parent)
+
+                        var symbolless_player = ""
+                        for i in range(ap.client.ap_user.length()):
+                                if "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ".contains(
+                                        ap.client.ap_user[i]
+                                ):
+                                        symbolless_player = symbolless_player + ap.client.ap_user[i].to_lower()
+
+                        var giftmap_panel = panel_prefab.instantiate()
+                        giftmap_panel.name = "Panel"
+                        giftmap_panel.position = Vector3(33.5, -190, 5.5)
+                        giftmap_panel.rotation_degrees = Vector3(-45, 0, 0)
+                        giftmap_panel.clue = "player"
+                        giftmap_panel.answer = symbolless_player
+
+                        if ap.enable_gift_maps.has("The Advanced"):
+                                var icely_panel = panel_prefab.instantiate()
+                                icely_panel.name = "IcelyPanel"
+                                icely_panel.answer = "icely"
+                                icely_panel.position = Vector3(33.5, -200, 5.5)
+                                giftmap_panel.proxies.append(NodePath("../IcelyPanel"))
+                                giftmap_parent.add_child.call_deferred(icely_panel)
+
+                                var icely_wpl = wpl_prefab.instantiate()
+                                icely_wpl.name = "IcelyWpl"
+                                icely_wpl.exit = "the_advanced"
+                                icely_wpl.senders.append(NodePath("../IcelyPanel"))
+                                giftmap_parent.add_child.call_deferred(icely_wpl)
+
+                        if ap.enable_gift_maps.has("The Charismatic"):
+                                var souvey_panel = panel_prefab.instantiate()
+                                souvey_panel.name = "SouveyPanel"
+                                souvey_panel.answer = "souvey"
+                                souvey_panel.position = Vector3(33.5, -210, 5.5)
+                                giftmap_panel.proxies.append(NodePath("../SouveyPanel"))
+                                giftmap_parent.add_child.call_deferred(souvey_panel)
+
+                                var souvey_wpl = wpl_prefab.instantiate()
+                                souvey_wpl.name = "SouveyWpl"
+                                souvey_wpl.exit = "the_charismatic"
+                                souvey_wpl.senders.append(NodePath("../SouveyPanel"))
+                                giftmap_parent.add_child.call_deferred(souvey_wpl)
+
+                        if ap.enable_gift_maps.has("The Crystalline"):
+                                var q_panel = panel_prefab.instantiate()
+                                q_panel.name = "QPanel"
+                                q_panel.answer = "q"
+                                q_panel.position = Vector3(33.5, -220, 5.5)
+                                giftmap_panel.proxies.append(NodePath("../QPanel"))
+                                giftmap_parent.add_child.call_deferred(q_panel)
+
+                                var q_wpl = wpl_prefab.instantiate()
+                                q_wpl.name = "QWpl"
+                                q_wpl.exit = "the_crystalline"
+                                q_wpl.senders.append(NodePath("../QPanel"))
+                                giftmap_parent.add_child.call_deferred(q_wpl)
+
+                        giftmap_parent.add_child.call_deferred(giftmap_panel)
+
+                        var giftmap_tpl = tpl_prefab.instantiate()
+                        giftmap_tpl.name = "PanelTeleporter"
+                        giftmap_tpl.teleport_point = Vector3(33.5, 1, 5.5)
+                        giftmap_tpl.teleport_rotate = Vector3(-45, 0, 0)
+                        giftmap_tpl.target_path = giftmap_panel
+                        giftmap_tpl.senders.append(
+                                NodePath("/root/scene/Components/Listeners/unlockReaderListenerDoubles")
+                        )
+                        giftmap_parent.add_child.call_deferred(giftmap_tpl)
+
         # Add the strict purple ending validation.
         if global.map == "the_sun_temple" and ap.strict_purple_ending:
                 var panel_prefab = preload("res://objects/nodes/panel.tscn")
@@ -313,8 +256,251 @@ func _ready():
                 entry1.get_parent().add_child.call_deferred(entry12)
                 entry1.queue_free()
 
+        # Move the Plaza RTE trigger outside of the turtle.
+        if global.map == "the_plaza":
+                var rte_trigger = get_node("/root/scene/Components/Warps/triggerArea")
+                rte_trigger.position.z = 0
+
+        # Add the mastery to Icarus.
+        if global.map == "icarus" and ap.enable_icarus:
+                var collectable_prefab = preload("res://objects/nodes/collectable.tscn")
+                var saver_prefab = preload("res://objects/nodes/saver.tscn")
+                var tpl_prefab = preload("res://objects/nodes/listeners/teleportListener.tscn")
+
+                var mastery = collectable_prefab.instantiate()
+                mastery.name = "collectable"
+                mastery.position = Vector3(0, -2000, 0)
+                mastery.unlock_type = "smiley"
+                mastery.material_override = load("res://assets/materials/gold.material")
+                get_node("/root/scene/Components/Collectables").add_child.call_deferred(mastery)
+
+                var tpl = tpl_prefab.instantiate()
+                tpl.teleport_point = Vector3(56.25, 0, -5.5)
+                tpl.teleport_rotate = Vector3(0, 0, 0)
+                tpl.target_path = mastery
+                tpl.name = "Teleport"
+                tpl.senderGroup.append(NodePath("/root/scene/Panels"))
+                tpl.nested = true
+                mastery.add_child.call_deferred(tpl)
+
+                var saver = saver_prefab.instantiate()
+                saver.name = "saver_collectables"
+                saver.type = "collectables"
+                saver.senderGroup.append(NodePath("/root/scene/Components/Collectables"))
+                get_node("/root/scene").add_child.call_deferred(saver)
+
+        # Add the mastery to The Advanced.
+        if global.map == "the_advanced":
+                var collectable_prefab = preload("res://objects/nodes/collectable.tscn")
+                var saver_prefab = preload("res://objects/nodes/saver.tscn")
+                var tpl_prefab = preload("res://objects/nodes/listeners/teleportListener.tscn")
+
+                var mastery = collectable_prefab.instantiate()
+                mastery.name = "collectable"
+                mastery.position = Vector3(0, -200, -5)
+                mastery.unlock_type = "smiley"
+                mastery.material_override = load("res://assets/materials/gold.material")
+                get_node("/root/scene/Components/Collectables").add_child.call_deferred(mastery)
+
+                var tpl = tpl_prefab.instantiate()
+                tpl.teleport_point = Vector3(0, 2, -5)
+                tpl.teleport_rotate = Vector3(0, 0, 0)
+                tpl.target_path = mastery
+                tpl.name = "Teleport"
+                tpl.senders.append(NodePath("/root/scene/Panels/Room_1/panel_29"))
+                tpl.senders.append(NodePath("/root/scene/Panels/Room_1/panel_30"))
+                tpl.senders.append(NodePath("/root/scene/Panels/Room_1/panel_31"))
+                mastery.add_child.call_deferred(tpl)
+
+                var saver = saver_prefab.instantiate()
+                saver.name = "saver_collectables"
+                saver.type = "collectables"
+                saver.senderGroup.append(NodePath("/root/scene/Components/Collectables"))
+                get_node("/root/scene").add_child.call_deferred(saver)
+
+        # Add the mastery to The Charismatic.
+        if global.map == "the_charismatic":
+                var collectable_prefab = preload("res://objects/nodes/collectable.tscn")
+                var saver_prefab = preload("res://objects/nodes/saver.tscn")
+
+                var mastery = collectable_prefab.instantiate()
+                mastery.name = "collectable"
+                mastery.position = Vector3(-17, 2, -29)
+                mastery.rotation_degrees = Vector3(0, 45, 0)
+                mastery.unlock_type = "smiley"
+                mastery.material_override = load("res://assets/materials/gold.material")
+                get_node("/root/scene/Components/Collectables").add_child.call_deferred(mastery)
+
+                var saver = saver_prefab.instantiate()
+                saver.name = "saver_collectables"
+                saver.type = "collectables"
+                saver.senderGroup.append(NodePath("/root/scene/Components/Collectables"))
+                get_node("/root/scene").add_child.call_deferred(saver)
+
+        # Add the mastery to The Crystalline.
+        if global.map == "the_crystalline":
+                var collectable_prefab = preload("res://objects/nodes/collectable.tscn")
+                var saver_prefab = preload("res://objects/nodes/saver.tscn")
+                var tpl_prefab = preload("res://objects/nodes/listeners/teleportListener.tscn")
+
+                var mastery = collectable_prefab.instantiate()
+                mastery.name = "collectable"
+                mastery.position = Vector3(0, 13, 37)
+                mastery.unlock_type = "smiley"
+                mastery.material_override = load("res://assets/materials/gold.material")
+                get_node("/root/scene/Components/Collectables").add_child.call_deferred(mastery)
+
+                var tpl = tpl_prefab.instantiate()
+                tpl.teleport_point = Vector3(0, 11.5, -20)
+                tpl.teleport_rotate = Vector3(0, 0, 180)
+                tpl.target_path = mastery
+                tpl.name = "Teleport"
+                tpl.senders.append(NodePath("/root/scene/Panels/Room_1/panel_3"))
+                mastery.add_child.call_deferred(tpl)
+
+                var saver = saver_prefab.instantiate()
+                saver.name = "saver_collectables"
+                saver.type = "collectables"
+                saver.senderGroup.append(NodePath("/root/scene/Components/Collectables"))
+                get_node("/root/scene").add_child.call_deferred(saver)
+
         ap.update_job_well_done_sign()
 
+        # Set up door locations.
+        var map_id = gamedata.map_id_by_name.get(global.map)
+        for door in gamedata.objects.get_doors():
+                if door.get_map_id() != map_id:
+                        continue
+
+                if not door.has_ap_id():
+                        continue
+
+                if (
+                        door.get_type() == gamedata.SCRIPT_proto.DoorType.ITEM_ONLY
+                        or door.get_type() == gamedata.SCRIPT_proto.DoorType.GALLERY_PAINTING
+                        or door.get_type() == gamedata.SCRIPT_proto.DoorType.CONTROL_CENTER_COLOR
+                ):
+                        continue
+
+                var locationListener = ap.SCRIPT_locationListener.new()
+                locationListener.location_id = door.get_ap_id()
+                locationListener.name = "locationListener_%d" % door.get_ap_id()
+
+                for panel_ref in door.get_panels():
+                        var panel_data = gamedata.objects.get_panels()[panel_ref.get_panel()]
+                        var panel_path = panel_data.get_path()
+
+                        if panel_ref.has_answer():
+                                for proxy in panel_data.get_proxies():
+                                        if proxy.get_answer() == panel_ref.get_answer():
+                                                panel_path = proxy.get_path()
+                                                break
+
+                        locationListener.senders.append(NodePath("/root/scene/" + panel_path))
+
+                for keyholder_ref in door.get_keyholders():
+                        var keyholder_data = gamedata.objects.get_keyholders()[keyholder_ref.get_keyholder()]
+
+                        var khl = khl_script.new()
+                        khl.name = (
+                                "location_%d_keyholder_%d" % [door.get_ap_id(), keyholder_ref.get_keyholder()]
+                        )
+                        khl.answer = keyholder_ref.get_key()
+                        khl.senders.append(NodePath("/root/scene/" + keyholder_data.get_path()))
+                        get_parent().add_child.call_deferred(khl)
+
+                        locationListener.senders.append(NodePath("../" + khl.name))
+
+                for sender in door.get_senders():
+                        locationListener.senders.append(NodePath("/root/scene/" + sender))
+
+                if door.has_complete_at():
+                        locationListener.complete_at = door.get_complete_at()
+
+                get_parent().add_child.call_deferred(locationListener)
+
+        # Set up letter locations.
+        for letter in gamedata.objects.get_letters():
+                var room = gamedata.objects.get_rooms()[letter.get_room_id()]
+                if room.get_map_id() != map_id:
+                        continue
+
+                var locationListener = ap.SCRIPT_locationListener.new()
+                locationListener.location_id = letter.get_ap_id()
+                locationListener.name = "locationListener_%d" % letter.get_ap_id()
+                locationListener.senders.append(NodePath("/root/scene/" + letter.get_path()))
+
+                get_parent().add_child.call_deferred(locationListener)
+
+                if (
+                        ap.get_letter_behavior(letter.get_key(), letter.has_level2() and letter.get_level2())
+                        != ap.kLETTER_BEHAVIOR_VANILLA
+                ):
+                        var scout = ap.scout_location(letter.get_ap_id())
+                        if scout != null and not (scout["for_self"] and scout["flags"] & 4 != 0):
+                                var collectable = get_tree().get_root().get_node("scene").get_node_or_null(
+                                        letter.get_path()
+                                )
+                                if collectable != null:
+                                        collectable.setScoutedText.call_deferred(scout["item"])
+
+        # Set up mastery locations.
+        for mastery in gamedata.objects.get_masteries():
+                var room = gamedata.objects.get_rooms()[mastery.get_room_id()]
+                if room.get_map_id() != map_id:
+                        continue
+
+                var locationListener = ap.SCRIPT_locationListener.new()
+                locationListener.location_id = mastery.get_ap_id()
+                locationListener.name = "locationListener_%d" % mastery.get_ap_id()
+                locationListener.senders.append(NodePath("/root/scene/" + mastery.get_path()))
+
+                get_parent().add_child.call_deferred(locationListener)
+
+        # Set up ending locations.
+        for ending in gamedata.objects.get_endings():
+                var room = gamedata.objects.get_rooms()[ending.get_room_id()]
+                if room.get_map_id() != map_id:
+                        continue
+
+                var locationListener = ap.SCRIPT_locationListener.new()
+                locationListener.location_id = ending.get_ap_id()
+                locationListener.name = "locationListener_%d" % ending.get_ap_id()
+                locationListener.senders.append(NodePath("/root/scene/" + ending.get_path()))
+
+                get_parent().add_child.call_deferred(locationListener)
+
+                if ap.kEndingNameByVictoryValue.get(ap.victory_condition, null) == ending.get_name():
+                        var victoryListener = ap.SCRIPT_victoryListener.new()
+                        victoryListener.name = "victoryListener"
+                        victoryListener.senders.append(NodePath("/root/scene/" + ending.get_path()))
+
+                        get_parent().add_child.call_deferred(victoryListener)
+
+        # Set up keyholder locations, in keyholder sanity.
+        if ap.keyholder_sanity:
+                for keyholder in gamedata.objects.get_keyholders():
+                        if not keyholder.has_key():
+                                continue
+
+                        var room = gamedata.objects.get_rooms()[keyholder.get_room_id()]
+                        if room.get_map_id() != map_id:
+                                continue
+
+                        var locationListener = ap.SCRIPT_locationListener.new()
+                        locationListener.location_id = keyholder.get_ap_id()
+                        locationListener.name = "locationListener_%d" % keyholder.get_ap_id()
+
+                        var khl = khl_script.new()
+                        khl.name = "location_%d_keyholder" % keyholder.get_ap_id()
+                        khl.answer = keyholder.get_key()
+                        khl.senders.append(NodePath("/root/scene/" + keyholder.get_path()))
+                        get_parent().add_child.call_deferred(khl)
+
+                        locationListener.senders.append(NodePath("../" + khl.name))
+
+                        get_parent().add_child.call_deferred(locationListener)
+
         var minimap = ap.SCRIPT_minimap.new()
         minimap.name = "Minimap"
         minimap.visible = ap.show_minimap
@@ -38,6 +38,7 @@ class Lingo2Manager:
     keyboard: dict[str, int]
     worldports: set[int]
     goaled: bool
+    latches: set[int]
 
     def __init__(self, game_ctx: "Lingo2GameContext", client_ctx: "Lingo2ClientContext"):
         self.game_ctx = game_ctx
@@ -47,6 +48,7 @@ class Lingo2Manager:
         self.tracker = Tracker(self)
         self.keyboard = {}
         self.worldports = set()
+        self.latches = set()
 
         self.reset()
 
@@ -56,6 +58,7 @@ class Lingo2Manager:
 
         self.worldports = set()
         self.goaled = False
+        self.latches = set()
 
     def update_keyboard(self, new_keyboard: dict[str, int]) -> dict[str, int]:
         ret: dict[str, int] = {}
@@ -81,6 +84,12 @@ class Lingo2Manager:
 
         return ret
 
+    def update_latches(self, new_latches: set[int]) -> set[int]:
+        ret = new_latches.difference(self.latches)
+        self.latches.update(new_latches)
+
+        return ret
+
 
 class Lingo2GameContext:
     server: Endpoint | None
@@ -244,6 +253,17 @@ class Lingo2GameContext:
 
         async_start(self.send_msgs([msg]), name="path reply")
 
+    def send_update_latches(self, latches):
+        if self.server is None:
+            return
+
+        msg = {
+            "cmd": "UpdateLatches",
+            "latches": latches,
+        }
+
+        async_start(self.send_msgs([msg]), name="update latches")
+
     async def send_msgs(self, msgs: list[Any]) -> None:
         """ `msgs` JSON serializable """
         if not self.server or not self.server.socket.open or self.server.socket.closed:
@@ -298,7 +318,7 @@ class Lingo2ClientContext(CommonContext):
             self.victory_data_storage_key = f"_read_client_status_{self.team}_{self.slot}"
 
             self.set_notify(self.get_datastorage_key("keyboard1"), self.get_datastorage_key("keyboard2"),
-                            self.victory_data_storage_key)
+                            self.victory_data_storage_key, self.get_datastorage_key("latches"))
             msg_batch = [{
                 "cmd": "Set",
                 "key": self.get_datastorage_key("keyboard1"),
@@ -311,6 +331,12 @@ class Lingo2ClientContext(CommonContext):
                 "default": 0,
                 "want_reply": True,
                 "operations": [{"operation": "default", "value": 0}]
+            }, {
+                "cmd": "Set",
+                "key": self.get_datastorage_key("latches"),
+                "default": [],
+                "want_reply": True,
+                "operations": [{"operation": "default", "value": []}]
             }]
 
             if self.slot_data.get("shuffle_worldports", False):
@@ -420,6 +446,10 @@ class Lingo2ClientContext(CommonContext):
                     self.manager.game_ctx.send_update_worldports(updates)
             elif args["key"] == self.victory_data_storage_key:
                 self.handle_status_update(args["value"])
+            elif args["key"] == self.get_datastorage_key("latches"):
+                updates = self.manager.update_latches(set(args["value"]))
+                if len(updates) > 0:
+                    self.manager.game_ctx.send_update_latches(updates)
 
     def get_datastorage_key(self, name: str):
         return f"Lingo2_{self.slot}_{name}"
@@ -501,6 +531,17 @@ class Lingo2ClientContext(CommonContext):
         self.manager.tracker.refresh_state()
         self.manager.game_ctx.send_accessible_locations()
 
+    async def update_latches(self, updates: set[int]):
+        await self.send_msgs([{
+            "cmd": "Set",
+            "key": self.get_datastorage_key("latches"),
+            "want_reply": True,
+            "operations": [{
+                "operation": "update",
+                "value": updates
+            }]
+        }])
+
 
 async def pipe_loop(manager: Lingo2Manager):
     while not manager.client_ctx.exit_event.is_set():
@@ -571,6 +612,10 @@ async def process_game_cmd(manager: Lingo2Manager, args: dict):
             path = manager.tracker.get_path_to_goal()
 
         manager.game_ctx.send_path_reply(args["type"], args.get("id", None), path)
+    elif cmd == "LatchDoor":
+        updates = manager.update_latches({args["door"]})
+        if len(updates) > 0:
+            async_start(manager.client_ctx.update_latches(updates), name="client update latches")
     elif cmd == "Quit":
         manager.client_ctx.exit_event.set()
 
@@ -1,6 +1,6 @@
 from dataclasses import dataclass
 
-from Options import PerGameCommonOptions, Toggle, Choice, DefaultOnToggle, Range
+from Options import PerGameCommonOptions, Toggle, Choice, DefaultOnToggle, Range, OptionSet
 
 
 class ShuffleDoors(DefaultOnToggle):
@@ -56,11 +56,7 @@ class ShuffleWorldports(Toggle):
     """
     Randomizes the connections between maps. This affects worldports only, which are the loading zones you walk into in
     order to change maps. This does not affect paintings, panels that teleport you, or certain other special connections
-    like the one between The Shop and Control Center. Connections that depend on placing letters in keyholders are also
-    currently not shuffled.
-
-    NOTE: It is highly recommended that you turn on Shuffle Control Center Colors when using Shuffle Worldports. Not
-    doing so runs the risk of creating an unfinishable seed.
+    like the one between The Shop and Control Center.
     """
     display_name = "Shuffle Worldports"
 
@@ -103,6 +99,28 @@ class EnableIcarus(Toggle):
     display_name = "Enable Icarus"
 
 
+class EnableGiftMaps(OptionSet):
+    """
+    Controls whether the beta tester gift maps are randomized. By default, these are not accessible at all from within
+    the randomizer. This option allows you to enter the maps, and creates items and locations for them. If worldport
+    shuffle is on, their worldports will be included in the randomization.
+
+    The gift maps are accessed via a panel in The Entry's Starting Room, which only appears if at least one gift map is
+    enabled. It is also treated like a cyan door, and will not appear until the condition specified in the Cyan Door
+    Behavior option is satisfied. Solving this panel with the name of one of the beta testers will teleport you to their
+    corresponding gift map.
+
+    In the base game, nothing happens once you complete a gift map. Masteries have been added to the gift maps in the
+    randomizer so that the player can be rewarded for completing them.
+
+    Note that the gift maps were originally only intended to be played by specific people, and as a result may be
+    frustrating or require knowledge of inside jokes. The Crystalline is particularly difficult as it requires
+    completing a parkour course.
+    """
+    display_name = "Enable Gift Maps"
+    valid_keys = ["The Advanced", "The Charismatic", "The Crystalline", "The Fuzzy", "The Stellar"]
+
+
 class DaedalusRoofAccess(Toggle):
     """
     If enabled, the player will be logically expected to be able to go from the castle entrance to any part of Daedalus
@@ -182,6 +200,7 @@ class Lingo2Options(PerGameCommonOptions):
     keyholder_sanity: KeyholderSanity
     cyan_door_behavior: CyanDoorBehavior
     enable_icarus: EnableIcarus
+    enable_gift_maps: EnableGiftMaps
     daedalus_roof_access: DaedalusRoofAccess
     strict_purple_ending: StrictPurpleEnding
     strict_cyan_ending: StrictCyanEnding
@@ -234,6 +234,13 @@ class Lingo2PlayerLogic:
                 return True
             elif game_map.type == data_pb2.MapType.ICARUS:
                 return bool(world.options.enable_icarus)
+            elif game_map.type == data_pb2.MapType.GIFT_MAP:
+                if game_map.name == "the_advanced":
+                    return "The Advanced" in world.options.enable_gift_maps.value
+                elif game_map.name == "the_charismatic":
+                    return "The Charismatic" in world.options.enable_gift_maps.value
+                elif game_map.name == "the_crystalline":
+                    return "The Crystalline" in world.options.enable_gift_maps.value
 
             return False