isaacscript-common 6.2.1 → 6.3.0

package/callbacks/reorderedCallbacks.d.ts

@@ -1,3 +1,4 @@
+import { LevelStage, StageType } from "isaac-typescript-definitions";
 /**
  * This is a utility function for users of the `ModCallbackCustom.POST_NEW_LEVEL_REORDERED` custom
  * callback.
@@ -18,3 +19,11 @@ export declare function forceNewLevelCallback(): void;
  * temporarily force the callback to fire.
  */
 export declare function forceNewRoomCallback(): void;
+/**
+ * Helper function to manually set the variable that the reordered callback logic uses to track the
+ * current stage and stage type.
+ *
+ * This is useful because if the stage is changed with the `Game.SetStage` method, the reordered
+ * callbacks will stop working.
+ */
+export declare function reorderedCallbacksSetStage(stage: LevelStage, stageType: StageType): void;

package/callbacks/reorderedCallbacks.lua

@@ -106,4 +106,13 @@ end
 function ____exports.forceNewRoomCallback(self)
     forceNewRoom = true
 end
+--- Helper function to manually set the variable that the reordered callback logic uses to track the
+-- current stage and stage type.
+-- 
+-- This is useful because if the stage is changed with the `Game.SetStage` method, the reordered
+-- callbacks will stop working.
+function ____exports.reorderedCallbacksSetStage(self, stage, stageType)
+    currentStage = stage
+    currentStageType = stageType
+end
 return ____exports

package/constants.d.ts

@@ -85,6 +85,15 @@ export declare const LAST_ROOM_TYPE: RoomType;
  * effect.
  */
 export declare const MAX_SPEED_STAT = 2;
+/** This is in the center of the room. */
+export declare const NEW_FLOOR_STARTING_POSITION_NORMAL_MODE: Vector;
+/** This is near the top door. */
+export declare const NEW_FLOOR_STARTING_POSITION_GREED_MODE: Vector;
+/**
+ * This is next to the bottom door. Presumably, the player does not start in the center of the room
+ * (like they do when getting to a new stage) so that the controls graphic is more visible.
+ */
+export declare const NEW_RUN_PLAYER_STARTING_POSITION: Vector;
 export declare const FIRST_STAGE = LevelStage.BASEMENT_1;
 export declare const LAST_STAGE: LevelStage;
 /** Corresponds to the maximum value for `EntityPlayer.SamsonBerserkCharge`. */

package/constants.lua

@@ -74,6 +74,13 @@ ____exports.LAST_ROOM_TYPE = getLastEnumValue(nil, RoomType)
 --- The maximum speed stat that a player can have. Any additional speed beyond this will not take
 -- effect.
 ____exports.MAX_SPEED_STAT = 2
+--- This is in the center of the room.
+____exports.NEW_FLOOR_STARTING_POSITION_NORMAL_MODE = Vector(320, 280)
+--- This is near the top door.
+____exports.NEW_FLOOR_STARTING_POSITION_GREED_MODE = Vector(320, 280)
+--- This is next to the bottom door. Presumably, the player does not start in the center of the room
+-- (like they do when getting to a new stage) so that the controls graphic is more visible.
+____exports.NEW_RUN_PLAYER_STARTING_POSITION = Vector(320, 380)
 ____exports.FIRST_STAGE = LevelStage.BASEMENT_1
 ____exports.LAST_STAGE = getLastEnumValue(nil, LevelStage)
 --- Corresponds to the maximum value for `EntityPlayer.SamsonBerserkCharge`.

package/enums/CornerType.d.ts

@@ -0,0 +1,6 @@
+export declare enum CornerType {
+    TOP_LEFT = 0,
+    TOP_RIGHT = 1,
+    BOTTOM_LEFT = 2,
+    BOTTOM_RIGHT = 3
+}

package/enums/CornerType.lua

