12 files changed, 192 insertions, 125 deletions

@@ -1,5 +1,27 @@
 # lingo2-archipelago Releases
 
+## v7.1.0 - 2025-10-07
+
+- Added a "Get Path" button to the locations tracker. This shows you the path
+  you're currently expected to be able to take in order to reach that
+  location/worldport/goal.
+- Worldport names in the spoiler log have been changed to be more descriptive.
+- Jumping into The Graveyard from The Sun Temple is now in logic.
+- Solving the FLIP panels above the Liberated and Literate entrances by looking
+  up is now in logic.
+- Renamed some locations so that they're shorter.
+- Fixed bug where White Ending would kick the player out of Archipelago.
+- Fixed bug where the minimap would be completely white when a texture pack is
+  enabled.
+- Generation failures while shuffling worldports should be significantly less
+  common.
+
+Download:
+[lingo2.apworld](https://files.fourisland.com/releases/lingo2-archipelago/apworld/v7.1.0/lingo2.apworld)<br/>
+Template YAML:
+[Lingo 2.yaml](https://files.fourisland.com/releases/lingo2-archipelago/apworld/v7.1.0/Lingo%202.yaml)<br/>
+Source: [v7.1.0](https://code.fourisland.com/lingo2-archipelago/tag/?h=v7.1.0)
+
 ## v7.0.2 - 2025-10-03
 
 - Fixed issue connecting to password-protected slots.
@@ -4,6 +4,7 @@ Archipelago init file for Lingo 2
 from typing import ClassVar
 
 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
@@ -82,9 +83,9 @@ class Lingo2World(World):
             else:
                 shuffle_entrances(self)
 
-        from Utils import visualize_regions
+        #from Utils import visualize_regions
 
-        visualize_regions(self.multiworld.get_region("Menu", self.player), "my_world.puml")
+        #visualize_regions(self.multiworld.get_region("Menu", self.player), "my_world.puml")
 
     def create_items(self):
         pool = [self.create_item(name) for name in self.player_logic.real_items]
@@ -109,6 +110,11 @@ class Lingo2World(World):
         for i in range(0, item_difference):
             pool.append(self.create_item(self.get_filler_item_name()))
 
+        if not any(ItemClassification.progression in item.classification for item in pool):
+            raise OptionError(f"Lingo 2 player {self.player} has no progression items. Please enable at least one "
+                              f"option that would add progression gating to your world, such as Shuffle Doors or "
+                              f"Shuffle Letters.")
+
         self.multiworld.itempool += pool
 
     def create_item(self, name: str) -> Item:
@@ -75,6 +75,8 @@ var strict_cyan_ending = false
 var strict_purple_ending = false
 var victory_condition = -1
 
+var color_by_material_path = {}
+
 signal could_not_connect
 signal connect_status
 signal ap_connected
@@ -112,6 +114,20 @@ func _init():
                 if data.size() > 6:
                         show_minimap = data[6]
 
+        # We need to create a mapping from material paths to the original colors of
+        # those materials. We force reload the materials, overwriting any custom
+        # textures, and create the mapping. We then reload the textures in case the
+        # player had a custom one enabled.
+        var directory = DirAccess.open("res://assets/materials")
+        for material_name in directory.get_files():
+                var material = ResourceLoader.load(
+                        "res://assets/materials/" + material_name, "", ResourceLoader.CACHE_MODE_REPLACE
+                )
+
+                color_by_material_path[material.resource_path] = Color(material.albedo_color)
+
+        settings.load_user_textures()
+
 
 func _ready():
         client = SCRIPT_client.new()
@@ -126,6 +126,7 @@ func _process(_delta):
 
 
 func _renderMap(gridmap):
+        var ap = global.get_node("Archipelago")
         var heights = {}
 
         var rendered = Image.create_empty(cell_width, cell_height, false, Image.FORMAT_RGBA8)
@@ -133,7 +134,7 @@ func _renderMap(gridmap):
 
         var meshes_node = get_tree().get_root().get_node("scene/Meshes")
         if meshes_node != null:
-                _renderMeshNode(gridmap, meshes_node, rendered)
+                _renderMeshNode(ap, gridmap, meshes_node, rendered)
 
         for pos in gridmap.get_used_cells():
                 var in_plane = Vector2i(pos.x, pos.z)
@@ -146,20 +147,22 @@ func _renderMap(gridmap):
                 var cell_item = gridmap.get_cell_item(pos)
                 var mesh = gridmap.mesh_library.get_item_mesh(cell_item)
                 var material = mesh.surface_get_material(0)
-                var color = material.albedo_color
+                var color = ap.color_by_material_path.get(material.resource_path, Color.TRANSPARENT)
 
                 rendered.set_pixel(pos.x - cell_left, pos.z - cell_top, color)
 
         return rendered
 
 
-func _renderMeshNode(gridmap, mesh, rendered):
+func _renderMeshNode(ap, gridmap, mesh, rendered):
         if mesh is MeshInstance3D:
                 var local_tl = gridmap.map_to_local(Vector3i(cell_left, 0, cell_top))
                 var global_tl = gridmap.to_global(local_tl)
                 var mesh_material = mesh.get_surface_override_material(0)
                 if mesh_material != null:
-                        var mesh_color = mesh_material.albedo_color
+                        var mesh_color = ap.color_by_material_path.get(
+                                mesh_material.resource_path, Color.TRANSPARENT
+                        )
 
                         for y in range(
                                 max(mesh.position.z - mesh.scale.z / 2 - global_tl.z, 0),
@@ -172,4 +175,4 @@ func _renderMeshNode(gridmap, mesh, rendered):
                                         rendered.set_pixel(x, y, mesh_color)
 
         for child in mesh.get_children():
-                _renderMeshNode(gridmap, child, rendered)
+                _renderMeshNode(ap, gridmap, child, rendered)
@@ -132,6 +132,12 @@ def create_regions(world: "Lingo2World"):
         reqs.simplify()
         reqs.remove_room(from_region)
 
+        if to_region in reqs.rooms:
+            # This connection can't ever increase access because you're required to have access to the other side in
+            # order for it to be usable. We will just not create the connection at all, in order to help GER figure out
+            # what regions are dead ends.
+            continue
+
         connection = Entrance(world.player, connection_name, regions[from_region])
         connection.access_rule = make_location_lambda(reqs, world, regions)
 
@@ -1851,22 +1851,10 @@ maps:
     rooms:
       Back Area:
         panels:
-          Left Landscape Bottom: 482
-          Left Landscape Left: 483
-          Left Landscape Right: 481
-          Left Landscape Top: 480
           PAINTING: 474
           PLANT: 472
-          Right Landscape Bottom: 486
-          Right Landscape Left: 487
-          Right Landscape Right: 485
-          Right Landscape Top: 484
           TOWEL: 475
           TREE: 473
-          Top Landscape Bottom: 478
-          Top Landscape Left: 479
-          Top Landscape Right: 477
-          Top Landscape Top: 476
       Behind Question Area:
         panels:
           DEW: 488
@@ -2024,6 +2012,20 @@ maps:
       Question Room Who:
         panels:
           QUESTION: 587
+      The Landscapes:
+        panels:
+          Left Landscape Bottom: 482
+          Left Landscape Left: 483
+          Left Landscape Right: 481
+          Left Landscape Top: 480
+          Right Landscape Bottom: 486
+          Right Landscape Left: 487
+          Right Landscape Right: 485
+          Right Landscape Top: 484
+          Top Landscape Bottom: 478
+          Top Landscape Left: 479
+          Top Landscape Right: 477
+          Top Landscape Top: 476
       Under Question Room:
         panels:
           QUESTION: 588
@@ -256,3 +256,7 @@ connections {
   to_room: "Zero Room"
   door { name: "Lavender Cube" }
 }
+connections {
+  from_room: "Back Area"
+  to_room: "The Landscapes"
+}
@@ -124,6 +124,7 @@ doors {
   panels { room: "Magnet Room" name: "SAW" }
   panels { room: "Magnet Room" name: "BLENDER" }
   location_room: "Magnet Room"
+  location_name: "Gravestone"
 }
 doors {
   name: "Hive Entrance"
@@ -205,23 +206,25 @@ doors {
   panels { room: "Jail Part 2" name: "GRIMACE" }
   panels { room: "Jail Part 2" name: "COMMENCE" }
   location_room: "Jail Part 2"
+  location_name: "Gravestone"
 }
 doors {
   name: "The Landscapes Gravestone"
   type: GRAVESTONE
-  panels { room: "Back Area" name: "Top Landscape Top" }
-  panels { room: "Back Area" name: "Top Landscape Right" }
-  panels { room: "Back Area" name: "Top Landscape Bottom" }
-  panels { room: "Back Area" name: "Top Landscape Left" }
-  panels { room: "Back Area" name: "Left Landscape Top" }
-  panels { room: "Back Area" name: "Left Landscape Right" }
-  panels { room: "Back Area" name: "Left Landscape Bottom" }
-  panels { room: "Back Area" name: "Left Landscape Left" }
-  panels { room: "Back Area" name: "Right Landscape Top" }
-  panels { room: "Back Area" name: "Right Landscape Right" }
-  panels { room: "Back Area" name: "Right Landscape Bottom" }
-  panels { room: "Back Area" name: "Right Landscape Left" }
-  location_room: "Back Area"
+  panels { room: "The Landscapes" name: "Top Landscape Top" }
+  panels { room: "The Landscapes" name: "Top Landscape Right" }
+  panels { room: "The Landscapes" name: "Top Landscape Bottom" }
+  panels { room: "The Landscapes" name: "Top Landscape Left" }
+  panels { room: "The Landscapes" name: "Left Landscape Top" }
+  panels { room: "The Landscapes" name: "Left Landscape Right" }
+  panels { room: "The Landscapes" name: "Left Landscape Bottom" }
+  panels { room: "The Landscapes" name: "Left Landscape Left" }
+  panels { room: "The Landscapes" name: "Right Landscape Top" }
+  panels { room: "The Landscapes" name: "Right Landscape Right" }
+  panels { room: "The Landscapes" name: "Right Landscape Bottom" }
+  panels { room: "The Landscapes" name: "Right Landscape Left" }
+  location_room: "The Landscapes"
+  location_name: "Gravestone"
 }
 doors {
   name: "Tower Entrance"
@@ -318,6 +321,7 @@ doors {
   panels { room: "Maze Up Area" name: "UP" }
   panels { room: "Maze Wreck Area" name: "WRECK" }
   location_room: "Maze Slice Area"
+  location_name: "Gravestone"
 }
 doors {
   name: "Courtyard Side Door"
@@ -419,10 +423,10 @@ doors {
   name: "Invisible Entrance"
   type: STANDARD
   receivers: "Components/Doors/entry_36"
-  panels { room: "Back Area" name: "Right Landscape Top" answer: "tell" }
-  panels { room: "Back Area" name: "Right Landscape Left" answer: "eyes" }
-  location_room: "Back Area"
-  location_name: "Landscapes Room Alternate Answers"
+  panels { room: "The Landscapes" name: "Right Landscape Top" answer: "tell" }
+  panels { room: "The Landscapes" name: "Right Landscape Left" answer: "eyes" }
+  location_room: "The Landscapes"
+  location_name: "Alternate Answers"
 }
 doors {
   name: "Nature Room Door"
@@ -468,6 +472,7 @@ doors {
   panels { room: "Whole Room" name: "CHIPS" }
   panels { room: "Whole Room" name: "TOWER" }
   location_room: "Whole Room"
+  location_name: "Gravestone"
 }
 doors {
   name: "Lavender Cube"
@@ -494,6 +499,7 @@ doors {
   panels { room: "Zero Room" name: "MANY" }
   panels { room: "Zero Room" name: "REMAINING" }
   location_room: "Zero Room"
+  location_name: "Panels"
 }
 doors {
   name: "Spiral Painting"
@@ -28,92 +28,6 @@ panels {
   answer: "tower"
   symbols: SPARKLES
 }
-panels {
-  name: "Top Landscape Top"
-  path: "Panels/Kiwi Room/kiwi_1"
-  clue: ""
-  answer: "one"
-  symbols: QUESTION
-}
-panels {
-  name: "Top Landscape Right"
-  path: "Panels/Kiwi Room/kiwi_2"
-  clue: ""
-  answer: "road"
-  symbols: QUESTION
-}
-panels {
-  name: "Top Landscape Bottom"
-  path: "Panels/Kiwi Room/kiwi_3"
-  clue: ""
-  answer: "many"
-  symbols: QUESTION
-}
-panels {
-  name: "Top Landscape Left"
-  path: "Panels/Kiwi Room/kiwi_4"
-  clue: ""
-  answer: "turns"
-  symbols: QUESTION
-}
-panels {
-  name: "Left Landscape Top"
-  path: "Panels/Kiwi Room/kiwi_5"
-  clue: ""
-  answer: "find"
-  symbols: QUESTION
-}
-panels {
-  name: "Left Landscape Right"
-  path: "Panels/Kiwi Room/kiwi_6"
-  clue: ""
-  answer: "keys"
-  symbols: QUESTION
-}
-panels {
-  name: "Left Landscape Bottom"
-  path: "Panels/Kiwi Room/kiwi_7"
-  clue: ""
-  answer: "write"
-  symbols: QUESTION
-}
-panels {
-  name: "Left Landscape Left"
-  path: "Panels/Kiwi Room/kiwi_8"
-  clue: ""
-  answer: "words"
-  symbols: QUESTION
-}
-panels {
-  name: "Right Landscape Top"
-  path: "Panels/Kiwi Room/kiwi_9"
-  clue: ""
-  answer: "hear"
-  symbols: QUESTION
-  proxies { answer: "tell" path: "Panels/Kiwi Proxies/kiwi_9_proxy_1" }
-}
-panels {
-  name: "Right Landscape Right"
-  path: "Panels/Kiwi Room/kiwi_10"
-  clue: ""
-  answer: "lies"
-  symbols: QUESTION
-}
-panels {
-  name: "Right Landscape Bottom"
-  path: "Panels/Kiwi Room/kiwi_11"
-  clue: ""
-  answer: "the"
-  symbols: QUESTION
-}
-panels {
-  name: "Right Landscape Left"
-  path: "Panels/Kiwi Room/kiwi_12"
-  clue: ""
-  answer: "ears"
-  symbols: QUESTION
-  proxies { answer: "eyes" path: "Panels/Kiwi Proxies/kiwi_12_proxy_1" }
-}
 paintings {
   name: "SPIRAL"
   path: "Components/Paintings/spiral"
@@ -0,0 +1,88 @@
+name: "The Landscapes"
+panel_display_name: "The Landscapes"
+panels {
+  name: "Top Landscape Top"
+  path: "Panels/Kiwi Room/kiwi_1"
+  clue: ""
+  answer: "one"
+  symbols: QUESTION
+}
+panels {
+  name: "Top Landscape Right"
+  path: "Panels/Kiwi Room/kiwi_2"
+  clue: ""
+  answer: "road"
+  symbols: QUESTION
+}
+panels {
+  name: "Top Landscape Bottom"
+  path: "Panels/Kiwi Room/kiwi_3"
+  clue: ""
+  answer: "many"
+  symbols: QUESTION
+}
+panels {
+  name: "Top Landscape Left"
+  path: "Panels/Kiwi Room/kiwi_4"
+  clue: ""
+  answer: "turns"
+  symbols: QUESTION
+}
+panels {
+  name: "Left Landscape Top"
+  path: "Panels/Kiwi Room/kiwi_5"
+  clue: ""
+  answer: "find"
+  symbols: QUESTION
+}
+panels {
+  name: "Left Landscape Right"
+  path: "Panels/Kiwi Room/kiwi_6"
+  clue: ""
+  answer: "keys"
+  symbols: QUESTION
+}
+panels {
+  name: "Left Landscape Bottom"
+  path: "Panels/Kiwi Room/kiwi_7"
+  clue: ""
+  answer: "write"
+  symbols: QUESTION
+}
+panels {
+  name: "Left Landscape Left"
+  path: "Panels/Kiwi Room/kiwi_8"
+  clue: ""
+  answer: "words"
+  symbols: QUESTION
+}
+panels {
+  name: "Right Landscape Top"
+  path: "Panels/Kiwi Room/kiwi_9"
+  clue: ""
+  answer: "hear"
+  symbols: QUESTION
+  proxies { answer: "tell" path: "Panels/Kiwi Proxies/kiwi_9_proxy_1" }
+}
+panels {
+  name: "Right Landscape Right"
+  path: "Panels/Kiwi Room/kiwi_10"
+  clue: ""
+  answer: "lies"
+  symbols: QUESTION
+}
+panels {
+  name: "Right Landscape Bottom"
+  path: "Panels/Kiwi Room/kiwi_11"
+  clue: ""
+  answer: "the"
+  symbols: QUESTION
+}
+panels {
+  name: "Right Landscape Left"
+  path: "Panels/Kiwi Room/kiwi_12"
+  clue: ""
+  answer: "ears"
+  symbols: QUESTION
+  proxies { answer: "eyes" path: "Panels/Kiwi Proxies/kiwi_12_proxy_1" }
+}
@@ -1,5 +1,5 @@
 name: "Whole Room"
-panel_display_name: "North Landscape"
+panel_display_name: "Building Building"
 panels {
   name: "VAULT"
   path: "Panels/Whole Room/whole_1"
@@ -1,7 +1,7 @@
 version {
   major: 7
-  minor: 0
-  patch: 2
+  minor: 1
+  patch: 0
 }
 # Filler item.
 special_names: "A Job Well Done"