Samus Eater teleport WIP

Author: blkerby

region/brinstar/green/Green Brinstar Main Shaft.json

@@ -2910,6 +2910,22 @@
       },
       "requires": []
     },
+    {
+      "link": [5, 13],
+      "name": "Samus Eater Teleport",
+      "entranceCondition": {
+        "comeInWithSamusEaterTeleport": {
+          "floorPositions": [[12, 13], [14, 13], [15, 13]],
+          "ceilingPositions": []
+        }
+      },
+      "requires": [
+        "Morph"
+      ],
+      "note": [
+        "Land in the last Samus Eater of Alpha Power Bomb Room, or the second Samus Eater from the right of Hellway."
+      ]
+    },
     {
       "id": 121,
       "link": [6, 2],
@@ -3477,6 +3493,25 @@
       },
       "requires": []
     },
+    {
+      "link": [6, 13],
+      "name": "Samus Eater Teleport",
+      "entranceCondition": {
+        "comeInWithSamusEaterTeleport": {
+          "floorPositions": [[15, 13], [1, 13]],
+          "ceilingPositions": []
+        }
+      },
+      "requires": [
+        "Morph"
+      ],
+      "note": [
+        "Land in the right side of the third Samus Eater on the floor of Hellway."
+      ],
+      "devNote": [
+        "The last Samus Eater on the right can also work."
+      ]
+    },
     {
       "id": 152,
       "link": [7, 2],

region/brinstar/red/Alpha Power Bomb Room.json

@@ -295,6 +295,23 @@
       ],
       "flashSuitChecked": true
     },
+    {
+      "link": [1, 1],
+      "name": "Leave with Samus Eater Teleport",
+      "entranceCondition": {
+        "comeInWithGMode": {
+          "mode": "direct",
+          "morphed": false
+        }
+      },
+      "requires": [],
+      "exitCondition": {
+        "leaveWithSamusEaterTeleport": {
+          "floorPositions": [[12, 13], [2, 13], [8, 13]],
+          "ceilingPositions": []
+        }
+      }    
+    },
     {
       "id": 10,
       "link": [1, 2],

region/brinstar/red/Hellway.json

@@ -285,6 +285,23 @@
       "flashSuitChecked": true,
       "note": "Shoot a Super towards the door while the Zeela is on the side of its platform to knock it off."
     },
+    {
+      "link": [1, 1],
+      "name": "Leave with Samus Eater Teleport",
+      "entranceCondition": {
+        "comeInWithGMode": {
+          "mode": "direct",
+          "morphed": false
+        }
+      },
+      "requires": [],
+      "exitCondition": {
+        "leaveWithSamusEaterTeleport": {
+          "floorPositions": [[7, 13], [11, 13], [15, 13], [10, 13], [14, 13], [1, 13]],
+          "ceilingPositions": [[6, 3], [10, 3]]
+        }
+      }    
+    },
     {
       "id": 12,
       "link": [1, 2],
@@ -463,6 +480,23 @@
         "leaveWithGModeSetup": {}
       },
       "flashSuitChecked": true
+    },
+    {
+      "link": [2, 2],
+      "name": "Leave with Samus Eater Teleport",
+      "entranceCondition": {
+        "comeInWithGMode": {
+          "mode": "direct",
+          "morphed": false
+        }
+      },
+      "requires": [],
+      "exitCondition": {
+        "leaveWithSamusEaterTeleport": {
+          "floorPositions": [[7, 13], [11, 13], [15, 13], [10, 13], [14, 13], [1, 13]],
+          "ceilingPositions": [[6, 3], [10, 3]]
+        }
+      }    
     }
   ],
   "notables": [

region/maridia/inner-pink/Colosseum.json

@@ -1946,6 +1946,20 @@
         "Grapple diagonally again to be pushed into the transition."
       ]
     },
