isaacscript-common 6.10.2 → 6.11.2

package/dist/features/customGridEntity.lua

@@ -3,9 +3,12 @@ local Map = ____lualib.Map
 local __TS__New = ____lualib.__TS__New
 local __TS__Iterator = ____lualib.__TS__Iterator
 local ____exports = {}
-local postNewRoomReordered, v
+local preUseItemWeNeedToGoDeeper, postNewRoomReordered, v
 local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local CollectibleType = ____isaac_2Dtypescript_2Ddefinitions.CollectibleType
+local GridCollisionClass = ____isaac_2Dtypescript_2Ddefinitions.GridCollisionClass
 local GridEntityType = ____isaac_2Dtypescript_2Ddefinitions.GridEntityType
+local ModCallback = ____isaac_2Dtypescript_2Ddefinitions.ModCallback
 local ____cachedClasses = require("cachedClasses")
 local game = ____cachedClasses.game
 local ____DefaultMap = require("classes.DefaultMap")
@@ -23,8 +26,45 @@ local ____roomData = require("functions.roomData")
 local getRoomListIndex = ____roomData.getRoomListIndex
 local ____vector = require("functions.vector")
 local isVector = ____vector.isVector
+local ____runInNFrames = require("features.runInNFrames")
+local runNextGameFrame = ____runInNFrames.runNextGameFrame
 local ____exports = require("features.saveDataManager.exports")
 local saveDataManager = ____exports.saveDataManager
+function preUseItemWeNeedToGoDeeper(self, _collectibleType, _rng, player, _useFlags, _activeSlot, _customVarData)
+    local room = game:GetRoom()
+    local roomListIndex = getRoomListIndex(nil)
+    local roomCustomGridEntities = v.level.customGridEntities:get(roomListIndex)
+    if roomCustomGridEntities == nil then
+        return nil
+    end
+    local gridIndex = room:GetGridIndex(player.Position)
+    local customGridEntity = roomCustomGridEntities:get(gridIndex)
+    if customGridEntity == nil then
+        return nil
+    end
+    if customGridEntity.gridCollisionClass ~= GridCollisionClass.NONE then
+        return nil
+    end
+    removeGridEntity(nil, customGridEntity.gridIndex, false)
+    local playerPtr = EntityPtr(player)
+    runNextGameFrame(
+        nil,
+        function()
+            local futureEntity = playerPtr.Ref
+            if futureEntity == nil then
+                return
+            end
+            local futurePlayer = futureEntity:ToPlayer()
+            if futurePlayer == nil then
+                return
+            end
+            v.room.manuallyUsingShovel = true
+            futurePlayer:UseActiveItem(CollectibleType.WE_NEED_TO_GO_DEEPER)
+            v.room.manuallyUsingShovel = false
+        end
+    )
+    return true
+end
 function postNewRoomReordered(self)
     local roomListIndex = getRoomListIndex(nil)
     local roomCustomGridEntities = v.level.customGridEntities:get(roomListIndex)
@@ -39,27 +79,34 @@ function postNewRoomReordered(self)
             local decoration = room:GetGridEntity(gridIndex)
             if decoration == nil then
                 roomCustomGridEntities:delete(gridIndex)
-                goto __continue6
+                goto __continue13
             end
             local sprite = decoration:GetSprite()
-            sprite:Load(data.anm2, true)
-            sprite:Play(data.defaultAnimation, true)
+            sprite:Load(data.anm2Path, true)
+            local animationToPlay = data.defaultAnimation == nil and sprite:GetDefaultAnimation() or data.defaultAnimation
+            sprite:Play(animationToPlay, true)
         end
-        ::__continue6::
+        ::__continue13::
     end
 end
 local FEATURE_NAME = "customGridEntity"
-v = {level = {customGridEntities = __TS__New(
-    DefaultMap,
-    function() return __TS__New(Map) end
-)}}
+v = {
+    level = {customGridEntities = __TS__New(
+        DefaultMap,
+        function() return __TS__New(Map) end
+    )},
+    room = {manuallyUsingShovel = false}
+}
 ---
 -- @internal
 function ____exports.customGridEntityInit(self, mod)
     saveDataManager(nil, FEATURE_NAME, v)
