14 files changed, 165 insertions, 3 deletions

@@ -1,5 +1,64 @@
 # lingo2-archipelago Releases
 
+## v9.1.0 - 2026-02-08
+
+- Added "Custom Mint Ending" option. This creates a panel in the Control Center
+  after putting EXIT into the keyholders, the answer to which is the value of
+  the option. The player must solve the panel to spawn Mint Ending.
+- Added "Shuffle Music" option. This randomizes the music track that plays on
+  each map.
+- Added an item group for symbols.
+- Fix the message on the Control Center wall overcounting the number of endings
+  by 1.
+
+Compatibility notes:
+
+- This client should be completely compatible with worlds generated on v9.0.0.
+
+Download:
+[lingo2.apworld](https://files.fourisland.com/releases/lingo2-archipelago/apworld/v9.1.0/lingo2.apworld)<br/>
+Template YAML:
+[Lingo 2.yaml](https://files.fourisland.com/releases/lingo2-archipelago/apworld/v9.1.0/Lingo%202.yaml)<br/>
+Source: [v9.1.0](https://code.fourisland.com/lingo2-archipelago/tag/?h=v9.1.0)
+
+## 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
@@ -157,6 +157,7 @@ class Lingo2World(World):
             "shuffle_doors",
             "shuffle_gallery_paintings",
             "shuffle_letters",
+            "shuffle_music",
             "shuffle_symbols",
             "shuffle_worldports",
             "strict_cyan_ending",
@@ -166,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(),
         }
 
@@ -67,6 +67,7 @@ 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
@@ -76,6 +77,7 @@ 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
@@ -84,6 +86,7 @@ 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
@@ -476,6 +479,7 @@ 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))
@@ -514,6 +518,15 @@ func _client_connected(slot_data):
         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 = {}
 
@@ -79,7 +79,7 @@ func on_map_load(root):
         var mastery_count = 0
         for key in unlocks.data:
                 if unlocks.data[key] == "unlocked":
-                        if key.ends_with("_ending"):
+                        if key.ends_with("_ending") and key != "free_ending":
                                 ending_count += 1
                         elif key.ends_with("_mastery"):
                                 mastery_count += 1
@@ -96,6 +96,39 @@ func on_map_load(root):
         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")
@@ -196,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,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):
@@ -178,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.
@@ -256,6 +265,13 @@ 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
@@ -273,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
@@ -223,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
@@ -237,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:
@@ -302,6 +304,12 @@ class Lingo2PlayerLogic:
             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
@@ -141,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)
 
@@ -75,8 +75,10 @@ class Lingo2StaticLogic:
         self.item_id_to_name[self.objects.special_ids["A Job Well Done"]] = "A Job Well Done"
         self.item_id_to_name[self.objects.special_ids["Numbers"]] = "Numbers"
 
+        self.item_name_groups["Symbols"] = []
         for symbol_name in SYMBOL_ITEMS.values():
             self.item_id_to_name[self.objects.special_ids[symbol_name]] = symbol_name
+            self.item_name_groups["Symbols"].append(symbol_name)
 
         for trap_name in ANTI_COLLECTABLE_TRAPS:
             self.item_id_to_name[self.objects.special_ids[trap_name]] = trap_name
@@ -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"
@@ -1,6 +1,6 @@
 version {
   major: 9
-  minor: 0
+  minor: 1
   patch: 0
 }
 # Filler item.
@@ -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;
 }
 
@@ -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;
 }
@@ -533,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());