isaacscript-common 6.5.0 → 6.5.1

package/features/customStage/backdrop.lua

@@ -2,7 +2,7 @@ local ____lualib = require("lualib_bundle")
 local Set = ____lualib.Set
 local __TS__New = ____lualib.__TS__New
 local ____exports = {}
-local getBackdropPNGPath, spawnWallEntity, spawnSecondWallEntity, spawnFloorEntity, getNumFloorLayers, BackdropKind, BackdropEntitySubType, DEFAULT_BACKDROP, ROOM_SHAPE_WALL_ANM2_LAYERS, ROOM_SHAPE_WALL_EXTRA_ANM2_LAYERS, WALL_OFFSET, BACKDROP_EFFECT_VARIANT
+local getBackdropPNGPath, spawnWallEntity, spawnSecondWallEntity, spawnFloorEntity, getNumFloorLayers, BackdropKind, DEFAULT_BACKDROP, ROOM_SHAPE_WALL_ANM2_LAYERS, ROOM_SHAPE_WALL_EXTRA_ANM2_LAYERS, WALL_OFFSET, BACKDROP_EFFECT_VARIANT
 local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
 local EffectVariant = ____isaac_2Dtypescript_2Ddefinitions.EffectVariant
 local EntityFlag = ____isaac_2Dtypescript_2Ddefinitions.EntityFlag
@@ -29,19 +29,17 @@ local irange = ____utils.irange
 local ____customStageConstants = require("features.customStage.customStageConstants")
 local ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH = ____customStageConstants.ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH
 function getBackdropPNGPath(self, customStage, backdropKind, rng)
-    local backdrop = customStage.backdrop == nil and DEFAULT_BACKDROP or customStage.backdrop
+    local backdrop = customStage.backdropPNGPaths == nil and DEFAULT_BACKDROP or customStage.backdropPNGPaths
     local pathArray = backdrop[backdropKind]
-    local path = getRandomArrayElement(nil, pathArray, rng)
-    return (backdrop.prefix .. path) .. backdrop.suffix
+    return getRandomArrayElement(nil, pathArray, rng)
 end
 function spawnWallEntity(self, customStage, rng, isExtraWall)
     local room = game:GetRoom()
     local roomShape = room:GetRoomShape()
-    local subType = isExtraWall and BackdropEntitySubType.WALL_EXTRA or BackdropEntitySubType.WALL
     local wallEffect = spawnEffectWithSeed(
         nil,
         BACKDROP_EFFECT_VARIANT,
-        subType,
+        0,
         VectorZero,
         1
     )
@@ -86,7 +84,7 @@ function spawnFloorEntity(self, customStage, rng)
     local floorEffect = spawnEffectWithSeed(
         nil,
         BACKDROP_EFFECT_VARIANT,
-        BackdropEntitySubType.FLOOR,
+        0,
         VectorZero,
         1
     )
@@ -154,23 +152,7 @@ BackdropKind.N_FLOOR = "nFloors"
 BackdropKind.L_FLOOR = "lFloors"
 BackdropKind.WALL = "walls"
 BackdropKind.CORNER = "corners"