@@ -0,0 +1,11 @@
+local ____exports = {}
+____exports.CornerType = {}
+____exports.CornerType.TOP_LEFT = 0
+____exports.CornerType[____exports.CornerType.TOP_LEFT] = "TOP_LEFT"
+____exports.CornerType.TOP_RIGHT = 1
+____exports.CornerType[____exports.CornerType.TOP_RIGHT] = "TOP_RIGHT"
+____exports.CornerType.BOTTOM_LEFT = 2
+____exports.CornerType[____exports.CornerType.BOTTOM_LEFT] = "BOTTOM_LEFT"
+____exports.CornerType.BOTTOM_RIGHT = 3
+____exports.CornerType[____exports.CornerType.BOTTOM_RIGHT] = "BOTTOM_RIGHT"
+return ____exports

package/features/customStage/backdrop.d.ts

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

package/features/customStage/backdrop.lua

@@ -0,0 +1,200 @@
+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 ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local EffectVariant = ____isaac_2Dtypescript_2Ddefinitions.EffectVariant
+local EntityFlag = ____isaac_2Dtypescript_2Ddefinitions.EntityFlag
+local RoomShape = ____isaac_2Dtypescript_2Ddefinitions.RoomShape
+local RoomType = ____isaac_2Dtypescript_2Ddefinitions.RoomType
+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 ____entitySpecific = require("functions.entitySpecific")
+local spawnEffectWithSeed = ____entitySpecific.spawnEffectWithSeed
+local ____rng = require("functions.rng")
+local newRNG = ____rng.newRNG
+local ____roomShape = require("functions.roomShape")
+local isLRoom = ____roomShape.isLRoom
+local isNarrowRoom = ____roomShape.isNarrowRoom
+local ____string = require("functions.string")
+local trimPrefix = ____string.trimPrefix
+local ____utils = require("functions.utils")
+local erange = ____utils.erange
+local irange = ____utils.irange
+function getBackdropPNGPath(self, customStage, backdropKind, rng)
+    local pathArray = customStage.backdrop[backdropKind]
+    local path = getRandomArrayElement(nil, pathArray, rng)
+    return (customStage.backdrop.prefix .. path) .. customStage.backdrop.suffix
+end
+function spawnWallEntity(self, customStage, rng, isExtraWall)
+    local room = game:GetRoom()
+    local roomShape = room:GetRoomShape()
+    local subType = isExtraWall and BackdropEntitySubType.WALL_EXTRA or BackdropEntitySubType.WALL
+    local wallEffect = spawnEffectWithSeed(
+        nil,
+        BACKDROP_EFFECT_VARIANT,
+        subType,
+        VectorZero,
+        1
+    )
+    wallEffect:AddEntityFlags(EntityFlag.RENDER_WALL)
+    local sprite = wallEffect:GetSprite()
+    sprite:Load("gfx/isaacscript-custom-stage/wall-backdrop.anm2", false)
+    local wallLayersArray = isExtraWall and ROOM_SHAPE_WALL_EXTRA_ANM2_LAYERS or ROOM_SHAPE_WALL_ANM2_LAYERS
+    local numWallLayers = wallLayersArray[roomShape]
+    if numWallLayers == nil then
+        error("Failed to get the layers when creating the backdrop for custom stage: " .. customStage.name)
+    end
+    if isLRoom(nil, roomShape) then
+        local cornerPNGPath = getBackdropPNGPath(nil, customStage, BackdropKind.CORNER, rng)
+        sprite:ReplaceSpritesheet(0, cornerPNGPath)
+    end
+    for ____, layerID in ipairs(irange(nil, 1, numWallLayers)) do
+        local wallPNGPath = getBackdropPNGPath(nil, customStage, BackdropKind.WALL, rng)
+        sprite:ReplaceSpritesheet(layerID, wallPNGPath)
+    end
+    local topLeftPos = room:GetTopLeftPos()
+    local renderPos = topLeftPos + WALL_OFFSET
+    local modifiedOffset = renderPos / 40 * 26
+    wallEffect.SpriteOffset = modifiedOffset
+    sprite:LoadGraphics()
+    local roomShapeName = RoomShape[roomShape]
+    local animation = trimPrefix(nil, roomShapeName, "SHAPE_")
+    local modifiedAnimation = isExtraWall and animation .. "X" or animation
+    sprite:Play(modifiedAnimation, true)
+end
+function spawnSecondWallEntity(self, customStage, rng)
+    local room = game:GetRoom()
+    local roomShape = room:GetRoomShape()
+    local extraLayers = ROOM_SHAPE_WALL_EXTRA_ANM2_LAYERS[roomShape]
+    local roomShapeHasExtraLayers = extraLayers ~= nil
+    if roomShapeHasExtraLayers then
+        spawnWallEntity(nil, customStage, rng, true)
+    end
+end
+function spawnFloorEntity(self, customStage, rng)
+    local room = game:GetRoom()
+    local roomShape = room:GetRoomShape()
+    local floorEffect = spawnEffectWithSeed(
+        nil,
+        BACKDROP_EFFECT_VARIANT,
+        BackdropEntitySubType.FLOOR,
+        VectorZero,
+        1
+    )
+    floorEffect:AddEntityFlags(EntityFlag.RENDER_FLOOR)
+    local sprite = floorEffect:GetSprite()
+    sprite:Load("gfx/isaacscript-custom-stage/floor-backdrop.anm2", false)
+    local numFloorLayers = getNumFloorLayers(nil, roomShape)
+    if numFloorLayers ~= nil then
+        for ____, layerID in ipairs(erange(nil, 0, numFloorLayers)) do
+            local wallPNGPath = getBackdropPNGPath(nil, customStage, BackdropKind.WALL, rng)
+            sprite:ReplaceSpritesheet(layerID, wallPNGPath)
+        end
+    end
+    if isLRoom(nil, roomShape) then
+        for ____, layerID in ipairs({16, 17}) do
+            local LFloorPNGPath = getBackdropPNGPath(nil, customStage, BackdropKind.L_FLOOR, rng)
+            sprite:ReplaceSpritesheet(layerID, LFloorPNGPath)
+        end
+    end
+    if isNarrowRoom(nil, roomShape) then
+        for ____, layerID in ipairs({18, 19}) do
+            local NFloorPNGPath = getBackdropPNGPath(nil, customStage, BackdropKind.N_FLOOR, rng)
+            sprite:ReplaceSpritesheet(layerID, NFloorPNGPath)
+        end
+    end
+    local topLeftPos = room:GetTopLeftPos()
+    local renderPos = topLeftPos
+    local modifiedOffset = renderPos / 40 * 26
+    floorEffect.SpriteOffset = modifiedOffset
+    sprite:LoadGraphics()
+    local roomShapeName = RoomShape[roomShape]
+    local animation = trimPrefix(nil, roomShapeName, "SHAPE_")
+    sprite:Play(animation, true)
+end
+function getNumFloorLayers(self, roomShape)
+    repeat
+        local ____switch23 = roomShape
+        local ____cond23 = ____switch23 == RoomShape.SHAPE_1x1
+        if ____cond23 then
+            do
+                return 4
+            end
+        end
+        ____cond23 = ____cond23 or (____switch23 == RoomShape.SHAPE_1x2 or ____switch23 == RoomShape.SHAPE_2x1)
+        if ____cond23 then
+            do
+                return 8
+            end
+        end
+        ____cond23 = ____cond23 or ____switch23 == RoomShape.SHAPE_2x2
+        if ____cond23 then
+            do
+                return 16
+            end
+        end
+        do
+            do
+                return nil
+            end
+        end
+    until true
+end
+BackdropKind = BackdropKind or ({})
+BackdropKind.N_FLOOR = "nFloors"
+BackdropKind.L_FLOOR = "lFloors"
+BackdropKind.WALL = "walls"
+BackdropKind.CORNER = "corners"
+BackdropEntitySubType = BackdropEntitySubType or ({})
+BackdropEntitySubType.VANILLA_LADDER = 0
+BackdropEntitySubType[BackdropEntitySubType.VANILLA_LADDER] = "VANILLA_LADDER"
+BackdropEntitySubType.WALL = 1
+BackdropEntitySubType[BackdropEntitySubType.WALL] = "WALL"
+BackdropEntitySubType.WALL_EXTRA = 2
+BackdropEntitySubType[BackdropEntitySubType.WALL_EXTRA] = "WALL_EXTRA"
+BackdropEntitySubType.FLOOR = 3
+BackdropEntitySubType[BackdropEntitySubType.FLOOR] = "FLOOR"
+ROOM_SHAPE_WALL_ANM2_LAYERS = {
+    [RoomShape.SHAPE_1x1] = 44,
+    [RoomShape.IH] = 36,
+    [RoomShape.IV] = 28,
+    [RoomShape.SHAPE_1x2] = 58,
+    [RoomShape.IIV] = 42,
+    [RoomShape.SHAPE_2x1] = 63,
+    [RoomShape.IIH] = 62,
+    [RoomShape.SHAPE_2x2] = 63,
+    [RoomShape.LTL] = 63,
+    [RoomShape.LTR] = 63,
+    [RoomShape.LBL] = 63,
+    [RoomShape.LBR] = 63
+}
+ROOM_SHAPE_WALL_EXTRA_ANM2_LAYERS = {
+    [RoomShape.SHAPE_2x1] = 7,
+    [RoomShape.SHAPE_2x2] = 21,
+    [RoomShape.LTL] = 19,
+    [RoomShape.LTR] = 19,
+    [RoomShape.LBL] = 19,
+    [RoomShape.LBR] = 19
+}
+WALL_OFFSET = Vector(-80, -80)
+BACKDROP_EFFECT_VARIANT = EffectVariant.LADDER
+local BACKDROP_ROOM_TYPE_SET = __TS__New(Set, {RoomType.DEFAULT, RoomType.BOSS, RoomType.MINI_BOSS})
+function ____exports.setBackdrop(self, customStage)
+    local room = game:GetRoom()
+    local roomType = room:GetType()
+    local decorationSeed = room:GetDecorationSeed()
+    local rng = newRNG(nil, decorationSeed)
+    if not BACKDROP_ROOM_TYPE_SET:has(roomType) then
+        return
+    end
+    spawnWallEntity(nil, customStage, rng, false)
+    spawnSecondWallEntity(nil, customStage, rng)
+    spawnFloorEntity(nil, customStage, rng)
+end
+return ____exports

