isaacscript-common 6.4.0 → 6.6.0

package/enums/DecorationVariant.d.ts

@@ -0,0 +1,9 @@
+export declare enum DecorationVariant {
+    VANILLA_DECORATION = 0,
+    /**
+     * The vanilla game does not support any custom grid entities. Under the hood, IsaacScript allows
+     * for custom grid entities by using decorations with this variant to represent custom grid
+     * entities.
+     */
+    CUSTOM_GRID_ENTITY = 1
+}

package/enums/DecorationVariant.lua

@@ -0,0 +1,7 @@
+local ____exports = {}
+____exports.DecorationVariant = {}
+____exports.DecorationVariant.VANILLA_DECORATION = 0
+____exports.DecorationVariant[____exports.DecorationVariant.VANILLA_DECORATION] = "VANILLA_DECORATION"
+____exports.DecorationVariant.CUSTOM_GRID_ENTITY = 1
+____exports.DecorationVariant[____exports.DecorationVariant.CUSTOM_GRID_ENTITY] = "CUSTOM_GRID_ENTITY"
+return ____exports

package/enums/RockAltType.d.ts

@@ -0,0 +1,7 @@
+export declare enum RockAltType {
+    URN = 0,
+    MUSHROOM = 1,
+    SKULL = 2,
+    POLYP = 3,
+    BUCKET = 4
+}

package/enums/RockAltType.lua

@@ -0,0 +1,13 @@
+local ____exports = {}
+____exports.RockAltType = {}
+____exports.RockAltType.URN = 0
+____exports.RockAltType[____exports.RockAltType.URN] = "URN"
+____exports.RockAltType.MUSHROOM = 1
+____exports.RockAltType[____exports.RockAltType.MUSHROOM] = "MUSHROOM"
+____exports.RockAltType.SKULL = 2
+____exports.RockAltType[____exports.RockAltType.SKULL] = "SKULL"
+____exports.RockAltType.POLYP = 3
+____exports.RockAltType[____exports.RockAltType.POLYP] = "POLYP"
+____exports.RockAltType.BUCKET = 4
+____exports.RockAltType[____exports.RockAltType.BUCKET] = "BUCKET"
+return ____exports

package/features/customGridEntity.d.ts

@@ -3,8 +3,8 @@ import { GridCollisionClass, GridEntityType } from "isaac-typescript-definitions
  * Helper function to spawn a custom grid entity.
  *
  * 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 to represent custom
- * grid entities.
+ * entities. Under the hood, IsaacScript accomplishes this by using decorations with an arbitrary
+ * non-zero variant to represent custom grid entities.
  *
  * Once a custom grid entity is spawned, you can take advantage of the custom grid callbacks such as
  * `POST_GRID_ENTITY_CUSTOM_UPDATE`.

package/features/customGridEntity.lua

@@ -10,13 +10,15 @@ local ____cachedClasses = require("cachedClasses")
 local game = ____cachedClasses.game
 local ____DefaultMap = require("classes.DefaultMap")
 local DefaultMap = ____DefaultMap.DefaultMap
+local ____DecorationVariant = require("enums.DecorationVariant")
+local DecorationVariant = ____DecorationVariant.DecorationVariant
 local ____ModCallbackCustom = require("enums.ModCallbackCustom")
 local ModCallbackCustom = ____ModCallbackCustom.ModCallbackCustom
 local ____featuresInitialized = require("featuresInitialized")
 local errorIfFeaturesNotInitialized = ____featuresInitialized.errorIfFeaturesNotInitialized
 local ____gridEntity = require("functions.gridEntity")
 local removeGrid = ____gridEntity.removeGrid
-local spawnGrid = ____gridEntity.spawnGrid
+local spawnGridWithVariant = ____gridEntity.spawnGridWithVariant
 local ____roomData = require("functions.roomData")
 local getRoomListIndex = ____roomData.getRoomListIndex
 local ____vector = require("functions.vector")
