isaacscript-common 7.4.3 → 7.6.0

package/dist/features/customStage/versusScreen.lua

@@ -1,8 +1,8 @@
 local ____lualib = require("lualib_bundle")
-local Map = ____lualib.Map
 local __TS__ArraySome = ____lualib.__TS__ArraySome
+local __TS__ArrayFind = ____lualib.__TS__ArrayFind
 local ____exports = {}
-local willVanillaVersusScreenPlay, getPlayerPNGPaths, getBossPNGPaths, DEFAULT_CHARACTER, PNG_PATH_PREFIX, PLAYER_PORTRAIT_PNG_PATH_PREFIX
+local willVanillaVersusScreenPlay, getPlayerPNGPaths, getBossPNGPaths, getBossPNGPathsCustom, 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
@@ -17,8 +17,8 @@ local ____array = require("functions.array")
 local arrayRemove = ____array.arrayRemove
 local ____bosses = require("functions.bosses")
 local getBosses = ____bosses.getBosses
-local ____entities = require("functions.entities")
-local getEntityID = ____entities.getEntityID
+local ____roomData = require("functions.roomData")
+local getRoomSubType = ____roomData.getRoomSubType
 local ____utils = require("functions.utils")
 local erange = ____utils.erange
 local ____bossNamePNGFileNames = require("objects.bossNamePNGFileNames")