+    mod:AddCallback(ModCallback.PRE_USE_ITEM, preUseItemWeNeedToGoDeeper, CollectibleType.WE_NEED_TO_GO_DEEPER)
     mod:AddCallbackCustom(ModCallbackCustom.POST_NEW_ROOM_REORDERED, postNewRoomReordered)
 end
---- Helper function to spawn a custom grid entity.
+--- Helper function to spawn a custom grid entity. Custom grid entities are persistent in that they
+-- will reappear if the player leaves and re-enters the room. (It will be manually respawned in the
+-- `POST_NEW_ROOM` callback.)
 -- 
 -- This is an IsaacScript feature because the vanilla game does not support any custom grid
 -- entities. Under the hood, IsaacScript accomplishes this by using decorations with an arbitrary
@@ -76,11 +123,12 @@ end
 -- @param gridIndexOrPosition The grid index or position in the room that you want to spawn the grid
 -- entity at. If a position is specified, the closest grid index will be
 -- used.
--- @param anm2 The path to the ANM2 file to use for the sprite.
--- @param defaultAnimation The name of the animation to play after the sprite is initialized and
--- after the player re-enters a room with this grid entity in it.
 -- @param gridCollisionClass The collision class that you want the custom grid entity to have.
-function ____exports.spawnCustomGrid(self, gridEntityTypeCustom, gridIndexOrPosition, anm2, defaultAnimation, gridCollisionClass)
+-- @param anm2Path The path to the ANM2 file to use for the sprite.
+-- @param defaultAnimation Optional. The name of the animation to play after the sprite is
+-- initialized and after the player re-enters a room with this grid entity
+-- in it. If not specified, the default animation in the anm2 will be used.
+function ____exports.spawnCustomGridEntity(self, gridEntityTypeCustom, gridIndexOrPosition, gridCollisionClass, anm2Path, defaultAnimation)
     errorIfFeaturesNotInitialized(nil, FEATURE_NAME)
     local room = game:GetRoom()
     local roomListIndex = getRoomListIndex(nil)