@@ -60,8 +62,8 @@ end
 --- Helper function to spawn a custom grid entity.
 -- 
 -- 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 to represent custom
--- grid entities.
+-- entities. Under the hood, IsaacScript accomplishes this by using decorations with an arbitrary
+-- non-zero variant to represent custom grid entities.
 -- 
 -- Once a custom grid entity is spawned, you can take advantage of the custom grid callbacks such as
 -- `POST_GRID_ENTITY_CUSTOM_UPDATE`.
@@ -84,8 +86,8 @@ function ____exports.spawnCustomGrid(self, gridEntityTypeCustom, gridIndexOrPosi
     local roomListIndex = getRoomListIndex(nil)
     local gridIndex = isVector(nil, gridIndexOrPosition) and room:GetGridIndex(gridIndexOrPosition) or gridIndexOrPosition
     local existingGridEntity = room:GetGridEntity(gridIndex)
-    local isExistingDecoration = existingGridEntity ~= nil and existingGridEntity:GetType() == GridEntityType.DECORATION
-    local decoration = isExistingDecoration and existingGridEntity or spawnGrid(nil, GridEntityType.DECORATION, gridIndexOrPosition)
+    local isExistingDecoration = existingGridEntity ~= nil and existingGridEntity:GetType() == GridEntityType.DECORATION and existingGridEntity:GetVariant() == DecorationVariant.CUSTOM_GRID_ENTITY
+    local decoration = isExistingDecoration and existingGridEntity or spawnGridWithVariant(nil, GridEntityType.DECORATION, DecorationVariant.CUSTOM_GRID_ENTITY, gridIndexOrPosition)
     if decoration == nil then
         error("Failed to spawn a decoration for a custom grid entity.")
     end

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, 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,18 +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 pathArray = customStage.backdrop[backdropKind]
-    local path = getRandomArrayElement(nil, pathArray, rng)
-    return (customStage.backdrop.prefix .. path) .. customStage.backdrop.suffix
+    local backdrop = customStage.backdropPNGPaths == nil and DEFAULT_BACKDROP or customStage.backdropPNGPaths
+    local pathArray = backdrop[backdropKind]
+    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
     )
@@ -85,7 +84,7 @@ function spawnFloorEntity(self, customStage, rng)
     local floorEffect = spawnEffectWithSeed(
         nil,
         BACKDROP_EFFECT_VARIANT,
-        BackdropEntitySubType.FLOOR,
+        0,
         VectorZero,
         1
     )
