isaacscript-common 6.21.0 → 6.22.0

package/dist/constants.d.ts

@@ -1,4 +1,10 @@
 import { CollectibleType, ItemPoolType } from "isaac-typescript-definitions";
+/**
+ * The combination of the following flags:
+ * - `DisplayFlag.VISIBLE` (1 << 0)
+ * - `DisplayFlag.SHADOW` (1 << 1)
+ * - `DisplayFlag.SHOW_ICON` (1 << 2)
+ */
 export declare const ALL_DISPLAY_FLAGS: BitFlags<number & {
     readonly __bitFlagBrand: symbol;
 } & {

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EAGf,YAAY,EAEb,MAAM,8BAA8B,CAAC;AAKtC,eAAO,MAAM,iBAAiB;;;;EAI7B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iCAAiC,SAAS,CAAC;AAExD;;;GAGG;AACH,eAAO,MAAM,mBAAmB,4CAA4C,CAAC;AAE7E,mEAAmE;AACnE,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC,oGAAoG;AACpG,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAE3C,eAAO,MAAM,sBAAsB,wBAAwB,CAAC;AAE5D,gGAAgG;AAChG,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC;;;;GAIG;AACH,eAAO,MAAM,gCAAgC,KAAK,CAAC;AAEnD;;;GAGG;AACH,eAAO,MAAM,cAAc,iBAAiB,CAAC;AAE7C;;;;GAIG;AACH,eAAO,MAAM,+BAA+B,iBACrB,CAAC;AAExB,2EAA2E;AAC3E,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC,8EAA8E;AAC9E,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAE3C,eAAO,MAAM,6BAA6B,KAAK,CAAC;AAEhD;;;GAGG;AACH,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAE3C;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,MAAM,CAAC;AAExC;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC,6DAA6D;AAC7D,eAAO,MAAM,cAAc,IAAI,CAAC;AAEhC,iFAAiF;AACjF,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAE9C;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAE7C,eAAO,MAAM,wBAAwB,QAA6B,CAAC;AAEnE,yFAAyF;AACzF,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAE9C,qFAAqF;AACrF,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAEzC;;;GAGG;AACH,eAAO,MAAM,cAAc,IAAM,CAAC;AAElC,yCAAyC;AACzC,eAAO,MAAM,uCAAuC,QAAmB,CAAC;AAExE,iCAAiC;AACjC,eAAO,MAAM,sCAAsC,QAAmB,CAAC;AAEvE;;;GAGG;AACH,eAAO,MAAM,gCAAgC,QAAmB,CAAC;AAEjE,+EAA+E;AAC/E,eAAO,MAAM,iCAAiC,SAAS,CAAC;AAExD,eAAO,MAAM,cAAc,QAA+B,CAAC;AAE3D;;;GAGG;AACH,eAAO,MAAM,iBAAiB,QAAyB,CAAC;AAExD,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAC3C,eAAO,MAAM,sBAAsB,QAA8B,CAAC;AAElE,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAE7C,6FAA6F;AAC7F,eAAO,MAAM,gDAAgD,QAAQ,CAAC;AAEtE;;;GAGG;AACH,eAAO,MAAM,cAAc,KAAK,CAAC;AAEjC;;;GAGG;AACH,eAAO,MAAM,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAgB,CAAC;AAExD;;;GAGG;AACH,eAAO,MAAM,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAgB,CAAC;AAEzD;;;;;GAKG;AACH,eAAO,MAAM,YAAY,EAAE,QAAQ,CAAC,KAAK,CAAkB,CAAC;AAE5D;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAsB,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EAGf,YAAY,EAEb,MAAM,8BAA8B,CAAC;AAKtC;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB;;;;EAI7B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iCAAiC,SAAS,CAAC;AAExD;;;GAGG;AACH,eAAO,MAAM,mBAAmB,4CAA4C,CAAC;AAE7E,mEAAmE;AACnE,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC,oGAAoG;AACpG,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAE3C,eAAO,MAAM,sBAAsB,wBAAwB,CAAC;AAE5D,gGAAgG;AAChG,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC;;;;GAIG;AACH,eAAO,MAAM,gCAAgC,KAAK,CAAC;AAEnD;;;GAGG;AACH,eAAO,MAAM,cAAc,iBAAiB,CAAC;AAE7C;;;;GAIG;AACH,eAAO,MAAM,+BAA+B,iBACrB,CAAC;AAExB,2EAA2E;AAC3E,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC,8EAA8E;AAC9E,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAE3C,eAAO,MAAM,6BAA6B,KAAK,CAAC;AAEhD;;;GAGG;AACH,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAE3C;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,MAAM,CAAC;AAExC;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC,6DAA6D;AAC7D,eAAO,MAAM,cAAc,IAAI,CAAC;AAEhC,iFAAiF;AACjF,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAE9C;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAE7C,eAAO,MAAM,wBAAwB,QAA6B,CAAC;AAEnE,yFAAyF;AACzF,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAE9C,qFAAqF;AACrF,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAEzC;;;GAGG;AACH,eAAO,MAAM,cAAc,IAAM,CAAC;AAElC,yCAAyC;AACzC,eAAO,MAAM,uCAAuC,QAAmB,CAAC;AAExE,iCAAiC;AACjC,eAAO,MAAM,sCAAsC,QAAmB,CAAC;AAEvE;;;GAGG;AACH,eAAO,MAAM,gCAAgC,QAAmB,CAAC;AAEjE,+EAA+E;AAC/E,eAAO,MAAM,iCAAiC,SAAS,CAAC;AAExD,eAAO,MAAM,cAAc,QAA+B,CAAC;AAE3D;;;GAGG;AACH,eAAO,MAAM,iBAAiB,QAAyB,CAAC;AAExD,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAC3C,eAAO,MAAM,sBAAsB,QAA8B,CAAC;AAElE,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAE7C,6FAA6F;AAC7F,eAAO,MAAM,gDAAgD,QAAQ,CAAC;AAEtE;;;GAGG;AACH,eAAO,MAAM,cAAc,KAAK,CAAC;AAEjC;;;GAGG;AACH,eAAO,MAAM,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAgB,CAAC;AAExD;;;GAGG;AACH,eAAO,MAAM,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAgB,CAAC;AAEzD;;;;;GAKG;AACH,eAAO,MAAM,YAAY,EAAE,QAAQ,CAAC,KAAK,CAAkB,CAAC;AAE5D;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAsB,CAAC"}

package/dist/constants.lua

@@ -10,6 +10,10 @@ local ____enums = require("functions.enums")
 local getEnumLength = ____enums.getEnumLength
 local ____flag = require("functions.flag")
 local addFlag = ____flag.addFlag
+--- The combination of the following flags:
+-- - `DisplayFlag.VISIBLE` (1 << 0)
+-- - `DisplayFlag.SHADOW` (1 << 1)
+-- - `DisplayFlag.SHOW_ICON` (1 << 2)
 ____exports.ALL_DISPLAY_FLAGS = addFlag(nil, DisplayFlag.VISIBLE, DisplayFlag.SHADOW, DisplayFlag.SHOW_ICON)
 --- The distance of the laser when Azazel does not have any range up items yet. For more info, see
 -- the documentation for the `getAzazelBrimstoneDistance` function.

package/dist/enums/private/StageTravelState.d.ts

@@ -2,8 +2,9 @@ export declare enum StageTravelState {
     NONE = 0,
     PLAYERS_JUMPING_DOWN = 1,
     PIXELATION_TO_BLACK = 2,
-    PAUSING_ON_BLACK = 3,
-    PIXELATION_TO_ROOM = 4,
-    PLAYERS_LAYING_DOWN = 5
+    WAITING_FOR_FIRST_PIXELATION_TO_END = 3,
+    WAITING_FOR_SECOND_PIXELATION_TO_GET_HALF_WAY = 4,
+    PIXELATION_TO_ROOM = 5,
+    PLAYERS_LAYING_DOWN = 6
 }
 //# sourceMappingURL=StageTravelState.d.ts.map

package/dist/enums/private/StageTravelState.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StageTravelState.d.ts","sourceRoot":"","sources":["../../../src/enums/private/StageTravelState.ts"],"names":[],"mappings":"AAAA,oBAAY,gBAAgB;IAC1B,IAAI,IAAA;IACJ,oBAAoB,IAAA;IACpB,mBAAmB,IAAA;IACnB,gBAAgB,IAAA;IAChB,kBAAkB,IAAA;IAClB,mBAAmB,IAAA;CACpB"}
+{"version":3,"file":"StageTravelState.d.ts","sourceRoot":"","sources":["../../../src/enums/private/StageTravelState.ts"],"names":[],"mappings":"AAAA,oBAAY,gBAAgB;IAC1B,IAAI,IAAA;IACJ,oBAAoB,IAAA;IACpB,mBAAmB,IAAA;IACnB,mCAAmC,IAAA;IACnC,6CAA6C,IAAA;IAC7C,kBAAkB,IAAA;IAClB,mBAAmB,IAAA;CACpB"}

package/dist/enums/private/StageTravelState.lua

@@ -6,10 +6,12 @@ ____exports.StageTravelState.PLAYERS_JUMPING_DOWN = 1
 ____exports.StageTravelState[____exports.StageTravelState.PLAYERS_JUMPING_DOWN] = "PLAYERS_JUMPING_DOWN"
 ____exports.StageTravelState.PIXELATION_TO_BLACK = 2
 ____exports.StageTravelState[____exports.StageTravelState.PIXELATION_TO_BLACK] = "PIXELATION_TO_BLACK"
-____exports.StageTravelState.PAUSING_ON_BLACK = 3
-____exports.StageTravelState[____exports.StageTravelState.PAUSING_ON_BLACK] = "PAUSING_ON_BLACK"
-____exports.StageTravelState.PIXELATION_TO_ROOM = 4
+____exports.StageTravelState.WAITING_FOR_FIRST_PIXELATION_TO_END = 3
+____exports.StageTravelState[____exports.StageTravelState.WAITING_FOR_FIRST_PIXELATION_TO_END] = "WAITING_FOR_FIRST_PIXELATION_TO_END"
+____exports.StageTravelState.WAITING_FOR_SECOND_PIXELATION_TO_GET_HALF_WAY = 4
+____exports.StageTravelState[____exports.StageTravelState.WAITING_FOR_SECOND_PIXELATION_TO_GET_HALF_WAY] = "WAITING_FOR_SECOND_PIXELATION_TO_GET_HALF_WAY"
+____exports.StageTravelState.PIXELATION_TO_ROOM = 5
 ____exports.StageTravelState[____exports.StageTravelState.PIXELATION_TO_ROOM] = "PIXELATION_TO_ROOM"
-____exports.StageTravelState.PLAYERS_LAYING_DOWN = 5
+____exports.StageTravelState.PLAYERS_LAYING_DOWN = 6
 ____exports.StageTravelState[____exports.StageTravelState.PLAYERS_LAYING_DOWN] = "PLAYERS_LAYING_DOWN"
 return ____exports

package/dist/features/customStage/customStageGridEntities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"customStageGridEntities.d.ts","sourceRoot":"","sources":["../../../src/features/customStage/customStageGridEntities.ts"],"names":[],"mappings":";AAgBA,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAI3D,0CAA0C;AAC1C,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,UAAU,GACrB,IAAI,CAyBN;AAED,oCAAoC;AACpC,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,UAAU,GACrB,IAAI,CAqBN;AAED,mCAAmC;AACnC,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,UAAU,GACrB,IAAI,CAkBN;AAED,mCAAmC;AACnC,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,UAAU,GACrB,IAAI,CAmBN;AAuDD,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,UAAU,GACrB,IAAI,CAYN;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,UAAU,GACrB,IAAI,CAsBN"}
+{"version":3,"file":"customStageGridEntities.d.ts","sourceRoot":"","sources":["../../../src/features/customStage/customStageGridEntities.ts"],"names":[],"mappings":";AAkBA,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAM3D,0CAA0C;AAC1C,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,UAAU,GACrB,IAAI,CAyBN;AAED,oCAAoC;AACpC,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,UAAU,GACrB,IAAI,CAqBN;AAED,mCAAmC;AACnC,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,UAAU,GACrB,IAAI,CAkBN;AAED,mCAAmC;AACnC,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,UAAU,GACrB,IAAI,CAmBN;AAuDD,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,UAAU,GACrB,IAAI,CAsBN;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,UAAU,GACrB,IAAI,CAsBN"}