package/features/customStage/boss.d.ts

@@ -0,0 +1,2 @@
+export declare function playBossRoomAnimation(force?: boolean): void;
+export declare function bossPostRender(): void;

package/features/customStage/boss.lua

@@ -0,0 +1,74 @@
+local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local RoomType = ____isaac_2Dtypescript_2Ddefinitions.RoomType
+local SoundEffect = ____isaac_2Dtypescript_2Ddefinitions.SoundEffect
+local ____cachedClasses = require("cachedClasses")
+local game = ____cachedClasses.game
+local sfxManager = ____cachedClasses.sfxManager
+local ____pause = require("features.pause")
+local pause = ____pause.pause
+local unpause = ____pause.unpause
+local ____v = require("features.customStage.v")
+local v = ____v.default
+local VERSUS_SCREEN_ANIMATION = "Scene"
+--- Taken from StageAPI. I do not know why rendering in a certain order is necessary, but otherwise
+-- the overlay layer will be on top of everything else and will hide the other elements.
+local VERSUS_SCREEN_LAYER_RENDER_ORDER = {
+    0,
+    1,
+    2,
+    3,
+    9,
+    14,
+    13,
+    4,
+    5,
+    12,
+    11,
+    6,
+    7,
+    8,
+    10
+}
+local versusScreenSprite = Sprite()
+versusScreenSprite:Load("gfx/ui/boss/versusscreen.anm2", true)
+function ____exports.playBossRoomAnimation(self, 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)
+    versusScreenSprite:Play(VERSUS_SCREEN_ANIMATION, true)
+    versusScreenSprite.PlaybackSpeed = 0.5
+end
+local function finishBossRoomAnimation(self)
+    local hud = game:GetHUD()
+    v.run.showingBossVersusScreen = false
+    unpause(nil)
+    hud:SetVisible(true)
+    sfxManager:Play(SoundEffect.CASTLE_PORTCULLIS)
+end
+function ____exports.bossPostRender(self)
+    if not v.run.showingBossVersusScreen then
+        return
+    end
+    if versusScreenSprite:IsFinished(VERSUS_SCREEN_ANIMATION) then
+        finishBossRoomAnimation(nil)
+        return
+    end
+    local room = game:GetRoom()
+    local centerPos = room:GetCenterPos()
+    local position = Isaac.WorldToRenderPosition(centerPos)
+    for ____, layerID in ipairs(VERSUS_SCREEN_LAYER_RENDER_ORDER) do
+        versusScreenSprite:RenderLayer(layerID, position)
+    end
+    versusScreenSprite:Update()
+end
+return ____exports

