isaacscript-common 6.2.1 → 6.5.0

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.d.ts

@@ -1 +1,2 @@
-export declare function customStageInit(): void;
+import { ModUpgraded } from "../../classes/ModUpgraded";
+export declare function customStageInit(mod: ModUpgraded): void;

package/features/customStage/init.lua

@@ -3,12 +3,44 @@ local Map = ____lualib.Map
 local __TS__ObjectAssign = ____lualib.__TS__ObjectAssign
 local __TS__New = ____lualib.__TS__New
 local ____exports = {}
-local getRoomTypeMap
+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
 local ____array = require("functions.array")
 local isArray = ____array.isArray
+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
 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)
+    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})
+        customStagesMap:set(customStage.name, customStage)
+    end
+end
 function getRoomTypeMap(self, customStageLua)
     local roomTypeMap = __TS__New(Map)
     for ____, roomMetadata in ipairs(customStageLua.roomsMetadata) do
@@ -34,15 +66,45 @@ function getRoomTypeMap(self, customStageLua)
     end
     return roomTypeMap
 end
-function ____exports.customStageInit(self)
-    local customStagesLua = metadataJSON
-    if not isArray(nil, customStagesLua) then
-        error("The IsaacScript standard library attempted to read the custom stage metadata from the \"metadata.lua\" file, but it was not an array.")
+function postRender(self)
+    local customStage = v.run.currentCustomStage
+    if customStage == nil then
+        return
     end
-    for ____, customStageLua in ipairs(customStagesLua) do
-        local roomTypeMap = getRoomTypeMap(nil, customStageLua)
-        local customStage = __TS__ObjectAssign({}, customStageLua, {roomTypeMap = roomTypeMap})
-        customStagesMap:set(customStage.name, customStage)
+    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
+        return
+    end
+    setBackdrop(nil, customStage)
+    playVersusScreenAnimation(nil, customStage)
+end
+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/streakText.d.ts

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

package/features/customStage/streakText.lua

@@ -0,0 +1,22 @@
+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 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
+return ____exports

package/features/customStage/v.d.ts

@@ -1,6 +1,16 @@
 /// <reference types="isaac-typescript-definitions" />
 import { CustomStage } from "../../interfaces/CustomStage";
+declare const v: {
+    run: {
+        currentCustomStage: CustomStage | null;
+        showingStreakText: boolean;
+        showingBossVersusScreen: 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,8 +2,12 @@ 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}}
+____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/debugDisplay/debugDisplay.lua

@@ -11,6 +11,7 @@ local saveDataManager = ____exports.saveDataManager
 local ____v = require("features.debugDisplay.v")
 local v = ____v.default
 local debugDisplayTextCallbacks = ____v.debugDisplayTextCallbacks
+local setDebugDisplayEnabled = ____v.setDebugDisplayEnabled
 function renderTextOnEntity(self, entity, text)
     if isReflectionRender(nil) then
         return
@@ -155,6 +156,7 @@ end
 --- The debug display feature is only initialized when the extra console commands feature is
 -- initialized.
 function ____exports.debugDisplayInit(self, mod)
+    setDebugDisplayEnabled(nil)
     saveDataManager(
         nil,
         "debugDisplay",