package/dist/features/customStage/customStageGridEntities.lua

@@ -19,10 +19,14 @@ local ____pickupsSpecific = require("functions.pickupsSpecific")
 local getCoins = ____pickupsSpecific.getCoins
 local getCollectibles = ____pickupsSpecific.getCollectibles
 local getTrinkets = ____pickupsSpecific.getTrinkets
+local ____stage = require("functions.stage")
+local calculateStageType = ____stage.calculateStageType
 local ____vector = require("functions.vector")
 local vectorEquals = ____vector.vectorEquals
 local ____exports = require("features.customTrapdoor.exports")
 local spawnCustomTrapdoor = ____exports.spawnCustomTrapdoor
+local ____exports = require("features.customStage.exports")
+local DEFAULT_BASE_STAGE = ____exports.DEFAULT_BASE_STAGE
 local ____v = require("features.customStage.v")
 local v = ____v.default
 function getNewDoorPNGPath(self, customStage, fileName)
@@ -226,7 +230,10 @@ function ____exports.convertVanillaTrapdoors(self, customStage, gridEntity)
         return
     end
     removeGridEntity(nil, gridEntity, true)
-    local destination = v.run.firstFloor and ({customStage.name, 2}) or nil
+    local baseStage = customStage.baseStage == nil and DEFAULT_BASE_STAGE or customStage.baseStage
+    local vanillaNextStage = baseStage + 2
+    local vanillaNextStageType = calculateStageType(nil, vanillaNextStage)
+    local destination = v.run.firstFloor and ({customStage.name, 2}) or ({vanillaNextStage, vanillaNextStageType})
     spawnCustomTrapdoor(nil, gridEntity.Position, destination)
 end
 --- The rewards are based on the ones from the wiki:

package/dist/features/customStage/exports.d.ts

@@ -1,4 +1,7 @@
-import { EntityType } from "isaac-typescript-definitions";
+import { EntityType, LevelStage, StageType } from "isaac-typescript-definitions";
+export declare const DEFAULT_BASE_STAGE = LevelStage.BASEMENT_2;
+export declare const DEFAULT_BASE_STAGE_TYPE = StageType.ORIGINAL;
+export declare const INVALID_STAGE_VALUE: LevelStage;
 /**
  * Helper function to warp to a custom stage/level.
  *
@@ -6,9 +9,11 @@ import { EntityType } from "isaac-typescript-definitions";
  * more details: https://isaacscript.github.io/main/custom-stages/
  *
  * @param name The name of the custom stage, corresponding to what is in the "tsconfig.json" file.
- * @param firstFloor Whether to go to the first floor or the second floor. For example, if you have
- *                   a custom stage emulating Caves, then the first floor would be Caves 1, and the
- *                   second floor would be Caves 2.
+ * @param firstFloor Optional. Whether to go to the first floor or the second floor. For example, if
+ *                   you have a custom stage emulating Caves, then the first floor would be Caves 1,
+ *                   and the second floor would be Caves 2. Default is true.
+ * @param verbose Optional. Whether to log additional information about the rooms that are chosen.
+ *                Default is false.
  */
 export declare function setCustomStage(name: string, firstFloor?: boolean, verbose?: boolean): void;
 /**
@@ -37,4 +42,9 @@ export declare function setCustomStage(name: string, firstFloor?: boolean, verbo
  *                        will be displayed on the right side of the boss "versus" screen.
  */
 export declare function registerCustomBoss(entityType: EntityType, variant: int, subType: int, namePNGPath: string, portraitPNGPath: string): void;
+/**
+ * Helper function to disable the custom stage. This is typically called before taking the player to
+ * a vanilla floor.
+ */
+export declare function disableCustomStage(): void;
 //# sourceMappingURL=exports.d.ts.map