@@ -153,15 +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 = {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/gridEntities.d.ts

@@ -0,0 +1,18 @@
+/// <reference types="isaac-typescript-definitions" />
+import { CustomStage } from "../../interfaces/CustomStage";
+/** For `GridEntityType.DECORATION` (1) */
+export declare function setCustomDecorationGraphics(customStage: CustomStage, gridEntity: GridEntity): void;
+/** For `GridEntityType.ROCK` (2) */
+export declare function setCustomRockGraphics(customStage: CustomStage, gridEntity: GridEntity): void;
+/** For `GridEntityType.PIT` (7) */
+export declare function setCustomPitGraphics(customStage: CustomStage, gridEntity: GridEntity): void;
+/** For GridEntityType.DOOR (16) */
+export declare function setCustomDoorGraphics(customStage: CustomStage, gridEntity: GridEntity): void;
+/**
+ * The rewards are based on the ones from the wiki:
+ * https://bindingofisaacrebirth.fandom.com/wiki/Rocks#Urns
+ *
+ * On the bugged stage of -1, only urns will spawn, so we do not have to handle the case of mushroom
+ * rewards, skull rewards, and so on.
+ */
+export declare function removeUrnRewards(customStage: CustomStage, gridEntity: GridEntity): void;

package/features/customStage/gridEntities.lua

@@ -0,0 +1,215 @@
+local ____lualib = require("lualib_bundle")
+local __TS__ArrayFilter = ____lualib.__TS__ArrayFilter
+local ____exports = {}
+local getNewDoorPNGPath, removeEntitiesSpawnedFromGridEntity
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local CollectibleType = ____isaac_2Dtypescript_2Ddefinitions.CollectibleType
+local EntityType = ____isaac_2Dtypescript_2Ddefinitions.EntityType
+local TrinketType = ____isaac_2Dtypescript_2Ddefinitions.TrinketType
+local ____DecorationVariant = require("enums.DecorationVariant")
+local DecorationVariant = ____DecorationVariant.DecorationVariant
+local ____entity = require("functions.entity")
+local removeEntities = ____entity.removeEntities
+local ____entitySpecific = require("functions.entitySpecific")
+local getNPCs = ____entitySpecific.getNPCs
+local ____pickups = require("functions.pickups")
+local getCoins = ____pickups.getCoins
+local getCollectibles = ____pickups.getCollectibles
+local getTrinkets = ____pickups.getTrinkets
+local ____vector = require("functions.vector")
+local vectorEquals = ____vector.vectorEquals
+function getNewDoorPNGPath(self, customStage, fileName)
+    repeat
+        local ____switch16 = fileName
+        local ____cond16 = ____switch16 == "gfx/grid/door_01_normaldoor.anm2"
+        if ____cond16 then
+            do
+                local ____customStage_doorPNGPaths_normal_0 = customStage.doorPNGPaths
+                if ____customStage_doorPNGPaths_normal_0 ~= nil then
+                    ____customStage_doorPNGPaths_normal_0 = ____customStage_doorPNGPaths_normal_0.normal
+                end
+                return ____customStage_doorPNGPaths_normal_0
+            end
+        end
+        ____cond16 = ____cond16 or ____switch16 == "gfx/grid/door_02_treasureroomdoor.anm2"
+        if ____cond16 then
+            do
+                local ____customStage_doorPNGPaths_treasureRoom_2 = customStage.doorPNGPaths
+                if ____customStage_doorPNGPaths_treasureRoom_2 ~= nil then
+                    ____customStage_doorPNGPaths_treasureRoom_2 = ____customStage_doorPNGPaths_treasureRoom_2.treasureRoom
+                end
+                return ____customStage_doorPNGPaths_treasureRoom_2
+            end
+        end
+        ____cond16 = ____cond16 or ____switch16 == "gfx/grid/door_03_ambushroomdoor.anm2"
+        if ____cond16 then
+            do
+                local ____customStage_doorPNGPaths_normalChallengeRoom_4 = customStage.doorPNGPaths
+                if ____customStage_doorPNGPaths_normalChallengeRoom_4 ~= nil then
+                    ____customStage_doorPNGPaths_normalChallengeRoom_4 = ____customStage_doorPNGPaths_normalChallengeRoom_4.normalChallengeRoom
+                end
+                return ____customStage_doorPNGPaths_normalChallengeRoom_4
+            end
+        end
+        ____cond16 = ____cond16 or ____switch16 == "gfx/grid/door_04_selfsacrificeroomdoor.anm2"
+        if ____cond16 then
+            do
+                local ____customStage_doorPNGPaths_curseRoom_6 = customStage.doorPNGPaths
+                if ____customStage_doorPNGPaths_curseRoom_6 ~= nil then
+                    ____customStage_doorPNGPaths_curseRoom_6 = ____customStage_doorPNGPaths_curseRoom_6.curseRoom
+                end
+                return ____customStage_doorPNGPaths_curseRoom_6
+            end
+        end
+        ____cond16 = ____cond16 or ____switch16 == "gfx/grid/door_05_arcaderoomdoor.anm2"
+        if ____cond16 then
+            do
+                local ____customStage_doorPNGPaths_arcade_8 = customStage.doorPNGPaths
+                if ____customStage_doorPNGPaths_arcade_8 ~= nil then
+                    ____customStage_doorPNGPaths_arcade_8 = ____customStage_doorPNGPaths_arcade_8.arcade
+                end
+                return ____customStage_doorPNGPaths_arcade_8
+            end
+        end
+        ____cond16 = ____cond16 or ____switch16 == "gfx/grid/door_07_devilroomdoor.anm2"
+        if ____cond16 then
+            do
+                local ____customStage_doorPNGPaths_devilRoom_10 = customStage.doorPNGPaths
+                if ____customStage_doorPNGPaths_devilRoom_10 ~= nil then
+                    ____customStage_doorPNGPaths_devilRoom_10 = ____customStage_doorPNGPaths_devilRoom_10.devilRoom
+                end
+                return ____customStage_doorPNGPaths_devilRoom_10
+            end
+        end
+        ____cond16 = ____cond16 or ____switch16 == "gfx/grid/door_07_holyroomdoor.anm2"
+        if ____cond16 then
+            do
+                local ____customStage_doorPNGPaths_angelRoom_12 = customStage.doorPNGPaths
+                if ____customStage_doorPNGPaths_angelRoom_12 ~= nil then
+                    ____customStage_doorPNGPaths_angelRoom_12 = ____customStage_doorPNGPaths_angelRoom_12.angelRoom
+                end
+                return ____customStage_doorPNGPaths_angelRoom_12
+            end
+        end
+        ____cond16 = ____cond16 or ____switch16 == "gfx/grid/door_08_holeinwall.anm2"
+        if ____cond16 then
+            do
+                local ____customStage_doorPNGPaths_secretRoom_14 = customStage.doorPNGPaths
+                if ____customStage_doorPNGPaths_secretRoom_14 ~= nil then
+                    ____customStage_doorPNGPaths_secretRoom_14 = ____customStage_doorPNGPaths_secretRoom_14.secretRoom
+                end
+                return ____customStage_doorPNGPaths_secretRoom_14
+            end
+        end
+        ____cond16 = ____cond16 or ____switch16 == "gfx/grid/door_09_bossambushroomdoor.anm2"
+        if ____cond16 then
+            do
+                local ____customStage_doorPNGPaths_bossChallengeRoom_16 = customStage.doorPNGPaths
+                if ____customStage_doorPNGPaths_bossChallengeRoom_16 ~= nil then
+                    ____customStage_doorPNGPaths_bossChallengeRoom_16 = ____customStage_doorPNGPaths_bossChallengeRoom_16.bossChallengeRoom
+                end
+                return ____customStage_doorPNGPaths_bossChallengeRoom_16
+            end
+        end
+        ____cond16 = ____cond16 or ____switch16 == "gfx/grid/door_10_bossroomdoor.anm2"
+        if ____cond16 then
+            do
+                local ____customStage_doorPNGPaths_bossRoom_18 = customStage.doorPNGPaths
+                if ____customStage_doorPNGPaths_bossRoom_18 ~= nil then
+                    ____customStage_doorPNGPaths_bossRoom_18 = ____customStage_doorPNGPaths_bossRoom_18.bossRoom
+                end
+                return ____customStage_doorPNGPaths_bossRoom_18
+            end
+        end
+        ____cond16 = ____cond16 or ____switch16 == "gfx/grid/door_15_bossrushdoor.anm2"
+        if ____cond16 then
+            do
+                local ____customStage_doorPNGPaths_bossRush_20 = customStage.doorPNGPaths
+                if ____customStage_doorPNGPaths_bossRush_20 ~= nil then
+                    ____customStage_doorPNGPaths_bossRush_20 = ____customStage_doorPNGPaths_bossRush_20.bossRush
+                end
+                return ____customStage_doorPNGPaths_bossRush_20
+            end
+        end
+    until true
+    return nil
+end
+function removeEntitiesSpawnedFromGridEntity(self, entities, gridEntity)
+    local entitiesFromGridEntity = __TS__ArrayFilter(
+        entities,
+        function(____, entity) return entity.FrameCount == 0 and vectorEquals(nil, entity.Position, gridEntity.Position) end
+    )
+    removeEntities(nil, entitiesFromGridEntity)
+end
+--- For `GridEntityType.DECORATION` (1)
+function ____exports.setCustomDecorationGraphics(self, customStage, gridEntity)
+    if customStage.decorationsPNGPath == nil then
+        return
+    end
+    local variant = gridEntity:GetVariant()
+    if variant ~= DecorationVariant.VANILLA_DECORATION then
+        return
+    end
+    local sprite = gridEntity:GetSprite()
+    local fileName = sprite:GetFilename()
+    if string.lower(fileName) == "gfx/grid/props_01_basement.anm2" then
+        sprite:ReplaceSpritesheet(0, customStage.decorationsPNGPath)
+        sprite:LoadGraphics()
+    end
+end
+--- For `GridEntityType.ROCK` (2)
+function ____exports.setCustomRockGraphics(self, customStage, gridEntity)
+    if customStage.rocksPNGPath == nil then
+        return
+    end
+    local sprite = gridEntity:GetSprite()
+    local fileName = sprite:GetFilename()
+    if fileName == "gfx/grid/grid_rock.anm2" then
+        sprite:ReplaceSpritesheet(0, customStage.rocksPNGPath)
+        sprite:LoadGraphics()
+    elseif fileName == "gfx/grid/grid_pit.anm2" then
+        sprite:ReplaceSpritesheet(1, customStage.rocksPNGPath)
+        sprite:LoadGraphics()
+    end
+end
+--- For `GridEntityType.PIT` (7)
+function ____exports.setCustomPitGraphics(self, customStage, gridEntity)
+    if customStage.pitsPNGPath == nil then
+        return
+    end
+    local sprite = gridEntity:GetSprite()
+    local fileName = sprite:GetFilename()
+    if fileName == "gfx/grid/grid_pit.anm2" then
+        sprite:ReplaceSpritesheet(0, customStage.pitsPNGPath)
+        sprite:LoadGraphics()
+    end
+end
+--- For GridEntityType.DOOR (16)
+function ____exports.setCustomDoorGraphics(self, customStage, gridEntity)
+    local sprite = gridEntity:GetSprite()
+    local fileName = sprite:GetFilename()
+    local doorPNGPath = getNewDoorPNGPath(nil, customStage, fileName)
+    if doorPNGPath ~= nil then
+        sprite:ReplaceSpritesheet(0, doorPNGPath)
+        sprite:LoadGraphics()
+    end
+end
+--- The rewards are based on the ones from the wiki:
+-- https://bindingofisaacrebirth.fandom.com/wiki/Rocks#Urns
+-- 
+-- On the bugged stage of -1, only urns will spawn, so we do not have to handle the case of mushroom
+-- rewards, skull rewards, and so on.
+function ____exports.removeUrnRewards(self, customStage, gridEntity)
+    if customStage.rocksPNGPath == nil then
+        return
+    end
+    local spiders = getNPCs(nil, EntityType.SPIDER)
+    removeEntitiesSpawnedFromGridEntity(nil, spiders, gridEntity)
+    local coins = getCoins(nil)
+    removeEntitiesSpawnedFromGridEntity(nil, coins, gridEntity)
+    local quarters = getCollectibles(nil, CollectibleType.QUARTER)
+    removeEntitiesSpawnedFromGridEntity(nil, quarters, gridEntity)
+    local swallowedPennies = getTrinkets(nil, TrinketType.SWALLOWED_PENNY)
+    removeEntitiesSpawnedFromGridEntity(nil, swallowedPennies, gridEntity)
+end
+return ____exports

package/features/customStage/init.lua

@@ -3,9 +3,12 @@ local Map = ____lualib.Map
 local __TS__ObjectAssign = ____lualib.__TS__ObjectAssign
 local __TS__New = ____lualib.__TS__New
 local ____exports = {}
-local initRoomTypeMaps, getRoomTypeMap, postRender, 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")
@@ -14,8 +17,18 @@ local ____exports = require("features.saveDataManager.exports")
 local saveDataManager = ____exports.saveDataManager
 local ____backdrop = require("features.customStage.backdrop")
 local setBackdrop = ____backdrop.setBackdrop
+local ____gridEntities = require("features.customStage.gridEntities")
+local removeUrnRewards = ____gridEntities.removeUrnRewards
+local setCustomDecorationGraphics = ____gridEntities.setCustomDecorationGraphics
+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
@@ -64,21 +77,50 @@ 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
+        return
+    end
+    removeUrnRewards(nil, customStage, gridEntity)
+end
+function postGridEntityBrokenInit(self, gridEntity)
+    local customStage = v.run.currentCustomStage
+    if customStage == nil then
+        return
+    end
+    setCustomDecorationGraphics(nil, customStage, gridEntity)
+    setCustomRockGraphics(nil, customStage, gridEntity)
+    setCustomPitGraphics(nil, customStage, gridEntity)
+    setCustomDoorGraphics(nil, customStage, gridEntity)
+end
 function postNewRoomReordered(self)
     local customStage = v.run.currentCustomStage
     if customStage == nil then
         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)
 end
 return ____exports

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,59 @@
+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:LoadGraphics()
+    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/features/customStage/versusScreen.lua