+    {
+      "link": [3, 2],
+      "name": "Samus Eater Teleport, Grapple Door Lock Skip",
+      "entranceCondition": {
+        "comeInWithSamusEaterTeleport": {
+        }
+      },
+      "requires": [
+        "canGrappleClip"
+      ],
+      "bypassesDoorShell": true,
+      "note": [
+      ]
+    },
     {
       "id": 77,
       "link": [3, 3],

schema/m3-room.schema.json

@@ -690,6 +690,40 @@
                 }
               }              
             },
+            "comeInWithSamusEaterTeleport": {
+              "type": "object",
+              "description": "Represents that Samus must come into the room after teleporting to the location of a Samus Eater.",
+              "required": ["floorPositions", "ceilingPositions"],
+              "additionalProperties": false,
+              "properties": {
+                "floorPositions": {
+                  "type": "array",
+                  "description": "A list of screen-local tile coordinates of suitable floor Samus Eaters positions which will work for this strat, matching a position in a corresponding 'leaveWithSamusEaterTeleport' strat.",
+                  "items": {
+                    "type": "array",
+                    "minItems": 2,
+                    "maxItems": 2,
+                    "items": {
+                      "type": "integer",
+                      "description": "X or Y coordinate measured as a tile count, with 0 representing the top or left-most tile of the screen."
+                    }
+                  }
+                },
+                "ceilingPositions": {
+                  "type": "array",
+                  "description": "A list of screen-local tile coordinates of suitable ceiling Samus Eaters positions which will work for this strat, matching a position in a corresponding 'leaveWithSamusEaterTeleport' strat.",
+                  "items": {
+                    "type": "array",
+                    "minItems": 2,
+                    "maxItems": 2,
+                    "items": {
+                      "type": "integer",
+                      "description": "X or Y coordinate measured as a tile count, with 0 representing the top or left-most tile of the screen."
+                    }
+                  }
+                }
+              }              
+            },
             "comesThroughToilet": {
               "type": "string",
               "description": "For a strat having an entranceCondition through a vertical transition, indicates whether the strat is applicable if the Toilet comes between this room and the room with the exitCondition.",
@@ -730,7 +764,8 @@
             {"required": ["comeInWithWallJumpBelow"]},
             {"required": ["comeInWithSpaceJumpBelow"]},
             {"required": ["comeInWithPlatformBelow"]},
-            {"required": ["comeInWithGrappleTeleport"]}
+            {"required": ["comeInWithGrappleTeleport"]},
+            {"required": ["comeInWithSamusEaterTeleport"]}
           ]
         },
         "startsWithShineCharge": {
@@ -1072,6 +1107,42 @@
                   }
                 }
               }              
+            },
+            "leaveWithSamusEaterTeleport": {
+              "type": "object",
+              "description": "Represents that Samus can leave through this door immediately after exiting G-mode, in such a way that Samus is teleported to the position of a Samus Eater at the start of the transition.",
+              "required": ["floorPositions", "ceilingPositions"],
+              "additionalProperties": false,
+              "properties": {
+                "floorPositions": {
+                  "type": "array",
+                  "description": "A list of screen-local tile coordinates of floor Samus Eaters, indicating the left-most tile of the Samus Eater that Samus can interact with.",
+                  "items": {
+                    "type": "array",
+                    "minItems": 2,
+                    "maxItems": 2,
+                    "items": {
+                      "type": "integer",
+                      "description": "X or Y coordinate measured as a tile count, with 0 representing the top or left-most tile of the screen.",
+                      "minimum": 0,
+                      "maximum": 15
+                    }
+                  }
+                },
+                "ceilingPositions": {
+                  "type": "array",
+                  "description": "A list of screen-local tile coordinates of ceiling Samus Eaters, indicating the left-most tile of the Samus Eater that Samus can interact with.",
+                  "items": {
+                    "type": "array",
+                    "minItems": 2,
+                    "maxItems": 2,
+                    "items": {
+                      "type": "integer",
+                      "description": "X or Y coordinate measured as a tile count, with 0 representing the top or left-most tile of the screen."
+                    }
+                  }
+                }
+              }              
             }
           }
         },

