isaacscript-common 6.3.0 → 6.5.1

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,18 +17,30 @@ local ____exports = require("features.saveDataManager.exports")
 local saveDataManager = ____exports.saveDataManager
 local ____backdrop = require("features.customStage.backdrop")
 local setBackdrop = ____backdrop.setBackdrop
-local ____boss = require("features.customStage.boss")
-local bossPostRender = ____boss.bossPostRender
-local playBossRoomAnimation = ____boss.playBossRoomAnimation
+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
 local customStagesMap = ____v.customStagesMap
+local ____versusScreen = require("features.customStage.versusScreen")
+local playVersusScreenAnimation = ____versusScreen.playVersusScreenAnimation
+local versusScreenPostRender = ____versusScreen.versusScreenPostRender
 function initRoomTypeMaps(self)
-    local customStagesLua = metadataJSON
-    if not isArray(nil, customStagesLua) then
+    if not isArray(nil, metadataJSON) then
         error("The IsaacScript standard library attempted to read the custom stage metadata from the \"metadata.lua\" file, but it was not an array.")
     end
+    local customStagesLua = metadataJSON
     for ____, customStageLua in ipairs(customStagesLua) do
         local roomTypeMap = getRoomTypeMap(nil, customStageLua)
         local customStage = __TS__ObjectAssign({}, customStageLua, {roomTypeMap = roomTypeMap})
@@ -58,7 +73,37 @@ function getRoomTypeMap(self, customStageLua)
     return roomTypeMap
 end
 function postRender(self)
-    bossPostRender(nil)
+    local customStage = v.run.currentCustomStage
+    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
@@ -66,12 +111,16 @@ function postNewRoomReordered(self)
         return
     end
     setBackdrop(nil, customStage)
-    playBossRoomAnimation(nil)
+    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,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

@@ -0,0 +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

@@ -0,0 +1,29 @@
+local ____exports = {}
+local ____cachedClasses = require("cachedClasses")
+local fonts = ____cachedClasses.fonts
+local ____constants = require("constants")
+local KColorDefault = ____constants.KColorDefault
+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
+        return
+    end
+    local font = fonts.upheaval
+    local length = font:GetStringWidthUTF8(customStage.name)
+    local bottomCenterPos = getScreenBottomCenterPos(nil)
+    local position = bottomCenterPos + STREAK_TEXT_BOTTOM_OFFSET
+    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

@@ -3,11 +3,17 @@ import { CustomStage } from "../../interfaces/CustomStage";
 declare const v: {
     run: {
         currentCustomStage: CustomStage | null;
+        showingStreakText: boolean;
         showingBossVersusScreen: boolean;
     };
+    room: {
+        showingShadows: boolean;
+    };
 };
 export default v;
 /** Indexed by custom stage name. */
 export declare const customStagesMap: Map<string, CustomStage>;
 /** Indexed by room variant. */
 export declare const customStageCachedRoomData: Map<number, Readonly<RoomConfig>>;
+/** Indexed by entity ID. */
+export declare const customBossPNGPaths: Map<string, [namePNGPath: string, portraitPNGPath: string]>;

package/features/customStage/v.lua

@@ -2,10 +2,12 @@ local ____lualib = require("lualib_bundle")
 local Map = ____lualib.Map
 local __TS__New = ____lualib.__TS__New
 local ____exports = {}