@@ -139,20 +139,28 @@ function ____exports.playVersusScreenAnimation(self, customStage, force)
     versusScreenSprite:ReplaceSpritesheet(BOSS_PORTRAIT_ANM2_LAYER, bossPortraitPNGPath)
     versusScreenSprite:LoadGraphics()
     local backgroundColor = VERSUS_SCREEN_BACKGROUND_COLORS[DEFAULT_STAGE_ID]
-    if customStage.versusScreenBackgroundColor ~= nil then
-        local ____customStage_versusScreenBackgroundColor_0 = customStage.versusScreenBackgroundColor
-        local r = ____customStage_versusScreenBackgroundColor_0.r
-        local g = ____customStage_versusScreenBackgroundColor_0.g
-        local b = ____customStage_versusScreenBackgroundColor_0.b
+    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
         backgroundColor = Color(r, g, b)
     end
     versusScreenBackgroundSprite.Color = backgroundColor
     local dirtSpotColor = VERSUS_SCREEN_DIRT_SPOT_COLORS[DEFAULT_STAGE_ID]
-    if customStage.versusScreenDirtSpotColor ~= nil then
-        local ____customStage_versusScreenDirtSpotColor_1 = customStage.versusScreenDirtSpotColor
-        local r = ____customStage_versusScreenDirtSpotColor_1.r
-        local g = ____customStage_versusScreenDirtSpotColor_1.g
-        local b = ____customStage_versusScreenDirtSpotColor_1.b
+    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
         dirtSpotColor = Color(r, g, b)
     end
     versusScreenDirtSpotSprite.Color = dirtSpotColor

package/features/extraConsoleCommands/init.lua

@@ -84,6 +84,7 @@ function initMap(self)
     extraConsoleCommandsFunctionMap:set("goldenKey", commands.goldenKey)
     extraConsoleCommandsFunctionMap:set("grid", commands.grid)
     extraConsoleCommandsFunctionMap:set("grid2", commands.grid2)
+    extraConsoleCommandsFunctionMap:set("gridCosts", commands.gridCosts)
     extraConsoleCommandsFunctionMap:set("gridEntities", commands.gridEntities)
     extraConsoleCommandsFunctionMap:set("h", commands.h)
     extraConsoleCommandsFunctionMap:set("hearts", commands.hearts)
@@ -168,6 +169,7 @@ function initMap(self)
     extraConsoleCommandsFunctionMap:set("trapdoor", commands.trapdoorCommand)
     extraConsoleCommandsFunctionMap:set("treasure", commands.treasure)
     extraConsoleCommandsFunctionMap:set("ultraSecret", commands.ultraSecret)
+    extraConsoleCommandsFunctionMap:set("unseed", commands.unseed)
     extraConsoleCommandsFunctionMap:set("up", commands.up)
     extraConsoleCommandsFunctionMap:set("warp", commands.warp)
 end