-BackdropEntitySubType = BackdropEntitySubType or ({})
-BackdropEntitySubType.VANILLA_LADDER = 0
-BackdropEntitySubType[BackdropEntitySubType.VANILLA_LADDER] = "VANILLA_LADDER"
-BackdropEntitySubType.WALL = 1
-BackdropEntitySubType[BackdropEntitySubType.WALL] = "WALL"
-BackdropEntitySubType.WALL_EXTRA = 2
-BackdropEntitySubType[BackdropEntitySubType.WALL_EXTRA] = "WALL_EXTRA"
-BackdropEntitySubType.FLOOR = 3
-BackdropEntitySubType[BackdropEntitySubType.FLOOR] = "FLOOR"
-DEFAULT_BACKDROP = {
-    prefix = ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH .. "/backdrop",
-    suffix = ".png",
-    nFloors = {"nfloor"},
-    lFloors = {"lfloor"},
-    walls = {"wall"},
-    corners = {"corner"}
-}
+DEFAULT_BACKDROP = {nFloors = {ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH .. "/backdrop/nfloor.png"}, lFloors = {ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH .. "/backdrop/lfloor.png"}, walls = {ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH .. "/backdrop/wall.png"}, corners = {ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH .. "/backdrop/corner.png"}}
 ROOM_SHAPE_WALL_ANM2_LAYERS = {
     [RoomShape.SHAPE_1x1] = 44,
     [RoomShape.IH] = 36,

package/features/customStage/init.lua

@@ -3,10 +3,12 @@ local Map = ____lualib.Map
 local __TS__ObjectAssign = ____lualib.__TS__ObjectAssign
 local __TS__New = ____lualib.__TS__New
 local ____exports = {}
-local initRoomTypeMaps, getRoomTypeMap, postRender, postGridEntityBrokenRockAlt, postGridEntityBrokenInit, postNewRoomReordered
+local initRoomTypeMaps, getRoomTypeMap, postRender, getShaderParams, postGridEntityBrokenRockAlt, postGridEntityBrokenInit, postNewRoomReordered
 local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
 local GridEntityType = ____isaac_2Dtypescript_2Ddefinitions.GridEntityType
 local ModCallback = ____isaac_2Dtypescript_2Ddefinitions.ModCallback
+local ____cachedClasses = require("cachedClasses")
+local game = ____cachedClasses.game
 local ____ModCallbackCustom = require("enums.ModCallbackCustom")
 local ModCallbackCustom = ____ModCallbackCustom.ModCallbackCustom
 local ____array = require("functions.array")
@@ -22,7 +24,11 @@ local setCustomDoorGraphics = ____gridEntities.setCustomDoorGraphics
 local setCustomPitGraphics = ____gridEntities.setCustomPitGraphics
 local setCustomRockGraphics = ____gridEntities.setCustomRockGraphics
 local metadataJSON = require("features.customStage.metadata")
+local ____shadows = require("features.customStage.shadows")
+local setShadows = ____shadows.setShadows
+local shadowsPostRender = ____shadows.shadowsPostRender
 local ____streakText = require("features.customStage.streakText")
+local streakTextGetShaderParams = ____streakText.streakTextGetShaderParams
 local streakTextPostRender = ____streakText.streakTextPostRender
 local ____v = require("features.customStage.v")
 local v = ____v.default
@@ -71,9 +77,17 @@ function postRender(self)
     if customStage == nil then
         return
     end
+    local isPaused = game:IsPaused()
+    if isPaused then
+        return
+    end
     streakTextPostRender(nil, customStage)
+    shadowsPostRender(nil, customStage)
     versusScreenPostRender(nil)
 end
+function getShaderParams(self, shaderName)
+    return streakTextGetShaderParams(nil, shaderName)
+end
 function postGridEntityBrokenRockAlt(self, gridEntity)
     local customStage = v.run.currentCustomStage
     if customStage == nil then
@@ -97,12 +111,14 @@ function postNewRoomReordered(self)
         return
     end
     setBackdrop(nil, customStage)
+    setShadows(nil, customStage)
     playVersusScreenAnimation(nil, customStage)
 end
 function ____exports.customStageInit(self, mod)
     saveDataManager(nil, "customStage", v)
     initRoomTypeMaps(nil)
     mod:AddCallback(ModCallback.POST_RENDER, postRender)
+    mod:AddCallback(ModCallback.GET_SHADER_PARAMS, getShaderParams)
     mod:AddCallbackCustom(ModCallbackCustom.POST_GRID_ENTITY_BROKEN, postGridEntityBrokenRockAlt, GridEntityType.ROCK_ALT)
     mod:AddCallbackCustom(ModCallbackCustom.POST_GRID_ENTITY_INIT, postGridEntityBrokenInit)
     mod:AddCallbackCustom(ModCallbackCustom.POST_NEW_ROOM_REORDERED, postNewRoomReordered)

package/features/customStage/shadows.d.ts

@@ -0,0 +1,3 @@
+import { CustomStage } from "../../interfaces/CustomStage";
+export declare function setShadows(customStage: CustomStage): void;
+export declare function shadowsPostRender(_customStage: CustomStage): void;

package/features/customStage/shadows.lua

@@ -0,0 +1,58 @@
+local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local RoomShape = ____isaac_2Dtypescript_2Ddefinitions.RoomShape
+local ____cachedClasses = require("cachedClasses")
+local game = ____cachedClasses.game
+local ____constants = require("constants")
+local VectorZero = ____constants.VectorZero
+local ____array = require("functions.array")
+local getRandomArrayElement = ____array.getRandomArrayElement
+local ____customStageConstants = require("features.customStage.customStageConstants")
+local ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH = ____customStageConstants.ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH
+local ____v = require("features.customStage.v")
+local v = ____v.default
+--- The animation comes from StageAPI.
+local ROOM_SHAPE_TO_SHADOW_ANIMATION = {
+    [RoomShape.SHAPE_1x1] = "1x1",
+    [RoomShape.IH] = "1x1",
+    [RoomShape.IV] = "1x1",
+    [RoomShape.SHAPE_1x2] = "1x2",
+    [RoomShape.IIV] = "1x2",
+    [RoomShape.SHAPE_2x1] = "2x1",
+    [RoomShape.IIH] = "2x1",
+    [RoomShape.SHAPE_2x2] = "2x2",
+    [RoomShape.LTL] = "2x2",
+    [RoomShape.LTR] = "2x2",
+    [RoomShape.LBL] = "2x2",
+    [RoomShape.LBR] = "2x2"
+}
+local shadowSprite = Sprite()
+shadowSprite:Load(ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH .. "/stage-shadow.anm2", true)
+function ____exports.setShadows(self, customStage)
+    if customStage.shadowPNGPaths == nil then
+        return
+    end
+    local room = game:GetRoom()
+    local roomShape = room:GetRoomShape()
+    local animation = ROOM_SHAPE_TO_SHADOW_ANIMATION[roomShape]
+    local shadowPNGPaths = customStage.shadowPNGPaths[animation]
+    if shadowPNGPaths == nil then
+        return
+    end
+    local decorationSeed = room:GetDecorationSeed()
+    local shadowPNGPath = getRandomArrayElement(nil, shadowPNGPaths, decorationSeed)
+    shadowSprite:ReplaceSpritesheet(0, shadowPNGPath)
+    shadowSprite:SetFrame(animation, 0)
+    v.room.showingShadows = true
+end
+function ____exports.shadowsPostRender(self, _customStage)
+    if not v.room.showingShadows then
+        return
+    end
+    local room = game:GetRoom()
+    local renderPosition = Isaac.WorldToRenderPosition(VectorZero)
+    local renderScrollOffset = room:GetRenderScrollOffset()
+    local position = renderPosition + renderScrollOffset
+    shadowSprite:Render(position)
+end
+return ____exports

package/features/customStage/streakText.d.ts

@@ -1,2 +1,3 @@
 import { CustomStage } from "../../interfaces/CustomStage";
 export declare function streakTextPostRender(customStage: CustomStage): void;
+export declare function streakTextGetShaderParams(shaderName: string): Record<string, unknown> | undefined;

package/features/customStage/streakText.lua

@@ -7,6 +7,7 @@ local ____ui = require("functions.ui")
 local getScreenBottomCenterPos = ____ui.getScreenBottomCenterPos
 local ____v = require("features.customStage.v")
 local v = ____v.default
+local EMPTY_SHADER_NAME = "IsaacScriptEmptyShader"
 local STREAK_TEXT_BOTTOM_OFFSET = Vector(0, -60)
 function ____exports.streakTextPostRender(self, customStage)
     if not v.run.showingStreakText then
@@ -19,4 +20,10 @@ function ____exports.streakTextPostRender(self, customStage)
     local adjustedX = position.X - length / 2
     font:DrawString(customStage.name, adjustedX, position.Y, KColorDefault)
 end
+function ____exports.streakTextGetShaderParams(self, shaderName)
+    if shaderName ~= EMPTY_SHADER_NAME then
+        return nil
+    end
+    return {}
+end
 return ____exports

package/features/customStage/v.d.ts

@@ -6,6 +6,9 @@ declare const v: {
         showingStreakText: boolean;
         showingBossVersusScreen: boolean;
     };
+    room: {
+        showingShadows: boolean;
+    };
 };
 export default v;
 /** Indexed by custom stage name. */

