75 files changed, 476 insertions, 13 deletions

@@ -1,5 +1,43 @@
 # lingo2-archipelago Releases
 
+## v9.0.0 - 2026-02-07
+
+- Added "Shuffle Fast Travel" option. This allows you to randomize the
+  destinations of the fast travel buttons on the pause menu to almost any map
+  (except for The Entry, which is always the center button).
+- Added "Fast Travel Access" option. By default, fast travel is unlocked by
+  entering the destination area manually. You can instead set to have all fast
+  travel destinations unlocked from the start, or have them locked behind items
+  (apart from The Entry).
+- Added "Restrict Letter Placements" option. When enabled, letter items will
+  only be placed in your local world, in letter locations. This only has an
+  effect when Shuffle Letters is set to Item Cyan or Progressive. This is
+  experimental, and may slow down generation.
+- The values of the Endings Requirement and Masteries Requirement options are
+  now shown in the Control Center, as well as how many endings and masteries you
+  currently have.
+- Previously, vanilla doors logic expected you to have to solve every panel in
+  the Daedalus Computer Room in order to use the back exit door. This has been
+  fixed to only require solving one panel.
+- Previously, shuffled doors + shuffled worldports logic expected you to be able
+  to enter Control Center from the Perceptive Entrance without the door item by
+  solving the PART panel (as you would in vanilla doors). This has been fixed so
+  that the door item is required in both directions.
+
+Compatibility notes:
+
+- The change to the door in the Control Center required creating a new item with
+  a new ID, which is not present in worlds generated on older versions of the
+  apworld. Therefore, if you have an older world using door shuffle, you may not
+  be able to access the checks in the Perceptive Entrance or the worldport (if
+  worldports are shuffled).
+
+Download:
+[lingo2.apworld](https://files.fourisland.com/releases/lingo2-archipelago/apworld/v9.0.0/lingo2.apworld)<br/>
+Template YAML:
+[Lingo 2.yaml](https://files.fourisland.com/releases/lingo2-archipelago/apworld/v9.0.0/Lingo%202.yaml)<br/>
+Source: [v9.0.0](https://code.fourisland.com/lingo2-archipelago/tag/?h=v9.0.0)
+
 ## v8.1.1 - 2026-02-05
 
 - Fixed issue in Daedalus Only mode where the Lavender Cubes and Rainbow Rooms
@@ -7,7 +7,7 @@ from BaseClasses import ItemClassification, Item, Tutorial
 from Options import OptionError
 from settings import Group, UserFilePath
 from worlds.AutoWorld import WebWorld, World
-from .items import Lingo2Item, ANTI_COLLECTABLE_TRAPS
+from .items import Lingo2Item, ANTI_COLLECTABLE_TRAPS, ALL_LETTERS_UPPER
 from .options import Lingo2Options
 from .player_logic import Lingo2PlayerLogic
 from .regions import create_regions, shuffle_entrances, connect_ports_from_ut
@@ -70,6 +70,9 @@ class Lingo2World(World):
         self.player_logic = Lingo2PlayerLogic(self)
         self.port_pairings = {}
 
+        if self.options.restrict_letter_placements:
+            self.options.local_items.value |= set(ALL_LETTERS_UPPER)
+
     def create_regions(self):
         if hasattr(self.multiworld, "re_gen_passthrough") and "Lingo 2" in self.multiworld.re_gen_passthrough:
             self.player_logic.rte_mapping = [self.world.static_logic.map_id_by_name[map_name]
@@ -128,11 +131,14 @@ class Lingo2World(World):
             self.push_precollected(self.create_item(name))
 
     def create_item(self, name: str) -> Item:
-        return Lingo2Item(name, ItemClassification.filler if name == self.get_filler_item_name() else
+        item = Lingo2Item(name, ItemClassification.filler if name == self.get_filler_item_name() else
                                 ItemClassification.trap if name in ANTI_COLLECTABLE_TRAPS else
                                 ItemClassification.progression,
                           self.item_name_to_id.get(name), self.player)
 
+        item.is_letter = (name in ALL_LETTERS_UPPER)
+        return item
+
     def set_rules(self):
         self.multiworld.completion_condition[self.player] = lambda state: state.has("Victory", self.player)
 
@@ -151,6 +157,7 @@ class Lingo2World(World):
             "shuffle_doors",
             "shuffle_gallery_paintings",
             "shuffle_letters",
+            "shuffle_music",
             "shuffle_symbols",
             "shuffle_worldports",
             "strict_cyan_ending",
@@ -160,7 +167,9 @@ class Lingo2World(World):
 
         slot_data: dict[str, object] = {
             **self.options.as_dict(*slot_options),
+            "custom_mint_ending": self.player_logic.custom_mint_ending or "",
             "rte": [self.static_logic.objects.maps[map_id].name for map_id in self.player_logic.rte_mapping],
+            "seed": self.random.randint(0, 1000000),
             "version": self.static_logic.get_data_version(),
         }
 
@@ -16,6 +16,7 @@ var anti_trap_ids = {}
 var location_name_by_id = {}
 var ending_display_name_by_name = {}
 var port_id_by_ap_id = {}
+var map_id_by_rte_ap_id = {}
 
 var kSYMBOL_ITEMS
 
@@ -57,6 +58,9 @@ func load(data_bytes):
         for map in objects.get_maps():
                 map_id_by_name[map.get_name()] = map.get_id()
 
+                if map.has_rte_ap_id():
+                        map_id_by_rte_ap_id[map.get_rte_ap_id()] = map.get_id()
+
         for door in objects.get_doors():
                 var map = objects.get_maps()[door.get_map_id()]
 
@@ -300,3 +304,7 @@ func _get_keyholder_location_name(keyholder):
                 "%s - %s Keyholder"
                 % [_get_room_object_location_prefix(keyholder), keyholder.get_key().to_upper()]
         )
+
+
+func vec3d_to_vector3(input) -> Vector3:
+        return Vector3(input.get_x(), input.get_y(), input.get_z())
@@ -46,6 +46,10 @@ const kCYAN_DOOR_BEHAVIOR_H2 = 0
 const kCYAN_DOOR_BEHAVIOR_DOUBLE_LETTER = 1
 const kCYAN_DOOR_BEHAVIOR_ITEM = 2
 
+const kFAST_TRAVEL_ACCESS_VANILLA = 0
+const kFAST_TRAVEL_ACCESS_UNLOCKED = 1
+const kFAST_TRAVEL_ACCESS_ITEMS = 2
+
 const kEndingNameByVictoryValue = {
         0: "GRAY",
         1: "PURPLE",
@@ -63,21 +67,26 @@ const kEndingNameByVictoryValue = {
 }
 
 var apworld_version = [0, 0, 0]
+var custom_mint_ending = ""
 var cyan_door_behavior = kCYAN_DOOR_BEHAVIOR_H2
 var daedalus_only = false
 var daedalus_roof_access = false
 var enable_gift_maps = []
 var enable_icarus = false
 var endings_requirement = 0
+var fast_travel_access = 0
 var keyholder_sanity = false
 var masteries_requirement = 0
+var music_mapping = {}
 var port_pairings = {}
+var rte_mapping = []
 var shuffle_control_center_colors = false
 var shuffle_doors = false
 var shuffle_gallery_paintings = false
 var shuffle_letters = kSHUFFLE_LETTERS_VANILLA
 var shuffle_symbols = false
 var shuffle_worldports = false
+var slot_rng = null
 var strict_cyan_ending = false
 var strict_purple_ending = false
 var victory_condition = -1
@@ -269,6 +278,13 @@ func _process_item(item, amount):
         if item_id == gamedata.objects.get_special_ids()["Numbers"] and global.map == "the_fuzzy":
                 global.allow_numbers = true
 
+        if gamedata.map_id_by_rte_ap_id.has(item_id):
+                var rteInner = get_tree().get_root().get_node_or_null(
+                        "scene/player/pause_menu/menu/return/rteInner"
+                )
+                if rteInner != null:
+                        rteInner.refreshButtons()
+
         # Show a message about the item if it's new.
         if int(item["index"]) > _last_new_item:
                 _last_new_item = int(item["index"])
@@ -463,12 +479,14 @@ func _client_connected(slot_data):
                         _last_new_item = localdata[0]
 
         # Read slot data.
+        custom_mint_ending = slot_data.get("custom_mint_ending", "")
         cyan_door_behavior = int(slot_data.get("cyan_door_behavior", 0))
         daedalus_only = bool(slot_data.get("daedalus_only", false))
         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))
         endings_requirement = int(slot_data.get("endings_requirement", 0))
+        fast_travel_access = int(slot_data.get("fast_travel_access", 0))
         keyholder_sanity = bool(slot_data.get("keyholder_sanity", false))
         masteries_requirement = int(slot_data.get("masteries_requirement", 0))
         shuffle_control_center_colors = bool(slot_data.get("shuffle_control_center_colors", false))
@@ -496,6 +514,19 @@ func _client_connected(slot_data):
                                 raw_pp[p1]
                         )]
 
+        rte_mapping.clear()
+        if slot_data.has("rte"):
+                rte_mapping = slot_data.get("rte")
+
+        slot_rng = RandomNumberGenerator.new()
+        slot_rng.seed = int(slot_data.get("seed", 0))
+
+        music_mapping.clear()
+        if bool(slot_data.get("shuffle_music", false)):
+                for map_name in global.reserved_scenes:
+                        var track_index = slot_rng.randi_range(0, musicPlayer.all_tracks.size() - 1)
+                        music_mapping[map_name] = musicPlayer.all_tracks.keys()[track_index]
+
         # Set up item locks.
         _item_locks = {}
 
@@ -74,6 +74,61 @@ func on_map_load(root):
                 old_door.queue_free()
                 root.get_node("/root/scene/Components/Doors").add_child.call_deferred(new_door)
 
+        # Display White Ending requirements.
+        var ending_count = 0
+        var mastery_count = 0
+        for key in unlocks.data:
+                if unlocks.data[key] == "unlocked":
+                        if key.ends_with("_ending") and key != "free_ending":
+                                ending_count += 1
+                        elif key.ends_with("_mastery"):
+                                mastery_count += 1
+
+        var sign_prefab = preload("res://objects/nodes/sign.tscn")
+        var sign1 = sign_prefab.instantiate()
+        sign1.position = Vector3(87.5, 5, -42.01)
+        sign1.text = "Endings: %d/%d" % [ending_count, ap.endings_requirement]
+        root.get_node("/root/scene").add_child.call_deferred(sign1)
+
+        var sign2 = sign_prefab.instantiate()
+        sign2.position = Vector3(87.5, 5, -15.99)
+        sign2.rotation_degrees.y = 180
+        sign2.text = "Masteries: %d/%d" % [mastery_count, ap.masteries_requirement]
+        root.get_node("/root/scene").add_child.call_deferred(sign2)
+
+        # Handle custom Mint Ending.
+        if ap.custom_mint_ending != "":
+                var panel_prefab = preload("res://objects/nodes/panel.tscn")
+                var tpl_prefab = preload("res://objects/nodes/listeners/teleportListener.tscn")
+
+                var mint_ending = root.get_node("/root/scene/Components/Endings/mint_ending")
+
+                var mint_panel = panel_prefab.instantiate()
+                mint_panel.name = "mint_panel"
+                mint_panel.clue = ap.custom_mint_ending
+                mint_panel.symbol = ""
+                mint_panel.answer = ap.custom_mint_ending
+                mint_panel.position = Vector3(-63, 3, -29)
+                mint_panel.rotation_degrees = Vector3(-45, 90, 0)
+                root.get_node("/root/scene").add_child.call_deferred(mint_panel)
+
+                var mint_tpl = tpl_prefab.instantiate()
+                mint_tpl.name = "mint_tpl"
+                mint_tpl.teleport_point = mint_ending.position
+                mint_tpl.teleport_rotate = mint_ending.rotation_degrees
+                mint_tpl.target_path = mint_ending
+                mint_tpl.senders.append(NodePath("/root/scene/mint_panel"))
+                root.get_node("/root/scene").add_child.call_deferred(mint_tpl)
+
+                var mint_tpl2 = tpl_prefab.instantiate()
+                mint_tpl2.name = "mint_tpl2"
+                mint_tpl2.teleport_point = Vector3(0, -1000, 0)
+                mint_tpl2.target_path = mint_panel
+                mint_tpl2.senders.append(NodePath("/root/scene/mint_panel"))
+                root.get_node("/root/scene").add_child.call_deferred(mint_tpl2)
+
+                mint_ending.position.y = -1000
+
 
 func _set_up_mastery_listener(root, name):
         var prefab = preload("res://objects/nodes/listeners/unlockReaderListener.tscn")
@@ -13,6 +13,8 @@ func _ready():
 
         var ap = global.get_node("Archipelago")
         var gamedata = global.get_node("Gamedata")
+        var map_id = gamedata.map_id_by_name.get(global.map)
+        var map_data = gamedata.objects.get_maps()[map_id]
 
         compass = global.get_node("Compass")
         compass.visible = ap.show_compass
@@ -26,8 +28,33 @@ func _ready():
 
         ap.update_job_well_done_sign()
 
+        # Set up the RTE trigger, if there is one.
+        if map_data.has_rte_trigger_pos():
+                var oneShotListener_prefab = preload("res://objects/nodes/listeners/oneShotListener.tscn")
+                var triggerArea_prefab = preload("res://objects/nodes/triggerArea.tscn")
+                var unlockSetterListener_prefab = preload(
+                        "res://objects/nodes/listeners/unlockSetterListener.tscn"
+                )
+
+                var triggerArea = triggerArea_prefab.instantiate()
+                triggerArea.name = "rte_triggerArea"
+                triggerArea.position = gamedata.vec3d_to_vector3(map_data.get_rte_trigger_pos())
+                triggerArea.scale = gamedata.vec3d_to_vector3(map_data.get_rte_trigger_scale())
+                get_parent().add_child.call_deferred(triggerArea)
+
+                var osl = oneShotListener_prefab.instantiate()
+                osl.name = "rte_osl"
+                osl.senders.append(NodePath("/root/scene/rte_triggerArea"))
+                get_parent().add_child.call_deferred(osl)
+
+                var usl = unlockSetterListener_prefab.instantiate()
+                usl.name = "rte_usl"
+                usl.key = "rte_%s" % global.map
+                usl.value = "unlocked"
+                usl.senders.append(NodePath("/root/scene/rte_osl"))
+                get_parent().add_child.call_deferred(usl)
+
         # 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
@@ -169,6 +196,17 @@ func _ready():
         minimap.visible = ap.show_minimap
         get_parent().add_child.call_deferred(minimap)
 
+        if ap.music_mapping.has(global.map):
+                var song_setter = get_node_or_null("/root/scene/songSetter")
+                if song_setter:
+                        song_setter.song_name = ap.music_mapping[global.map]
+                else:
+                        var song_setter_prefab = preload("res://objects/nodes/songSetter.tscn")
+                        song_setter = song_setter_prefab.instantiate()
+                        song_setter.name = "songSetter"
+                        song_setter.song_name = ap.music_mapping[global.map]
+                        get_parent().add_child.call_deferred(song_setter)
+
         super._ready()
 
         await get_tree().process_frame
@@ -1,5 +1,7 @@
 extends "res://scripts/ui/rteMenu.gd"
 
+var buttons = []
+
 
 func _readier():
         var ap = global.get_node("Archipelago")
@@ -8,5 +10,58 @@ func _readier():
                 get_node("rte_daedalus").show()
 
                 switcher.preload_map("res://objects/scenes/daedalus.tscn")
+        elif !ap.rte_mapping.is_empty():
+                buttons = [$rte_the_plaza, $rte_the_gallery, $rte_daedalus, $rte_control_center]
+                for i in range(4):
+                        buttons[i].name = "button_%d" % i
+                for i in range(4):
+                        _setupButton(buttons[i], ap.rte_mapping[i])
+
+                refreshButtons()
         else:
                 super()._readier()
+
+
+func _setupButton(button, map_name):
+        switcher.preload_map("res://objects/scenes/%s.tscn" % map_name)
+
+        button.hide()
+        button.text = map_name.replace("_", " ")
+        button.name = "rte_%s" % map_name
+        button.autowrap_mode = TextServer.AUTOWRAP_WORD
+
+        var ap = global.get_node("Archipelago")
+        if (
+                ap.fast_travel_access == ap.kFAST_TRAVEL_ACCESS_VANILLA
+                and !unlocks.data.has("rte_%s" % map_name)
+        ):
+                unlocks.data["rte_%s" % map_name] = ""
+
+
+func refreshButtons():
+        var ap = global.get_node("Archipelago")
+        if ap.rte_mapping.is_empty():
+                return
+
+        for i in range(4):
+                if _shouldShowButton(ap.rte_mapping[i]):
+                        buttons[i].show()
+                else:
+                        buttons[i].hide()
+
+
+func _shouldShowButton(map_name):
+        var ap = global.get_node("Archipelago")
+
+        if ap.fast_travel_access == ap.kFAST_TRAVEL_ACCESS_VANILLA:
+                return unlocks.data["rte_%s" % map_name] == "unlocked"
+        elif ap.fast_travel_access == ap.kFAST_TRAVEL_ACCESS_UNLOCKED:
+                return true
+        elif ap.fast_travel_access == ap.kFAST_TRAVEL_ACCESS_ITEMS:
+                var gamedata = global.get_node("Gamedata")
+                var map_id = gamedata.map_id_by_name[map_name]
+                var rte_ap_id = gamedata.objects.get_maps()[map_id].get_rte_ap_id()
+
+                return ap.client.hasItem(rte_ap_id)
+
+        return false
@@ -5,6 +5,8 @@ from BaseClasses import Item
 class Lingo2Item(Item):
     game: str = "Lingo 2"
 
+    is_letter: bool
+
 
 SYMBOL_ITEMS: dict[data_pb2.PuzzleSymbol, str] = {
     data_pb2.PuzzleSymbol.SUN: "Sun Symbol",
@@ -28,4 +30,5 @@ SYMBOL_ITEMS: dict[data_pb2.PuzzleSymbol, str] = {
     data_pb2.PuzzleSymbol.QUESTION: "Question Symbol",
 }
 
-ANTI_COLLECTABLE_TRAPS: list[str] = [f"Anti {letter}" for letter in "ABCDEFGHIJKLMNOPQRSTUVWXYZ"]
+ALL_LETTERS_UPPER = "ABCDEFGHIJKLMNOPQRSTUVWXYZ"
+ANTI_COLLECTABLE_TRAPS: list[str] = [f"Anti {letter}" for letter in ALL_LETTERS_UPPER]
@@ -1,4 +1,13 @@
-from BaseClasses import Location
+from enum import Enum
+
+from BaseClasses import Location, Item
+from .items import Lingo2Item
+
+
+class LetterPlacementType(Enum):
+    ANY = 0
+    DISALLOW = 1
+    FORCE = 2
 
 
 class Lingo2Location(Location):
@@ -6,3 +15,19 @@ class Lingo2Location(Location):
 
     port_id: int
     goal: bool
+    letter_placement_type: LetterPlacementType
+
+    def set_up_letter_rule(self, lpt: LetterPlacementType):
+        self.letter_placement_type = lpt
+        self.item_rule = self._l2_item_rule
+
+    def _l2_item_rule(self, item: Item) -> bool:
+        if not isinstance(item, Lingo2Item):
+            return True
+
+        if self.letter_placement_type == LetterPlacementType.FORCE:
+            return item.is_letter
+        elif self.letter_placement_type == LetterPlacementType.DISALLOW:
+            return not item.is_letter
+
+        return True
@@ -1,6 +1,6 @@
 from dataclasses import dataclass
 
-from Options import PerGameCommonOptions, Toggle, Choice, DefaultOnToggle, Range, OptionSet
+from Options import PerGameCommonOptions, Toggle, Choice, DefaultOnToggle, Range, OptionSet, FreeText
 
 
 class ShuffleDoors(DefaultOnToggle):
@@ -44,6 +44,17 @@ class ShuffleLetters(Choice):
     option_item_cyan = 4
 
 
+class RestrictLetterPlacements(Toggle):
+    """
+    If enabled, letter items will be shuffled among letter locations in your local world. Shuffle Letters must be set to
+    Progressive or Item Cyan for this to be useful.
+
+    WARNING: This option may slow down generation. Additionally, it is only reliable with Shuffle Letters set to Item
+    Cyan. When set to Progressive, Shuffle Doors and Shuffle Symbols must be turned off.
+    """
+    display_name = "Restrict Letter Placements"
+
+
 class ShuffleSymbols(Toggle):
     """
     If enabled, 19 items will be added to the pool, representing the different symbols that can appear on a panel.
@@ -167,6 +178,15 @@ class DaedalusRoofAccess(Toggle):
     display_name = "Allow Daedalus Roof Access"
 
 
+class CustomMintEnding(FreeText):
+    """
+    If not blank, this will add a new panel that must be solved before collecting Mint Ending (EXIT in the Control
+    Center). The panel will only require typing the text provided for this option, which means the choice of letters
+    here has an impact on logic.
+    """
+    display_name = "Custom Mint Ending"
+
+
 class StrictPurpleEnding(DefaultOnToggle):
     """
     If enabled, the player will be required to have all purple (level 1) letters in order to get Purple Ending.
@@ -245,12 +265,20 @@ class TrapPercentage(Range):
     default = 0
 
 
+class ShuffleMusic(Toggle):
+    """
+    If enabled, every map will be assigned a random music track.
+    """
+    display_name = "Shuffle Music"
+
+
 @dataclass
 class Lingo2Options(PerGameCommonOptions):
     shuffle_doors: ShuffleDoors
     shuffle_control_center_colors: ShuffleControlCenterColors
     shuffle_gallery_paintings: ShuffleGalleryPaintings
     shuffle_letters: ShuffleLetters
+    restrict_letter_placements: RestrictLetterPlacements
     shuffle_symbols: ShuffleSymbols
     shuffle_worldports: ShuffleWorldports
     keyholder_sanity: KeyholderSanity
@@ -261,9 +289,11 @@ class Lingo2Options(PerGameCommonOptions):
     enable_gift_maps: EnableGiftMaps
     daedalus_only: DaedalusOnly
     daedalus_roof_access: DaedalusRoofAccess
+    custom_mint_ending: CustomMintEnding
     strict_purple_ending: StrictPurpleEnding
     strict_cyan_ending: StrictCyanEnding
     victory_condition: VictoryCondition
     endings_requirement: EndingsRequirement
     masteries_requirement: MasteriesRequirement
     trap_percentage: TrapPercentage
+    shuffle_music: ShuffleMusic
@@ -192,6 +192,7 @@ class AccessRequirements:
 class PlayerLocation(NamedTuple):
     code: int | None
     reqs: AccessRequirements
+    is_letter: bool = False
 
 
 class LetterBehavior(IntEnum):
@@ -222,6 +223,7 @@ class Lingo2PlayerLogic:
     double_letter_amount: dict[str, int]
     goal_room_id: int
     rte_mapping: list[int]
+    custom_mint_ending: str | None
 
     def __init__(self, world: "Lingo2World"):
         self.world = world
@@ -236,6 +238,7 @@ class Lingo2PlayerLogic:
         self.real_items = list()
         self.starting_items = list()
         self.double_letter_amount = dict()
+        self.custom_mint_ending = None
 
         def should_shuffle_map(game_map) -> bool | set[int]:
             if world.options.daedalus_only:
@@ -295,6 +298,18 @@ class Lingo2PlayerLogic:
                     self.shuffled_doors.update(set(door.id for door in world.static_logic.objects.doors
                                                    if door.map_id == game_map.id and door.daedalus_only_allow))
 
+        if (world.options.restrict_letter_placements
+                and world.options.shuffle_letters == ShuffleLetters.option_progressive
+                and (world.options.shuffle_doors or world.options.shuffle_symbols)):
+            raise OptionError(f"When Restrict Letter Placements is enabled and Shuffle Letters is set to Progressive, "
+                              f"both Shuffle Doors and Shuffle Symbols must be disabled (Player {world.player}).")
+
+        if world.options.custom_mint_ending.value != "":
+            self.custom_mint_ending = ''.join(filter(str.isalpha, world.options.custom_mint_ending.value)).lower()
+
+            if len(self.custom_mint_ending) > 52:
+                raise OptionError(f"Custom Mint Ending should not be greater than 52 letters (Player {world.player}).")
+
         maximum_masteries = 13 + len(world.options.enable_gift_maps.value)
         if world.options.enable_icarus:
             maximum_masteries += 1
@@ -406,9 +421,11 @@ class Lingo2PlayerLogic:
             if not self.should_shuffle_room(letter.room_id):
                 continue
 
-            self.locations_by_room.setdefault(letter.room_id, []).append(PlayerLocation(letter.ap_id,
-                                                                                        AccessRequirements()))
             behavior = self.get_letter_behavior(letter.key, letter.level2)
+
+            self.locations_by_room.setdefault(letter.room_id, []).append(
+                PlayerLocation(letter.ap_id, AccessRequirements(), behavior == LetterBehavior.ITEM))
+
             if behavior == LetterBehavior.VANILLA:
                 if not world.for_tracker:
                     letter_name = f"{letter.key.upper()}{'2' if letter.level2 else '1'}"
@@ -4,7 +4,7 @@ import BaseClasses
 from BaseClasses import Region, ItemClassification, Entrance
 from entrance_rando import randomize_entrances
 from .items import Lingo2Item
-from .locations import Lingo2Location
+from .locations import Lingo2Location, LetterPlacementType
 from .options import FastTravelAccess
 from .player_logic import AccessRequirements
 from .rules import make_location_lambda
@@ -25,6 +25,11 @@ def create_locations(room, new_region: Region, world: "Lingo2World", regions: di
         new_location = Lingo2Location(world.player, world.static_logic.location_id_to_name[location.code],
                                       location.code, new_region)
         new_location.access_rule = make_location_lambda(reqs, world, regions)
+        if world.options.restrict_letter_placements:
+            if location.is_letter:
+                new_location.set_up_letter_rule(LetterPlacementType.FORCE)
+            else:
+                new_location.set_up_letter_rule(LetterPlacementType.DISALLOW)
         new_region.locations.append(new_location)
 
     for event_name, item_name in world.player_logic.event_loc_item_by_room.get(room.id, {}).items():
@@ -136,6 +141,10 @@ def create_regions(world: "Lingo2World"):
         if connection.HasField("cyan_ending") and connection.cyan_ending and world.options.strict_cyan_ending:
             world.player_logic.add_solution_reqs(reqs, "abcdefghijklmnopqrstuvwxyzabcdefghijklmnopqrstuvwxyz")
 
+        if (connection.HasField("mint_ending") and connection.mint_ending
+                and world.player_logic.custom_mint_ending is not None):
+            world.player_logic.add_solution_reqs(reqs, world.player_logic.custom_mint_ending)
+
         reqs.simplify()
         reqs.remove_room(from_region)
 
@@ -174,3 +174,17 @@ door_groups {
     name: "Lavender Cubes"
   }
 }
+door_groups {
+  name: "Control Center - Perceptive Entrance"
+  type: SHUFFLE_GROUP
+  # This is a weird situation where there's two different ways to open the door
+  # and we want both to work in vanilla.
+  doors {
+    map: "control_center"
+    name: "Perceptive From Outside"
+  }
+  doors {
+    map: "control_center"
+    name: "Perceptive From Inside"
+  }
+}
@@ -4785,6 +4785,7 @@ progressives:
   Icarus Quick Travel: 2933
   Progressive Gold Ending: 2753
 door_groups:
+  Control Center - Perceptive Entrance: 3424
   Control Center Blue Doors: 2788
   Control Center Brown Doors: 2787
   Control Center Orange Doors: 2786
@@ -17,6 +17,7 @@ connections {
   from_room: "Main Area"
   to_room: "Mint Ending"
   door { name: "Mint Ending Door" }
+  mint_ending: true
 }
 connections {
   from_room: "Main Area"
@@ -114,7 +114,7 @@ doors {
 }
 doors {
   name: "Perceptive From Inside"
-  type: LOCATION_ONLY
+  type: STANDARD
   panels { room: "Perceptive Entrance" name: "PART" }
   location_room: "Perceptive Entrance"
 }
@@ -1,2 +1,4 @@
 display_name: "Four Rooms"
 rte_room: "Synonyms Room"
+rte_trigger_pos { x: 20 y: 0 z: -2.5 }
+rte_trigger_scale { x: 6 y: 1 z: 8 }
@@ -1,5 +1,7 @@
 display_name: "Icarus"
 type: ICARUS
 rte_room: "Welcome Spine (Obverse)"
+rte_trigger_pos { x: 60 y: -3 z: 1 }
+rte_trigger_scale { x: 6 y: 1 z: 7 }
 # The map's mastery is created at runtime.
 custom_nodes: "Components/Collectables/collectable"
@@ -1,5 +1,7 @@
 display_name: "The Advanced"
 type: GIFT_MAP
 rte_room: "Main Area"
+rte_trigger_pos { x: 0 y: 0 z: 4 }
+rte_trigger_scale { x: 6 y: 1 z: 6 }
 # The map's mastery is created at runtime.
 custom_nodes: "Components/Collectables/collectable"
@@ -1,2 +1,4 @@
 display_name: "The Ancient"
 rte_room: "Outside"
+rte_trigger_pos { x: 0 y: 0 z: 0 }
+rte_trigger_scale { x: 6 y: 1 z: 6 }
@@ -1,2 +1,4 @@
 display_name: "The Bearer"
 rte_room: "Entry"
+rte_trigger_pos { x: 0 y: 0 z: -4 }
+rte_trigger_scale { x: 6 y: 1 z: 6 }
@@ -1,2 +1,4 @@
 display_name: "The Between"
 rte_room: "Main Area"
+rte_trigger_pos { x: 0 y: 0 z: 0 }
+rte_trigger_scale { x: 13 y: 1 z: 13 }
@@ -1,2 +1,4 @@
 display_name: "The Butterfly"
 rte_room: "Main Area"
+rte_trigger_pos { x: -15.5 y: 0 z: 15.5 }
+rte_trigger_scale { x: 8 y: 1 z: 8 }
@@ -1,5 +1,7 @@
 display_name: "The Charismatic"
 type: GIFT_MAP
 rte_room: "Main Area"
+rte_trigger_pos { x: 0 y: 0 z: 0 }
+rte_trigger_scale { x: 3 y: 1 z: 10 }
 # The map's mastery is created at runtime.
 custom_nodes: "Components/Collectables/collectable"
@@ -1,4 +1,6 @@
 display_name: "The Colorful"
 rte_room: "White Room"
+rte_trigger_pos { x: 0 y: 0 z: 10 }
+rte_trigger_scale { x: 4 y: 1 z: 4 }
 # This has something to do with the FISH/FISHES proxy.
 excluded_nodes: "Components/panel_fake"
@@ -1,5 +1,7 @@
 display_name: "The Congruent"
 rte_room: "Main Area"
+rte_trigger_pos { x: 0 y: 0 z: 0 }
+rte_trigger_scale { x: 6 y: 1 z: 6 }
 worldport_entrance {
   room: "Main Area"
   name: "DARKROOM"
@@ -1,5 +1,7 @@
 display_name: "The Crystalline"
 type: GIFT_MAP
 rte_room: "Main Area"
+rte_trigger_pos { x: 0 y: 0 z: 0 }
+rte_trigger_scale { x: 10 y: 1 z: 10 }
 # The map's mastery is created at runtime.
 custom_nodes: "Components/Collectables/collectable"
@@ -1,2 +1,4 @@
 display_name: "The Darkroom"
 rte_room: "First Room"
+rte_trigger_pos { x: 0 y: 0 z: 1 }
+rte_trigger_scale { x: 14 y: 1 z: 13 }
@@ -1,2 +1,4 @@
 display_name: "The Digital"
 rte_room: "Main Area"
+rte_trigger_pos { x: -9 y: 0 z: -5 }
+rte_trigger_scale { x: 15 y: 1 z: 15 }
@@ -1,5 +1,7 @@
 display_name: "The Double Sided"
 rte_room: "Start"
+rte_trigger_pos { x: 0 y: 0 z: -4 }
+rte_trigger_scale { x: 4 y: 1 z: 4 }
 worldport_entrance {
   room: "Start"
   name: "DARKROOM"
@@ -1,4 +1,6 @@
 display_name: "The Extravagant"
 rte_room: "Y Minus First Floor"
+rte_trigger_pos { x: 0 y: 0 z: 0 }
+rte_trigger_scale { x: 6 y: 1 z: 6 }
 # This appears to be completely inaccessible.
 excluded_nodes: "Components/Warps/worldport"
@@ -1,5 +1,7 @@
 display_name: "The Fuzzy"
 type: GIFT_MAP
 rte_room: "Main Area"
+rte_trigger_pos { x: 0 y: 0 z: 4 }
+rte_trigger_scale { x: 6 y: 1 z: 6 }
 # The map's mastery is created at runtime.
 custom_nodes: "Components/Collectables/collectable"
@@ -1,5 +1,7 @@
 display_name: "The Graveyard"
 rte_room: "Outside"
+rte_trigger_pos { x: 0 y: 0 z: 0 }
+rte_trigger_scale { x: 8 y: 1 z: 8 }
 # These really shouldn't be shuffled because it would make Black Ending trivial.
 excluded_nodes: "Components/Paintings/grave"
 excluded_nodes: "Components/Paintings/grave2"
@@ -1,5 +1,7 @@
 display_name: "The Great"
 rte_room: "Main Area"
+rte_trigger_pos { x: 24 y: 0 z: 1 }
+rte_trigger_scale { x: 35 y: 1 z: 14 }
 # This can't be shuffled because it is tilted.
 excluded_nodes: "Components/Paintings/u"
 # This can't be shuffled because it is on the ground.
@@ -1,2 +1,4 @@
 display_name: "The Hive"
 rte_room: "Main Area"
+rte_trigger_pos { x: -26 y: 0 z: -19 }
+rte_trigger_scale { x: 60 y: 10 z: 60 }
@@ -1,5 +1,7 @@
 display_name: "The Impressive"
 rte_room: "Lobby"
+rte_trigger_pos { x: 0 y: 0 z: 5 }
+rte_trigger_scale { x: 6 y: 1 z: 10 }
 # These are apparently little eyes on the Green Eye panel pedestals? I don't
 # think they're ever visible in gameplay.
 excluded_nodes: "Meshes/eye"
@@ -1,2 +1,4 @@
 display_name: "The Invisible"
 rte_room: "Entrance"
+rte_trigger_pos { x: 0 y: 0 z: -57 }
+rte_trigger_scale { x: 12 y: 1 z: 12 }
@@ -1,5 +1,7 @@
 display_name: "The Jubilant"
 rte_room: "Main Area"
+rte_trigger_pos { x: 0 y: 0 z: 2 }
+rte_trigger_scale { x: 8 y: 1 z: 8 }
 worldport_entrance {
   room: "Main Area"
   name: "GREAT"
@@ -1,5 +1,7 @@
 display_name: "The Keen"
 rte_room: "Main Area"
+rte_trigger_pos { x: 0 y: 0 z: 0 }
+rte_trigger_scale { x: 6 y: 1 z: 6 }
 worldport_entrance {
   room: "Main Area"
   name: "GREAT"
@@ -1,5 +1,7 @@
 display_name: "The Liberated"
 rte_room: "Puzzle Room"
+rte_trigger_pos { x: 0 y: 0 z: 0 }
+rte_trigger_scale { x: 6 y: 1 z: 6 }
 worldport_entrance {
   room: "Puzzle Room"
   name: "ENTRY"
@@ -1,5 +1,7 @@
 display_name: "The Linear"
 rte_room: "Room"
+rte_trigger_pos { x: 0 y: 0 z: 0 }
+rte_trigger_scale { x: 6 y: 1 z: 6 }
 worldport_entrance {
   room: "Room"
   name: "GREAT"
@@ -1,5 +1,7 @@
 display_name: "The Lionized"
 rte_room: "Puzzle Room"
+rte_trigger_pos { x: 0 y: 0 z: 0 }
+rte_trigger_scale { x: 6 y: 1 z: 6 }
 worldport_entrance {
   room: "Puzzle Room"
   name: "ENTRY"
@@ -1,5 +1,7 @@
 display_name: "The Literate"
 rte_room: "Puzzle Room"
+rte_trigger_pos { x: 0 y: 0 z: 0 }
+rte_trigger_scale { x: 6 y: 1 z: 6 }
 worldport_entrance {
   room: "Puzzle Room"
   name: "ENTRY"
@@ -1,5 +1,7 @@
 display_name: "The Lively"
 rte_room: "Puzzle Room"
+rte_trigger_pos { x: 0 y: 0 z: 0 }
+rte_trigger_scale { x: 6 y: 1 z: 6 }
 worldport_entrance {
   room: "Puzzle Room"
   name: "BETWEEN"
@@ -1,5 +1,7 @@
 display_name: "The Nuanced"
 rte_room: "Main Room"
+rte_trigger_pos { x: 0 y: 0 z: 9 }
+rte_trigger_scale { x: 6 y: 1 z: 15 }
 worldport_entrance {
   room: "Main Room"
   name: "UNYIELDING"
@@ -1,5 +1,7 @@
 display_name: "The Orb"
 rte_room: "Main Area"
+rte_trigger_pos { x: 34 y: 0 z: 39 }
+rte_trigger_scale { x: 4 y: 1 z: 8 }
 # These are inaccessible, and were probably just copy pasted from the other
 # rooms.
 excluded_nodes: "Components/Warps/worldport2"
@@ -1,2 +1,4 @@
 display_name: "The Owl"
 rte_room: "R2C2 Bottom"
+rte_trigger_pos { x: 0 y: 0 z: 8 }
+rte_trigger_scale { x: 4 y: 1 z: 3 }
@@ -1,2 +1,4 @@
 display_name: "The Parthenon"
 rte_room: "Main Area"
+rte_trigger_pos { x: 0 y: 0 z: -15 }
+rte_trigger_scale { x: 18 y: 1 z: 30 }
@@ -1,2 +1,4 @@
 display_name: "The Partial"
 rte_room: "Obverse Side"
+rte_trigger_pos { x: 0 y: 0 z: 5 }
+rte_trigger_scale { x: 13 y: 1 z: 16 }
@@ -1,5 +1,7 @@
 display_name: "The Perceptive"
 rte_room: "Main Area"
+rte_trigger_pos { x: 0 y: 0 z: 0 }
+rte_trigger_scale { x: 30 y: 1 z: 20 }
 worldport_entrance {
   room: "Main Area"
   name: "CC"
@@ -1,5 +1,7 @@
 display_name: "The Quiet"
 rte_room: "Main Area"
+rte_trigger_pos { x: 0 y: 0 z: 2 }
+rte_trigger_scale { x: 8 y: 1 z: 8 }
 worldport_entrance {
   room: "Main Area"
   name: "DAEDALUS"
@@ -1,5 +1,7 @@
 display_name: "The Repetitive"
 rte_room: "Main Room"
+rte_trigger_pos { x: 0 y: 0 z: 35.5 }
+rte_trigger_scale { x: 13 y: 1 z: 14 }
 # These paintings are directly above/behind panels and thus can't be entered.
 excluded_nodes: "Meshes/eyeRed3"
 excluded_nodes: "Meshes/eyeRed4"
@@ -1,4 +1,6 @@
 display_name: "The Revitalized"
 rte_room: "Bye Room"
+rte_trigger_pos { x: 0 y: 0 z: 0 }
+rte_trigger_scale { x: 14 y: 1 z: 14 }
 # Let's not include the demo (for now).
 excluded_nodes: "Components/panel_demo"
@@ -1,2 +1,4 @@
 display_name: "The Shop"
 rte_room: "Main Area"
+rte_trigger_pos { x: 0.5 y: 0 z: -12 }
+rte_trigger_scale { x: 15 y: 1 z: 19 }
@@ -1,5 +1,7 @@
 display_name: "The Sirenic"
 rte_room: "Start"
+rte_trigger_pos { x: 0 y: 0 z: 23 }
+rte_trigger_scale { x: 6 y: 1 z: 4 }
 worldport_entrance {
   room: "Start"
   name: "PLAZA"
@@ -1,6 +1,8 @@
 display_name: "The Stellar"
 type: GIFT_MAP
 rte_room: "Starting Room"
+rte_trigger_pos { x: 0 y: 0 z: -3 }
+rte_trigger_scale { x: 6 y: 1 z: 6 }
 # This panel does not appear to be accessible without sniping.
 excluded_nodes: "Panels/Room_1/panel_2"
 # The map's mastery is created at runtime.
@@ -1,2 +1,4 @@
 display_name: "The Stormy"
 rte_room: "Center"
+rte_trigger_pos { x: 0 y: 0 z: 0 }
+rte_trigger_scale { x: 8 y: 1 z: 8 }
@@ -1,5 +1,7 @@
 display_name: "The Sturdy"
 rte_room: "Main Area"
+rte_trigger_pos { x: 0 y: 0 z: 2 }
+rte_trigger_scale { x: 40 y: 1 z: 40 }
 # Let's ignore the second half of the rainbows for now.
 #excluded_nodes: "Components/Doors/Rainbow2/Hinge/rainbowMirrored"
 #excluded_nodes: "Components/Doors/Rainbow/Hinge/rainbowMirrored"
@@ -1,5 +1,7 @@
 display_name: "The Sun Temple"
 rte_room: "Entrance"
+rte_trigger_pos { x: 0 y: 0 z: 2 }
+rte_trigger_scale { x: 10 y: 1 z: 10 }
 worldport_entrance {
   room: "Entrance"
   name: "UNKEMPT"
@@ -1,2 +1,4 @@
 display_name: "The Sweet"
 rte_room: "Main Area"
+rte_trigger_pos { x: 0 y: 0 z: -14.5 }
+rte_trigger_scale { x: 10 y: 1 z: 25 }
@@ -1,5 +1,7 @@
 display_name: "The Symbolic"
 rte_room: "White Room"
+rte_trigger_pos { x: 0 y: 0 z: 0 }
+rte_trigger_scale { x: 6 y: 1 z: 6 }
 worldport_entrance {
   room: "White Room"
   name: "PLAZA"
@@ -1,5 +1,7 @@
 display_name: "The Talented"
 rte_room: "Main Area"
+rte_trigger_pos { x: 0 y: 0 z: 9 }
+rte_trigger_scale { x: 6 y: 1 z: 15 }
 worldport_entrance {
   room: "Main Area"
   name: "GREAT"
@@ -1,3 +1,5 @@
 display_name: "The Tenacious"
 rte_room: "Control Center Entrance"
+rte_trigger_pos { x: 0 y: 0 z: 10 }
+rte_trigger_scale { x: 4 y: 1 z: 4 }
 daedalus_only_mode: DAED_ONLY_ALLOW
@@ -1,2 +1,4 @@
 display_name: "The Three Doors"
 rte_room: "First Second Room"
+rte_trigger_pos { x: -15 y: 0 z: 1 }
+rte_trigger_scale { x: 8 y: 1 z: 4 }
@@ -1,5 +1,7 @@
 display_name: "The Tower"
 rte_room: "First Floor"
+rte_trigger_pos { x: 0 y: 0 z: 0 }
+rte_trigger_scale { x: 8 y: 1 z: 8 }
 worldport_entrance {
   room: "First Floor"
   name: "GREAT"
@@ -1,2 +1,4 @@
 display_name: "The Tree"
 rte_room: "Main Area"
+rte_trigger_pos { x: 0 y: 0 z: 0 }
+rte_trigger_scale { x: 15 y: 1 z: 15 }
@@ -1,2 +1,4 @@
 display_name: "The Unkempt"
 rte_room: "Main Area"
+rte_trigger_pos { x: -12 y: 0 z: -2 }
+rte_trigger_scale { x: 20 y: 1 z: 5 }
@@ -1,2 +1,4 @@
 display_name: "The Unyielding"
 rte_room: "Digital Entrance"
+rte_trigger_pos { x: 0 y: 0 z: -6 }
+rte_trigger_scale { x: 6 y: 1 z: 6 }
@@ -1,4 +1,6 @@
 display_name: "The Wise"
 rte_room: "Entry"
+rte_trigger_pos { x: 0 y: 0 z: 22.5 }
+rte_trigger_scale { x: 6 y: 1 z: 6 }
 # This port is out of bounds.
 excluded_nodes: "Components/Warps/worldport"
@@ -1,5 +1,7 @@
 display_name: "The Wondrous"
 rte_room: "Entry"
+rte_trigger_pos { x: 8 y: 0 z: 40 }
+rte_trigger_scale { x: 6 y: 1 z: 6 }
 worldport_entrance {
   room: "Entry"
   name: "DAEDALUS"
@@ -1,5 +1,7 @@
 display_name: "The Words"
 rte_room: "Main Area"
+rte_trigger_pos { x: 0 y: 0 z: 0 }
+rte_trigger_scale { x: 8 y: 1 z: 8 }
 # These are old proxies of the main room's panels that are not linked up
 # anymore.
 excluded_nodes: "Panels/Proxies/panel_3"
@@ -1,7 +1,7 @@
 version {
-  major: 8
-  minor: 1
-  patch: 1
+  major: 9
+  minor: 0
+  patch: 0
 }
 # Filler item.
 special_names: "A Job Well Done"
@@ -136,6 +136,7 @@ message Connection {
   optional bool roof_access = 7;
   optional bool purple_ending = 8;
   optional bool cyan_ending = 9;
+  optional bool mint_ending = 11;
   optional bool vanilla_only = 10;
 }
 
@@ -291,6 +292,8 @@ message Map {
 
   optional uint64 rte_room = 7;
   optional uint64 rte_ap_id = 8;
+  optional Vec3d rte_trigger_pos = 9;
+  optional Vec3d rte_trigger_scale = 10;
 }
 
 message Progressive {
@@ -79,6 +79,10 @@ message HumanConnection {
   // when the Strict Cyan Ending option is on.
   optional bool cyan_ending = 10;
 
+  // This means that the connection should additionally require being able to
+  // type a specific text string when Custom Mint Ending is on.
+  optional bool mint_ending = 12;
+
   // This means that the connection only exists when doors are not shuffled.
   optional bool vanilla_only = 11;
 }
@@ -239,6 +243,8 @@ message HumanMap {
 
   optional PortIdentifier worldport_entrance = 3;
   optional string rte_room = 7;
+  optional Vec3d rte_trigger_pos = 8;
+  optional Vec3d rte_trigger_scale = 9;
 
   // These two fields are used by the validator and nothing else. excluded_nodes
   // are objects in the tscn that are intentionally not mentioned in the txtpb.
@@ -105,6 +105,11 @@ class DataPacker {
       map.set_rte_room(container_.FindOrAddRoom(map_name, metadata.rte_room(),
                                                 std::nullopt));
     }
+
+    if (metadata.has_rte_trigger_pos()) {
+      *map.mutable_rte_trigger_pos() = metadata.rte_trigger_pos();
+      *map.mutable_rte_trigger_scale() = metadata.rte_trigger_scale();
+    }
   }
 
   void ProcessRooms(std::filesystem::path path,
@@ -528,6 +533,11 @@ class DataPacker {
       r_connection.set_cyan_ending(human_connection.cyan_ending());
     }
 
+    if (human_connection.has_mint_ending()) {
+      f_connection.set_mint_ending(human_connection.mint_ending());
+      r_connection.set_mint_ending(human_connection.mint_ending());
+    }
+
     if (human_connection.has_vanilla_only()) {
       f_connection.set_vanilla_only(human_connection.vanilla_only());
       r_connection.set_vanilla_only(human_connection.vanilla_only());