package/dist/features/customStage/exports.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"exports.d.ts","sourceRoot":"","sources":["../../../src/features/customStage/exports.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EAKX,MAAM,8BAA8B,CAAC;AAsBtC;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,UAAU,UAAO,EACjB,OAAO,UAAQ,GACd,IAAI,CA6CN;AA4ED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,GAAG,EACZ,OAAO,EAAE,GAAG,EACZ,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,MAAM,GACtB,IAAI,CAGN"}
+{"version":3,"file":"exports.d.ts","sourceRoot":"","sources":["../../../src/features/customStage/exports.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,UAAU,EAGV,SAAS,EACV,MAAM,8BAA8B,CAAC;AAmBtC,eAAO,MAAM,kBAAkB,wBAAwB,CAAC;AACxD,eAAO,MAAM,uBAAuB,qBAAqB,CAAC;AAE1D,eAAO,MAAM,mBAAmB,YAAmB,CAAC;AAEpD;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,UAAU,UAAO,EACjB,OAAO,UAAQ,GACd,IAAI,CAwDN;AA4ED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,GAAG,EACZ,OAAO,EAAE,GAAG,EACZ,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,MAAM,GACtB,IAAI,CAGN;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC"}

package/dist/features/customStage/exports.lua

@@ -35,10 +35,10 @@ function setStageRoomsData(self, customStage, rng, verbose)
     for ____, room in ipairs(getRoomsInGrid(nil)) do
         do
             if room.SafeGridIndex == startingRoomGridIndex then
-                goto __continue6
+                goto __continue7
             end
             if room.Data == nil then
-                goto __continue6
+                goto __continue7
             end
             local roomType = room.Data.Type
             local roomShapeMap = customStage.roomTypeMap:get(roomType)
@@ -46,19 +46,19 @@ function setStageRoomsData(self, customStage, rng, verbose)
                 if roomType == RoomType.DEFAULT then
                     logError((((("Failed to find any custom rooms for RoomType." .. tostring(RoomType[roomType])) .. " (") .. tostring(roomType)) .. ") for custom stage: ") .. customStage.name)
                 end
-                goto __continue6
+                goto __continue7
             end
             local roomShape = room.Data.Shape
             local roomDoorSlotFlagMap = roomShapeMap:get(roomShape)
             if roomDoorSlotFlagMap == nil then
                 logError((((((((("Failed to find any custom rooms for RoomType." .. tostring(RoomType[roomType])) .. " (") .. tostring(roomType)) .. ") + RoomShape.") .. tostring(RoomShape[roomShape])) .. " (") .. tostring(roomShape)) .. ") for custom stage: ") .. customStage.name)
-                goto __continue6
+                goto __continue7
             end
             local doorSlotFlags = room.Data.Doors
             local roomsMetadata = roomDoorSlotFlagMap:get(doorSlotFlags)
             if roomsMetadata == nil then
                 logError((((((((((("Failed to find any custom rooms for RoomType." .. tostring(RoomType[roomType])) .. " (") .. tostring(roomType)) .. ") + RoomShape.") .. tostring(RoomShape[roomShape])) .. " (") .. tostring(roomShape)) .. ") + DoorSlotFlags ") .. tostring(doorSlotFlags)) .. " for custom stage: ") .. customStage.name)
-                goto __continue6
+                goto __continue7
             end
             local randomRoom = getRandomCustomStageRoom(nil, roomsMetadata, rng, verbose)
             local newRoomData = customStageCachedRoomData:get(randomRoom.variant)
@@ -66,26 +66,29 @@ function setStageRoomsData(self, customStage, rng, verbose)
                 newRoomData = getRoomDataForTypeVariant(nil, roomType, randomRoom.variant, false)
                 if newRoomData == nil then
                     logError((("Failed to get the room data for room variant " .. tostring(randomRoom.variant)) .. " for custom stage: ") .. customStage.name)
-                    goto __continue6
+                    goto __continue7
                 end
                 customStageCachedRoomData:set(randomRoom.variant, newRoomData)
             end
             room.Data = newRoomData
         end
-        ::__continue6::
+        ::__continue7::
     end
 end
-local DEFAULT_BASE_STAGE = LevelStage.BASEMENT_2
-local DEFAULT_BASE_STAGE_TYPE = StageType.ORIGINAL
+____exports.DEFAULT_BASE_STAGE = LevelStage.BASEMENT_2
+____exports.DEFAULT_BASE_STAGE_TYPE = StageType.ORIGINAL
+____exports.INVALID_STAGE_VALUE = -1
 --- Helper function to warp to a custom stage/level.
 -- 
 -- Custom stages/levels must first be defined in the "tsconfig.json" file. See the documentation for
 -- more details: https://isaacscript.github.io/main/custom-stages/
 -- 
 -- @param name The name of the custom stage, corresponding to what is in the "tsconfig.json" file.
--- @param firstFloor Whether to go to the first floor or the second floor. For example, if you have
--- a custom stage emulating Caves, then the first floor would be Caves 1, and the
--- second floor would be Caves 2.
+-- @param firstFloor Optional. Whether to go to the first floor or the second floor. For example, if
+-- you have a custom stage emulating Caves, then the first floor would be Caves 1,
+-- and the second floor would be Caves 2. Default is true.
+-- @param verbose Optional. Whether to log additional information about the rooms that are chosen.
+-- Default is false.
 function ____exports.setCustomStage(self, name, firstFloor, verbose)
     if firstFloor == nil then
         firstFloor = true
@@ -98,22 +101,27 @@ function ____exports.setCustomStage(self, name, firstFloor, verbose)
         error(("Failed to set the custom stage of \"" .. name) .. "\" because it was not found in the custom stages map. (Try restarting IsaacScript / recompiling the mod / restarting the game, and try again. If that does not work, you probably forgot to define it in your \"tsconfig.json\" file.) See the website for more details on how to set up custom stages.")
     end
     local level = game:GetLevel()
+    local stage = level:GetStage()
     local seeds = game:GetSeeds()
     local startSeed = seeds:GetStartSeed()
     local rng = newRNG(nil, startSeed)
     v.run.currentCustomStage = customStage
     v.run.firstFloor = firstFloor
-    local baseStage = customStage.baseStage == nil and DEFAULT_BASE_STAGE or customStage.baseStage
+    if stage == ____exports.INVALID_STAGE_VALUE then
+        level:SetStage(LevelStage.BASEMENT_1, StageType.ORIGINAL)
+    end
+    local baseStage = customStage.baseStage == nil and ____exports.DEFAULT_BASE_STAGE or customStage.baseStage
     if not firstFloor then
         baseStage = baseStage + 1
     end
-    local baseStageType = customStage.baseStageType == nil and DEFAULT_BASE_STAGE_TYPE or customStage.baseStageType
-    setStage(nil, baseStage, baseStageType)
+    local baseStageType = customStage.baseStageType == nil and ____exports.DEFAULT_BASE_STAGE_TYPE or customStage.baseStageType
+    local reseed = stage >= baseStage
+    setStage(nil, baseStage, baseStageType, reseed)
     setStageRoomsData(nil, customStage, rng, verbose)
-    local stage = -1
-    local stageType = StageType.WRATH_OF_THE_LAMB
-    level:SetStage(stage, stageType)
-    reorderedCallbacksSetStage(nil, stage, stageType)
+    local targetStage = ____exports.INVALID_STAGE_VALUE
+    local targetStageType = StageType.WRATH_OF_THE_LAMB
+    level:SetStage(targetStage, targetStageType)
+    reorderedCallbacksSetStage(nil, targetStage, targetStageType)
 end
 --- By default, unknown bosses will be drawn on the boss "versus" screen as "???". If your custom
 -- stage has custom bosses, you can use this function to register the corresponding graphic file
@@ -142,4 +150,9 @@ function ____exports.registerCustomBoss(self, entityType, variant, subType, name
     local entityID = getEntityIDFromConstituents(nil, entityType, variant, subType)
     customBossPNGPaths:set(entityID, {namePNGPath, portraitPNGPath})
 end
+--- Helper function to disable the custom stage. This is typically called before taking the player to
+-- a vanilla floor.
+function ____exports.disableCustomStage(self)
+    v.run.currentCustomStage = nil
+end
 return ____exports

package/dist/features/customStage/streakText.lua

@@ -133,7 +133,7 @@ local EMPTY_SHADER_NAME = "IsaacScript-RenderAboveHUD"
 TEXT_STAY_FRAME = 8
 TEXT_OUT_FRAME = 60
 --- This matches the offset that the vanilla game uses; determined via trial and error.
-local STREAK_SPRITE_TOP_OFFSET = Vector(0, 48.25)
+local STREAK_SPRITE_TOP_OFFSET = Vector(0, 47)
 --- This matches the offset that the vanilla game uses; determined via trial and error.
 local STREAK_SPRITE_BOTTOM_OFFSET = Vector(0, -48.25)
 STREAK_TEXT_BOTTOM_Y_OFFSET = -9

package/dist/features/customStage/versusScreen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"versusScreen.d.ts","sourceRoot":"","sources":["../../../src/features/customStage/versusScreen.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAqE3D;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAavC;AAED,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI,CAuDxE;AA+ED,wBAAgB,sBAAsB,IAAI,IAAI,CAoC7C"}
+{"version":3,"file":"versusScreen.d.ts","sourceRoot":"","sources":["../../../src/features/customStage/versusScreen.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AA2E3D;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAavC;AAED,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI,CAwExE;AAoFD,wBAAgB,sBAAsB,IAAI,IAAI,CAoC7C"}

package/dist/features/customStage/versusScreen.lua

@@ -1,13 +1,15 @@
 local ____lualib = require("lualib_bundle")
 local Map = ____lualib.Map
+local __TS__ArraySome = ____lualib.__TS__ArraySome
 local ____exports = {}
-local getPlayerPNGPaths, getBossPNGPaths, DEFAULT_CHARACTER, PNG_PATH_PREFIX, PLAYER_PORTRAIT_PNG_PATH_PREFIX
+local willVanillaVersusScreenPlay, getPlayerPNGPaths, getBossPNGPaths, DEFAULT_CHARACTER, PNG_PATH_PREFIX, PLAYER_PORTRAIT_PNG_PATH_PREFIX
 local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
 local BossID = ____isaac_2Dtypescript_2Ddefinitions.BossID
 local PlayerType = ____isaac_2Dtypescript_2Ddefinitions.PlayerType
 local RoomType = ____isaac_2Dtypescript_2Ddefinitions.RoomType
 local SoundEffect = ____isaac_2Dtypescript_2Ddefinitions.SoundEffect
 local StageID = ____isaac_2Dtypescript_2Ddefinitions.StageID
+local StageType = ____isaac_2Dtypescript_2Ddefinitions.StageType
 local ____cachedClasses = require("cachedClasses")
 local game = ____cachedClasses.game
 local sfxManager = ____cachedClasses.sfxManager
@@ -34,11 +36,24 @@ local VERSUS_SCREEN_DIRT_SPOT_COLORS = ____versusScreenDirtSpotColors.VERSUS_SCR
 local ____pause = require("features.pause")
 local pause = ____pause.pause
 local unpause = ____pause.unpause
+local ____runInNFrames = require("features.runInNFrames")
+local runNextGameFrame = ____runInNFrames.runNextGameFrame
 local ____customStageConstants = require("features.customStage.customStageConstants")
 local ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH = ____customStageConstants.ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH
+local ____exports = require("features.customStage.exports")
+local DEFAULT_BASE_STAGE = ____exports.DEFAULT_BASE_STAGE
+local DEFAULT_BASE_STAGE_TYPE = ____exports.DEFAULT_BASE_STAGE_TYPE
+local INVALID_STAGE_VALUE = ____exports.INVALID_STAGE_VALUE
 local ____v = require("features.customStage.v")
 local v = ____v.default
 local customBossPNGPaths = ____v.customBossPNGPaths
+function willVanillaVersusScreenPlay(self)
+    local bosses = getBosses(nil)
+    return __TS__ArraySome(
+        bosses,
+        function(____, boss) return boss:GetBossID() ~= 0 end
+    )
+end
 function getPlayerPNGPaths(self)
     local player = Isaac.GetPlayer()
     local character = player:GetPlayerType()
@@ -126,10 +141,26 @@ end
 function ____exports.playVersusScreenAnimation(self, customStage)
     local room = game:GetRoom()
     local roomType = room:GetType()
+    local roomCleared = room:IsClear()
     local hud = game:GetHUD()
     if roomType ~= RoomType.BOSS then
         return
     end
+    if roomCleared then
+        return
+    end
+    if willVanillaVersusScreenPlay(nil) then
+        local level = game:GetLevel()
+        level:SetStage(DEFAULT_BASE_STAGE, DEFAULT_BASE_STAGE_TYPE)
+        runNextGameFrame(
+            nil,
+            function()
+                local futureLevel = game:GetLevel()
+                futureLevel:SetStage(INVALID_STAGE_VALUE, StageType.ORIGINAL)
+            end
+        )
+        return
+    end
     v.run.showingBossVersusScreen = true
     pause(nil)
     hud:SetVisible(false)

package/dist/features/customTrapdoor/blackSprite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"blackSprite.d.ts","sourceRoot":"","sources":["../../../src/features/customTrapdoor/blackSprite.ts"],"names":[],"mappings":"AAUA,wBAAgB,eAAe,IAAI,IAAI,CAYtC"}
+{"version":3,"file":"blackSprite.d.ts","sourceRoot":"","sources":["../../../src/features/customTrapdoor/blackSprite.ts"],"names":[],"mappings":"AAUA,wBAAgB,eAAe,IAAI,IAAI,CAgBtC"}

package/dist/features/customTrapdoor/blackSprite.lua

@@ -7,7 +7,7 @@ local ____v = require("features.customTrapdoor.v")
 local v = ____v.default
 local blackSprite = Sprite()
 function ____exports.drawBlackSprite(self)
-    if v.run.state ~= StageTravelState.PAUSING_ON_BLACK then
+    if v.run.state ~= StageTravelState.WAITING_FOR_FIRST_PIXELATION_TO_END and v.run.state ~= StageTravelState.WAITING_FOR_SECOND_PIXELATION_TO_GET_HALF_WAY then
         return
     end
     if not blackSprite:IsLoaded() then

package/dist/features/customTrapdoor/customTrapdoorConstants.d.ts

@@ -1,6 +1,10 @@
 import { GridEntityType } from "isaac-typescript-definitions";
 export declare const CUSTOM_TRAPDOOR_FEATURE_NAME = "customTrapdoor";
 export declare const GridEntityTypeCustom: {
+    /**
+     * We arbitrarily choose 1000 as to not conflict with end-user mods. (The expectation is that
+     * end-user mods will begin their enums with values of 1 and increment upwards.)
+     */
     readonly TRAPDOOR_CUSTOM: GridEntityType;
 };
 /** This also applies to crawl spaces. The value was determined through trial and error. */

package/dist/features/customTrapdoor/customTrapdoorConstants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"customTrapdoorConstants.d.ts","sourceRoot":"","sources":["../../../src/features/customTrapdoor/customTrapdoorConstants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE9D,eAAO,MAAM,4BAA4B,mBAAmB,CAAC;AAE7D,eAAO,MAAM,oBAAoB;;CAEvB,CAAC;AAEX,2FAA2F;AAC3F,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC,eAAO,MAAM,iCAAiC,QAA+B,CAAC;AAC9E,eAAO,MAAM,6BAA6B,KAAK,CAAC;AAEhD,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAE5C,eAAO,MAAM,oCAAoC,EAAE,WAAW,CAAC,MAAM,CAClC,CAAC;AAEpC,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAE7C,eAAO,MAAM,4CAA4C,IAAI,CAAC;AAC9D,eAAO,MAAM,+CAA+C,IAAI,CAAC"}
+{"version":3,"file":"customTrapdoorConstants.d.ts","sourceRoot":"","sources":["../../../src/features/customTrapdoor/customTrapdoorConstants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE9D,eAAO,MAAM,4BAA4B,mBAAmB,CAAC;AAE7D,eAAO,MAAM,oBAAoB;IAC/B;;;OAGG;;CAEK,CAAC;AAEX,2FAA2F;AAC3F,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC,eAAO,MAAM,iCAAiC,QAA+B,CAAC;AAC9E,eAAO,MAAM,6BAA6B,KAAK,CAAC;AAEhD,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAE5C,eAAO,MAAM,oCAAoC,EAAE,WAAW,CAAC,MAAM,CAClC,CAAC;AAEpC,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAE7C,eAAO,MAAM,4CAA4C,IAAI,CAAC;AAC9D,eAAO,MAAM,+CAA+C,IAAI,CAAC"}

package/dist/features/customTrapdoor/exports.d.ts

@@ -1,4 +1,7 @@
-import { LevelStage, StageType } from "isaac-typescript-definitions";
+/// <reference types="isaac-typescript-definitions" />
+/// <reference types="isaac-typescript-definitions" />
+/// <reference types="isaac-typescript-definitions" />
+import { TrapdoorDestination } from "../../types/TrapdoorDestination";
 /**
  * Helper function to spawn a trapdoor grid entity that will have one or more of the following
  * attributes:
@@ -14,17 +17,17 @@ import { LevelStage, StageType } from "isaac-typescript-definitions";
  *
  * @param gridIndexOrPosition The location in the room to spawn the trapdoor.
  * @param destination Optional. Used to specify where the player will go after jumping into the
- *                    trapdoor. Can either be a tuple or undefined. For example, a destination of
- *                    `[LevelStage.CAVES_1, StageType.ORIGINAL]` corresponds to Caves 1, and a
- *                    destination of `["Slaughterhouse", 1]` corresponds to a custom stage of
- *                    Slaughterhouse 1. If the destination is set to undefined, then the "normal"
- *                    destination corresponding to the current stage and room will be used (e.g. the
- *                    next floor).
+ *                    trapdoor. Can either be a vanilla stage tuple, a custom stage tuple, or
+ *                    undefined. For example, a destination of `[LevelStage.CAVES_1,
+ *                    StageType.ORIGINAL]` corresponds to Caves 1, and a destination of
+ *                    `["Slaughterhouse", 1]` corresponds to a custom stage of Slaughterhouse 1. If
+ *                    the destination is undefined, then the "normal" destination corresponding to
+ *                    the current stage and room will be used (e.g. the next floor, in most cases).
  * @param anm2Path Optional. The path to the anm2 file to use. By default, the vanilla trapdoor anm2
  *                 of "gfx/grid/door_11_trapdoor.anm2" will be used. The specified anm2 file must
  *                 have animations called "Opened", "Closed", and "Open Animation".
  * @param spawnOpen Optional. Whether or not to spawn the trapdoor in an open state. By default,
  *                  behavior will be used that emulates a vanilla trapdoor.
  */
-export declare function spawnCustomTrapdoor(gridIndexOrPosition: int | Vector, destination?: [stage: LevelStage, stageType: StageType] | [customStageName: string, floorNum: int], anm2Path?: string, spawnOpen?: boolean): GridEntity;
+export declare function spawnCustomTrapdoor(gridIndexOrPosition: int | Vector, destination?: TrapdoorDestination, anm2Path?: string, spawnOpen?: boolean): GridEntity;
 //# sourceMappingURL=exports.d.ts.map

package/dist/features/customTrapdoor/exports.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"exports.d.ts","sourceRoot":"","sources":["../../../src/features/customTrapdoor/exports.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,UAAU,EACV,SAAS,EACV,MAAM,8BAA8B,CAAC;AAgBtC;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,mBAAmB,CACjC,mBAAmB,EAAE,GAAG,GAAG,MAAM,EACjC,WAAW,CAAC,EACR,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,CAAC,GACzC,CAAC,eAAe,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,EAC5C,QAAQ,SAAmC,EAC3C,SAAS,CAAC,EAAE,OAAO,GAClB,UAAU,CAwCZ"}
+{"version":3,"file":"exports.d.ts","sourceRoot":"","sources":["../../../src/features/customTrapdoor/exports.ts"],"names":[],"mappings":";;;AAYA,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAStE;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,mBAAmB,CACjC,mBAAmB,EAAE,GAAG,GAAG,MAAM,EACjC,WAAW,CAAC,EAAE,mBAAmB,EACjC,QAAQ,SAAmC,EAC3C,SAAS,CAAC,EAAE,OAAO,GAClB,UAAU,CAwCZ"}

package/dist/features/customTrapdoor/exports.lua

@@ -45,12 +45,12 @@ end
 -- 
 -- @param gridIndexOrPosition The location in the room to spawn the trapdoor.
 -- @param destination Optional. Used to specify where the player will go after jumping into the
--- trapdoor. Can either be a tuple or undefined. For example, a destination of
--- `[LevelStage.CAVES_1, StageType.ORIGINAL]` corresponds to Caves 1, and a
--- destination of `["Slaughterhouse", 1]` corresponds to a custom stage of
--- Slaughterhouse 1. If the destination is set to undefined, then the "normal"
--- destination corresponding to the current stage and room will be used (e.g. the
--- next floor).
+-- trapdoor. Can either be a vanilla stage tuple, a custom stage tuple, or
+-- undefined. For example, a destination of `[LevelStage.CAVES_1,
+-- StageType.ORIGINAL]` corresponds to Caves 1, and a destination of
+-- `["Slaughterhouse", 1]` corresponds to a custom stage of Slaughterhouse 1. If
+-- the destination is undefined, then the "normal" destination corresponding to
+-- the current stage and room will be used (e.g. the next floor, in most cases).
 -- @param anm2Path Optional. The path to the anm2 file to use. By default, the vanilla trapdoor anm2
 -- of "gfx/grid/door_11_trapdoor.anm2" will be used. The specified anm2 file must
 -- have animations called "Opened", "Closed", and "Open Animation".

package/dist/features/customTrapdoor/init.lua

@@ -2,7 +2,7 @@ local ____lualib = require("lualib_bundle")
 local __TS__ArraySome = ____lualib.__TS__ArraySome
 local Map = ____lualib.Map
 local ____exports = {}
-local postRender, checkAllPlayersJumpComplete, checkPixelationToBlackComplete, checkPausingOnBlackComplete, checkAllPlayersLayingDownComplete, goToCustomDestination, anyPlayerPlayingExtraAnimation, postPEffectUpdate, checkJumpComplete, postGridEntityCustomUpdateTrapdoor
+local postRender, checkAllPlayersJumpComplete, checkPixelationToBlackComplete, checkSecondPixelationHalfWay, checkAllPlayersLayingDownComplete, goToCustomDestination, anyPlayerPlayingExtraAnimation, postPEffectUpdate, checkJumpComplete, postGridEntityCustomUpdateTrapdoor
 local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
 local Direction = ____isaac_2Dtypescript_2Ddefinitions.Direction
 local EntityCollisionClass = ____isaac_2Dtypescript_2Ddefinitions.EntityCollisionClass
@@ -29,6 +29,7 @@ local setStage = ____stage.setStage
 local ____types = require("functions.types")
 local isString = ____types.isString
 local ____exports = require("features.customStage.exports")
+local disableCustomStage = ____exports.disableCustomStage
 local setCustomStage = ____exports.setCustomStage
 local ____streakText = require("features.customStage.streakText")
 local topStreakTextStart = ____streakText.topStreakTextStart
@@ -55,7 +56,7 @@ local v = ____v.default
 function postRender(self)
     checkAllPlayersJumpComplete(nil)
     checkPixelationToBlackComplete(nil)
-    checkPausingOnBlackComplete(nil)
+    checkSecondPixelationHalfWay(nil)
     checkAllPlayersLayingDownComplete(nil)
     drawBlackSprite(nil)
 end
@@ -78,25 +79,33 @@ function checkPixelationToBlackComplete(self)
     end
     local hud = game:GetHUD()
     local renderFrameCount = Isaac.GetFrameCount()
-    local roomGridIndex = getRoomGridIndex(nil)
     local renderFrameScreenBlack = v.run.stateRenderFrame + PIXELATION_TO_BLACK_FRAMES
     if renderFrameCount < renderFrameScreenBlack then
         return
     end
-    v.run.state = StageTravelState.PAUSING_ON_BLACK
-    v.run.stateRenderFrame = renderFrameCount
+    v.run.state = StageTravelState.WAITING_FOR_FIRST_PIXELATION_TO_END
     hud:SetVisible(false)
-    goToCustomDestination(nil)
-    teleport(
+    runNextGameFrame(
         nil,
-        roomGridIndex,
-        Direction.NO_DIRECTION,
-        RoomTransitionAnim.PIXELATION,
-        true
+        function()
+            local level = game:GetLevel()
+            local startingRoomIndex = level:GetStartingRoomIndex()
+            local futureRenderFrameCount = Isaac.GetFrameCount()
+            v.run.state = StageTravelState.WAITING_FOR_SECOND_PIXELATION_TO_GET_HALF_WAY
+            v.run.stateRenderFrame = futureRenderFrameCount
+            goToCustomDestination(nil)
+            teleport(
+                nil,
+                startingRoomIndex,
+                Direction.NO_DIRECTION,
+                RoomTransitionAnim.PIXELATION,
+                true
+            )
+        end
     )
 end
-function checkPausingOnBlackComplete(self)
-    if v.run.state ~= StageTravelState.PAUSING_ON_BLACK or v.run.stateRenderFrame == nil then
+function checkSecondPixelationHalfWay(self)
+    if v.run.state ~= StageTravelState.WAITING_FOR_SECOND_PIXELATION_TO_GET_HALF_WAY or v.run.stateRenderFrame == nil then
         return
     end
     local hud = game:GetHUD()
@@ -110,8 +119,8 @@ function checkPausingOnBlackComplete(self)
     runNextRoom(
         nil,
         function()
-            movePlayersToCenter(nil)
             v.run.state = StageTravelState.PLAYERS_LAYING_DOWN
+            movePlayersToCenter(nil)
             for ____, player in ipairs(getAllPlayers(nil)) do
                 player:AnimateAppear()
                 player.EntityCollisionClass = EntityCollisionClass.ALL
@@ -145,6 +154,7 @@ function goToCustomDestination(self)
         local firstFloor = arg2 == 1
         setCustomStage(nil, "Slaughterhouse", firstFloor)
     else
+        disableCustomStage(nil)
         setStage(nil, arg1, arg2)
     end
 end

package/dist/features/customTrapdoor/touched.lua

@@ -73,6 +73,7 @@ function setPlayerAttributes(self, trapdoorPlayer, position)
         player.Velocity = VectorZero
         player.EntityCollisionClass = EntityCollisionClass.NONE
         player.GridCollisionClass = EntityGridCollisionClass.NONE
+        player:StopExtraAnimation()
     end
 end
 function dropTaintedForgotten(self, player)

package/dist/features/customTrapdoor/v.d.ts

@@ -1,13 +1,13 @@
-import { LevelStage, StageType } from "isaac-typescript-definitions";
 import { DefaultMap } from "../../classes/DefaultMap";
 import { StageTravelState } from "../../enums/private/StageTravelState";
 import { CustomTrapdoorDescription } from "../../interfaces/private/CustomTrapdoorDescription";
+import { TrapdoorDestination } from "../../types/TrapdoorDestination";
 declare const v: {
     run: {
         state: StageTravelState;
         /** The render frame that this state was reached. */
         stateRenderFrame: number | null;
-        destination: [stage: LevelStage, stageType: StageType] | [customStageName: string, floorNum: number] | null;
+        destination: TrapdoorDestination | null;
     };
     level: {
         /** Indexed by room list index and grid index. */

package/dist/features/customTrapdoor/v.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"v.d.ts","sourceRoot":"","sources":["../../../src/features/customTrapdoor/v.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AACxE,OAAO,EAAE,yBAAyB,EAAE,MAAM,oDAAoD,CAAC;AAE/F,QAAA,MAAM,CAAC;;;QAIH,oDAAoD;;;;;QAUpD,iDAAiD;;;CAKpD,CAAC;AACF,eAAe,CAAC,CAAC"}
+{"version":3,"file":"v.d.ts","sourceRoot":"","sources":["../../../src/features/customTrapdoor/v.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AACxE,OAAO,EAAE,yBAAyB,EAAE,MAAM,oDAAoD,CAAC;AAC/F,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAEtE,QAAA,MAAM,CAAC;;;QAIH,oDAAoD;;;;;QAOpD,iDAAiD;;;CAKpD,CAAC;AACF,eAAe,CAAC,CAAC"}

package/dist/features/playerInventory.d.ts

@@ -10,6 +10,13 @@ import { CollectibleType } from "isaac-typescript-definitions";
  * middle of the run (e.g. with D4), the order of the inventory will not correspond to the order
  * that the items were actually given to the player. In this case, the inventory will be in the
  * order of the lowest `CollectibleType` to the highest.
+ *
+ * Under the hood, the inventory tracking works by tracking the number of collectibles that a player
+ * has on every frame. Thus, in a situation where a collectible was both added and removed to the
+ * player on the same frame, the amount of total collectibles would stay the same, and the inventory
+ * would not be updated. In vanilla, this situation would never happen, but another mod might do
+ * this for some reason. (With that said, the next time that a collectible is normally added or
+ * removed, it would trigger a re-scan, and the previous changes would be picked up.)
  */
 export declare function getPlayerInventory(player: EntityPlayer, includeActiveCollectibles?: boolean): CollectibleType[];
 //# sourceMappingURL=playerInventory.d.ts.map

package/dist/features/playerInventory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"playerInventory.d.ts","sourceRoot":"","sources":["../../src/features/playerInventory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAe,MAAM,8BAA8B,CAAC;AAyG5E;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,YAAY,EACpB,yBAAyB,UAAO,GAC/B,eAAe,EAAE,CAanB"}
+{"version":3,"file":"playerInventory.d.ts","sourceRoot":"","sources":["../../src/features/playerInventory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAe,MAAM,8BAA8B,CAAC;AAyG5E;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,YAAY,EACpB,yBAAyB,UAAO,GAC/B,eAAe,EAAE,CAanB"}

package/dist/features/playerInventory.lua

@@ -91,6 +91,13 @@ end
 -- middle of the run (e.g. with D4), the order of the inventory will not correspond to the order
 -- that the items were actually given to the player. In this case, the inventory will be in the
 -- order of the lowest `CollectibleType` to the highest.
+-- 
+-- Under the hood, the inventory tracking works by tracking the number of collectibles that a player
+-- has on every frame. Thus, in a situation where a collectible was both added and removed to the
+-- player on the same frame, the amount of total collectibles would stay the same, and the inventory
+-- would not be updated. In vanilla, this situation would never happen, but another mod might do
+-- this for some reason. (With that said, the next time that a collectible is normally added or
+-- removed, it would trigger a re-scan, and the previous changes would be picked up.)
 function ____exports.getPlayerInventory(self, player, includeActiveCollectibles)
     if includeActiveCollectibles == nil then
         includeActiveCollectibles = true

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

@@ -1,7 +1,7 @@
-import { LevelStage, StageType } from "isaac-typescript-definitions";
+import { TrapdoorDestination } from "../../types/TrapdoorDestination";
 export interface CustomTrapdoorDescription {
     open: boolean;
-    destination: [stage: LevelStage, stageType: StageType] | [customStageName: string, floorNum: int];
+    destination: TrapdoorDestination;
     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,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAErE,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,OAAO,CAAC;IACd,WAAW,EACP,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,CAAC,GACzC,CAAC,eAAe,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;IAC7C,UAAU,EAAE,OAAO,CAAC;CACrB"}
+{"version":3,"file":"CustomTrapdoorDescription.d.ts","sourceRoot":"","sources":["../../../src/interfaces/private/CustomTrapdoorDescription.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAEtE,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,OAAO,CAAC;IACd,WAAW,EAAE,mBAAmB,CAAC;IACjC,UAAU,EAAE,OAAO,CAAC;CACrB"}

package/dist/types/TrapdoorDestination.d.ts

@@ -0,0 +1,3 @@
+import { LevelStage, StageType } from "isaac-typescript-definitions";
+export declare type TrapdoorDestination = [stage: LevelStage, stageType: StageType] | [customStageName: string, floorNum: int];
+//# sourceMappingURL=TrapdoorDestination.d.ts.map

package/dist/types/TrapdoorDestination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TrapdoorDestination.d.ts","sourceRoot":"","sources":["../../src/types/TrapdoorDestination.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAErE,oBAAY,mBAAmB,GAC3B,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,CAAC,GACzC,CAAC,eAAe,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC"}

package/dist/types/TrapdoorDestination.lua

@@ -0,0 +1,2 @@
+local ____exports = {}
+return ____exports

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacscript-common",
-  "version": "6.21.0",
+  "version": "6.22.0",
   "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.1.3"
+    "isaac-typescript-definitions": "^3.1.4"
   }
 }

package/src/constants.ts

@@ -9,6 +9,12 @@ import { NUM_NORMAL_PILL_COLORS } from "./constantsFirstLast";
 import { getEnumLength } from "./functions/enums";
 import { addFlag } from "./functions/flag";
 
+/**
+ * The combination of the following flags:
+ * - `DisplayFlag.VISIBLE` (1 << 0)
+ * - `DisplayFlag.SHADOW` (1 << 1)
+ * - `DisplayFlag.SHOW_ICON` (1 << 2)
+ */
 export const ALL_DISPLAY_FLAGS = addFlag(
   DisplayFlag.VISIBLE,
   DisplayFlag.SHADOW,

package/src/enums/private/StageTravelState.ts

@@ -2,7 +2,8 @@ export enum StageTravelState {
   NONE,
   PLAYERS_JUMPING_DOWN,
   PIXELATION_TO_BLACK,
-  PAUSING_ON_BLACK,
+  WAITING_FOR_FIRST_PIXELATION_TO_END,
+  WAITING_FOR_SECOND_PIXELATION_TO_GET_HALF_WAY,
   PIXELATION_TO_ROOM,
   PLAYERS_LAYING_DOWN,
 }

package/src/features/customStage/customStageGridEntities.ts

@@ -2,6 +2,7 @@ import {
   CollectibleType,
   EntityType,
   GridEntityType,
+  LevelStage,
   TrinketType,
 } from "isaac-typescript-definitions";
 import { DecorationVariant } from "../../enums/DecorationVariant";
@@ -13,9 +14,12 @@ import {
   getCollectibles,
   getTrinkets,
 } from "../../functions/pickupsSpecific";
+import { calculateStageType } from "../../functions/stage";
 import { vectorEquals } from "../../functions/vector";
 import { CustomStage } from "../../interfaces/CustomStage";
+import { TrapdoorDestination } from "../../types/TrapdoorDestination";
 import { spawnCustomTrapdoor } from "../customTrapdoor/exports";
+import { DEFAULT_BASE_STAGE } from "./exports";
 import v from "./v";
 
 /** For `GridEntityType.DECORATION` (1) */
@@ -189,9 +193,19 @@ export function convertVanillaTrapdoors(
 
   removeGridEntity(gridEntity, true);
 
-  const destination: [string, int] | undefined = v.run.firstFloor
+  // - If we are on the first floor of a custom stage, then the destination will be the second floor
+  //   of the custom stage. (e.g. Caves 1 to Caves 2)
+  // - If we are on the second floor of a custom stage, then the destination will be the vanilla
+  //   floor equivalent to 2 floors after the floor used as a basis for the custom stage.
+  const baseStage =
+    customStage.baseStage === undefined
+      ? DEFAULT_BASE_STAGE
+      : customStage.baseStage;
+  const vanillaNextStage = (baseStage + 2) as LevelStage;
+  const vanillaNextStageType = calculateStageType(vanillaNextStage);
+  const destination: TrapdoorDestination = v.run.firstFloor
     ? [customStage.name, 2]
-    : undefined;
+    : [vanillaNextStage, vanillaNextStageType];
   spawnCustomTrapdoor(gridEntity.Position, destination);
 }
 

package/src/features/customStage/exports.ts

@@ -23,8 +23,10 @@ import v, {
   customStagesMap,
 } from "./v";
 
-const DEFAULT_BASE_STAGE = LevelStage.BASEMENT_2;
-const DEFAULT_BASE_STAGE_TYPE = StageType.ORIGINAL;
+export const DEFAULT_BASE_STAGE = LevelStage.BASEMENT_2;
+export const DEFAULT_BASE_STAGE_TYPE = StageType.ORIGINAL;
+
+export const INVALID_STAGE_VALUE = -1 as LevelStage;
 
 /**
  * Helper function to warp to a custom stage/level.
@@ -33,9 +35,11 @@ const DEFAULT_BASE_STAGE_TYPE = StageType.ORIGINAL;
  * more details: https://isaacscript.github.io/main/custom-stages/
  *
  * @param name The name of the custom stage, corresponding to what is in the "tsconfig.json" file.
- * @param firstFloor Whether to go to the first floor or the second floor. For example, if you have
- *                   a custom stage emulating Caves, then the first floor would be Caves 1, and the
- *                   second floor would be Caves 2.
+ * @param firstFloor Optional. Whether to go to the first floor or the second floor. For example, if
+ *                   you have a custom stage emulating Caves, then the first floor would be Caves 1,
+ *                   and the second floor would be Caves 2. Default is true.
+ * @param verbose Optional. Whether to log additional information about the rooms that are chosen.
+ *                Default is false.
  */
 export function setCustomStage(
   name: string,
@@ -50,6 +54,7 @@ export function setCustomStage(
   }
 
   const level = game.GetLevel();
+  const stage = level.GetStage();
   const seeds = game.GetSeeds();
   const startSeed = seeds.GetStartSeed();
   const rng = newRNG(startSeed);
@@ -57,6 +62,12 @@ export function setCustomStage(
   v.run.currentCustomStage = customStage;
   v.run.firstFloor = firstFloor;
 
+  // Before changing the stage, we have to revert the bugged stage, if necessary. This prevents the
+  // bug where the backdrop will not spawn.
+  if (stage === INVALID_STAGE_VALUE) {
+    level.SetStage(LevelStage.BASEMENT_1, StageType.ORIGINAL);
+  }
+
   let baseStage: int =
     customStage.baseStage === undefined
       ? DEFAULT_BASE_STAGE
@@ -64,22 +75,26 @@ export function setCustomStage(
   if (!firstFloor) {
     baseStage++;
   }
+
   const baseStageType =
     customStage.baseStageType === undefined
       ? DEFAULT_BASE_STAGE_TYPE
       : (customStage.baseStageType as StageType);
-  setStage(baseStage as LevelStage, baseStageType);
+
+  const reseed = (stage as int) >= baseStage;
+
+  setStage(baseStage as LevelStage, baseStageType, reseed);
 
   setStageRoomsData(customStage, rng, verbose);
 
-  // Set the stage to an invalid value, which will prevent the walls and floors from loading. We
-  // must use `StageType.WRATH_OF_THE_LAMB` instead of `StageType.ORIGINAL` or else the walls will
-  // not render properly. DeadInfinity suspects that this might be because it is trying to use the
-  // Dark Room's backdrop (instead of The Chest).
-  const stage = -1 as LevelStage;
-  const stageType = StageType.WRATH_OF_THE_LAMB;
-  level.SetStage(stage, stageType);
-  reorderedCallbacksSetStage(stage, stageType);
+  // Set the stage to an invalid value, which will prevent the walls and floors from loading.
+  // Furthermore, we must use `StageType.WRATH_OF_THE_LAMB` instead of `StageType.ORIGINAL` or else
+  // the walls will not render properly. DeadInfinity suspects that this might be because it is
+  // trying to use the Dark Room's backdrop (instead of The Chest).
+  const targetStage = INVALID_STAGE_VALUE;
+  const targetStageType = StageType.WRATH_OF_THE_LAMB;
+  level.SetStage(targetStage, targetStageType);
+  reorderedCallbacksSetStage(targetStage, targetStageType);
 
   // 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
@@ -197,3 +212,11 @@ export function registerCustomBoss(
   const entityID = getEntityIDFromConstituents(entityType, variant, subType);
   customBossPNGPaths.set(entityID, [namePNGPath, portraitPNGPath]);
 }
+
+/**
+ * Helper function to disable the custom stage. This is typically called before taking the player to
+ * a vanilla floor.
+ */
+export function disableCustomStage(): void {
+  v.run.currentCustomStage = null;
+}

package/src/features/customStage/streakText.ts

@@ -26,7 +26,7 @@ const TEXT_STAY_FRAME = 8;
 const TEXT_OUT_FRAME = 60;
 
 /** This matches the offset that the vanilla game uses; determined via trial and error. */
-const STREAK_SPRITE_TOP_OFFSET = Vector(0, 48.25);
+const STREAK_SPRITE_TOP_OFFSET = Vector(0, 47);
 
 /** This matches the offset that the vanilla game uses; determined via trial and error. */
 const STREAK_SPRITE_BOTTOM_OFFSET = Vector(0, -48.25);

package/src/features/customStage/versusScreen.ts

@@ -4,6 +4,7 @@ import {
   RoomType,
   SoundEffect,
   StageID,
+  StageType,
 } from "isaac-typescript-definitions";
 import { game, sfxManager } from "../../cachedClasses";
 import { arrayRemove } from "../../functions/array";
@@ -18,7 +19,13 @@ import { PLAYER_PORTRAIT_PNG_FILE_NAMES } from "../../objects/playerPortraitPNGF
 import { VERSUS_SCREEN_BACKGROUND_COLORS } from "../../objects/versusScreenBackgroundColors";
 import { VERSUS_SCREEN_DIRT_SPOT_COLORS } from "../../objects/versusScreenDirtSpotColors";
 import { pause, unpause } from "../pause";
+import { runNextGameFrame } from "../runInNFrames";
 import { ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH } from "./customStageConstants";
+import {
+  DEFAULT_BASE_STAGE,
+  DEFAULT_BASE_STAGE_TYPE,
+  INVALID_STAGE_VALUE,
+} from "./exports";
 import v, { customBossPNGPaths } from "./v";
 
 const DEFAULT_CHARACTER = PlayerType.ISAAC;
@@ -102,12 +109,29 @@ export function versusScreenInit(): void {
 export function playVersusScreenAnimation(customStage: CustomStage): void {
   const room = game.GetRoom();
   const roomType = room.GetType();
+  const roomCleared = room.IsClear();
   const hud = game.GetHUD();
 
   if (roomType !== RoomType.BOSS) {
     return;
   }
 
+  if (roomCleared) {
+    return;
+  }
+
+  if (willVanillaVersusScreenPlay()) {
+    // Since we are on an invalid stage, the versus screen will have a completely black background.
+    // Revert to using the background from the default stage.
+    const level = game.GetLevel();
+    level.SetStage(DEFAULT_BASE_STAGE, DEFAULT_BASE_STAGE_TYPE);
+    runNextGameFrame(() => {
+      const futureLevel = game.GetLevel();
+      futureLevel.SetStage(INVALID_STAGE_VALUE, StageType.ORIGINAL);
+    });
+    return;
+  }
+
   v.run.showingBossVersusScreen = true;
 
   pause();
@@ -156,6 +180,11 @@ export function playVersusScreenAnimation(customStage: CustomStage): void {
   }
 }
 
+function willVanillaVersusScreenPlay() {
+  const bosses = getBosses();
+  return bosses.some((boss) => boss.GetBossID() !== 0);
+}
+
 /** Use the character of the 0th player. */
 function getPlayerPNGPaths(): [
   playerNamePNGPath: string,

package/src/features/customTrapdoor/blackSprite.ts

@@ -9,7 +9,11 @@ import v from "./v";
 const blackSprite = Sprite();
 
 export function drawBlackSprite(): void {
-  if (v.run.state !== StageTravelState.PAUSING_ON_BLACK) {
+  if (
+    v.run.state !== StageTravelState.WAITING_FOR_FIRST_PIXELATION_TO_END &&
+    v.run.state !==
+      StageTravelState.WAITING_FOR_SECOND_PIXELATION_TO_GET_HALF_WAY
+  ) {
     return;
   }
 

package/src/features/customTrapdoor/customTrapdoorConstants.ts

@@ -3,6 +3,10 @@ import { GridEntityType } from "isaac-typescript-definitions";
 export const CUSTOM_TRAPDOOR_FEATURE_NAME = "customTrapdoor";
 
 export const GridEntityTypeCustom = {
+  /**
+   * We arbitrarily choose 1000 as to not conflict with end-user mods. (The expectation is that
+   * end-user mods will begin their enums with values of 1 and increment upwards.)
+   */
   TRAPDOOR_CUSTOM: 1000 as GridEntityType,
 } as const;
 

package/src/features/customTrapdoor/exports.ts

@@ -10,6 +10,7 @@ import { getNextStage, getNextStageType } from "../../functions/nextStage";
 import { getRoomListIndex } from "../../functions/roomData";
 import { isVector } from "../../functions/vector";
 import { CustomTrapdoorDescription } from "../../interfaces/private/CustomTrapdoorDescription";
+import { TrapdoorDestination } from "../../types/TrapdoorDestination";
 import { spawnCustomGridEntity } from "../customGridEntity";
 import {
   CUSTOM_TRAPDOOR_FEATURE_NAME,
@@ -33,12 +34,12 @@ import v from "./v";
  *
  * @param gridIndexOrPosition The location in the room to spawn the trapdoor.
  * @param destination Optional. Used to specify where the player will go after jumping into the
- *                    trapdoor. Can either be a tuple or undefined. For example, a destination of
- *                    `[LevelStage.CAVES_1, StageType.ORIGINAL]` corresponds to Caves 1, and a
- *                    destination of `["Slaughterhouse", 1]` corresponds to a custom stage of
- *                    Slaughterhouse 1. If the destination is set to undefined, then the "normal"
- *                    destination corresponding to the current stage and room will be used (e.g. the
- *                    next floor).
+ *                    trapdoor. Can either be a vanilla stage tuple, a custom stage tuple, or
+ *                    undefined. For example, a destination of `[LevelStage.CAVES_1,
+ *                    StageType.ORIGINAL]` corresponds to Caves 1, and a destination of
+ *                    `["Slaughterhouse", 1]` corresponds to a custom stage of Slaughterhouse 1. If
+ *                    the destination is undefined, then the "normal" destination corresponding to
+ *                    the current stage and room will be used (e.g. the next floor, in most cases).
  * @param anm2Path Optional. The path to the anm2 file to use. By default, the vanilla trapdoor anm2
  *                 of "gfx/grid/door_11_trapdoor.anm2" will be used. The specified anm2 file must
  *                 have animations called "Opened", "Closed", and "Open Animation".
@@ -47,9 +48,7 @@ import v from "./v";
  */
 export function spawnCustomTrapdoor(
   gridIndexOrPosition: int | Vector,
-  destination?:
-    | [stage: LevelStage, stageType: StageType]
-    | [customStageName: string, floorNum: int],
+  destination?: TrapdoorDestination,
   anm2Path = "gfx/grid/door_11_trapdoor.anm2",
   spawnOpen?: boolean,
 ): GridEntity {

package/src/features/customTrapdoor/init.ts

@@ -16,7 +16,7 @@ import { getRoomGridIndex, getRoomListIndex } from "../../functions/roomData";
 import { teleport } from "../../functions/roomTransition";
 import { setStage } from "../../functions/stage";
 import { isString } from "../../functions/types";
-import { setCustomStage } from "../customStage/exports";
+import { disableCustomStage, setCustomStage } from "../customStage/exports";
 import { topStreakTextStart } from "../customStage/streakText";
 import { enableAllInputs } from "../disableInputs";
 import { runNextGameFrame } from "../runInNFrames";
@@ -48,7 +48,7 @@ export function customTrapdoorInit(mod: ModUpgraded): void {
 function postRender() {
   checkAllPlayersJumpComplete();
   checkPixelationToBlackComplete();
-  checkPausingOnBlackComplete();
+  checkSecondPixelationHalfWay();
   checkAllPlayersLayingDownComplete();
   drawBlackSprite();
 }
@@ -77,6 +77,8 @@ function checkAllPlayersJumpComplete() {
     Direction.NO_DIRECTION,
     RoomTransitionAnim.PIXELATION,
   );
+
+  // Next, we wait a certain amount of render frames for the pixelation to fade the screen to black.
 }
 
 function checkPixelationToBlackComplete() {
@@ -89,7 +91,6 @@ function checkPixelationToBlackComplete() {
 
   const hud = game.GetHUD();
   const renderFrameCount = Isaac.GetFrameCount();
-  const roomGridIndex = getRoomGridIndex();
 
   const renderFrameScreenBlack =
     v.run.stateRenderFrame + PIXELATION_TO_BLACK_FRAMES;
@@ -97,25 +98,44 @@ function checkPixelationToBlackComplete() {
     return;
   }
 
-  v.run.state = StageTravelState.PAUSING_ON_BLACK;
-  v.run.stateRenderFrame = renderFrameCount;
+  v.run.state = StageTravelState.WAITING_FOR_FIRST_PIXELATION_TO_END;
 
+  // Now, we display a black sprite on top of the pixelation effect, to prevent showing the rest of
+  // the animation.
   hud.SetVisible(false);
-  goToCustomDestination();
 
-  // Start another pixelation effect. This time, we will keep the screen black with the sprite, and
-  // then remove the black sprite once the pixelation effect is halfway complete.
-  teleport(
-    roomGridIndex,
-    Direction.NO_DIRECTION,
-    RoomTransitionAnim.PIXELATION,
-    true,
-  );
+  // If the pixelation effect is not fully allowed to complete, the game's internal buffer will not
+  // be flushed. The consequence of this is that after 11 custom stage transitions, the "log.txt"
+  // starts to become become spammed with: [ASSERT] - PushRenderTarget: stack overflow!
+
+  // In order to work around this, we fully let the animation complete by only continuing the stage
+  // transition on the next game frame.
+  runNextGameFrame(() => {
+    const level = game.GetLevel();
+    const startingRoomIndex = level.GetStartingRoomIndex();
+    const futureRenderFrameCount = Isaac.GetFrameCount();
+
+    v.run.state =
+      StageTravelState.WAITING_FOR_SECOND_PIXELATION_TO_GET_HALF_WAY;
+    v.run.stateRenderFrame = futureRenderFrameCount;
+
+    goToCustomDestination();
+
+    // Start another pixelation effect. This time, we will keep the screen black with the sprite,
+    // and then remove the black sprite once the pixelation effect is halfway complete.
+    teleport(
+      startingRoomIndex,
+      Direction.NO_DIRECTION,
+      RoomTransitionAnim.PIXELATION,
+      true,
+    );
+  });
 }
 
-function checkPausingOnBlackComplete() {
+function checkSecondPixelationHalfWay() {
   if (
-    v.run.state !== StageTravelState.PAUSING_ON_BLACK ||
+    v.run.state !==
+      StageTravelState.WAITING_FOR_SECOND_PIXELATION_TO_GET_HALF_WAY ||
     v.run.stateRenderFrame === null
   ) {
     return;
@@ -135,12 +155,12 @@ function checkPausingOnBlackComplete() {
   hud.SetVisible(true);
 
   runNextRoom(() => {
+    v.run.state = StageTravelState.PLAYERS_LAYING_DOWN;
+
     // 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();
 
-    v.run.state = StageTravelState.PLAYERS_LAYING_DOWN;
-
     for (const player of getAllPlayers()) {
       player.AnimateAppear();
 
@@ -186,6 +206,7 @@ function goToCustomDestination() {
     setCustomStage("Slaughterhouse", firstFloor);
   } else {
     // A number represents a vanilla `LevelStage`.
+    disableCustomStage();
     setStage(arg1, arg2 as StageType);
   }
 }

package/src/features/customTrapdoor/touched.ts

@@ -81,6 +81,9 @@ function playerTouchedCustomTrapdoor(
   v.run.state = StageTravelState.PLAYERS_JUMPING_DOWN;
   v.run.destination = trapdoorDescription.destination;
 
+  // We don't want to allow pausing, since that will allow render frames to pass without advancing
+  // the stage traveling logic. (We track how many render frames have passed to know when to move to
+  // the next step.)
   const whitelist = new Set([ButtonAction.CONSOLE]);
   disableAllInputsExceptFor(CUSTOM_TRAPDOOR_FEATURE_NAME, whitelist);
   setPlayerAttributes(player, gridEntity.Position);
@@ -114,6 +117,8 @@ function setPlayerAttributes(trapdoorPlayer: EntityPlayer, position: Vector) {
     // We don't want enemy attacks to move the players.
     player.EntityCollisionClass = EntityCollisionClass.NONE;
     player.GridCollisionClass = EntityGridCollisionClass.NONE;
+
+    player.StopExtraAnimation();
   }
 }
 

package/src/features/customTrapdoor/v.ts

@@ -1,7 +1,7 @@
-import { LevelStage, StageType } from "isaac-typescript-definitions";
 import { DefaultMap } from "../../classes/DefaultMap";
 import { StageTravelState } from "../../enums/private/StageTravelState";
 import { CustomTrapdoorDescription } from "../../interfaces/private/CustomTrapdoorDescription";
+import { TrapdoorDestination } from "../../types/TrapdoorDestination";
 
 const v = {
   run: {
@@ -10,10 +10,7 @@ const v = {
     /** The render frame that this state was reached. */
     stateRenderFrame: null as int | null,
 
-    destination: null as
-      | [stage: LevelStage, stageType: StageType]
-      | [customStageName: string, floorNum: int]
-      | null,
+    destination: null as TrapdoorDestination | null,
   },
 
   level: {

package/src/features/playerInventory.ts

@@ -114,6 +114,13 @@ function postCollectibleRemoved(
  * middle of the run (e.g. with D4), the order of the inventory will not correspond to the order
  * that the items were actually given to the player. In this case, the inventory will be in the
  * order of the lowest `CollectibleType` to the highest.
+ *
+ * Under the hood, the inventory tracking works by tracking the number of collectibles that a player
+ * has on every frame. Thus, in a situation where a collectible was both added and removed to the
+ * player on the same frame, the amount of total collectibles would stay the same, and the inventory
+ * would not be updated. In vanilla, this situation would never happen, but another mod might do
+ * this for some reason. (With that said, the next time that a collectible is normally added or
+ * removed, it would trigger a re-scan, and the previous changes would be picked up.)
  */
 export function getPlayerInventory(
   player: EntityPlayer,

package/src/interfaces/private/CustomTrapdoorDescription.ts

@@ -1,9 +1,7 @@
-import { LevelStage, StageType } from "isaac-typescript-definitions";
+import { TrapdoorDestination } from "../../types/TrapdoorDestination";
 
 export interface CustomTrapdoorDescription {
   open: boolean;
-  destination:
-    | [stage: LevelStage, stageType: StageType]
-    | [customStageName: string, floorNum: int];
+  destination: TrapdoorDestination;
   firstSpawn: boolean;
 }

package/src/types/TrapdoorDestination.ts

@@ -0,0 +1,5 @@
+import { LevelStage, StageType } from "isaac-typescript-definitions";
+
+export type TrapdoorDestination =
+  | [stage: LevelStage, stageType: StageType]
+  | [customStageName: string, floorNum: int];