package/features/customStage/v.lua

@@ -2,7 +2,7 @@ local ____lualib = require("lualib_bundle")
 local Map = ____lualib.Map
 local __TS__New = ____lualib.__TS__New
 local ____exports = {}
-local v = {run = {currentCustomStage = nil, showingStreakText = false, showingBossVersusScreen = false}}
+local v = {run = {currentCustomStage = nil, showingStreakText = false, showingBossVersusScreen = false}, room = {showingShadows = false}}
 ____exports.default = v
 --- Indexed by custom stage name.
 ____exports.customStagesMap = __TS__New(Map)

package/functions/doors.lua

@@ -82,8 +82,8 @@ end
 -- "gfx/grid/door_08_holeinwall.anm2".
 function ____exports.isSecretRoomDoor(self, door)
     local sprite = door:GetSprite()
-    local filename = sprite:GetFilename()
-    return filename == "gfx/grid/door_08_holeinwall.anm2"
+    local fileName = sprite:GetFilename()
+    return string.lower(fileName) == "gfx/grid/door_08_holeinwall.anm2"
 end
 --- Helper function to remove a single door.
 function ____exports.removeDoor(self, door)
@@ -243,8 +243,8 @@ function ____exports.isDoorToDownpour(self, door)
         return false
     end
     local sprite = door:GetSprite()