@@ -92,13 +140,14 @@ function ____exports.spawnCustomGrid(self, gridEntityTypeCustom, gridIndexOrPosi
         error("Failed to spawn a decoration for a custom grid entity.")
     end
     local sprite = decoration:GetSprite()
-    sprite:Load(anm2, true)
-    sprite:Play(defaultAnimation, true)
+    sprite:Load(anm2Path, true)
+    local animationToPlay = defaultAnimation == nil and sprite:GetDefaultAnimation() or defaultAnimation
+    sprite:Play(animationToPlay, true)
     local customGridEntityData = {
         gridEntityTypeCustom = gridEntityTypeCustom,
         roomListIndex = roomListIndex,
         gridIndex = gridIndex,
-        anm2 = anm2,
+        anm2Path = anm2Path,
         defaultAnimation = defaultAnimation,
         gridCollisionClass = gridCollisionClass
     }

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,EAEL,UAAU,EAOX,MAAM,8BAA8B,CAAC;AAsBtC;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,UAAQ,GAAG,IAAI,CA+GlE;AAUD,wBAAgB,mBAAmB,IAAI,IAAI,CAQ1C;AAED;;;;;;;;;;;;;;;;;;;;;;;;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,EAMX,MAAM,8BAA8B,CAAC;AAoBtC;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,UAAQ,GAAG,IAAI,CAwGlE;AAED,wBAAgB,mBAAmB,IAAI,IAAI,CAQ1C;AAED;;;;;;;;;;;;;;;;;;;;;;;;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"}

package/dist/features/customStage/exports.lua

@@ -1,13 +1,10 @@
 local ____lualib = require("lualib_bundle")
 local Map = ____lualib.Map
 local ____exports = {}
-local postRoomTransition
 local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
-local Direction = ____isaac_2Dtypescript_2Ddefinitions.Direction
 local GridRoom = ____isaac_2Dtypescript_2Ddefinitions.GridRoom
 local LevelStage = ____isaac_2Dtypescript_2Ddefinitions.LevelStage
 local RoomShape = ____isaac_2Dtypescript_2Ddefinitions.RoomShape
-local RoomTransitionAnim = ____isaac_2Dtypescript_2Ddefinitions.RoomTransitionAnim
 local RoomType = ____isaac_2Dtypescript_2Ddefinitions.RoomType
 local StageType = ____isaac_2Dtypescript_2Ddefinitions.StageType
 local ____cachedClasses = require("cachedClasses")
@@ -19,8 +16,6 @@ local getEntityIDFromConstituents = ____entities.getEntityIDFromConstituents
 local ____log = require("functions.log")
 local log = ____log.log
 local logError = ____log.logError
-local ____playerCenter = require("functions.playerCenter")
-local movePlayersToCenter = ____playerCenter.movePlayersToCenter
 local ____rng = require("functions.rng")
 local newRNG = ____rng.newRNG
 local ____roomData = require("functions.roomData")
@@ -30,8 +25,6 @@ local getRooms = ____rooms.getRooms
 local ____stage = require("functions.stage")
 local getGotoCommand = ____stage.getGotoCommand
 local setStage = ____stage.setStage
-local ____runNextRoom = require("features.runNextRoom")
-local runNextRoom = ____runNextRoom.runNextRoom
 local ____customStageUtils = require("features.customStage.customStageUtils")
 local getRandomCustomStageRoom = ____customStageUtils.getRandomCustomStageRoom
 local ____streakText = require("features.customStage.streakText")
@@ -41,10 +34,6 @@ local v = ____v.default
 local customBossPNGPaths = ____v.customBossPNGPaths
 local customStageCachedRoomData = ____v.customStageCachedRoomData
 local customStagesMap = ____v.customStagesMap
-function postRoomTransition(self)
-    movePlayersToCenter(nil)
-    topStreakTextStart(nil)
-end
 local DEFAULT_BASE_STAGE = LevelStage.BASEMENT_2
 local DEFAULT_BASE_STAGE_TYPE = StageType.ORIGINAL
 --- Helper function to warp to a custom stage/level.
@@ -116,8 +105,6 @@ function ____exports.setCustomStage(self, name, verbose)
     local stageType = StageType.WRATH_OF_THE_LAMB
     level:SetStage(stage, stageType)
     reorderedCallbacksSetStage(nil, stage, stageType)
-    game:StartRoomTransition(startingRoomGridIndex, Direction.NO_DIRECTION, RoomTransitionAnim.FADE)
-    runNextRoom(nil, postRoomTransition)
 end
 function ____exports.setCustomStageDebug(self)
     local customStage = v.run.currentCustomStage

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

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/features/customStage/init.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AA8BxD,wBAAgB,eAAe,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAoBtD"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/features/customStage/init.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAiCxD,wBAAgB,eAAe,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CA4BtD"}

package/dist/features/customStage/init.lua

@@ -3,14 +3,18 @@ local Map = ____lualib.Map
 local __TS__ObjectAssign = ____lualib.__TS__ObjectAssign
 local __TS__New = ____lualib.__TS__New
 local ____exports = {}
-local initRoomTypeMaps, getRoomTypeMap, postRender, postGameStarted, getShaderParams, postGridEntityBrokenRockAlt, postGridEntityBrokenInit, postNewRoomReordered
+local initRoomTypeMaps, getRoomTypeMap, postRender, postCurseEval, postGameStarted, getShaderParams, postGridEntityBrokenRockAlt, postGridEntityBrokenInit, postNewRoomReordered
 local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
 local GridEntityType = ____isaac_2Dtypescript_2Ddefinitions.GridEntityType
+local LevelCurse = ____isaac_2Dtypescript_2Ddefinitions.LevelCurse
 local ModCallback = ____isaac_2Dtypescript_2Ddefinitions.ModCallback
 local ____ModCallbackCustom = require("enums.ModCallbackCustom")
 local ModCallbackCustom = ____ModCallbackCustom.ModCallbackCustom
 local ____array = require("functions.array")
 local isArray = ____array.isArray
