isaacscript-common 6.4.0 → 6.5.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, BackdropEntitySubType, 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,9 +29,10 @@ 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 backdrop = customStage.backdrop == nil and DEFAULT_BACKDROP or customStage.backdrop
+    local pathArray = backdrop[backdropKind]
     local path = getRandomArrayElement(nil, pathArray, rng)
-    return (customStage.backdrop.prefix .. path) .. customStage.backdrop.suffix
+    return (backdrop.prefix .. path) .. backdrop.suffix
 end
 function spawnWallEntity(self, customStage, rng, isExtraWall)
     local room = game:GetRoom()
@@ -162,6 +163,14 @@ 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"}
+}
 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,8 +3,9 @@ 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, postGridEntityBrokenRockAlt, postGridEntityBrokenInit, postNewRoomReordered
 local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local GridEntityType = ____isaac_2Dtypescript_2Ddefinitions.GridEntityType
 local ModCallback = ____isaac_2Dtypescript_2Ddefinitions.ModCallback
 local ____ModCallbackCustom = require("enums.ModCallbackCustom")
 local ModCallbackCustom = ____ModCallbackCustom.ModCallbackCustom
@@ -14,6 +15,12 @@ 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 ____streakText = require("features.customStage.streakText")
 local streakTextPostRender = ____streakText.streakTextPostRender
@@ -67,6 +74,23 @@ function postRender(self)
     streakTextPostRender(nil, customStage)
     versusScreenPostRender(nil)
 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
@@ -79,6 +103,8 @@ function ____exports.customStageInit(self, mod)
     saveDataManager(nil, "customStage", v)
     initRoomTypeMaps(nil)
     mod:AddCallback(ModCallback.POST_RENDER, postRender)
+    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/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

package/features/extraConsoleCommands/listCommands.d.ts

@@ -153,10 +153,15 @@ export declare function goldenBomb(): void;
 export declare function goldenHearts(params: string): void;
 /** Gives the player a golden key. */
 export declare function goldenKey(): void;
-/** Alias for the "debug 2" command. */
+/**
+ * Alias for the "debug 11" command. Useful for seeing the coordinates and grid index of each tile
+ * in the room.
+ */
 export declare function grid(): void;
-/** Alias for the "debug 11" command. */
+/** Alias for the "gridCosts" command. */
 export declare function grid2(): void;
+/** Alias for the "debug 2" command. Useful for seeing the grid costs of each tile in the room. */
+export declare function gridCosts(): void;
 /** Spawns every grid entity, starting at the top-left-most tile. */
 export declare function gridEntities(): void;
 /** Alias for the "hearts" command. */
@@ -346,6 +351,8 @@ export declare function trapdoorCommand(): void;
 export declare function treasure(): void;
 /** Warps to the first Ultra Secret Room on the floor. */
 export declare function ultraSecret(): void;