-    local filename = sprite:GetFilename()
-    return string.lower(filename) == "gfx/grid/door_downpour.anm2"
+    local fileName = sprite:GetFilename()
+    return string.lower(fileName) == "gfx/grid/door_downpour.anm2"
 end
 --- This refers to the Repentance door that spawns in a boss room after defeating the boss. You have
 -- to spend two hearts to open it. It has a sprite filename of "gfx/grid/door_mausoleum.anm2".
@@ -253,8 +253,8 @@ function ____exports.isDoorToMausoleum(self, door)
         return false
     end
     local sprite = door:GetSprite()
-    local filename = sprite:GetFilename()
-    return string.lower(filename) == "gfx/grid/door_mausoleum.anm2"
+    local fileName = sprite:GetFilename()
+    return string.lower(fileName) == "gfx/grid/door_mausoleum.anm2"
 end
 --- This refers to the "strange door" located on the first room of Depths 2. You open it with either
 -- a Polaroid or a Negative. It has a sprite filename of "gfx/grid/door_mausoleum_alt.anm2".
@@ -263,8 +263,8 @@ function ____exports.isDoorToMausoleumAscent(self, door)
         return false
     end
     local sprite = door:GetSprite()
-    local filename = sprite:GetFilename()
-    return string.lower(filename) == "gfx/grid/door_mausoleum_alt.anm2"
+    local fileName = sprite:GetFilename()
+    return string.lower(fileName) == "gfx/grid/door_mausoleum_alt.anm2"
 end
 --- This refers to the Repentance door that spawns in a boss room after defeating the boss. You have
 -- to spend two bombs to open it. It has a sprite filename of "gfx/grid/door_mines.anm2".
@@ -273,8 +273,8 @@ function ____exports.isDoorToMines(self, door)
         return false
     end
     local sprite = door:GetSprite()
-    local filename = sprite:GetFilename()
-    return string.lower(filename) == "gfx/grid/door_mines.anm2"
+    local fileName = sprite:GetFilename()
+    return string.lower(fileName) == "gfx/grid/door_mines.anm2"
 end
 --- This refers to the Repentance door that spawns after defeating Mom. You open it with the
 -- completed knife. It has a sprite filename of "gfx/grid/door_momsheart.anm2".
@@ -283,8 +283,8 @@ function ____exports.isDoorToMomsHeart(self, door)
         return false
     end
     local sprite = door:GetSprite()
-    local filename = sprite:GetFilename()
-    return filename == "gfx/grid/door_momsheart.anm2"
+    local fileName = sprite:GetFilename()
+    return string.lower(fileName) == "gfx/grid/door_momsheart.anm2"
 end
 function ____exports.isHiddenSecretRoomDoor(self, door)
     local sprite = door:GetSprite()

package/interfaces/CustomStageLua.d.ts

@@ -39,43 +39,33 @@ export declare type CustomStageTSConfig = Readonly<{
      * the graphics for the walls and floor.) If not specified, the graphics for Basement will be
      * used.
      */