@@ -46,7 +46,6 @@ 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(
@@ -57,40 +56,51 @@ end
 function getPlayerPNGPaths(self)
     local player = Isaac.GetPlayer()
     local character = player:GetPlayerType()
-    local playerNamePNGFileName = PLAYER_NAME_PNG_FILE_NAMES[character]
-    if playerNamePNGFileName == nil then
-        playerNamePNGFileName = PLAYER_NAME_PNG_FILE_NAMES[DEFAULT_CHARACTER]
+    local namePNGFileName = PLAYER_NAME_PNG_FILE_NAMES[character]
+    if namePNGFileName == nil then
+        namePNGFileName = PLAYER_NAME_PNG_FILE_NAMES[DEFAULT_CHARACTER]
     end
-    local playerNamePNGPath = (PNG_PATH_PREFIX .. "/") .. tostring(playerNamePNGFileName)
-    local playerPortraitFileName = PLAYER_PORTRAIT_PNG_FILE_NAMES[character]
-    if playerNamePNGFileName == nil then
-        playerPortraitFileName = PLAYER_PORTRAIT_PNG_FILE_NAMES[DEFAULT_CHARACTER]
+    local namePNGPath = (PNG_PATH_PREFIX .. "/") .. tostring(namePNGFileName)
+    local portraitFileName = PLAYER_PORTRAIT_PNG_FILE_NAMES[character]
+    if namePNGFileName == nil then
+        portraitFileName = PLAYER_PORTRAIT_PNG_FILE_NAMES[DEFAULT_CHARACTER]
     end
-    local playerPortraitPNGPath = (PLAYER_PORTRAIT_PNG_PATH_PREFIX .. "/") .. tostring(playerPortraitFileName)
-    return {playerNamePNGPath, playerPortraitPNGPath}
+    local portraitPNGPath = (PLAYER_PORTRAIT_PNG_PATH_PREFIX .. "/") .. tostring(portraitFileName)
+    return {namePNGPath = namePNGPath, portraitPNGPath = portraitPNGPath}
 end
-function getBossPNGPaths(self)
+function getBossPNGPaths(self, customStage)
+    local paths = getBossPNGPathsCustom(nil, customStage)
+    if paths ~= nil then
+        return paths
+    end
     local bosses = getBosses(nil)
     local firstBoss = bosses[1]
-    if firstBoss ~= nil then
-        local entityID = getEntityID(nil, firstBoss)
-        local pngPaths = customBossPNGPaths:get(entityID)
-        if pngPaths ~= nil then
-            return pngPaths
-        end
-    end
     local bossID = firstBoss == nil and 0 or firstBoss:GetBossID()
     if bossID == 0 then
         local questionMarkSprite = (PNG_PATH_PREFIX .. "/") .. BOSS_NAME_PNG_FILE_NAMES[BossID.BLUE_BABY]
-        local bossNamePNGPath = questionMarkSprite
-        local bossPortraitPNGPath = questionMarkSprite
-        return {bossNamePNGPath, bossPortraitPNGPath}
-    end
-    local bossNamePNGFileName = BOSS_NAME_PNG_FILE_NAMES[bossID]
-    local bossNamePNGPath = (PNG_PATH_PREFIX .. "/") .. bossNamePNGFileName
-    local bossPortraitPNGFileName = BOSS_PORTRAIT_PNG_FILE_NAMES[bossID]
-    local bossPortraitPNGPath = (PNG_PATH_PREFIX .. "/") .. bossPortraitPNGFileName
-    return {bossNamePNGPath, bossPortraitPNGPath}
+        local namePNGPath = questionMarkSprite
+        local portraitPNGPath = questionMarkSprite
+        return {namePNGPath = namePNGPath, portraitPNGPath = portraitPNGPath}
+    end
+    local namePNGFileName = BOSS_NAME_PNG_FILE_NAMES[bossID]
+    local namePNGPath = (PNG_PATH_PREFIX .. "/") .. namePNGFileName
+    local portraitPNGFileName = BOSS_PORTRAIT_PNG_FILE_NAMES[bossID]
+    local portraitPNGPath = (PNG_PATH_PREFIX .. "/") .. portraitPNGFileName
+    return {namePNGPath = namePNGPath, portraitPNGPath = portraitPNGPath}
+end
+function getBossPNGPathsCustom(self, customStage)
+    if customStage.bossPool == nil then
+        return nil
+    end
+    local roomSubType = getRoomSubType(nil)
+    local matchingBossEntry = __TS__ArrayFind(
+        customStage.bossPool,
+        function(____, bossEntry) return bossEntry.subType == roomSubType end
+    )
+    if matchingBossEntry == nil then
+        return nil
+    end
+    return matchingBossEntry.versusScreen
 end
 DEFAULT_CHARACTER = PlayerType.ISAAC
 local DEFAULT_STAGE_ID = StageID.BASEMENT
@@ -164,37 +174,45 @@ function ____exports.playVersusScreenAnimation(self, customStage)
     v.run.showingBossVersusScreen = true
     pause(nil)
     hud:SetVisible(false)
-    local playerNamePNGPath, playerPortraitPNGPath = table.unpack(getPlayerPNGPaths(nil))
-    versusScreenSprite:ReplaceSpritesheet(PLAYER_NAME_ANM2_LAYER, playerNamePNGPath)
-    versusScreenSprite:ReplaceSpritesheet(PLAYER_PORTRAIT_ANM2_LAYER, playerPortraitPNGPath)
-    local bossNamePNGPath, bossPortraitPNGPath = table.unpack(getBossPNGPaths(nil))
-    versusScreenSprite:ReplaceSpritesheet(BOSS_NAME_ANM2_LAYER, bossNamePNGPath)
-    versusScreenSprite:ReplaceSpritesheet(BOSS_PORTRAIT_ANM2_LAYER, bossPortraitPNGPath)
+    do
+        local ____getPlayerPNGPaths_result_0 = getPlayerPNGPaths(nil)
+        local namePNGPath = ____getPlayerPNGPaths_result_0.namePNGPath
+        local portraitPNGPath = ____getPlayerPNGPaths_result_0.portraitPNGPath
+        versusScreenSprite:ReplaceSpritesheet(PLAYER_NAME_ANM2_LAYER, namePNGPath)
+        versusScreenSprite:ReplaceSpritesheet(PLAYER_PORTRAIT_ANM2_LAYER, portraitPNGPath)
+    end
+    do
+        local ____getBossPNGPaths_result_1 = getBossPNGPaths(nil, customStage)
+        local namePNGPath = ____getBossPNGPaths_result_1.namePNGPath
+        local portraitPNGPath = ____getBossPNGPaths_result_1.portraitPNGPath
+        versusScreenSprite:ReplaceSpritesheet(BOSS_NAME_ANM2_LAYER, namePNGPath)
+        versusScreenSprite:ReplaceSpritesheet(BOSS_PORTRAIT_ANM2_LAYER, portraitPNGPath)
+    end
     versusScreenSprite:LoadGraphics()
     local backgroundColor = VERSUS_SCREEN_BACKGROUND_COLORS[DEFAULT_STAGE_ID]
-    local ____customStage_versusScreen_backgroundColor_0 = customStage.versusScreen
-    if ____customStage_versusScreen_backgroundColor_0 ~= nil then
-        ____customStage_versusScreen_backgroundColor_0 = ____customStage_versusScreen_backgroundColor_0.backgroundColor
-    end
-    if ____customStage_versusScreen_backgroundColor_0 ~= nil then
-        local ____customStage_versusScreen_backgroundColor_2 = customStage.versusScreen.backgroundColor
-        local r = ____customStage_versusScreen_backgroundColor_2.r
-        local g = ____customStage_versusScreen_backgroundColor_2.g
-        local b = ____customStage_versusScreen_backgroundColor_2.b
-        local a = ____customStage_versusScreen_backgroundColor_2.a
+    local ____customStage_versusScreen_backgroundColor_2 = customStage.versusScreen
+    if ____customStage_versusScreen_backgroundColor_2 ~= nil then
+        ____customStage_versusScreen_backgroundColor_2 = ____customStage_versusScreen_backgroundColor_2.backgroundColor
+    end
+    if ____customStage_versusScreen_backgroundColor_2 ~= nil then
+        local ____customStage_versusScreen_backgroundColor_4 = customStage.versusScreen.backgroundColor
+        local r = ____customStage_versusScreen_backgroundColor_4.r
+        local g = ____customStage_versusScreen_backgroundColor_4.g
+        local b = ____customStage_versusScreen_backgroundColor_4.b
+        local a = ____customStage_versusScreen_backgroundColor_4.a
         backgroundColor = Color(r, g, b, a)
     end
     versusScreenBackgroundSprite.Color = backgroundColor
     local dirtSpotColor = VERSUS_SCREEN_DIRT_SPOT_COLORS[DEFAULT_STAGE_ID]
-    local ____customStage_versusScreen_dirtSpotColor_3 = customStage.versusScreen
-    if ____customStage_versusScreen_dirtSpotColor_3 ~= nil then
-        ____customStage_versusScreen_dirtSpotColor_3 = ____customStage_versusScreen_dirtSpotColor_3.dirtSpotColor
-    end
-    if ____customStage_versusScreen_dirtSpotColor_3 ~= nil then
-        local ____customStage_versusScreen_dirtSpotColor_5 = customStage.versusScreen.dirtSpotColor
-        local r = ____customStage_versusScreen_dirtSpotColor_5.r
-        local g = ____customStage_versusScreen_dirtSpotColor_5.g
-        local b = ____customStage_versusScreen_dirtSpotColor_5.b
+    local ____customStage_versusScreen_dirtSpotColor_5 = customStage.versusScreen
+    if ____customStage_versusScreen_dirtSpotColor_5 ~= nil then
+        ____customStage_versusScreen_dirtSpotColor_5 = ____customStage_versusScreen_dirtSpotColor_5.dirtSpotColor
+    end
+    if ____customStage_versusScreen_dirtSpotColor_5 ~= nil then
+        local ____customStage_versusScreen_dirtSpotColor_7 = customStage.versusScreen.dirtSpotColor
+        local r = ____customStage_versusScreen_dirtSpotColor_7.r
+        local g = ____customStage_versusScreen_dirtSpotColor_7.g
+        local b = ____customStage_versusScreen_dirtSpotColor_7.b
         dirtSpotColor = Color(r, g, b)
     end
     versusScreenDirtSpotSprite.Color = dirtSpotColor
@@ -214,10 +232,6 @@ function ____exports.versusScreenPostRender(self)
     if not v.run.showingBossVersusScreen then
         return
     end
-    local isPaused = game:IsPaused()
-    if isPaused then
-        return
-    end
     if versusScreenSprite:IsFinished(VERSUS_SCREEN_ANIMATION_NAME) then
         finishVersusScreenAnimation(nil)
         return

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

@@ -1,33 +1,45 @@
-/// <reference types="isaac-typescript-definitions" />
-/// <reference types="isaac-typescript-definitions" />
-/// <reference types="isaac-typescript-definitions" />
-import { TrapdoorDestination } from "../../types/TrapdoorDestination";
+import { LevelStage, StageType } from "isaac-typescript-definitions";
 /**
- * Helper function to spawn a trapdoor grid entity that will have one or more of the following
- * attributes:
+ * Helper function to spawn a trapdoor grid entity that will take a player to a custom stage. If you
+ * want to create a custom trapdoor that goes to a vanilla stage instead, use the
+ * `spawnCustomTrapdoorToVanilla` helper function.
+ *
+ * Custom trapdoors can have one or more of the following attributes:
  *
  * - custom destination (or custom logic for after the player enters)
  * - custom graphics
  * - custom logic for opening/closing
  *
- * You can use this function to take the player to your custom stage.
- *
  * Under the hood, the custom trapdoor is represented by a decoration grid entity and is manually
  * respawned every time the player re-enters the room.
  *
  * @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 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 customStageName The name of the custom stage.
+ * @param customStageFloorNum The floor of the custom stage. For most purposes, you should use 1 or
+ *                            2.
+ * @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, customStageName: string, customStageFloorNum: int, anm2Path?: string, spawnOpen?: boolean): GridEntity;
+/**
+ * This is the same thing as the `spawnCustomTrapdoor` function, but instead of having a destination
+ * of a custom stage, it has a destination of a vanilla stage.
+ *
+ * For more information, see the `spawnCustomTrapdoor` function.
+ *
+ * @param gridIndexOrPosition The location in the room to spawn the trapdoor.
+ * @param stage Optional. The number of the vanilla stage to go to. If not provided, the "normal"
+ *              next stage will be selected.
+ * @param stageType The stage type of the vanilla stage to go to. If not provided, the "normal" next
+ *                  stage type will be selected.
  * @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?: TrapdoorDestination, anm2Path?: string, spawnOpen?: boolean): GridEntity;
+export declare function spawnCustomTrapdoorToVanilla(gridIndexOrPosition: int | Vector, stage?: LevelStage, stageType?: StageType, 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":";;;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"}
+{"version":3,"file":"exports.d.ts","sourceRoot":"","sources":["../../../src/features/customTrapdoor/exports.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAOrE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,mBAAmB,CACjC,mBAAmB,EAAE,GAAG,GAAG,MAAM,EACjC,eAAe,EAAE,MAAM,EACvB,mBAAmB,EAAE,GAAG,EACxB,QAAQ,SAAmC,EAC3C,SAAS,CAAC,EAAE,OAAO,GAClB,UAAU,CAcZ;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,4BAA4B,CAC1C,mBAAmB,EAAE,GAAG,GAAG,MAAM,EACjC,KAAK,CAAC,EAAE,UAAU,EAClB,SAAS,CAAC,EAAE,SAAS,EACrB,QAAQ,SAAmC,EAC3C,SAAS,CAAC,EAAE,OAAO,GAClB,UAAU,CAkBZ"}

package/dist/features/customTrapdoor/exports.lua

@@ -1,94 +1,78 @@
-local ____lualib = require("lualib_bundle")
-local Map = ____lualib.Map
 local ____exports = {}
-local getDefaultDestination
-local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
-local GridCollisionClass = ____isaac_2Dtypescript_2Ddefinitions.GridCollisionClass
-local ____cachedClasses = require("core.cachedClasses")
-local game = ____cachedClasses.game
-local ____TrapdoorAnimation = require("enums.private.TrapdoorAnimation")
-local TrapdoorAnimation = ____TrapdoorAnimation.TrapdoorAnimation
 local ____featuresInitialized = require("featuresInitialized")
 local errorIfFeaturesNotInitialized = ____featuresInitialized.errorIfFeaturesNotInitialized
 local ____nextStage = require("functions.nextStage")
 local getNextStage = ____nextStage.getNextStage
 local getNextStageType = ____nextStage.getNextStageType
-local ____roomData = require("functions.roomData")
-local getRoomListIndex = ____roomData.getRoomListIndex
-local ____vector = require("functions.vector")
-local isVector = ____vector.isVector
-local ____customGridEntity = require("features.customGridEntity")
-local spawnCustomGridEntity = ____customGridEntity.spawnCustomGridEntity
 local ____customTrapdoorConstants = require("features.customTrapdoor.customTrapdoorConstants")
 local CUSTOM_TRAPDOOR_FEATURE_NAME = ____customTrapdoorConstants.CUSTOM_TRAPDOOR_FEATURE_NAME
-local GridEntityTypeCustom = ____customTrapdoorConstants.GridEntityTypeCustom
-local ____openClose = require("features.customTrapdoor.openClose")
-local shouldTrapdoorSpawnOpen = ____openClose.shouldTrapdoorSpawnOpen
-local ____v = require("features.customTrapdoor.v")
-local v = ____v.default
-function getDefaultDestination(self)
-    local nextStage = getNextStage(nil)
-    local nextStageType = getNextStageType(nil)
-    return {nextStage, nextStageType}
-end
---- Helper function to spawn a trapdoor grid entity that will have one or more of the following
--- attributes:
+local ____spawn = require("features.customTrapdoor.spawn")
+local spawnCustomTrapdoorToDestination = ____spawn.spawnCustomTrapdoorToDestination
+--- Helper function to spawn a trapdoor grid entity that will take a player to a custom stage. If you
+-- want to create a custom trapdoor that goes to a vanilla stage instead, use the
+-- `spawnCustomTrapdoorToVanilla` helper function.
+-- 
+-- Custom trapdoors can have one or more of the following attributes:
 -- 
 -- - custom destination (or custom logic for after the player enters)
 -- - custom graphics
 -- - custom logic for opening/closing
 -- 
--- You can use this function to take the player to your custom stage.
--- 
 -- Under the hood, the custom trapdoor is represented by a decoration grid entity and is manually
 -- respawned every time the player re-enters the room.
 -- 
 -- @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 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 customStageName The name of the custom stage.
+-- @param customStageFloorNum The floor of the custom stage. For most purposes, you should use 1 or
+-- 2.
 -- @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.
-function ____exports.spawnCustomTrapdoor(self, gridIndexOrPosition, destination, anm2Path, spawnOpen)
+function ____exports.spawnCustomTrapdoor(self, gridIndexOrPosition, customStageName, customStageFloorNum, anm2Path, spawnOpen)
     if anm2Path == nil then
         anm2Path = "gfx/grid/door_11_trapdoor.anm2"
     end
     errorIfFeaturesNotInitialized(nil, CUSTOM_TRAPDOOR_FEATURE_NAME)
-    local room = game:GetRoom()
-    local roomFrameCount = room:GetFrameCount()
-    local roomListIndex = getRoomListIndex(nil)
-    local gridIndex = isVector(nil, gridIndexOrPosition) and room:GetGridIndex(gridIndexOrPosition) or gridIndexOrPosition
-    local gridEntity = spawnCustomGridEntity(
+    local destination = {customStageName = customStageName, customStageFloorNum = customStageFloorNum}
+    return spawnCustomTrapdoorToDestination(
         nil,
-        GridEntityTypeCustom.TRAPDOOR_CUSTOM,
         gridIndexOrPosition,
-        GridCollisionClass.NONE,
+        destination,
         anm2Path,
-        TrapdoorAnimation.OPENED
+        spawnOpen
     )
-    local firstSpawn = roomFrameCount ~= 0
-    local ____temp_0
-    if spawnOpen == nil then
-        ____temp_0 = shouldTrapdoorSpawnOpen(nil, gridEntity, firstSpawn)
-    else
-        ____temp_0 = spawnOpen
-    end
-    local open = ____temp_0
-    local destinationToUse = destination == nil and getDefaultDestination(nil) or destination
-    local roomTrapdoorMap = v.level.trapdoors:getAndSetDefault(roomListIndex)
-    local customTrapdoorDescription = {open = open, destination = destinationToUse, firstSpawn = firstSpawn}
-    roomTrapdoorMap:set(gridIndex, customTrapdoorDescription)
-    if not open then
-        local sprite = gridEntity:GetSprite()
-        sprite:Play(TrapdoorAnimation.CLOSED, true)
+end
+--- This is the same thing as the `spawnCustomTrapdoor` function, but instead of having a destination
+-- of a custom stage, it has a destination of a vanilla stage.
+-- 
+-- For more information, see the `spawnCustomTrapdoor` function.
+-- 
+-- @param gridIndexOrPosition The location in the room to spawn the trapdoor.
+-- @param stage Optional. The number of the vanilla stage to go to. If not provided, the "normal"
+-- next stage will be selected.
+-- @param stageType The stage type of the vanilla stage to go to. If not provided, the "normal" next
+-- stage type will be selected.
+-- @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.
+function ____exports.spawnCustomTrapdoorToVanilla(self, gridIndexOrPosition, stage, stageType, anm2Path, spawnOpen)
+    if anm2Path == nil then
+        anm2Path = "gfx/grid/door_11_trapdoor.anm2"
     end
-    return gridEntity
+    errorIfFeaturesNotInitialized(nil, CUSTOM_TRAPDOOR_FEATURE_NAME)
+    local vanillaStage = stage == nil and getNextStage(nil) or stage
+    local vanillaStageType = stageType == nil and getNextStageType(nil) or stageType
+    local destination = {vanillaStage = vanillaStage, vanillaStageType = vanillaStageType}
+    return spawnCustomTrapdoorToDestination(
+        nil,
+        gridIndexOrPosition,
+        destination,
+        anm2Path,
+        spawnOpen
+    )
 end
 return ____exports

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

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/features/customTrapdoor/init.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AA0BxD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAUzD"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/features/customTrapdoor/init.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAyBxD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAUzD"}

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, checkSecondPixelationHalfWay, checkAllPlayersLayingDownComplete, goToCustomDestination, anyPlayerPlayingExtraAnimation, postPEffectUpdate, checkJumpComplete, postGridEntityCustomUpdateTrapdoor
+local postRender, checkAllPlayersJumpComplete, checkPixelationToBlackComplete, checkSecondPixelationHalfWay, checkAllPlayersLayingDownComplete, goToCustomTrapdoorDestination, anyPlayerPlayingExtraAnimation, postPEffectUpdate, checkJumpComplete, postGridEntityCustomUpdateTrapdoor
 local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
 local Direction = ____isaac_2Dtypescript_2Ddefinitions.Direction
 local EntityCollisionClass = ____isaac_2Dtypescript_2Ddefinitions.EntityCollisionClass
@@ -26,8 +26,6 @@ local ____roomTransition = require("functions.roomTransition")
 local teleport = ____roomTransition.teleport
 local ____stage = require("functions.stage")
 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
@@ -93,7 +91,7 @@ function checkPixelationToBlackComplete(self)
             local futureRenderFrameCount = Isaac.GetFrameCount()
             v.run.state = StageTravelState.WAITING_FOR_SECOND_PIXELATION_TO_GET_HALF_WAY
             v.run.stateRenderFrame = futureRenderFrameCount
-            goToCustomDestination(nil)
+            goToCustomTrapdoorDestination(nil)
             teleport(
                 nil,
                 startingRoomIndex,
@@ -145,17 +143,21 @@ function checkAllPlayersLayingDownComplete(self)
     v.run.state = StageTravelState.NONE
     enableAllInputs(nil, CUSTOM_TRAPDOOR_FEATURE_NAME)
 end
-function goToCustomDestination(self)
+function goToCustomTrapdoorDestination(self)
     if v.run.destination == nil then
         return
     end
-    local arg1, arg2 = table.unpack(v.run.destination)
-    if isString(nil, arg1) then
-        local firstFloor = arg2 == 1
+    local ____v_run_destination_0 = v.run.destination
+    local customStageName = ____v_run_destination_0.customStageName
+    local customStageFloorNum = ____v_run_destination_0.customStageFloorNum
+    local vanillaStage = ____v_run_destination_0.vanillaStage
+    local vanillaStageType = ____v_run_destination_0.vanillaStageType
+    if customStageName ~= nil and customStageFloorNum ~= nil then
+        local firstFloor = customStageFloorNum == 1
         setCustomStage(nil, "Slaughterhouse", firstFloor)
-    else
+    elseif vanillaStage ~= nil and vanillaStageType ~= nil then
         disableCustomStage(nil)
-        setStage(nil, arg1, arg2)
+        setStage(nil, vanillaStage, vanillaStageType)
     end
 end
 function anyPlayerPlayingExtraAnimation(self)

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

@@ -0,0 +1,6 @@
+/// <reference types="isaac-typescript-definitions" />
+/// <reference types="isaac-typescript-definitions" />
+/// <reference types="isaac-typescript-definitions" />
+import { CustomTrapdoorDestination } from "../../interfaces/private/CustomTrapdoorDestination";
+export declare function spawnCustomTrapdoorToDestination(gridIndexOrPosition: int | Vector, destination: CustomTrapdoorDestination, anm2Path: string, spawnOpen?: boolean): GridEntity;
+//# sourceMappingURL=spawn.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../../src/features/customTrapdoor/spawn.ts"],"names":[],"mappings":";;;AAMA,OAAO,EAAE,yBAAyB,EAAE,MAAM,oDAAoD,CAAC;AAM/F,wBAAgB,gCAAgC,CAC9C,mBAAmB,EAAE,GAAG,GAAG,MAAM,EACjC,WAAW,EAAE,yBAAyB,EACtC,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,OAAO,GAClB,UAAU,CAoCZ"}

package/dist/features/customTrapdoor/spawn.lua

@@ -0,0 +1,52 @@
+local ____lualib = require("lualib_bundle")
+local Map = ____lualib.Map
+local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local GridCollisionClass = ____isaac_2Dtypescript_2Ddefinitions.GridCollisionClass
+local ____cachedClasses = require("core.cachedClasses")
+local game = ____cachedClasses.game
+local ____TrapdoorAnimation = require("enums.private.TrapdoorAnimation")
+local TrapdoorAnimation = ____TrapdoorAnimation.TrapdoorAnimation
+local ____roomData = require("functions.roomData")
+local getRoomListIndex = ____roomData.getRoomListIndex
+local ____vector = require("functions.vector")
+local isVector = ____vector.isVector
+local ____customGridEntity = require("features.customGridEntity")
+local spawnCustomGridEntity = ____customGridEntity.spawnCustomGridEntity
+local ____customTrapdoorConstants = require("features.customTrapdoor.customTrapdoorConstants")
+local GridEntityTypeCustom = ____customTrapdoorConstants.GridEntityTypeCustom
+local ____openClose = require("features.customTrapdoor.openClose")
+local shouldTrapdoorSpawnOpen = ____openClose.shouldTrapdoorSpawnOpen
+local ____v = require("features.customTrapdoor.v")
+local v = ____v.default
+function ____exports.spawnCustomTrapdoorToDestination(self, gridIndexOrPosition, destination, anm2Path, spawnOpen)
+    local room = game:GetRoom()
+    local roomFrameCount = room:GetFrameCount()
+    local roomListIndex = getRoomListIndex(nil)
+    local gridIndex = isVector(nil, gridIndexOrPosition) and room:GetGridIndex(gridIndexOrPosition) or gridIndexOrPosition
+    local gridEntity = spawnCustomGridEntity(
+        nil,
+        GridEntityTypeCustom.TRAPDOOR_CUSTOM,
+        gridIndexOrPosition,
+        GridCollisionClass.NONE,
+        anm2Path,
+        TrapdoorAnimation.OPENED
+    )
+    local firstSpawn = roomFrameCount ~= 0
+    local ____temp_0
+    if spawnOpen == nil then
+        ____temp_0 = shouldTrapdoorSpawnOpen(nil, gridEntity, firstSpawn)
+    else
+        ____temp_0 = spawnOpen
+    end
+    local open = ____temp_0
+    local roomTrapdoorMap = v.level.trapdoors:getAndSetDefault(roomListIndex)
+    local customTrapdoorDescription = {open = open, destination = destination, firstSpawn = firstSpawn}
+    roomTrapdoorMap:set(gridIndex, customTrapdoorDescription)
+    if not open then
+        local sprite = gridEntity:GetSprite()
+        sprite:Play(TrapdoorAnimation.CLOSED, true)
+    end
+    return gridEntity
+end
+return ____exports

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

@@ -1,13 +1,13 @@
 import { DefaultMap } from "../../classes/DefaultMap";
 import { StageTravelState } from "../../enums/private/StageTravelState";
 import { CustomTrapdoorDescription } from "../../interfaces/private/CustomTrapdoorDescription";
-import { TrapdoorDestination } from "../../types/TrapdoorDestination";
+import { CustomTrapdoorDestination } from "../../interfaces/private/CustomTrapdoorDestination";
 declare const v: {
     run: {
         state: StageTravelState;
         /** The render frame that this state was reached. */
         stateRenderFrame: number | null;
-        destination: TrapdoorDestination | null;
+        destination: CustomTrapdoorDestination | 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,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"}
+{"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,yBAAyB,EAAE,MAAM,oDAAoD,CAAC;AAE/F,QAAA,MAAM,CAAC;;;QAIH,oDAAoD;;;;;QAOpD,iDAAiD;;;CAKpD,CAAC;AACF,eAAe,CAAC,CAAC"}

package/dist/functions/dev.d.ts

@@ -0,0 +1,20 @@
+import { ModUpgraded } from "../classes/ModUpgraded";
+/**
+ * Helper function to enable some IsaacScript features that are useful when developing a mod. They
+ * shouldn't be enabled when your mod goes to production (i.e. it is uploaded to the Steam
+ * Workshop).
+ *
+ * The list of development features that are enabled are as follows:
+ *
+ * - `saveDataManagerSetGlobal` - Sets your local variables registered with the save data manager as
+ *   global variables so you can access them from the in-game console.
+ * - `setLogFunctionsGlobal` - Sets the various log functions global so that you can access them
+ *   from the in-game console.
+ * - `enableExtraConsoleCommands` - Enables many extra in-game console commands that make warping
+ *   around easier (like e.g. `angel` to warp to the Angel Room).
+ * - `enableFastReset` - Makes it so that the r key resets the game instantaneously.
+ * - `removeFadeIn` - Removes the slow fade in that occurs at the beginning of the run, so that you
+ *   can immediately start playing or testing.
+ */
+export declare function enableDevFeatures(mod: ModUpgraded): void;
+//# sourceMappingURL=dev.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/functions/dev.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAOrD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAMxD"}

package/dist/functions/dev.lua

@@ -0,0 +1,34 @@
+local ____exports = {}
+local ____exports = require("features.extraConsoleCommands.exports")
+local enableExtraConsoleCommands = ____exports.enableExtraConsoleCommands
+local ____fadeInRemover = require("features.fadeInRemover")
+local removeFadeIn = ____fadeInRemover.removeFadeIn
+local ____fastReset = require("features.fastReset")
+local enableFastReset = ____fastReset.enableFastReset
+local ____exports = require("features.saveDataManager.exports")
+local saveDataManagerSetGlobal = ____exports.saveDataManagerSetGlobal
+local ____log = require("functions.log")
+local setLogFunctionsGlobal = ____log.setLogFunctionsGlobal
+--- Helper function to enable some IsaacScript features that are useful when developing a mod. They
+-- shouldn't be enabled when your mod goes to production (i.e. it is uploaded to the Steam
+-- Workshop).
+-- 
+-- The list of development features that are enabled are as follows:
+-- 
+-- - `saveDataManagerSetGlobal` - Sets your local variables registered with the save data manager as
+--   global variables so you can access them from the in-game console.
+-- - `setLogFunctionsGlobal` - Sets the various log functions global so that you can access them
+--   from the in-game console.
+-- - `enableExtraConsoleCommands` - Enables many extra in-game console commands that make warping
+--   around easier (like e.g. `angel` to warp to the Angel Room).
+-- - `enableFastReset` - Makes it so that the r key resets the game instantaneously.
+-- - `removeFadeIn` - Removes the slow fade in that occurs at the beginning of the run, so that you
+--   can immediately start playing or testing.
+function ____exports.enableDevFeatures(self, mod)
+    saveDataManagerSetGlobal(nil)
+    setLogFunctionsGlobal(nil)
+    enableExtraConsoleCommands(nil, mod)
+    enableFastReset(nil)
+    removeFadeIn(nil)
+end
+return ____exports