+/** If currently on a set seed, changes to an unseeded state and restarts the game. */
+export declare function unseed(): void;
 /** Moves the player 0.5 units up. Provide a number to move a custom amount of units. */
 export declare function up(params: string): void;
 /**

package/features/extraConsoleCommands/listCommands.lua

@@ -76,7 +76,9 @@ local ____rooms = require("functions.rooms")
 local changeRoom = ____rooms.changeRoom
 local getRoomGridIndexesForType = ____rooms.getRoomGridIndexesForType
 local ____run = require("functions.run")
+local onSetSeed = ____run.onSetSeed
 local restart = ____run.restart
+local setUnseeded = ____run.setUnseeded
 local ____trinkets = require("functions.trinkets")
 local getGoldenTrinketType = ____trinkets.getGoldenTrinketType
 local ____utils = require("functions.utils")
@@ -137,6 +139,10 @@ function ____exports.goldenKey(self)
     local player = Isaac.GetPlayer()
     player:AddGoldenKey()
 end
+--- Alias for the "debug 2" command. Useful for seeing the grid costs of each tile in the room.
+function ____exports.gridCosts(self)
+    Isaac.ExecuteCommand("debug 2")
+end
 --- Gives a half red heart. Provide a number to give a custom amount of hearts. (You can use negative
 -- numbers to remove hearts.)
 function ____exports.hearts(self, params)
@@ -583,13 +589,14 @@ end
 function ____exports.goldKey(self)
     ____exports.goldenKey(nil)
 end
---- Alias for the "debug 2" command.
+--- Alias for the "debug 11" command. Useful for seeing the coordinates and grid index of each tile
+-- in the room.
 function ____exports.grid(self)
-    Isaac.ExecuteCommand("debug 2")
+    Isaac.ExecuteCommand("debug 11")
 end
---- Alias for the "debug 11" command.
+--- Alias for the "gridCosts" command.
 function ____exports.grid2(self)
-    Isaac.ExecuteCommand("debug 11")
+    ____exports.gridCosts(nil)
 end
 --- Spawns every grid entity, starting at the top-left-most tile.
 function ____exports.gridEntities(self)
@@ -1075,6 +1082,15 @@ end
 function ____exports.ultraSecret(self)
     warpToRoomType(nil, RoomType.ULTRA_SECRET)
 end
+--- If currently on a set seed, changes to an unseeded state and restarts the game.
+function ____exports.unseed(self)
+    if not onSetSeed(nil) then
+        printConsole(nil, "You are not on a set seed, so you cannot unseed the run.")
+        return
+    end
+    setUnseeded(nil)
+    restart(nil)
+end
 --- Moves the player 0.5 units up. Provide a number to move a custom amount of units.
 function ____exports.up(self, params)
     movePlayer(nil, params, Direction.UP)

package/functions/doors.d.ts

@@ -70,31 +70,36 @@ export declare function isDevilRoomDoor(door: GridEntityDoor): boolean;
 export declare function isDoorSlotInRoomShape(doorSlot: DoorSlot, roomShape: RoomShape): boolean;
 /**
  * This refers to the Repentance door that spawns in a boss room after defeating the boss. You have
- * to spend one key to open it. It has a sprite filename of "gfx/grid/Door_Downpour.anm2".
+ * to spend one key to open it. It has a sprite filename of "gfx/grid/door_downpour.anm2".
  */
 export declare function isDoorToDownpour(door: GridEntityDoor): boolean;
 /**
  * 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".
+ * to spend two hearts to open it. It has a sprite filename of "gfx/grid/door_mausoleum.anm2".
  */
 export declare function isDoorToMausoleum(door: GridEntityDoor): boolean;
 /**
  * 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".
+ * a Polaroid or a Negative. It has a sprite filename of "gfx/grid/door_mausoleum_alt.anm2".
  */
 export declare function isDoorToMausoleumAscent(door: GridEntityDoor): boolean;
 /**
  * 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".
+ * to spend two bombs to open it. It has a sprite filename of "gfx/grid/door_mines.anm2".
  */
 export declare function isDoorToMines(door: GridEntityDoor): boolean;
 /**
  * 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".
+ * completed knife. It has a sprite filename of "gfx/grid/door_momsheart.anm2".
  */
 export declare function isDoorToMomsHeart(door: GridEntityDoor): boolean;
 export declare function isHiddenSecretRoomDoor(door: GridEntityDoor): boolean;
 export declare function isRepentanceDoor(door: GridEntityDoor): boolean;
+/**
+ * This refers to the hole in the wall that appears after bombing the entrance to a secret room.
+ * Note that the door still exists before it has been bombed open. It has a sprite filename of
+ * "gfx/grid/door_08_holeinwall.anm2".
+ */
 export declare function isSecretRoomDoor(door: GridEntityDoor): boolean;
 /**
  * Helper function to reset an unlocked door back to a locked state. Doing this is non-trivial