package/features/customStage/exports.d.ts

@@ -5,3 +5,4 @@
  * more details: https://isaacscript.github.io/main/custom-stages/
  */
 export declare function setCustomStage(name: string, verbose?: boolean): void;
+export declare function setCustomStageDebug(): void;

package/features/customStage/exports.lua

@@ -1,6 +1,7 @@
 local ____lualib = require("lualib_bundle")
 local Map = ____lualib.Map
 local ____exports = {}
+local postRoomTransition
 local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
 local Direction = ____isaac_2Dtypescript_2Ddefinitions.Direction
 local GridRoom = ____isaac_2Dtypescript_2Ddefinitions.GridRoom
@@ -10,8 +11,13 @@ local RoomType = ____isaac_2Dtypescript_2Ddefinitions.RoomType
 local StageType = ____isaac_2Dtypescript_2Ddefinitions.StageType
 local ____cachedClasses = require("cachedClasses")
 local game = ____cachedClasses.game
+local ____reorderedCallbacks = require("callbacks.reorderedCallbacks")
+local reorderedCallbacksSetStage = ____reorderedCallbacks.reorderedCallbacksSetStage
 local ____log = require("functions.log")
+local log = ____log.log
 local logError = ____log.logError
+local ____playerCenter = require("functions.playerCenter")
+local movePlayersToCenter = ____playerCenter.movePlayersToCenter
 local ____rng = require("functions.rng")
 local newRNG = ____rng.newRNG
 local ____roomData = require("functions.roomData")