+local ____flag = require("functions.flag")
+local hasFlag = ____flag.hasFlag
+local removeFlag = ____flag.removeFlag
 local ____exports = require("features.saveDataManager.exports")
 local saveDataManager = ____exports.saveDataManager
 local ____backdrop = require("features.customStage.backdrop")
@@ -26,6 +30,7 @@ local ____shadows = require("features.customStage.shadows")
 local setShadows = ____shadows.setShadows
 local ____streakText = require("features.customStage.streakText")
 local streakTextGetShaderParams = ____streakText.streakTextGetShaderParams
+local streakTextInit = ____streakText.streakTextInit
 local streakTextPostGameStarted = ____streakText.streakTextPostGameStarted
 local streakTextPostRender = ____streakText.streakTextPostRender
 local ____v = require("features.customStage.v")
@@ -33,6 +38,7 @@ local v = ____v.default
 local customStagesMap = ____v.customStagesMap
 local ____versusScreen = require("features.customStage.versusScreen")
 local playVersusScreenAnimation = ____versusScreen.playVersusScreenAnimation
+local versusScreenInit = ____versusScreen.versusScreenInit
 local versusScreenPostRender = ____versusScreen.versusScreenPostRender
 function initRoomTypeMaps(self)
     if not isArray(nil, metadataJSON) then
@@ -78,6 +84,16 @@ function postRender(self)
     streakTextPostRender(nil)
     versusScreenPostRender(nil)
 end
+function postCurseEval(self, curses)
+    local customStage = v.run.currentCustomStage
+    if customStage == nil then
+        return nil
+    end
+    if hasFlag(nil, curses, LevelCurse.MAZE) then
+        return removeFlag(nil, curses, LevelCurse.MAZE)
+    end
+    return nil
+end
 function postGameStarted(self)
     streakTextPostGameStarted(nil)
 end
@@ -116,9 +132,15 @@ function postNewRoomReordered(self)
     playVersusScreenAnimation(nil, customStage)
 end
 function ____exports.customStageInit(self, mod)
-    saveDataManager(nil, "customStage", v)
     initRoomTypeMaps(nil)
+    if customStagesMap.size == 0 then
+        return
+    end
+    saveDataManager(nil, "customStage", v)
+    streakTextInit(nil)
+    versusScreenInit(nil)
     mod:AddCallback(ModCallback.POST_RENDER, postRender)
+    mod:AddCallback(ModCallback.POST_CURSE_EVAL, postCurseEval)
     mod:AddCallback(ModCallback.POST_GAME_STARTED, postGameStarted)
     mod:AddCallback(ModCallback.GET_SHADER_PARAMS, getShaderParams)
     mod:AddCallbackCustom(ModCallbackCustom.POST_GRID_ENTITY_BROKEN, postGridEntityBrokenRockAlt, GridEntityType.ROCK_ALT)

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

@@ -1,4 +1,10 @@
 import { CustomStage } from "../../interfaces/CustomStage";
+/**
+ * We must load the sprites in an init function to prevent issues with mods that replace the vanilla
+ * files. (For some reason, loading the sprites will cause the overwrite to no longer apply on the
+ * second and subsequent runs.)
+ */
+export declare function streakTextInit(): void;
 export declare function streakTextPostRender(): void;
 export declare function streakTextPostGameStarted(): void;
 export declare function streakTextGetShaderParams(customStage: CustomStage, shaderName: string): void;

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