strats.md

@@ -491,6 +491,38 @@ A `leaveWithGrappleTeleport` comes with an implicit tech requirement `canGrapple
 }
 ```
 
+## Leave With Samus Eater Teleport
+
+A `leaveWithSamusEaterTeleport` exit condition represents that Samus can leave through this door immediately after initiating a teleport to the position of a Samus Eater in the room, by exiting G-mode. The position where Samus touched the Samus Eater determines where Samus will be placed in the next room. Most positions will result in Samus being placed behind the door after the transition, which will likely put Samus out of bounds. In some rooms, however, the space behind the door may be in-bounds; and there is a possibility of using specific Samus Eater locations to spawn Samus slightly in front of the door but lower than normal.
+
+A `leaveWithSamusEaterTeleport` object has the following properties:
+
+- _floorPositions_: A list of screen-local tile coordinates of floor Samus Eaters, indicating the left-most tile of the Samus Eater that Samus can interact with.
+- _ceilingPositions_: A list of screen-local tile coordinates of ceiling Samus Eaters, indicating the left-most tile of the Samus Eater that Samus can interact with.
+
+A `leaveWithSamusEaterTeleport` comes with an implicit tech requirement `canSamusEaterTeleport`.
+
+#### Example
+```json
+    {
+      "link": [1, 1],
+      "name": "Leave with Samus Eater Teleport",
+      "entranceCondition": {
+        "comeInWithGMode": {
+          "mode": "direct",
+          "morphed": false
+        }
+      },
+      "requires": [],
+      "exitCondition": {
+        "leaveWithSamusEaterTeleport": {
+          "floorPositions": [[12, 13], [2, 13], [8, 13]],
+          "ceilingPositions": []
+        }
+      }    
+    },
+```
+
 ## Entrance conditions
 
 In all strats with an `entranceCondition`, the `from` node of the strat must be a door node or entrance node. An `entranceCondition` object must contain exactly one of the following properties:

tech.json

@@ -2410,6 +2410,30 @@
                     "For high-energy (immobile) setups, instead turn around while taking knockback from the enemy that returns control to Samus (a 5-frame window)",
                     "This results in Samus entering a morph ball state without needing to have collected or equipped Morph."
                   ]
+                },
+                {
+                  "name": "canSamusEaterTeleport",
+                  "techRequires": [
+                    "canEnterGMode"
+                  ],
+                  "otherRequires": [],
+                  "note": [
+                    "Ability to use a Samus Eater to teleport when exiting G-mode, just before touching a door transition,",
+                    "modifying where Samus is placed in the next room.",
+                    "Exiting G-mode will teleport Samus to position where she touched the Samus Eater.",
+                    "At the start of the door transition, Samus' X and Y pixel positions are reduced modulo 256 (the size of a screen),",
+                    "so the relative position within the screen is all the matters (not the absolute position in the room).",
+                    "The transition must be touched 2 frames after control is regained control by releasing X-Ray.",
+                    "A normalized method to do this is to position Samus slightly more than 1 pixel from the door (but less than $1.3 pixels away),",
+                    "then hold forward toward the door while X-Ray is released.",
+                    "Correct subpixels for this method can be obtained in the following way: 1) jump and press against a wall above,",
+                    "2) jump and do a mid-air turnaround (making sure not to be in front of a wall when turning), which moves Samus back by half a pixel,",
+                    "3) moonwalking back toward the door until 2 pixels away;",
+                    "4) jump and do a turnaround mid-air toward the door.",
+                    "Moonwalking moves back Samus in half-pixel increments, so in the absence of frame-perfect timing there is a 50% chance of ending in the correct position.",
+                    "If Samus is 2 pixels away from the door after the final jump turnaround, then the position is correct;",
+                    "if Samus is 1 pixel away from the door, then the position is incorrect, and the setup should be repeated."
+                  ]
                 }
               ]
             },