@@ -21,11 +27,19 @@ local getRooms = ____rooms.getRooms
 local ____stage = require("functions.stage")
 local getGotoCommand = ____stage.getGotoCommand
 local setStage = ____stage.setStage
+local ____runNextRoom = require("features.runNextRoom")
+local runNextRoom = ____runNextRoom.runNextRoom
+local ____boss = require("features.customStage.boss")
+local playBossRoomAnimation = ____boss.playBossRoomAnimation
 local ____util = require("features.customStage.util")
 local getRandomCustomStageRoom = ____util.getRandomCustomStageRoom
 local ____v = require("features.customStage.v")
+local v = ____v.default
 local customStageCachedRoomData = ____v.customStageCachedRoomData
 local customStagesMap = ____v.customStagesMap
+function postRoomTransition(self)
+    movePlayersToCenter(nil)
+end
 --- Helper function to warp to a custom stage/level.
 -- 
 -- Custom stages/levels must first be defined in the "tsconfig.json" file. See the documentation for
@@ -43,6 +57,7 @@ function ____exports.setCustomStage(self, name, verbose)
     local seeds = game:GetSeeds()
     local startSeed = seeds:GetStartSeed()
     local rng = newRNG(nil, startSeed)
+    v.run.currentCustomStage = customStage
     setStage(nil, customStage.baseStage, customStage.baseStageType)
     for ____, room in ipairs(getRooms(nil)) do
         do
@@ -88,7 +103,19 @@ function ____exports.setCustomStage(self, name, verbose)
         end
         ::__continue4::
     end
-    level:SetStage(-1, StageType.ORIGINAL)
+    local stage = -1
+    local stageType = StageType.WRATH_OF_THE_LAMB
+    level:SetStage(stage, stageType)
+    reorderedCallbacksSetStage(nil, stage, stageType)
     game:StartRoomTransition(startingRoomGridIndex, Direction.NO_DIRECTION, RoomTransitionAnim.FADE)