@@ -1 +1 @@
-{"version":3,"file":"streakText.d.ts","sourceRoot":"","sources":["../../../src/features/customStage/streakText.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AA+F3D,wBAAgB,oBAAoB,IAAI,IAAI,CAS3C;AAmFD,wBAAgB,yBAAyB,IAAI,IAAI,CAGhD;AAGD,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,MAAM,GACjB,IAAI,CAYN;AAiFD,wBAAgB,kBAAkB,IAAI,IAAI,CAUzC"}
+{"version":3,"file":"streakText.d.ts","sourceRoot":"","sources":["../../../src/features/customStage/streakText.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AA0F3D;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAMrC;AAGD,wBAAgB,oBAAoB,IAAI,IAAI,CAS3C;AAmFD,wBAAgB,yBAAyB,IAAI,IAAI,CAGhD;AAGD,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,MAAM,GACjB,IAAI,CAYN;AAgFD,wBAAgB,kBAAkB,IAAI,IAAI,CAUzC"}

package/dist/features/customStage/streakText.lua

@@ -88,9 +88,9 @@ function renderSprite(self, customStage, sprite, position)
     local adjustment = 0
     local scale = VectorOne
     repeat
-        local ____switch26 = animation
-        local ____cond26 = ____switch26 == UIStreakAnimation.TEXT
-        if ____cond26 then
+        local ____switch27 = animation
+        local ____cond27 = ____switch27 == UIStreakAnimation.TEXT
+        if ____cond27 then
             do
                 if frame < TEXT_STAY_FRAME then
                     adjustment = TEXT_IN_ADJUSTMENTS[frame + 1] or 0
@@ -103,16 +103,16 @@ function renderSprite(self, customStage, sprite, position)
                 break
             end
         end
-        ____cond26 = ____cond26 or ____switch26 == UIStreakAnimation.TEXT_IN
-        if ____cond26 then
+        ____cond27 = ____cond27 or ____switch27 == UIStreakAnimation.TEXT_IN
+        if ____cond27 then
             do
                 adjustment = TEXT_IN_ADJUSTMENTS[frame + 1] or 0
                 scale = TEXT_IN_SCALES[frame + 1] or VectorOne
                 break
             end
         end
-        ____cond26 = ____cond26 or ____switch26 == UIStreakAnimation.TEXT_OUT
-        if ____cond26 then
+        ____cond27 = ____cond27 or ____switch27 == UIStreakAnimation.TEXT_OUT
+        if ____cond27 then
             do
                 adjustment = TEXT_OUT_ADJUSTMENTS[frame + 1] or 0
                 scale = TEXT_OUT_SCALES[frame + 1] or VectorOne
@@ -127,7 +127,6 @@ function renderSprite(self, customStage, sprite, position)
     until true
     local adjustedX = centeredX + adjustment
     local adjustedY = position.Y + STREAK_TEXT_BOTTOM_Y_OFFSET
-    sprite:RenderLayer(0, position)
     font:DrawStringScaled(
         name,
         adjustedX,
@@ -203,11 +202,16 @@ TEXT_OUT_SCALES = {
     Vector(3, 0.2)
 }
 topStreakSprite = Sprite()
-topStreakSprite:Load("resources/gfx/ui/ui_streak.anm2", false)
-topStreakSprite.PlaybackSpeed = TEXT_PLAYBACK_SPEED
 bottomStreakSprite = Sprite()
-bottomStreakSprite:Load("resources/gfx/ui/ui_streak.anm2", false)
-bottomStreakSprite.PlaybackSpeed = TEXT_PLAYBACK_SPEED
+--- We must load the sprites in an init function to prevent issues with mods that replace the vanilla
+-- files. (For some reason, loading the sprites will cause the overwrite to no longer apply on the
+-- second and subsequent runs.)
+function ____exports.streakTextInit(self)
+    topStreakSprite:Load("resources/gfx/ui/ui_streak.anm2", false)
+    topStreakSprite.PlaybackSpeed = TEXT_PLAYBACK_SPEED
+    bottomStreakSprite:Load("resources/gfx/ui/ui_streak.anm2", false)
+    bottomStreakSprite.PlaybackSpeed = TEXT_PLAYBACK_SPEED
+end
 function ____exports.streakTextPostRender(self)
     checkEndTopStreakText(nil)
     trackMapInputPressed(nil)

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

@@ -1,4 +1,10 @@
 import { CustomStage } from "../../interfaces/CustomStage";
+/**
+ * We must load the sprites in an init function to prevent issues with mods that replace the vanilla
+ * files. (For some reason, loading the sprites will cause the overwrite to no longer apply on the
+ * second and subsequent runs.)
+ */
+export declare function versusScreenInit(): void;
 export declare function playVersusScreenAnimation(customStage: CustomStage): void;
 export declare function versusScreenPostRender(): void;
 //# sourceMappingURL=versusScreen.d.ts.map

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;AAiF3D,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":"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"}

package/dist/features/customStage/versusScreen.lua

@@ -107,17 +107,22 @@ PNG_PATH_PREFIX = "gfx/ui/boss"
 PLAYER_PORTRAIT_PNG_PATH_PREFIX = "gfx/ui/stage"
 local VANILLA_VERSUS_PLAYBACK_SPEED = 0.5
 local versusScreenSprite = Sprite()
-versusScreenSprite:Load("gfx/ui/boss/versusscreen.anm2", false)
-versusScreenSprite:ReplaceSpritesheet(OVERLAY_ANM2_LAYER, ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH .. "/overlay.png")
-versusScreenSprite:LoadGraphics()
 --- Unfortunately, we must split the background layer into an entirely different sprite so that we
 -- can color it with the `Color` property.
 local versusScreenBackgroundSprite = Sprite()
-versusScreenBackgroundSprite:Load("gfx/ui/boss/versusscreen.anm2", true)
 --- Unfortunately, we must split the dirt layer into an entirely different sprite so that we can
 -- color it with the `Color` property.
 local versusScreenDirtSpotSprite = Sprite()
-versusScreenDirtSpotSprite:Load("gfx/ui/boss/versusscreen.anm2", true)
+--- We must load the sprites in an init function to prevent issues with mods that replace the vanilla
+-- files. (For some reason, loading the sprites will cause the overwrite to no longer apply on the
+-- second and subsequent runs.)
+function ____exports.versusScreenInit(self)
+    versusScreenSprite:Load("gfx/ui/boss/versusscreen.anm2", false)
+    versusScreenSprite:ReplaceSpritesheet(OVERLAY_ANM2_LAYER, ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH .. "/overlay.png")
+    versusScreenSprite:LoadGraphics()
+    versusScreenBackgroundSprite:Load("gfx/ui/boss/versusscreen.anm2", true)
+    versusScreenDirtSpotSprite:Load("gfx/ui/boss/versusscreen.anm2", true)
+end
 function ____exports.playVersusScreenAnimation(self, customStage)
     local room = game:GetRoom()
     local roomType = room:GetType()

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

@@ -0,0 +1,2 @@
+export declare function drawBlackSprite(): void;
+//# sourceMappingURL=blackSprite.d.ts.map

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

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

package/dist/features/customTrapdoor/blackSprite.lua

@@ -0,0 +1,19 @@
+local ____exports = {}
+local ____constants = require("constants")
+local VectorZero = ____constants.VectorZero
+local ____StageTravelState = require("enums.private.StageTravelState")
+local StageTravelState = ____StageTravelState.StageTravelState
+local ____customStageConstants = require("features.customStage.customStageConstants")
+local ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH = ____customStageConstants.ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH
+local ____v = require("features.customTrapdoor.v")
+local v = ____v.default
+local sprite = Sprite()
+sprite:Load(ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH .. "/black.anm2", true)
+sprite:SetFrame("Default", 0)
+function ____exports.drawBlackSprite(self)
+    if v.run.state ~= StageTravelState.PAUSING_ON_BLACK then
+        return
+    end
+    sprite:RenderLayer(0, VectorZero)
+end
+return ____exports

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

@@ -0,0 +1,15 @@
+import { GridEntityType } from "isaac-typescript-definitions";
+export declare const CUSTOM_TRAPDOOR_FEATURE_NAME = "customTrapdoor";
+export declare const GridEntityTypeCustom: {
+    readonly TRAPDOOR_CUSTOM: GridEntityType;
+};
+/** This also applies to crawl spaces. The value was determined through trial and error. */
+export declare const TRAPDOOR_OPEN_DISTANCE = 60;
+export declare const TRAPDOOR_OPEN_DISTANCE_AFTER_BOSS: number;
+export declare const TRAPDOOR_BOSS_REACTION_FRAMES = 30;
+export declare const TRAPDOOR_TOUCH_DISTANCE = 16.5;
+export declare const ANIMATIONS_THAT_PREVENT_STAGE_TRAVEL: ReadonlySet<string>;
+export declare const PIXELATION_TO_BLACK_FRAMES = 52;
+export declare const OTHER_PLAYER_TRAPDOOR_JUMP_DELAY_GAME_FRAMES = 10;
+export declare const OTHER_PLAYER_TRAPDOOR_JUMP_DURATION_GAME_FRAMES = 8;
+//# sourceMappingURL=customTrapdoorConstants.d.ts.map

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

@@ -0,0 +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,KAAK,CAAC;AAC/D,eAAO,MAAM,+CAA+C,IAAI,CAAC"}

package/dist/features/customTrapdoor/customTrapdoorConstants.lua

@@ -0,0 +1,16 @@
+local ____lualib = require("lualib_bundle")
+local Set = ____lualib.Set
+local __TS__New = ____lualib.__TS__New
+local ____exports = {}
+____exports.CUSTOM_TRAPDOOR_FEATURE_NAME = "customTrapdoor"
+____exports.GridEntityTypeCustom = {TRAPDOOR_CUSTOM = 1000}
+--- This also applies to crawl spaces. The value was determined through trial and error.
+____exports.TRAPDOOR_OPEN_DISTANCE = 60
+____exports.TRAPDOOR_OPEN_DISTANCE_AFTER_BOSS = ____exports.TRAPDOOR_OPEN_DISTANCE * 2.5
+____exports.TRAPDOOR_BOSS_REACTION_FRAMES = 30
+____exports.TRAPDOOR_TOUCH_DISTANCE = 16.5
+____exports.ANIMATIONS_THAT_PREVENT_STAGE_TRAVEL = __TS__New(Set, {"Happy", "Sad", "Jump"})
+____exports.PIXELATION_TO_BLACK_FRAMES = 52
+____exports.OTHER_PLAYER_TRAPDOOR_JUMP_DELAY_GAME_FRAMES = 10
+____exports.OTHER_PLAYER_TRAPDOOR_JUMP_DURATION_GAME_FRAMES = 8
+return ____exports

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

@@ -0,0 +1,29 @@
+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:
+ *
+ * - custom destination (or custom logic for after the player enters)
+ * - custom graphics
+ * - custom logic for opening/closing
+ * - TODO: player jumping animation?
+ *
+ * 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 tuple containing the stage and stage type, or a
+ *                    string containing the name of a custom stage. If not specified at all, then
+ *                    the "normal" destination corresponding to the current stage and room will be
+ *                    used (e.g. the next floor).
+ * @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] | string, anm2Path?: string, spawnOpen?: boolean): GridEntity;
+//# sourceMappingURL=exports.d.ts.map

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

@@ -0,0 +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;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,mBAAmB,CACjC,mBAAmB,EAAE,GAAG,GAAG,MAAM,EACjC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,CAAC,GAAG,MAAM,EAChE,QAAQ,SAAmC,EAC3C,SAAS,CAAC,EAAE,OAAO,GAClB,UAAU,CAwCZ"}

package/dist/features/customTrapdoor/exports.lua

@@ -0,0 +1,93 @@
+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("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:
+-- 
+-- - custom destination (or custom logic for after the player enters)
+-- - custom graphics
+-- - custom logic for opening/closing
+-- - TODO: player jumping animation?
+-- 
+-- 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 tuple containing the stage and stage type, or a
+-- string containing the name of a custom stage. If not specified at all, then
+-- the "normal" destination corresponding to the current stage and room will be
+-- used (e.g. the next floor).
+-- @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)
+    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(
+        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 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
+    return gridEntity
+end
+return ____exports

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

@@ -0,0 +1,3 @@
+import { ModUpgraded } from "../../classes/ModUpgraded";
+export declare function customTrapdoorInit(mod: ModUpgraded): void;
+//# sourceMappingURL=init.d.ts.map

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

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