Ridley Tank Room R-Mode Spark Interrupt (#2397)

Author: aquanight

helpers.json

@@ -1692,6 +1692,67 @@
             ]}
           ]
         },
+        {
+          "name": "h_CrystalFlashForReserveEnergy",
+          "requires": [
+            "canCrystalFlash",
+            {"or": [
+              {"and": [
+                {"or": [
+                  {"disableEquipment": "ETank"},
+                  {"resourceMaxCapacity": [{"type": "RegularEnergy", "count": 1099}]}
+                ]},
+                {"partialRefill": {"type": "RegularEnergy", "limit": 1099}},
+                {"refill": ["ReserveEnergy"]}
+              ]},
+              {"and": [
+                {"refill": ["RegularEnergy"]},
+                {"partialRefill": {"type": "ReserveEnergy", "limit": 51}}
+              ]}
+            ]},
+            {"resourceAvailable": [{"type": "ReserveEnergy", "count": 1}]}
+          ],
+          "note": [
+            "This helper represents using a Crystal Flash with the specific goal of getting reserves, which is",
+            "particularly important in R-Mode due to needing reserves for R-Mode standup.",
+            "If Energy Tanks can be disabled, regular energy will be capped at 10 E-Tanks to provide up to 400 Reserves.",
+            "Without this, reserve energy will be capped at 51: the maximum possible when the player has all 14 E-Tanks."
+          ]
+        },
+        {
+          "name": "h_heatedCrystalFlashForReserveEnergy",
+          "requires": [
+            {"or": [
+              {"and": [
+                "h_heatProof",
+                "h_CrystalFlashForReserveEnergy"
+              ]},
+              {"and": [
+                {"simpleHeatFrames": 185},
+                "canHeatedCrystalFlash",
+                {"and": [
+                  {"or": [
+                    {"disableEquipment": "ETank"},
+                    {"resourceMaxCapacity": [{"type": "RegularEnergy", "count": 999}]}
+                  ]},
+                  {"partialRefill": {"type": "RegularEnergy", "limit": 999}},
+                  {"refill": ["ReserveEnergy"]}
+                ]},
+                {"simpleHeatFrames": 20}
+              ]}
+            ]},
+            {"resourceAvailable": [{"type": "ReserveEnergy", "count": 1}]}
+          ],
+          "note": [
+            "This helper represents using a Crystal Flash in heat with the specific goal of getting reserves, which is",
+            "particularly important in R-Mode due to needing reserves for R-Mode standup.",
+            "In unprotected heat, at 14 E-Tanks, a Crystal Flash would normally fail to reach the energy maximum and",
+            "provide reserves.",
+            "If Energy Tanks can be disabled, regular energy will be capped at 9 E-Tanks (10 if heat protection is available)",
+            "to provide up to 400 Reserves. Without this, heat protection is mandatory, and Reserve energy will be capped at 51:",
+            "the maximum possible when the player has all 14 E-Tanks."
+          ]
+        },
         {
           "name": "h_RModeKnockbackSpark",
           "requires": [

region/lowernorfair/east/Ridley Tank Room.json

@@ -66,6 +66,31 @@
       },
       "flashSuitChecked": true
     },
+    {
+      "link": [1, 1],
+      "name": "R-Mode Spark Interrupt (Gain Blue Suit)",
+      "entranceCondition": {
+        "comeInWithRMode": {}
+      },
+      "requires": [
+        "h_heatProof",
+        "h_heatedCrystalFlashForReserveEnergy",
+        {"disableEquipment": "Varia"},
+        {"disableEquipment": "Gravity"},
+        {"canShineCharge": {"usedTiles": 12, "openEnd": 0}},
+        {"autoReserveTrigger": {}},
+        "canRModePauseAbuseSparkInterrupt"
+      ],
+      "flashSuitChecked": true,
+      "blueSuitChecked": true,
+      "note": [
+        "This room has no enemies, so the only damage source is by turning off (or not having) heat protection",
+        "This is a very short shinecharge runway."
+      ],
+      "devNote": [
+        "FIXME: Needs to support X-Ray buffering, and heatFrames with Varia disabled would also enable a non-pause abuse strat."
+      ]
+    },
     {
       "id": 5,
       "link": [1, 1],

tests/asserts/keywords.py

@@ -334,6 +334,7 @@ def check_shinecharge_req(req):
 def check_heat_req(req):
     if isinstance(req, str):
         if req in ["h_heatProof", "h_heatedCrystalFlash", "h_heatedLavaCrystalFlash", "h_heatedAcidCrystalFlash",
+                   "h_heatedCrystalFlashForReserveEnergy",
                    "h_heatedCrystalSpark", "h_LowerNorfairElevatorDownwardFrames",
                    "h_LowerNorfairElevatorUpwardFrames", "h_MainHallElevatorFrames", "h_heatedGreenGateGlitch",
                    "h_heatedDirectGModeLeaveSameDoor", "h_heatedIndirectGModeOpenSameDoor",