+    runNextRoom(nil, postRoomTransition)
+end
+function ____exports.setCustomStageDebug(self)
+    local customStage = v.run.currentCustomStage
+    if customStage == nil then
+        log("No custom stage is currently loaded.")
+        return
+    end
+    playBossRoomAnimation(nil, true)
 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,35 @@ local Map = ____lualib.Map
 local __TS__ObjectAssign = ____lualib.__TS__ObjectAssign
 local __TS__New = ____lualib.__TS__New
 local ____exports = {}
-local getRoomTypeMap
+local initRoomTypeMaps, getRoomTypeMap, postRender, postNewRoomReordered
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+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 ____boss = require("features.customStage.boss")
+local bossPostRender = ____boss.bossPostRender
+local playBossRoomAnimation = ____boss.playBossRoomAnimation
 local metadataJSON = require("features.customStage.metadata")
 local ____v = require("features.customStage.v")
+local v = ____v.default
 local customStagesMap = ____v.customStagesMap
+function initRoomTypeMaps(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.")
+    end
+    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 +57,21 @@ 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.")
-    end
-    for ____, customStageLua in ipairs(customStagesLua) do
-        local roomTypeMap = getRoomTypeMap(nil, customStageLua)
-        local customStage = __TS__ObjectAssign({}, customStageLua, {roomTypeMap = roomTypeMap})
-        customStagesMap:set(customStage.name, customStage)
+function postRender(self)
+    bossPostRender(nil)
+end
+function postNewRoomReordered(self)
+    local customStage = v.run.currentCustomStage
+    if customStage == nil then
+        return
     end
+    setBackdrop(nil, customStage)
+    playBossRoomAnimation(nil)
+end
+function ____exports.customStageInit(self, mod)
+    saveDataManager(nil, "customStage", v)
+    initRoomTypeMaps(nil)
+    mod:AddCallback(ModCallback.POST_RENDER, postRender)
+    mod:AddCallbackCustom(ModCallbackCustom.POST_NEW_ROOM_REORDERED, postNewRoomReordered)
 end
 return ____exports

package/features/customStage/stageAPIBoss.d.ts

@@ -0,0 +1,29 @@
+/// <reference types="isaac-typescript-definitions" />
+/// <reference types="isaac-typescript-definitions" />
+/// <reference types="isaac-typescript-definitions" />
+interface ParamTable {
+    BossPortrait?: string;
+    BossPortraitTwo?: string;
+    BossName?: string;
+    BossSpot?: string;
+    PlayerPortrait?: string;
+    PlayerName?: string;
+    PlayerSpot?: string;
+    Unskippable?: boolean;
+    BackgroundColor?: Color;
+    DirtColor?: Color;
+    NoShake?: boolean;
+    Animation?: string;
+    Sprite?: Sprite;
+    NoLoadGraphics?: boolean;
+    BossOffset?: Vector;
+}
+declare const StageAPILocal: {
+    BossSprite: Sprite | undefined;
+    BossSpriteBg: Sprite | undefined;
+    BossSpriteDirt: Sprite | undefined;
+    PlayingBossSprite: Sprite | undefined;
+    PlayingBossSpriteBg: Sprite | undefined;
+    PlayingBossSpriteDirt: Sprite | undefined;
+    BossOffset: Vector | undefined;
+};

package/features/customStage/stageAPIBoss.lua

@@ -0,0 +1,9 @@
+local StageAPILocal = {
+    BossSprite = nil,
+    BossSpriteBg = nil,
+    BossSpriteDirt = nil,
+    PlayingBossSprite = nil,
+    PlayingBossSpriteBg = nil,
+    PlayingBossSpriteDirt = nil,
+    BossOffset = nil
+}

package/features/customStage/v.d.ts

@@ -1,5 +1,12 @@
 /// <reference types="isaac-typescript-definitions" />
 import { CustomStage } from "../../interfaces/CustomStage";
+declare const v: {
+    run: {
+        currentCustomStage: CustomStage | null;
+        showingBossVersusScreen: boolean;
+    };
+};
+export default v;
 /** Indexed by custom stage name. */
 export declare const customStagesMap: Map<string, CustomStage>;
 /** Indexed by room variant. */

package/features/customStage/v.lua

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

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",