-local v = {run = {currentCustomStage = nil, 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)
 --- Indexed by room variant.
 ____exports.customStageCachedRoomData = __TS__New(Map)
+--- Indexed by entity ID.
+____exports.customBossPNGPaths = __TS__New(Map)
 return ____exports

package/features/customStage/versusScreen.d.ts

@@ -0,0 +1,3 @@
+import { CustomStage } from "../../interfaces/CustomStage";
+export declare function playVersusScreenAnimation(customStage: CustomStage, force?: boolean): void;
+export declare function versusScreenPostRender(): void;

package/features/customStage/versusScreen.lua

@@ -0,0 +1,201 @@
+local ____lualib = require("lualib_bundle")
+local Map = ____lualib.Map
+local ____exports = {}
+local getPlayerPNGPaths, getBossPNGPaths, DEFAULT_CHARACTER, PNG_PATH_PREFIX, PLAYER_PORTRAIT_PNG_PATH_PREFIX
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local BossID = ____isaac_2Dtypescript_2Ddefinitions.BossID
+local PlayerType = ____isaac_2Dtypescript_2Ddefinitions.PlayerType
+local RoomType = ____isaac_2Dtypescript_2Ddefinitions.RoomType
+local SoundEffect = ____isaac_2Dtypescript_2Ddefinitions.SoundEffect
+local StageID = ____isaac_2Dtypescript_2Ddefinitions.StageID
+local ____cachedClasses = require("cachedClasses")
+local game = ____cachedClasses.game
+local sfxManager = ____cachedClasses.sfxManager
+local ____array = require("functions.array")
+local arrayRemove = ____array.arrayRemove
+local ____boss = require("functions.boss")
+local getBosses = ____boss.getBosses
+local ____entity = require("functions.entity")
+local getEntityID = ____entity.getEntityID
+local ____utils = require("functions.utils")
+local erange = ____utils.erange
+local ____bossNamePNGFileNames = require("objects.bossNamePNGFileNames")
+local BOSS_NAME_PNG_FILE_NAMES = ____bossNamePNGFileNames.BOSS_NAME_PNG_FILE_NAMES
+local ____bossPortraitPNGFileNames = require("objects.bossPortraitPNGFileNames")
+local BOSS_PORTRAIT_PNG_FILE_NAMES = ____bossPortraitPNGFileNames.BOSS_PORTRAIT_PNG_FILE_NAMES
+local ____playerNamePNGFileNames = require("objects.playerNamePNGFileNames")
+local PLAYER_NAME_PNG_FILE_NAMES = ____playerNamePNGFileNames.PLAYER_NAME_PNG_FILE_NAMES
+local ____playerPortraitPNGFileNames = require("objects.playerPortraitPNGFileNames")
+local PLAYER_PORTRAIT_PNG_FILE_NAMES = ____playerPortraitPNGFileNames.PLAYER_PORTRAIT_PNG_FILE_NAMES
+local ____versusScreenBackgroundColors = require("objects.versusScreenBackgroundColors")
+local VERSUS_SCREEN_BACKGROUND_COLORS = ____versusScreenBackgroundColors.VERSUS_SCREEN_BACKGROUND_COLORS
+local ____versusScreenDirtSpotColors = require("objects.versusScreenDirtSpotColors")
+local VERSUS_SCREEN_DIRT_SPOT_COLORS = ____versusScreenDirtSpotColors.VERSUS_SCREEN_DIRT_SPOT_COLORS
+local ____pause = require("features.pause")
+local pause = ____pause.pause
+local unpause = ____pause.unpause
+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
+local customBossPNGPaths = ____v.customBossPNGPaths
+function getPlayerPNGPaths(self)
+    local player = Isaac.GetPlayer()
+    local character = player:GetPlayerType()
+    local playerNamePNGFileName = PLAYER_NAME_PNG_FILE_NAMES[character]
+    if playerNamePNGFileName == nil then
+        playerNamePNGFileName = PLAYER_NAME_PNG_FILE_NAMES[DEFAULT_CHARACTER]
+    end
+    local playerNamePNGPath = (PNG_PATH_PREFIX .. "/") .. tostring(playerNamePNGFileName)
+    local playerPortraitFileName = PLAYER_PORTRAIT_PNG_FILE_NAMES[character]
+    if playerNamePNGFileName == nil then
+        playerPortraitFileName = PLAYER_PORTRAIT_PNG_FILE_NAMES[DEFAULT_CHARACTER]
+    end
+    local playerPortraitPNGPath = (PLAYER_PORTRAIT_PNG_PATH_PREFIX .. "/") .. tostring(playerPortraitFileName)
+    return {playerNamePNGPath, playerPortraitPNGPath}
+end
+function getBossPNGPaths(self)
+    local bosses = getBosses(nil)
+    local firstBoss = bosses[1]
+    if firstBoss ~= nil then
+        local entityID = getEntityID(nil, firstBoss)
+        local pngPaths = customBossPNGPaths:get(entityID)
+        if pngPaths ~= nil then
+            return pngPaths
+        end
+    end
+    local bossID = firstBoss == nil and 0 or firstBoss:GetBossID()
+    if bossID == 0 then
+        local questionMarkSprite = (PNG_PATH_PREFIX .. "/") .. BOSS_NAME_PNG_FILE_NAMES[BossID.BLUE_BABY]
+        local bossNamePNGPath = questionMarkSprite
+        local bossPortraitPNGPath = questionMarkSprite
+        return {bossNamePNGPath, bossPortraitPNGPath}
+    end
+    local bossNamePNGFileName = BOSS_NAME_PNG_FILE_NAMES[bossID]
+    local bossNamePNGPath = (PNG_PATH_PREFIX .. "/") .. bossNamePNGFileName
+    local bossPortraitPNGFileName = BOSS_PORTRAIT_PNG_FILE_NAMES[bossID]
+    local bossPortraitPNGPath = (PNG_PATH_PREFIX .. "/") .. bossPortraitPNGFileName
+    return {bossNamePNGPath, bossPortraitPNGPath}
+end
+DEFAULT_CHARACTER = PlayerType.ISAAC
+local DEFAULT_STAGE_ID = StageID.BASEMENT
+local VERSUS_SCREEN_ANIMATION_NAME = "Scene"
+--- The layers range from 0 to 13.
+local NUM_VERSUS_SCREEN_ANM2_LAYERS = 14
+local BACKGROUND_ANM2_LAYER = 0
+local BOSS_DIRT_SPOT_ANM2_LAYER = 2
+local PLAYER_DIRT_SPOT_ANM2_LAYER = 3
+local BOSS_PORTRAIT_ANM2_LAYER = 4
+local PLAYER_PORTRAIT_ANM2_LAYER = 5
+local PLAYER_NAME_ANM2_LAYER = 6
+local BOSS_NAME_ANM2_LAYER = 7
+local OVERLAY_ANM2_LAYER = 11
+--- We only need to render either the normal player portrait layer or the alternate player portrait
+-- layer. Rendering both will cause the player not to shake.
+local PLAYER_PORTRAIT_ALT_ANM2_LAYER = 12
+--- These are the non-special layers that we will render last.
+local OTHER_ANM2_LAYERS = arrayRemove(
+    nil,
+    erange(nil, NUM_VERSUS_SCREEN_ANM2_LAYERS),
+    BACKGROUND_ANM2_LAYER,
+    BOSS_DIRT_SPOT_ANM2_LAYER,
+    PLAYER_DIRT_SPOT_ANM2_LAYER,
+    OVERLAY_ANM2_LAYER,
+    PLAYER_PORTRAIT_ALT_ANM2_LAYER
+)
+PNG_PATH_PREFIX = "gfx/ui/boss"
+PLAYER_PORTRAIT_PNG_PATH_PREFIX = "gfx/ui/stage"
+local VANILLA_VERSUS_PLAYBACK_SPEED = 0.5
+local versusScreenSprite = Sprite()
+versusScreenSprite:Load("gfx/ui/boss/versusscreen.anm2", false)
+versusScreenSprite:ReplaceSpritesheet(OVERLAY_ANM2_LAYER, ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH .. "/overlay.png")
+versusScreenSprite:LoadGraphics()
+--- Unfortunately, we must split the background layer into an entirely different sprite so that we
+-- can color it with the `Color` property.
+local versusScreenBackgroundSprite = Sprite()
+versusScreenBackgroundSprite:Load("gfx/ui/boss/versusscreen.anm2", true)
+--- Unfortunately, we must split the dirt layer into an entirely different sprite so that we can
+-- color it with the `Color` property.
+local versusScreenDirtSpotSprite = Sprite()
+versusScreenDirtSpotSprite:Load("gfx/ui/boss/versusscreen.anm2", true)
+function ____exports.playVersusScreenAnimation(self, customStage, force)
+    if force == nil then
+        force = false
+    end
+    local room = game:GetRoom()
+    local roomType = room:GetType()
+    local hud = game:GetHUD()
+    if roomType ~= RoomType.BOSS and not force then
+        return
+    end
+    v.run.showingBossVersusScreen = true
+    pause(nil)
+    hud:SetVisible(false)
+    local playerNamePNGPath, playerPortraitPNGPath = table.unpack(getPlayerPNGPaths(nil))
+    versusScreenSprite:ReplaceSpritesheet(PLAYER_NAME_ANM2_LAYER, playerNamePNGPath)
+    versusScreenSprite:ReplaceSpritesheet(PLAYER_PORTRAIT_ANM2_LAYER, playerPortraitPNGPath)
+    local bossNamePNGPath, bossPortraitPNGPath = table.unpack(getBossPNGPaths(nil))
+    versusScreenSprite:ReplaceSpritesheet(BOSS_NAME_ANM2_LAYER, bossNamePNGPath)
+    versusScreenSprite:ReplaceSpritesheet(BOSS_PORTRAIT_ANM2_LAYER, bossPortraitPNGPath)
+    versusScreenSprite:LoadGraphics()
+    local backgroundColor = VERSUS_SCREEN_BACKGROUND_COLORS[DEFAULT_STAGE_ID]
+    local ____customStage_versusScreen_backgroundColor_0 = customStage.versusScreen
+    if ____customStage_versusScreen_backgroundColor_0 ~= nil then
+        ____customStage_versusScreen_backgroundColor_0 = ____customStage_versusScreen_backgroundColor_0.backgroundColor
+    end
+    if ____customStage_versusScreen_backgroundColor_0 ~= nil then
+        local ____customStage_versusScreen_backgroundColor_2 = customStage.versusScreen.backgroundColor
+        local r = ____customStage_versusScreen_backgroundColor_2.r
+        local g = ____customStage_versusScreen_backgroundColor_2.g
+        local b = ____customStage_versusScreen_backgroundColor_2.b
+        backgroundColor = Color(r, g, b)
+    end
+    versusScreenBackgroundSprite.Color = backgroundColor
+    local dirtSpotColor = VERSUS_SCREEN_DIRT_SPOT_COLORS[DEFAULT_STAGE_ID]
+    local ____customStage_versusScreen_dirtSpotColor_3 = customStage.versusScreen
+    if ____customStage_versusScreen_dirtSpotColor_3 ~= nil then
+        ____customStage_versusScreen_dirtSpotColor_3 = ____customStage_versusScreen_dirtSpotColor_3.dirtSpotColor
+    end
+    if ____customStage_versusScreen_dirtSpotColor_3 ~= nil then
+        local ____customStage_versusScreen_dirtSpotColor_5 = customStage.versusScreen.dirtSpotColor
+        local r = ____customStage_versusScreen_dirtSpotColor_5.r
+        local g = ____customStage_versusScreen_dirtSpotColor_5.g
+        local b = ____customStage_versusScreen_dirtSpotColor_5.b
+        dirtSpotColor = Color(r, g, b)
+    end
+    versusScreenDirtSpotSprite.Color = dirtSpotColor
+    for ____, sprite in ipairs({versusScreenBackgroundSprite, versusScreenDirtSpotSprite, versusScreenSprite}) do
+        sprite:Play(VERSUS_SCREEN_ANIMATION_NAME, true)
+        sprite.PlaybackSpeed = VANILLA_VERSUS_PLAYBACK_SPEED
+    end
+end
+local function finishVersusScreenAnimation(self)
+    local hud = game:GetHUD()
+    v.run.showingBossVersusScreen = false
+    unpause(nil)
+    hud:SetVisible(true)
+    sfxManager:Play(SoundEffect.CASTLE_PORTCULLIS)
+end
+function ____exports.versusScreenPostRender(self)
+    if not v.run.showingBossVersusScreen then
+        return
+    end
+    if versusScreenSprite:IsFinished(VERSUS_SCREEN_ANIMATION_NAME) then
+        finishVersusScreenAnimation(nil)
+        return
+    end
+    local room = game:GetRoom()
+    local centerPos = room:GetCenterPos()
+    local position = Isaac.WorldToRenderPosition(centerPos)
+    versusScreenBackgroundSprite:RenderLayer(BACKGROUND_ANM2_LAYER, position)
+    versusScreenBackgroundSprite:Update()
+    versusScreenSprite:RenderLayer(OVERLAY_ANM2_LAYER, position)
+    versusScreenDirtSpotSprite:RenderLayer(BOSS_DIRT_SPOT_ANM2_LAYER, position)
+    versusScreenDirtSpotSprite:RenderLayer(PLAYER_DIRT_SPOT_ANM2_LAYER, position)
+    versusScreenDirtSpotSprite:Update()
+    for ____, layerID in ipairs(OTHER_ANM2_LAYERS) do
+        versusScreenSprite:RenderLayer(layerID, position)
+    end
+    versusScreenSprite:Update()
+end
+return ____exports

package/features/deployJSONRoom.lua

@@ -28,6 +28,7 @@ local errorIfFeaturesNotInitialized = ____featuresInitialized.errorIfFeaturesNot
 local ____array = require("functions.array")
 local emptyArray = ____array.emptyArray
 local ____entity = require("functions.entity")
+local getEntityIDFromConstituents = ____entity.getEntityIDFromConstituents
 local removeAllMatchingEntities = ____entity.removeAllMatchingEntities
 local spawn = ____entity.spawn
 local spawnWithSeed = ____entity.spawnWithSeed
@@ -39,6 +40,7 @@ local ____gridEntity = require("functions.gridEntity")
 local convertXMLGridEntityType = ____gridEntity.convertXMLGridEntityType
 local getAllGridIndexes = ____gridEntity.getAllGridIndexes
 local getGridEntities = ____gridEntity.getGridEntities
+local getGridEntityIDFromConstituents = ____gridEntity.getGridEntityIDFromConstituents
 local removeAllGridExcept = ____gridEntity.removeAllGridExcept
 local removeGrid = ____gridEntity.removeGrid
 local setGridEntityInvisible = ____gridEntity.setGridEntityInvisible
@@ -239,7 +241,8 @@ function spawnAllEntities(self, jsonRoom, rng, verbose)
         end
         if entityType >= 1000 then
             if verbose then
-                log(((((((("Spawning grid entity " .. tostring(entityType)) .. ".") .. tostring(variant)) .. " at: (") .. tostring(x)) .. ", ") .. tostring(y)) .. ")")
+                local gridEntityID = getGridEntityIDFromConstituents(nil, entityType, variant)
+                log(((((("Spawning grid entity " .. gridEntityID) .. " at: (") .. tostring(x)) .. ", ") .. tostring(y)) .. ")")
             end
             spawnGridEntityForJSONRoom(
                 nil,
@@ -250,7 +253,8 @@ function spawnAllEntities(self, jsonRoom, rng, verbose)
             )
         else
             if verbose then
-                log(((((((((("Spawning normal entity " .. tostring(entityType)) .. ".") .. tostring(variant)) .. ".") .. tostring(subType)) .. " at: (") .. tostring(x)) .. ", ") .. tostring(y)) .. ")")
+                local entityID = getEntityIDFromConstituents(nil, entityType, variant, subType)
+                log(((((("Spawning normal entity " .. entityID) .. " at: (") .. tostring(x)) .. ", ") .. tostring(y)) .. ")")
             end
             local entity = spawnNormalEntityForJSONRoom(
                 nil,

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/features/saveDataManager/exports.lua

@@ -11,8 +11,6 @@ local ____deepCopy = require("functions.deepCopy")
 local deepCopy = ____deepCopy.deepCopy
 local ____types = require("functions.types")
 local isString = ____types.isString
-local ____constants = require("features.saveDataManager.constants")
-local SAVE_DATA_MANAGER_FEATURE_NAME = ____constants.SAVE_DATA_MANAGER_FEATURE_NAME
 local ____main = require("features.saveDataManager.main")
 local forceSaveDataManagerLoad = ____main.forceSaveDataManagerLoad
 local forceSaveDataManagerSave = ____main.forceSaveDataManagerSave
@@ -21,6 +19,8 @@ local ____maps = require("features.saveDataManager.maps")
 local saveDataConditionalFuncMap = ____maps.saveDataConditionalFuncMap
 local saveDataDefaultsMap = ____maps.saveDataDefaultsMap
 local saveDataMap = ____maps.saveDataMap
+local ____saveDataManagerConstants = require("features.saveDataManager.saveDataManagerConstants")
+local SAVE_DATA_MANAGER_FEATURE_NAME = ____saveDataManagerConstants.SAVE_DATA_MANAGER_FEATURE_NAME
 --- This is the entry point to the save data manager, a system which provides two major features:
 -- 
 -- 1. automatic resetting of variables on a new run, on a new level, or on a new room (as desired)

package/features/saveDataManager/load.lua

@@ -12,11 +12,11 @@ local iterateTableInOrder = ____table.iterateTableInOrder
 local ____types = require("functions.types")
 local isString = ____types.isString
 local isTable = ____types.isTable
-local ____constants = require("features.saveDataManager.constants")
-local SAVE_DATA_MANAGER_DEBUG = ____constants.SAVE_DATA_MANAGER_DEBUG
-local SAVE_DATA_MANAGER_FEATURE_NAME = ____constants.SAVE_DATA_MANAGER_FEATURE_NAME
 local ____merge = require("features.saveDataManager.merge")
 local merge = ____merge.merge
+local ____saveDataManagerConstants = require("features.saveDataManager.saveDataManagerConstants")
+local SAVE_DATA_MANAGER_DEBUG = ____saveDataManagerConstants.SAVE_DATA_MANAGER_DEBUG
+local SAVE_DATA_MANAGER_FEATURE_NAME = ____saveDataManagerConstants.SAVE_DATA_MANAGER_FEATURE_NAME
 function readSaveDatFile(self, mod)
     local renderFrameCount = Isaac.GetFrameCount()
     local ok, jsonStringOrErrMsg = pcall(tryLoadModData, mod)

package/features/saveDataManager/main.lua

@@ -21,9 +21,6 @@ local logError = ____log.logError
 local ____table = require("functions.table")
 local clearTable = ____table.clearTable
 local iterateTableInOrder = ____table.iterateTableInOrder
-local ____constants = require("features.saveDataManager.constants")
-local SAVE_DATA_MANAGER_DEBUG = ____constants.SAVE_DATA_MANAGER_DEBUG
-local SAVE_DATA_MANAGER_FEATURE_NAME = ____constants.SAVE_DATA_MANAGER_FEATURE_NAME
 local ____load = require("features.saveDataManager.load")
 local loadFromDisk = ____load.loadFromDisk
 local ____maps = require("features.saveDataManager.maps")
@@ -32,6 +29,9 @@ local saveDataDefaultsMap = ____maps.saveDataDefaultsMap
 local saveDataMap = ____maps.saveDataMap
 local ____save = require("features.saveDataManager.save")
 local saveToDisk = ____save.saveToDisk
+local ____saveDataManagerConstants = require("features.saveDataManager.saveDataManagerConstants")
+local SAVE_DATA_MANAGER_DEBUG = ____saveDataManagerConstants.SAVE_DATA_MANAGER_DEBUG
+local SAVE_DATA_MANAGER_FEATURE_NAME = ____saveDataManagerConstants.SAVE_DATA_MANAGER_FEATURE_NAME
 function postPlayerInit(self)
     if mod == nil then
         error(("The mod for the " .. SAVE_DATA_MANAGER_FEATURE_NAME) .. " was not initialized.")

package/features/saveDataManager/merge.lua

@@ -26,8 +26,8 @@ local ____types = require("functions.types")
 local isTable = ____types.isTable
 local ____utils = require("functions.utils")
 local getTraversalDescription = ____utils.getTraversalDescription
-local ____constants = require("features.saveDataManager.constants")
-local SAVE_DATA_MANAGER_DEBUG = ____constants.SAVE_DATA_MANAGER_DEBUG
+local ____saveDataManagerConstants = require("features.saveDataManager.saveDataManagerConstants")
+local SAVE_DATA_MANAGER_DEBUG = ____saveDataManagerConstants.SAVE_DATA_MANAGER_DEBUG
 local ____serializationBrand = require("features.saveDataManager.serializationBrand")
 local isSerializationBrand = ____serializationBrand.isSerializationBrand
 --- `merge` takes the values from a new table and recursively merges them into an old object (while