-    backdrop?: Readonly<{
+    backdropPNGPaths?: Readonly<{
         /**
-         * The beginning of the path that leads to the backdrop graphics. For example:
+         * An array that contains the full paths to the graphic files that are used for the floor in
+         * narrow rooms. (The "n" stands for "narrow").
          *
-         * ```sh
-         * gfx/backdrop/revelations/revelations_
-         * ```
-         */
-        prefix: string;
-        /**
-         * The end of the path that leads to the backdrop graphics. In most cases, this will be ".png".
-         */
-        suffix: string;
-        /**
-         * An array of strings that represent the graphic files that are used for the floors in narrow
-         * rooms. (The "n" stands for "narrow").
-         *
-         * You must have at least one string in this array, but you can specify more than one to
-         * randomly add extra variety (like the vanilla stages do).
+         * You must have at least one path in this array, but you can specify more than one to randomly
+         * add extra variety (like the vanilla stages do).
          *
          * For an example of this, see the vanilla file "resources/gfx/backdrop/01_basement_nfloor.png".
          */
         nFloors: readonly string[];
         /**
-         * An array of strings that represent the graphic files that are used for the floors in L rooms.
+         * An array that contains the full paths to the graphic files that are used for the floor in L
+         * rooms.
          *
-         * You must have at least one string in this array, but you can specify more than one to
-         * randomly add extra variety (like the vanilla stages do).
+         * You must have at least one path in this array, but you can specify more than one to randomly
+         * add extra variety (like the vanilla stages do).
          *
          * For an example of this, see the vanilla file "resources/gfx/backdrop/01_lbasementfloor.png".
          */
         lFloors: readonly string[];
         /**
-         * An array of strings that represent the graphic files for the stage's walls.
+         * An array that contains the full paths to the graphic files that are used for the walls of the
+         * floor.
          *
-         * You must have at least one string in this array, but you can specify more than one to
-         * randomly add extra variety (like the vanilla stages do).
+         * You must have at least one path in this array, but you can specify more than one to randomly
+         * add extra variety (like the vanilla stages do).
          *
          * For an example of this, see the vanilla file "resources/gfx/backdrop/01_basement.png". (In
          * the vanilla file, they concatenate all four variations together into one PNG file. However,
@@ -83,9 +73,10 @@ export declare type CustomStageTSConfig = Readonly<{
          */
         walls: readonly string[];
         /**
-         * An array of strings that represent the graphic files for the stage's corners. You must have
-         * at least one string in this array, but you can specify more than one to randomly add extra
-         * variety (like the vanilla stages do).
+         * An array that contains the full paths to the graphic files for the stage's corners.
+         *
+         * You must have at least one path in this array, but you can specify more than one to randomly
+         * add extra variety (like the vanilla stages do).
          *
          * For an example of this, see the vanilla file "resources/gfx/backdrop/01_basement.png". (In
          * the vanilla file, they concatenate both variations together into one PNG file and put it in
@@ -97,8 +88,8 @@ export declare type CustomStageTSConfig = Readonly<{
         corners: readonly string[];
     }>;
     /**
-     * Optional. The path to the spritesheet that contains the graphics of the decorations for the
-     * floor.
+     * Optional. The full path to the spritesheet that contains the graphics of the decorations for
+     * the floor.
      *
      * If not specified, the vanilla Basement decorations spritesheet will be used. For reference,
      * this is located at: `C:\Program Files (x86)\Steam\steamapps\common\The Binding of Isaac
@@ -106,8 +97,8 @@ export declare type CustomStageTSConfig = Readonly<{
      */
     decorationsPNGPath?: string;
     /**
-     * Optional. The path to the spritesheet that contains the graphics of the rocks/blocks/urns for
-     * the floor.
+     * Optional. The full path to the spritesheet that contains the graphics of the rocks/blocks/urns
+     * for the floor.
      *
      * If specified, it is assumed that you have your own custom rock alt type, and all vanilla
      * rewards/enemies that spawn from urns will be automatically removed. Use the
@@ -120,18 +111,22 @@ export declare type CustomStageTSConfig = Readonly<{
      */
     rocksPNGPath?: string;
     /**
-     * Optional. The path to the spritesheet that contains the graphics of the pits for the floor.
+     * Optional. The full path to the spritesheet that contains the graphics of the pits for the
+     * floor.
      *
      * If not specified, the vanilla Basement pits spritesheet will be used. For reference, this is
      * located at: `C:\Program Files (x86)\Steam\steamapps\common\The Binding of Isaac
      * Rebirth\resources\gfx\grid\grid_pit.png`
      */
     pitsPNGPath?: string;
-    /** Optional. A collection of paths that contain graphics for the doors of the floor. */
+    /**
+     * Optional. A collection of paths that contain graphics for the doors of the floor. If not
+     * specified, the doors for Basement will be used.
+     */
     doorPNGPaths?: Readonly<{
         /**
-         * Optional. The path to the spritesheet that contains the graphics of the normal doors for the
-         * floor.
+         * Optional. The full path to the spritesheet that contains the graphics of the normal doors for
+         * the floor.
          *
          * If not specified, the vanilla Basement door spritesheet will be used. For reference, this is
          * located at: `C:\Program Files (x86)\Steam\steamapps\common\The Binding of Isaac
@@ -139,8 +134,8 @@ export declare type CustomStageTSConfig = Readonly<{
          */
         normal?: string;
         /**
-         * Optional. The path to the spritesheet that contains the graphics of the Treasure Room doors
-         * for the floor.
+         * Optional. The full path to the spritesheet that contains the graphics of the Treasure Room
+         * doors for the floor.
          *
          * If not specified, the vanilla Basement door spritesheet will be used. For reference, this is
          * located at: `C:\Program Files (x86)\Steam\steamapps\common\The Binding of Isaac
@@ -148,8 +143,8 @@ export declare type CustomStageTSConfig = Readonly<{
          */
         treasureRoom?: string;
         /**
-         * Optional. The path to the spritesheet that contains the graphics of the Boss Room doors for
-         * the floor.
+         * Optional. The full path to the spritesheet that contains the graphics of the Boss Room doors
+         * for the floor.
          *
          * If not specified, the vanilla Basement door spritesheet will be used. For reference, this is
          * located at: `C:\Program Files (x86)\Steam\steamapps\common\The Binding of Isaac
@@ -157,8 +152,8 @@ export declare type CustomStageTSConfig = Readonly<{
          */
         bossRoom?: string;
         /**
-         * Optional. The path to the spritesheet that contains the graphics of the Secret Room and Super
-         * Secret Room doors for the floor.
+         * Optional. The full path to the spritesheet that contains the graphics of the Secret Room and
+         * Super Secret Room doors for the floor.
          *
          * If not specified, the vanilla Basement door spritesheet will be used. For reference, this is
          * located at: `C:\Program Files (x86)\Steam\steamapps\common\The Binding of Isaac
@@ -166,8 +161,8 @@ export declare type CustomStageTSConfig = Readonly<{
          */
         secretRoom?: string;
         /**
-         * Optional. The path to the spritesheet that contains the graphics of the arcade doors for the
-         * floor.
+         * Optional. The full path to the spritesheet that contains the graphics of the arcade doors for
+         * the floor.
          *
          * If not specified, the vanilla Basement door spritesheet will be used. For reference, this is
          * located at: `C:\Program Files (x86)\Steam\steamapps\common\The Binding of Isaac
@@ -175,8 +170,8 @@ export declare type CustomStageTSConfig = Readonly<{
          */
         arcade?: string;
         /**
-         * Optional. The path to the spritesheet that contains the graphics of the Curse Room doors for
-         * the floor.
+         * Optional. The full path to the spritesheet that contains the graphics of the Curse Room doors
+         * for the floor.
          *
          * If not specified, the vanilla Basement door spritesheet will be used. For reference, this is
          * located at: `C:\Program Files (x86)\Steam\steamapps\common\The Binding of Isaac
@@ -184,8 +179,8 @@ export declare type CustomStageTSConfig = Readonly<{
          */
         curseRoom?: string;
         /**
-         * Optional. The path to the spritesheet that contains the graphics of the normal Challenge Room
-         * doors for the floor.
+         * Optional. The full path to the spritesheet that contains the graphics of the normal Challenge
+         * Room doors for the floor.
          *
          * If not specified, the vanilla Basement door spritesheet will be used. For reference, this is
          * located at: `C:\Program Files (x86)\Steam\steamapps\common\The Binding of Isaac
@@ -193,8 +188,8 @@ export declare type CustomStageTSConfig = Readonly<{
          */
         normalChallengeRoom?: string;
         /**
-         * Optional. The path to the spritesheet that contains the graphics of the Boss Challenge Room
-         * doors for the floor.
+         * Optional. The full path to the spritesheet that contains the graphics of the Boss Challenge
+         * Room doors for the floor.
          *
          * If not specified, the vanilla Basement door spritesheet will be used. For reference, this is
          * located at: `C:\Program Files (x86)\Steam\steamapps\common\The Binding of Isaac
@@ -202,8 +197,8 @@ export declare type CustomStageTSConfig = Readonly<{
          */
         bossChallengeRoom?: string;
         /**
-         * Optional. The path to the spritesheet that contains the graphics of the Devil Room doors for
-         * the floor.
+         * Optional. The full path to the spritesheet that contains the graphics of the Devil Room doors
+         * for the floor.
          *
          * If not specified, the vanilla Basement door spritesheet will be used. For reference, this is
          * located at: `C:\Program Files (x86)\Steam\steamapps\common\The Binding of Isaac
@@ -211,8 +206,8 @@ export declare type CustomStageTSConfig = Readonly<{
          */
         devilRoom?: string;
         /**
-         * Optional. The path to the spritesheet that contains the graphics of the Angel Room doors for
-         * the floor.
+         * Optional. The full path to the spritesheet that contains the graphics of the Angel Room doors
+         * for the floor.
          *
          * If not specified, the vanilla Basement door spritesheet will be used. For reference, this is
          * located at: `C:\Program Files (x86)\Steam\steamapps\common\The Binding of Isaac
@@ -220,8 +215,8 @@ export declare type CustomStageTSConfig = Readonly<{
          */
         angelRoom?: string;
         /**
-         * Optional. The path to the spritesheet that contains the graphics of the Boss Rush doors for
-         * the floor.
+         * Optional. The full path to the spritesheet that contains the graphics of the Boss Rush doors
+         * for the floor.
          *
          * If not specified, the vanilla Basement door spritesheet will be used. For reference, this is
          * located at: `C:\Program Files (x86)\Steam\steamapps\common\The Binding of Isaac
@@ -229,8 +224,8 @@ export declare type CustomStageTSConfig = Readonly<{
          */
         bossRush?: string;
         /**
-         * Optional. The path to the spritesheet that contains the graphics of the Chest Room doors for
-         * the floor.
+         * Optional. The full path to the spritesheet that contains the graphics of the Chest Room doors
+         * for the floor.
          *
          * If not specified, the vanilla Basement door spritesheet will be used. For reference, this is
          * located at: `C:\Program Files (x86)\Steam\steamapps\common\The Binding of Isaac
@@ -238,6 +233,50 @@ export declare type CustomStageTSConfig = Readonly<{
          */
         chestRoom?: string;
     }>;
+    /**
+     * Optional. A collection of paths that contain graphics for the custom shadows of the floor. (In
+     * this context, "shadows" are the outlines from things on the roof. For example, in Basement, a
+     * shadow of a sideways V is used.) If not specified, no extra shadows will be drawn.
+     */
+    shadowPNGPaths?: Readonly<{
+        /**
+         * An array containing the full paths to the shadows that are used in rooms of shape
+         * `RoomShape.SHAPE_1x1` (1), `RoomShape.IH` (2), and `RoomShape.IV` (3).
+         *
+         * If more than one shadow is specified, one will be randomly chosen for each room.
+         *
+         * If not specified, no extra shadows will be drawn in these room shapes.
+         */
+        "1x1"?: readonly string[];
+        /**
+         * An array containing the full paths to the shadows that are used in rooms of shape
+         * `RoomShape.SHAPE_1x2` (4) and `RoomShape.IIV` (5).
+         *
+         * If more than one shadow is specified, one will be randomly chosen for each room.
+         *
+         * If not specified, no extra shadows will be drawn in these room shapes.
+         */
+        "1x2"?: readonly string[];
+        /**
+         * An array containing the full paths to the shadows that are used in rooms of shape
+         * `RoomShape.SHAPE_2x1` (6) and `RoomShape.IIH` (7).
+         *
+         * If more than one shadow is specified, one will be randomly chosen for each room.
+         *
+         * If not specified, no extra shadows will be drawn in these room shapes.
+         */
+        "2x1"?: readonly string[];
+        /**
+         * An array containing the full paths to the shadows that are used in rooms of shape
+         * `RoomShape.SHAPE_2x2` (8), `RoomShape.LTL` (9), `RoomShape.LTR` (10), `RoomShape.LBL` (11),
+         * and `RoomShape.LBR` (12).
+         *
+         * If more than one shadow is specified, one will be randomly chosen for each room.
+         *
+         * If not specified, no extra shadows will be drawn in these room shapes.
+         */
+        "2x2"?: readonly string[];
+    }>;
     /** Optional. A collection of colors used in the boss "versus" screen. */
     versusScreen?: Readonly<{
         /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacscript-common",
-  "version": "6.5.0",
+  "version": "6.5.1",
   "description": "Helper functions and features for IsaacScript mods.",
   "keywords": [
     "isaac",