isaacscript-common 6.11.1 → 6.11.2

package/dist/features/taintedLazarusPlayers.lua

@@ -8,17 +8,18 @@ local ModCallback = ____isaac_2Dtypescript_2Ddefinitions.ModCallback
 local PlayerType = ____isaac_2Dtypescript_2Ddefinitions.PlayerType
 local ____featuresInitialized = require("featuresInitialized")
 local errorIfFeaturesNotInitialized = ____featuresInitialized.errorIfFeaturesNotInitialized
+local ____log = require("functions.log")
+local logError = ____log.logError
 local ____exports = require("features.saveDataManager.exports")
 local saveDataManager = ____exports.saveDataManager
 function postPlayerInit(self, player)
-    local entityPtr = EntityPtr(player)
     local character = player:GetPlayerType()
     if character == PlayerType.LAZARUS_B then
         local ____v_run_queuedTaintedLazarus_0 = v.run.queuedTaintedLazarus
-        ____v_run_queuedTaintedLazarus_0[#____v_run_queuedTaintedLazarus_0 + 1] = entityPtr
+        ____v_run_queuedTaintedLazarus_0[#____v_run_queuedTaintedLazarus_0 + 1] = player
     elseif character == PlayerType.LAZARUS_2_B then
         local ____v_run_queuedDeadTaintedLazarus_1 = v.run.queuedDeadTaintedLazarus
-        ____v_run_queuedDeadTaintedLazarus_1[#____v_run_queuedDeadTaintedLazarus_1 + 1] = entityPtr
+        ____v_run_queuedDeadTaintedLazarus_1[#____v_run_queuedDeadTaintedLazarus_1 + 1] = player
     else
         return
     end
@@ -28,20 +29,19 @@ function checkDequeue(self)
     if #v.run.queuedTaintedLazarus == 0 or #v.run.queuedDeadTaintedLazarus == 0 then
         return
     end
-    local taintedLazarusPtr = table.remove(v.run.queuedTaintedLazarus, 1)
-    local deadTaintedLazarusPtr = table.remove(v.run.queuedDeadTaintedLazarus, 1)
-    if taintedLazarusPtr == nil or deadTaintedLazarusPtr == nil then
-        return
-    end
-    local taintedLazarus = taintedLazarusPtr.Ref
-    local deadTaintedLazarus = deadTaintedLazarusPtr.Ref
+    local taintedLazarus = table.remove(v.run.queuedTaintedLazarus, 1)
+    local deadTaintedLazarus = table.remove(v.run.queuedDeadTaintedLazarus, 1)
     if taintedLazarus == nil or deadTaintedLazarus == nil then
         return
     end
     local taintedLazarusPtrHash = GetPtrHash(taintedLazarus)
     local deadTaintedLazarusPtrHash = GetPtrHash(deadTaintedLazarus)
-    v.run.subPlayerMap:set(taintedLazarusPtrHash, deadTaintedLazarusPtr)
-    v.run.subPlayerMap:set(deadTaintedLazarusPtrHash, taintedLazarusPtr)
+    if taintedLazarusPtrHash == deadTaintedLazarusPtrHash then
+        logError("Failed to cache the Tainted Lazarus player objects, since the hash for Tainted Lazarus and Dead Tainted Lazarus were the same.")
+        return
+    end
+    v.run.subPlayerMap:set(taintedLazarusPtrHash, deadTaintedLazarus)
+    v.run.subPlayerMap:set(deadTaintedLazarusPtrHash, taintedLazarus)
 end
 local FEATURE_NAME = "taintedLazarusPlayers"
 v = {run = {
@@ -72,14 +72,6 @@ end
 function ____exports.getTaintedLazarusSubPlayer(self, player)
     errorIfFeaturesNotInitialized(nil, FEATURE_NAME)
     local ptrHash = GetPtrHash(player)
-    local entityPtr = v.run.subPlayerMap:get(ptrHash)
-    if entityPtr == nil then
-        return nil
-    end
-    local entity = entityPtr.Ref
-    if entity == nil then
-        return nil
-    end
-    return entity:ToPlayer()
+    return v.run.subPlayerMap:get(ptrHash)
 end
 return ____exports

package/dist/functions/log.lua

@@ -550,14 +550,14 @@ function ____exports.logTableDifferences(table1, table2)
     __TS__ArraySort(keys)
     for ____, key in ipairs(keys) do
         if not table1KeysSet:has(key) then
-            ____exports.log("  Table 1 is missing key: " .. key)
+            ____exports.log("  Table 1 is missing key: " .. tostring(key))
         elseif not table2KeysSet:has(key) then
-            ____exports.log("  Table 2 is missing key: " .. key)
+            ____exports.log("  Table 2 is missing key: " .. tostring(key))
         else
             local value1 = table1[key]
             local value2 = table2[key]
             if value1 ~= value2 then
-                ____exports.log(((((("  " .. key) .. " --> \"") .. tostring(value1)) .. "\" versus \"") .. tostring(value2)) .. "\"")
+                ____exports.log(((((("  " .. tostring(key)) .. " --> \"") .. tostring(value1)) .. "\" versus \"") .. tostring(value2)) .. "\"")
             end
         end
     end

package/dist/functions/playerIndex.d.ts

@@ -10,6 +10,11 @@ import { PlayerIndex } from "../types/PlayerIndex";
  * helper function instead to get a filtered list of players.
  */
 export declare function getAllPlayers(): EntityPlayer[];
+/**
+ * Helper function to get all of the other players in the room besides the one provided. (This
+ * includes "child" players.)
+ */
+export declare function getOtherPlayers(player: EntityPlayer): EntityPlayer[];
 /**
  * Helper function to get the corresponding `EntityPlayer` object that corresponds to a
  * `PlayerIndex`.

package/dist/functions/playerIndex.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"playerIndex.d.ts","sourceRoot":"","sources":["../../src/functions/playerIndex.ts"],"names":[],"mappings":";;;AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AASnD;;;;;;GAMG;AACH,wBAAgB,aAAa,IAAI,YAAY,EAAE,CAU9C;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,WAAW,GACvB,YAAY,GAAG,SAAS,CAG1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,YAAY,EACpB,6BAA6B,UAAQ,GACpC,WAAW,CA4Bb;AA2BD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,YAAY,GACzB,GAAG,GAAG,SAAS,CAajB;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,0BAA0B,UAAQ,GAAG,YAAY,EAAE,CAS7E;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,eAAe,GACzB,YAAY,GAAG,SAAS,CAa1B;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAE3D"}
+{"version":3,"file":"playerIndex.d.ts","sourceRoot":"","sources":["../../src/functions/playerIndex.ts"],"names":[],"mappings":";;;AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AASnD;;;;;;GAMG;AACH,wBAAgB,aAAa,IAAI,YAAY,EAAE,CAU9C;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,EAAE,CAMpE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,WAAW,GACvB,YAAY,GAAG,SAAS,CAG1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,YAAY,EACpB,6BAA6B,UAAQ,GACpC,WAAW,CA4Bb;AA2BD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,YAAY,GACzB,GAAG,GAAG,SAAS,CAajB;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,0BAA0B,UAAQ,GAAG,YAAY,EAAE,CAS7E;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,eAAe,GACzB,YAAY,GAAG,SAAS,CAa1B;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAE3D"}

package/dist/functions/playerIndex.lua

@@ -1,8 +1,8 @@
 local ____lualib = require("lualib_bundle")
 local Set = ____lualib.Set
 local __TS__New = ____lualib.__TS__New
-local __TS__ArrayFind = ____lualib.__TS__ArrayFind
 local __TS__ArrayFilter = ____lualib.__TS__ArrayFilter
+local __TS__ArrayFind = ____lualib.__TS__ArrayFind
 local ____exports = {}
 local getPlayerIndexCollectibleType, DEFAULT_COLLECTIBLE_TYPE, EXCLUDED_CHARACTERS
 local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
@@ -79,15 +79,15 @@ end
 function getPlayerIndexCollectibleType(self, player, differentiateForgottenAndSoul)
     local character = player:GetPlayerType()
     repeat
-        local ____switch10 = character
-        local ____cond10 = ____switch10 == PlayerType.THE_SOUL
-        if ____cond10 then
+        local ____switch12 = character
+        local ____cond12 = ____switch12 == PlayerType.THE_SOUL
+        if ____cond12 then
             do
                 return differentiateForgottenAndSoul and CollectibleType.SPOON_BENDER or DEFAULT_COLLECTIBLE_TYPE
             end
         end
-        ____cond10 = ____cond10 or ____switch10 == PlayerType.LAZARUS_2_B
-        if ____cond10 then
+        ____cond12 = ____cond12 or ____switch12 == PlayerType.LAZARUS_2_B
+        if ____cond12 then
             do
                 return CollectibleType.INNER_EYE
             end
@@ -150,6 +150,16 @@ function ____exports.isChildPlayer(self, player)
 end
 DEFAULT_COLLECTIBLE_TYPE = CollectibleType.SAD_ONION
 EXCLUDED_CHARACTERS = __TS__New(Set, {PlayerType.ESAU, PlayerType.THE_SOUL_B})
+--- Helper function to get all of the other players in the room besides the one provided. (This
+-- includes "child" players.)
+function ____exports.getOtherPlayers(self, player)
+    local playerPtrHash = GetPtrHash(player)
+    local players = ____exports.getAllPlayers(nil)
+    return __TS__ArrayFilter(
+        players,
+        function(____, otherPlayer) return GetPtrHash(otherPlayer) ~= playerPtrHash end
+    )
+end
 --- Helper function to get the corresponding `EntityPlayer` object that corresponds to a
 -- `PlayerIndex`.
 function ____exports.getPlayerFromIndex(self, playerIndex)

package/dist/functions/table.d.ts

@@ -3,7 +3,7 @@
  * In a `Map`, you can use the `clear` method to delete every element. However, in a `LuaMap`, the
  * `clear` method does not exist. Use this helper function as a drop-in replacement for this.
  */
-export declare function clearTable(luaMap: LuaMap): void;
+export declare function clearTable(luaMap: LuaMap<AnyNotNil, unknown>): void;
 /** Helper function to copy specific values from a object to a table. */
 export declare function copyValuesToTable(object: unknown, keys: string[], luaMap: LuaMap<string, unknown>): void;
 /**

package/dist/functions/table.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../../src/functions/table.ts"],"names":[],"mappings":";AAEA;;;GAGG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAI/C;AAED,wEAAwE;AACxE,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,OAAO,EACf,IAAI,EAAE,MAAM,EAAE,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,IAAI,CAON;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,UAAU,EAAE,MAAM,EAClB,GAAG,IAAI,EAAE,MAAM,EAAE,GAChB,OAAO,EAAE,CAoBX;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,UAAU,EAAE,MAAM,EAClB,GAAG,IAAI,EAAE,MAAM,EAAE,GAChB,MAAM,EAAE,CA4BV;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,UAAU,EAAE,MAAM,EAClB,GAAG,IAAI,EAAE,MAAM,EAAE,GAChB,MAAM,EAAE,CAmBV;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,CAAC,EACtC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EACpB,IAAI,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,KAAK,IAAI,EAChC,OAAO,UAAO,GACb,IAAI,CA6BN;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,EAClC,GAAG,IAAI,EAAE,MAAM,EAAE,GAChB,OAAO,CAET"}
+{"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../../src/functions/table.ts"],"names":[],"mappings":";AAEA;;;GAGG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,GAAG,IAAI,CAInE;AAED,wEAAwE;AACxE,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,OAAO,EACf,IAAI,EAAE,MAAM,EAAE,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,IAAI,CAON;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,UAAU,EAAE,MAAM,EAClB,GAAG,IAAI,EAAE,MAAM,EAAE,GAChB,OAAO,EAAE,CAoBX;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,UAAU,EAAE,MAAM,EAClB,GAAG,IAAI,EAAE,MAAM,EAAE,GAChB,MAAM,EAAE,CA4BV;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,UAAU,EAAE,MAAM,EAClB,GAAG,IAAI,EAAE,MAAM,EAAE,GAChB,MAAM,EAAE,CAmBV;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,CAAC,EACtC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EACpB,IAAI,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,KAAK,IAAI,EAChC,OAAO,UAAO,GACb,IAAI,CA6BN;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,EAClC,GAAG,IAAI,EAAE,MAAM,EAAE,GAChB,OAAO,CAET"}

package/dist/initFeatures.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"initFeatures.d.ts","sourceRoot":"","sources":["../src/initFeatures.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAyBpD,wBAAgB,YAAY,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAGnD"}
+{"version":3,"file":"initFeatures.d.ts","sourceRoot":"","sources":["../src/initFeatures.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AA0BpD,wBAAgB,YAAY,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAGnD"}

package/dist/initFeatures.lua

@@ -10,6 +10,8 @@ local ____customGridEntity = require("features.customGridEntity")
 local customGridEntityInit = ____customGridEntity.customGridEntityInit
 local ____init = require("features.customStage.init")
 local customStageInit = ____init.customStageInit
+local ____init = require("features.customTrapdoor.init")
+local customTrapdoorInit = ____init.customTrapdoorInit
 local ____deployJSONRoom = require("features.deployJSONRoom")
 local deployJSONRoomInit = ____deployJSONRoom.deployJSONRoomInit
 local ____disableAllSound = require("features.disableAllSound")
@@ -55,6 +57,7 @@ function initFeaturesMajor(self, mod)
     customGridEntityInit(nil, mod)
 end
 function initFeaturesMinor(self, mod)
+    customTrapdoorInit(nil, mod)
     disableAllSoundInit(nil, mod)
     disableInputsInit(nil, mod)
     fadeInRemoverInit(nil, mod)

package/dist/interfaces/CustomGridEntityData.d.ts

@@ -1,10 +1,14 @@
 import { GridCollisionClass, GridEntityType } from "isaac-typescript-definitions";
 export interface CustomGridEntityData {
+    /**
+     * This is not a real `GridEntityType`; rather it is an arbitrary integer selected by end-user
+     * mods.
+     */
     gridEntityTypeCustom: GridEntityType;
     roomListIndex: int;
     gridIndex: int;
     anm2Path: string;
-    defaultAnimation: string;
+    defaultAnimation?: string;
     gridCollisionClass: GridCollisionClass;
 }
 //# sourceMappingURL=CustomGridEntityData.d.ts.map

package/dist/interfaces/CustomGridEntityData.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CustomGridEntityData.d.ts","sourceRoot":"","sources":["../../src/interfaces/CustomGridEntityData.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,cAAc,EACf,MAAM,8BAA8B,CAAC;AAEtC,MAAM,WAAW,oBAAoB;IACnC,oBAAoB,EAAE,cAAc,CAAC;IACrC,aAAa,EAAE,GAAG,CAAC;IACnB,SAAS,EAAE,GAAG,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,kBAAkB,CAAC;CACxC"}
+{"version":3,"file":"CustomGridEntityData.d.ts","sourceRoot":"","sources":["../../src/interfaces/CustomGridEntityData.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,cAAc,EACf,MAAM,8BAA8B,CAAC;AAEtC,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,oBAAoB,EAAE,cAAc,CAAC;IAErC,aAAa,EAAE,GAAG,CAAC;IACnB,SAAS,EAAE,GAAG,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,kBAAkB,CAAC;CACxC"}

package/dist/interfaces/private/CustomTrapdoorDescription.d.ts

@@ -1,4 +1,7 @@
+import { LevelStage, StageType } from "isaac-typescript-definitions";
 export interface CustomTrapdoorDescription {
+    open: boolean;
+    destination: [stage: LevelStage, stageType: StageType] | string;
     firstSpawn: boolean;
 }
 //# sourceMappingURL=CustomTrapdoorDescription.d.ts.map

package/dist/interfaces/private/CustomTrapdoorDescription.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CustomTrapdoorDescription.d.ts","sourceRoot":"","sources":["../../../src/interfaces/private/CustomTrapdoorDescription.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,OAAO,CAAC;CACrB"}
+{"version":3,"file":"CustomTrapdoorDescription.d.ts","sourceRoot":"","sources":["../../../src/interfaces/private/CustomTrapdoorDescription.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAErE,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,OAAO,CAAC;IACd,WAAW,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,CAAC,GAAG,MAAM,CAAC;IAChE,UAAU,EAAE,OAAO,CAAC;CACrB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacscript-common",
-  "version": "6.11.1",
+  "version": "6.11.2",
   "description": "Helper functions and features for IsaacScript mods.",
   "keywords": [
     "isaac",
@@ -22,6 +22,6 @@
   "main": "dist/index",
   "types": "dist/index.d.ts",
   "dependencies": {
-    "isaac-typescript-definitions": "^3.0.32"
+    "isaac-typescript-definitions": "^3.0.34"
   }
 }

package/src/callbacks/postFlip.ts

@@ -21,6 +21,7 @@ import {
 
 const v = {
   run: {
+    /** We don't consider the case of a multiplayer game with more than one Tainted Lazarus. */
     usedFlipAtLeastOnce: false,
   },
 };
@@ -63,10 +64,10 @@ function useItemFlip(
 
   if (!v.run.usedFlipAtLeastOnce) {
     v.run.usedFlipAtLeastOnce = true;
-    postFirstFlipFire(newLazarus);
+    postFirstFlipFire(newLazarus, player);
   }
 
-  postFlipFire(newLazarus);
+  postFlipFire(newLazarus, player);
 
   return undefined;
 }

package/src/callbacks/subscriptions/postFirstFlip.ts

@@ -1,5 +1,5 @@
 export type PostFirstFlipRegisterParameters = [
-  callback: (player: EntityPlayer) => void,
+  callback: (newLazarus: EntityPlayer, oldLazarus: EntityPlayer) => void,
 ];
 
 const subscriptions: PostFirstFlipRegisterParameters[] = [];
@@ -17,8 +17,11 @@ export function postFirstFlipRegister(
 }
 
 /** @internal */
-export function postFirstFlipFire(player: EntityPlayer): void {
+export function postFirstFlipFire(
+  newLazarus: EntityPlayer,
+  oldLazarus: EntityPlayer,
+): void {
   for (const [callback] of subscriptions) {
-    callback(player);
+    callback(newLazarus, oldLazarus);
   }
 }

package/src/callbacks/subscriptions/postFlip.ts

@@ -1,5 +1,5 @@
 export type PostFlipRegisterParameters = [
-  callback: (player: EntityPlayer) => void,
+  callback: (newLazarus: EntityPlayer, oldLazarus: EntityPlayer) => void,
 ];
 
 const subscriptions: PostFlipRegisterParameters[] = [];
@@ -15,8 +15,11 @@ export function postFlipRegister(...args: PostFlipRegisterParameters): void {
 }
 
 /** @internal */
-export function postFlipFire(player: EntityPlayer): void {
+export function postFlipFire(
+  newLazarus: EntityPlayer,
+  oldLazarus: EntityPlayer,
+): void {
   for (const [callback] of subscriptions) {
-    callback(player);
+    callback(newLazarus, oldLazarus);
   }
 }

package/src/enums/ModCallbackCustom.ts

@@ -295,7 +295,7 @@ export enum ModCallbackCustom {
    * before the player has actually used the Flip item.
    *
    * ```ts
-   * function postFirstFlip(player: EntityPlayer): void {}
+   * function postFirstFlip(newLazarus: EntityPlayer, oldLazarus: EntityPlayer): void {}
    * ```
    */
   POST_FIRST_FLIP,
@@ -309,7 +309,7 @@ export enum ModCallbackCustom {
    * before the player has actually used the Flip item.
    *
    * ```ts
-   * function postFlip(player: EntityPlayer): void {}
+   * function postFlip(newLazarus: EntityPlayer, oldLazarus: EntityPlayer): void {}
    * ```
    */
   POST_FLIP,

package/src/enums/private/StageTravelState.ts

@@ -1,4 +1,8 @@
 export enum StageTravelState {
   NONE,
-  // TODO
+  PLAYERS_JUMPING_DOWN,
+  PIXELATION_TO_BLACK,
+  PAUSING_ON_BLACK,
+  PIXELATION_TO_ROOM,
+  PLAYERS_LAYING_DOWN,
 }

package/src/enums/private/TrapdoorAnimation.ts

@@ -0,0 +1,5 @@
+export enum TrapdoorAnimation {
+  OPENED = "Opened",
+  CLOSED = "Closed",
+  OPEN_ANIMATION = "Open Animation",
+}

package/src/features/customGridEntity.ts

@@ -19,6 +19,7 @@ import {
 import { getRoomListIndex } from "../functions/roomData";
 import { isVector } from "../functions/vector";
 import { CustomGridEntityData } from "../interfaces/CustomGridEntityData";
+import { runNextGameFrame } from "./runInNFrames";
 import { saveDataManager } from "./saveDataManager/exports";
 
 const FEATURE_NAME = "customGridEntity";
@@ -30,6 +31,10 @@ const v = {
       () => new Map(),
     ),
   },
+
+  room: {
+    manuallyUsingShovel: false,
+  },
 };
 
 /** @internal */
@@ -53,12 +58,54 @@ export function customGridEntityInit(mod: ModUpgraded): void {
 function preUseItemWeNeedToGoDeeper(
   _collectibleType: CollectibleType,
   _rng: RNG,
-  _player: EntityPlayer,
+  player: EntityPlayer,
   _useFlags: BitFlags<UseFlag>,
   _activeSlot: ActiveSlot,
   _customVarData: int,
 ): boolean | undefined {
-  return undefined;
+  // If a player uses We Need to Go Deeper on top of a custom grid entity, then they will always get
+  // a crawlspace, due to how custom grids are implemented with decorations. Thus, remove the custom
+  // grid entity to prevent this from happening if needed.
+  const room = game.GetRoom();
+  const roomListIndex = getRoomListIndex();
+  const roomCustomGridEntities = v.level.customGridEntities.get(roomListIndex);
+  if (roomCustomGridEntities === undefined) {
+    return undefined;
+  }
+
+  const gridIndex = room.GetGridIndex(player.Position);
+  const customGridEntity = roomCustomGridEntities.get(gridIndex);
+  if (customGridEntity === undefined) {
+    return undefined;
+  }
+
+  // If the custom grid entity has collision, then the player should not be able to be standing on
+  // top of it.
+  if (customGridEntity.gridCollisionClass !== GridCollisionClass.NONE) {
+    return undefined;
+  }
+
+  removeGridEntity(customGridEntity.gridIndex, false);
+
+  const playerPtr = EntityPtr(player);
+  runNextGameFrame(() => {
+    const futureEntity = playerPtr.Ref;
+    if (futureEntity === undefined) {
+      return;
+    }
+
+    const futurePlayer = futureEntity.ToPlayer();
+    if (futurePlayer === undefined) {
+      return;
+    }
+
+    v.room.manuallyUsingShovel = true;
+    futurePlayer.UseActiveItem(CollectibleType.WE_NEED_TO_GO_DEEPER);
+    v.room.manuallyUsingShovel = false;
+  });
+
+  // Cancel the original effect.
+  return true;
 }
 
 // ModCallbackCustom.POST_NEW_ROOM_REORDERED
@@ -81,12 +128,18 @@ function postNewRoomReordered() {
 
     const sprite = decoration.GetSprite();
     sprite.Load(data.anm2Path, true);
-    sprite.Play(data.defaultAnimation, true);
+    const animationToPlay =
+      data.defaultAnimation === undefined
+        ? sprite.GetDefaultAnimation()
+        : data.defaultAnimation;
+    sprite.Play(animationToPlay, true);
   }
 }
 
 /**
- * Helper function to spawn a custom grid entity.
+ * Helper function to spawn a custom grid entity. Custom grid entities are persistent in that they
+ * will reappear if the player leaves and re-enters the room. (It will be manually respawned in the
+ * `POST_NEW_ROOM` callback.)
  *
  * This is an IsaacScript feature because the vanilla game does not support any custom grid
  * entities. Under the hood, IsaacScript accomplishes this by using decorations with an arbitrary
@@ -103,17 +156,18 @@ function postNewRoomReordered() {
  * @param gridIndexOrPosition The grid index or position in the room that you want to spawn the grid
  *                            entity at. If a position is specified, the closest grid index will be
  *                            used.
- * @param anm2Path The path to the ANM2 file to use for the sprite.
- * @param defaultAnimation The name of the animation to play after the sprite is initialized and
- *                         after the player re-enters a room with this grid entity in it.
  * @param gridCollisionClass The collision class that you want the custom grid entity to have.
+ * @param anm2Path The path to the ANM2 file to use for the sprite.
+ * @param defaultAnimation Optional. The name of the animation to play after the sprite is
+ *                         initialized and after the player re-enters a room with this grid entity
+ *                         in it. If not specified, the default animation in the anm2 will be used.
  */
 export function spawnCustomGridEntity(
   gridEntityTypeCustom: GridEntityType,
   gridIndexOrPosition: int | Vector,
-  anm2Path: string,
-  defaultAnimation: string,
   gridCollisionClass: GridCollisionClass,
+  anm2Path: string,
+  defaultAnimation?: string,
 ): GridEntity {
   errorIfFeaturesNotInitialized(FEATURE_NAME);
 
@@ -142,7 +196,11 @@ export function spawnCustomGridEntity(
 
   const sprite = decoration.GetSprite();
   sprite.Load(anm2Path, true);
-  sprite.Play(defaultAnimation, true);
+  const animationToPlay =
+    defaultAnimation === undefined
+      ? sprite.GetDefaultAnimation()
+      : defaultAnimation;
+  sprite.Play(animationToPlay, true);
 
   const customGridEntityData: CustomGridEntityData = {
     gridEntityTypeCustom,

package/src/features/customStage/exports.ts

@@ -1,10 +1,8 @@
 import {
-  Direction,
   EntityType,
   GridRoom,
   LevelStage,
   RoomShape,
-  RoomTransitionAnim,
   RoomType,
   StageType,
 } from "isaac-typescript-definitions";
@@ -12,12 +10,10 @@ import { game } from "../../cachedClasses";
 import { reorderedCallbacksSetStage } from "../../callbacks/reorderedCallbacks";
 import { getEntityIDFromConstituents } from "../../functions/entities";
 import { log, logError } from "../../functions/log";
-import { movePlayersToCenter } from "../../functions/playerCenter";
 import { newRNG } from "../../functions/rng";
 import { getRoomData } from "../../functions/roomData";
 import { getRooms } from "../../functions/rooms";
 import { getGotoCommand, setStage } from "../../functions/stage";
-import { runNextRoom } from "../runNextRoom";
 import { getRandomCustomStageRoom } from "./customStageUtils";
 import { topStreakTextStart } from "./streakText";
 import v, {
@@ -136,24 +132,9 @@ export function setCustomStage(name: string, verbose = false): void {
 
   // We must reload the current room in order for the `Level.SetStage` method to take effect.
   // Furthermore, we need to cancel the queued warp to the `GridRoom.DEBUG` room. We can accomplish
-  // both of these things by initiating a room transition to the starting room of the floor. (We
-  // assume that since we just warped to a new floor, we are already in the starting room.)
-  game.StartRoomTransition(
-    startingRoomGridIndex,
-    Direction.NO_DIRECTION,
-    RoomTransitionAnim.FADE,
-  );
-
-  // We do more setup once the room is reloaded from the transition.
-  runNextRoom(postRoomTransition);
-}
-
-function postRoomTransition() {
-  // After the room transition, the players will be placed next to a door, but they should be in the
-  // center of the room to emulate what happens on a vanilla stage.
-  movePlayersToCenter();
-
-  topStreakTextStart();
+  // both of these things by initiating a room transition to an arbitrary room. However, we rely on
+  // the parent function to do this, since for normal purposes, we need to initiate a room
+  // transition for pixelation purposes.
 }
 
 export function setCustomStageDebug(): void {

package/src/features/customStage/init.ts

@@ -1,6 +1,7 @@
 import {
   DoorSlotFlag,
   GridEntityType,
+  LevelCurse,
   ModCallback,
   RoomShape,
   RoomType,
@@ -8,6 +9,7 @@ import {
 import { ModUpgraded } from "../../classes/ModUpgraded";
 import { ModCallbackCustom } from "../../enums/ModCallbackCustom";
 import { isArray } from "../../functions/array";
+import { hasFlag, removeFlag } from "../../functions/flag";
 import { CustomStage, RoomTypeMap } from "../../interfaces/CustomStage";
 import {
   CustomStageLua,
@@ -49,6 +51,7 @@ export function customStageInit(mod: ModUpgraded): void {
   versusScreenInit();
 
   mod.AddCallback(ModCallback.POST_RENDER, postRender); // 2
+  mod.AddCallback(ModCallback.POST_CURSE_EVAL, postCurseEval); // 12
   mod.AddCallback(ModCallback.POST_GAME_STARTED, postGameStarted); // 15
   mod.AddCallback(ModCallback.GET_SHADER_PARAMS, getShaderParams); // 21
   mod.AddCallbackCustom(
@@ -137,6 +140,23 @@ function postRender() {
   versusScreenPostRender();
 }
 
+// ModCallback.POST_CURSE_EVAL (12)
+function postCurseEval(
+  curses: BitFlags<LevelCurse>,
+): BitFlags<LevelCurse> | undefined {
+  const customStage = v.run.currentCustomStage;
+  if (customStage === null) {
+    return undefined;
+  }
+
+  // Prevent XL floors on custom stages, since the streak text will not work properly.
+  if (hasFlag(curses, LevelCurse.MAZE)) {
+    return removeFlag(curses, LevelCurse.MAZE);
+  }
+
+  return undefined;
+}
+
 // ModCallback.POST_GAME_STARTED (15)
 function postGameStarted() {
   // We don't early return here because we need to unconditionally reset the sprites.

package/src/features/customStage/streakText.ts

@@ -287,7 +287,6 @@ function renderSprite(
   const adjustedX = centeredX + adjustment;
   const adjustedY = position.Y + STREAK_TEXT_BOTTOM_Y_OFFSET;
 
-  sprite.RenderLayer(0, position);
   font.DrawStringScaled(
     name,
     adjustedX,

package/src/features/customTrapdoor/blackSprite.ts

@@ -0,0 +1,16 @@
+import { VectorZero } from "../../constants";
+import { StageTravelState } from "../../enums/private/StageTravelState";
+import { ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH } from "../customStage/customStageConstants";
+import v from "./v";
+
+const sprite = Sprite();
+sprite.Load(`${ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH}/black.anm2`, true);
+sprite.SetFrame("Default", 0);
+
+export function drawBlackSprite(): void {
+  if (v.run.state !== StageTravelState.PAUSING_ON_BLACK) {
+    return;
+  }
+
+  sprite.RenderLayer(0, VectorZero);
+}

package/src/features/customTrapdoor/customTrapdoorConstants.ts

@@ -2,12 +2,22 @@ import { GridEntityType } from "isaac-typescript-definitions";
 
 export const CUSTOM_TRAPDOOR_FEATURE_NAME = "customTrapdoor";
 
+export const GridEntityTypeCustom = {
+  TRAPDOOR_CUSTOM: 1000 as GridEntityType,
+} as const;
+
 /** This also applies to crawl spaces. The value was determined through trial and error. */
 export const TRAPDOOR_OPEN_DISTANCE = 60;
 
 export const TRAPDOOR_OPEN_DISTANCE_AFTER_BOSS = TRAPDOOR_OPEN_DISTANCE * 2.5;
 export const TRAPDOOR_BOSS_REACTION_FRAMES = 30;
 
-export const GridEntityTypeCustom = {
-  TRAPDOOR_CUSTOM: 1000 as GridEntityType,
-} as const;
+export const TRAPDOOR_TOUCH_DISTANCE = 16.5;
+
+export const ANIMATIONS_THAT_PREVENT_STAGE_TRAVEL: ReadonlySet<string> =
+  new Set(["Happy", "Sad", "Jump"]);
+
+export const PIXELATION_TO_BLACK_FRAMES = 52;
+
+export const OTHER_PLAYER_TRAPDOOR_JUMP_DELAY_GAME_FRAMES = 10;
+export const OTHER_PLAYER_TRAPDOOR_JUMP_DURATION_GAME_FRAMES = 8;