isaacscript-common 14.2.0 → 15.0.1

package/dist/src/classes/features/other/StageHistory.lua

@@ -0,0 +1,200 @@
+local ____lualib = require("lualib_bundle")
+local __TS__Class = ____lualib.__TS__Class
+local __TS__ClassExtends = ____lualib.__TS__ClassExtends
+local __TS__Decorate = ____lualib.__TS__Decorate
+local __TS__ArraySome = ____lualib.__TS__ArraySome
+local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local GameStateFlag = ____isaac_2Dtypescript_2Ddefinitions.GameStateFlag
+local LevelStage = ____isaac_2Dtypescript_2Ddefinitions.LevelStage
+local StageType = ____isaac_2Dtypescript_2Ddefinitions.StageType
+local ____cachedClasses = require("src.core.cachedClasses")
+local game = ____cachedClasses.game
+local ____decorators = require("src.decorators")
+local Exported = ____decorators.Exported
+local ____ModCallbackCustom = require("src.enums.ModCallbackCustom")
+local ModCallbackCustom = ____ModCallbackCustom.ModCallbackCustom
+local ____nextStage = require("src.functions.nextStage")
+local getNextStage = ____nextStage.getNextStage
+local getNextStageType = ____nextStage.getNextStageType
+local ____stage = require("src.functions.stage")
+local calculateStageType = ____stage.calculateStageType
+local onRepentanceStage = ____stage.onRepentanceStage
+local ____types = require("src.functions.types")
+local asNumber = ____types.asNumber
+local ____Feature = require("src.classes.private.Feature")
+local Feature = ____Feature.Feature
+____exports.StageHistory = __TS__Class()
+local StageHistory = ____exports.StageHistory
+StageHistory.name = "StageHistory"
+__TS__ClassExtends(StageHistory, Feature)
+function StageHistory.prototype.____constructor(self)
+    Feature.prototype.____constructor(self)
+    self.v = {run = {stageHistory = {}}}
+    self.postNewLevelReordered = function()
+        local level = game:GetLevel()
+        local stage = level:GetStage()
+        local stageType = level:GetStageType()
+        local ____self_v_run_stageHistory_0 = self.v.run.stageHistory
+        ____self_v_run_stageHistory_0[#____self_v_run_stageHistory_0 + 1] = {stage, stageType}
+    end
+    self.customCallbacksUsed = {{ModCallbackCustom.POST_NEW_LEVEL_REORDERED, {self.postNewLevelReordered}}}
+end
+function StageHistory.prototype.getNextStageTypeWithHistory(self, upwards)
+    if upwards == nil then
+        upwards = false
+    end
+    local backwardsPath = game:GetStateFlag(GameStateFlag.BACKWARDS_PATH)
+    if not backwardsPath then
+        return getNextStageType(nil, upwards)
+    end
+    local level = game:GetLevel()
+    local stage = level:GetStage()
+    local repentanceStage = onRepentanceStage(nil)
+    local visitedDownpour1 = self:hasVisitedStage(LevelStage.BASEMENT_1, StageType.REPENTANCE)
+    local visitedDross1 = self:hasVisitedStage(LevelStage.BASEMENT_1, StageType.REPENTANCE_B)
+    local visitedDownpour2 = self:hasVisitedStage(LevelStage.BASEMENT_2, StageType.REPENTANCE)
+    local visitedDross2 = self:hasVisitedStage(LevelStage.BASEMENT_2, StageType.REPENTANCE_B)
+    local visitedMines1 = self:hasVisitedStage(LevelStage.CAVES_1, StageType.REPENTANCE)
+    local visitedAshpit1 = self:hasVisitedStage(LevelStage.CAVES_1, StageType.REPENTANCE_B)
+    local visitedMines2 = self:hasVisitedStage(LevelStage.DEPTHS_2, StageType.REPENTANCE)
+    local visitedAshpit2 = self:hasVisitedStage(LevelStage.DEPTHS_2, StageType.REPENTANCE_B)
+    if stage == LevelStage.BASEMENT_2 and repentanceStage then
+        if visitedDownpour1 then
+            return StageType.REPENTANCE
+        end
+        if visitedDross1 then
+            return StageType.REPENTANCE_B
+        end
+    end
+    if stage == LevelStage.CAVES_1 and repentanceStage then
+        if visitedDownpour2 then
+            return StageType.REPENTANCE
+        end
+        if visitedDross2 then
+            return StageType.REPENTANCE_B
+        end
+    end
+    if stage == LevelStage.CAVES_2 and not repentanceStage then
+        if visitedDownpour2 then
+            return StageType.REPENTANCE
+        end
+        if visitedDross2 then
+            return StageType.REPENTANCE_B
+        end
+    end
+    if stage == LevelStage.CAVES_2 and repentanceStage then
+        if visitedMines1 then
+            return StageType.REPENTANCE
+        end
+        if visitedAshpit1 then
+            return StageType.REPENTANCE_B
+        end
+    end
+    if stage == LevelStage.DEPTHS_2 and not repentanceStage then
+        if visitedAshpit2 then
+            return StageType.REPENTANCE_B
+        end
+        if visitedMines2 then
+            return StageType.REPENTANCE
+        end
+    end
+    local nextStage = self:getNextStageWithHistory()
+    return calculateStageType(nil, nextStage)
+end
+function StageHistory.prototype.getNextStageWithHistory(self)
+    local backwardsPath = game:GetStateFlag(GameStateFlag.BACKWARDS_PATH)
+    if not backwardsPath then
+        return getNextStage(nil)
+    end
+    local level = game:GetLevel()
+    local stage = level:GetStage()
+    local repentanceStage = onRepentanceStage(nil)
+    local visitedDownpour1 = self:hasVisitedStage(LevelStage.BASEMENT_1, StageType.REPENTANCE)
+    local visitedDross1 = self:hasVisitedStage(LevelStage.BASEMENT_1, StageType.REPENTANCE_B)
+    local visitedDownpour2 = self:hasVisitedStage(LevelStage.BASEMENT_2, StageType.REPENTANCE)
+    local visitedDross2 = self:hasVisitedStage(LevelStage.BASEMENT_2, StageType.REPENTANCE_B)
+    local visitedMines1 = self:hasVisitedStage(LevelStage.CAVES_1, StageType.REPENTANCE)
+    local visitedAshpit1 = self:hasVisitedStage(LevelStage.CAVES_1, StageType.REPENTANCE_B)
+    local visitedMines2 = self:hasVisitedStage(LevelStage.DEPTHS_2, StageType.REPENTANCE)
+    local visitedAshpit2 = self:hasVisitedStage(LevelStage.DEPTHS_2, StageType.REPENTANCE_B)
+    if stage == LevelStage.BASEMENT_1 then
+        if repentanceStage then
+            return LevelStage.BASEMENT_1
+        end
+        return LevelStage.HOME
+    end
+    if stage == LevelStage.BASEMENT_2 then
+        if repentanceStage then
+            if visitedDownpour1 or visitedDross1 then
+                return LevelStage.BASEMENT_1
+            end
+            return LevelStage.BASEMENT_2
+        end
+        return LevelStage.BASEMENT_1
+    end
+    if stage == LevelStage.CAVES_1 then
+        if repentanceStage then
+            if visitedDownpour2 or visitedDross2 then
+                return LevelStage.BASEMENT_2
+            end
+            return LevelStage.CAVES_1
+        end
+        return LevelStage.BASEMENT_2
+    end
+    if stage == LevelStage.CAVES_2 then
+        if repentanceStage then
+            if visitedMines1 or visitedAshpit1 then
+                return LevelStage.CAVES_1
+            end
+            return LevelStage.CAVES_2
+        end
+        return LevelStage.CAVES_1
+    end
+    if stage == LevelStage.DEPTHS_1 then
+        if repentanceStage then
+            if visitedMines2 or visitedAshpit2 then
+                return LevelStage.CAVES_2
+            end
+            return LevelStage.DEPTHS_1
+        end
+        return LevelStage.CAVES_2
+    end
+    if stage == LevelStage.DEPTHS_2 then
+        if repentanceStage then
+            return LevelStage.DEPTHS_2
+        end
+        return LevelStage.DEPTHS_1
+    end
+    return asNumber(nil, stage) - 1
+end
+function StageHistory.prototype.getStageHistory(self)
+    return self.v.run.stageHistory
+end
+function StageHistory.prototype.hasVisitedStage(self, stage, stageType)
+    if stageType == nil then
+        return __TS__ArraySome(
+            self.v.run.stageHistory,
+            function(____, ____bindingPattern0)
+                local previousStage
+                previousStage = ____bindingPattern0[1]
+                return previousStage == stage
+            end
+        )
+    end
+    return __TS__ArraySome(
+        self.v.run.stageHistory,
+        function(____, ____bindingPattern0)
+            local previousStageType
+            local previousStage
+            previousStage = ____bindingPattern0[1]
+            previousStageType = ____bindingPattern0[2]
+            return previousStage == stage and previousStageType == stageType
+        end
+    )
+end
+__TS__Decorate({Exported}, StageHistory.prototype, "getNextStageTypeWithHistory", true)
+__TS__Decorate({Exported}, StageHistory.prototype, "getNextStageWithHistory", true)
+__TS__Decorate({Exported}, StageHistory.prototype, "getStageHistory", true)
+__TS__Decorate({Exported}, StageHistory.prototype, "hasVisitedStage", true)
+return ____exports

package/dist/src/classes/features/other/StartAmbush.d.ts

@@ -0,0 +1,14 @@
+import { Feature } from "../../private/Feature";
+export declare class StartAmbush extends Feature {
+    private runInNFrames;
+    /**
+     * Helper function to start a Challenge Room or the Boss Rush.
+     *
+     * Specifically, this is performed by spawning a sack on top of the player, waiting a game frame,
+     * and then removing the sack and the pickups that the sack dropped.
+     *
+     * In order to use this function, you must upgrade your mod with `ISCFeature.START_AMBUSH`.
+     */
+    startAmbush(): void;
+}
+//# sourceMappingURL=StartAmbush.d.ts.map

package/dist/src/classes/features/other/StartAmbush.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StartAmbush.d.ts","sourceRoot":"","sources":["../../../../../src/classes/features/other/StartAmbush.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAMhD,qBAAa,WAAY,SAAQ,OAAO;IACtC,OAAO,CAAC,YAAY,CAAe;IAWnC;;;;;;;OAOG;IAEI,WAAW,IAAI,IAAI;CA+B3B"}

package/dist/src/classes/features/other/StartAmbush.lua

@@ -0,0 +1,53 @@
+local ____lualib = require("lualib_bundle")
+local __TS__Class = ____lualib.__TS__Class
+local __TS__ClassExtends = ____lualib.__TS__ClassExtends
+local __TS__ArrayFilter = ____lualib.__TS__ArrayFilter
+local __TS__Decorate = ____lualib.__TS__Decorate
+local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local SackSubType = ____isaac_2Dtypescript_2Ddefinitions.SackSubType
+local ____decorators = require("src.decorators")
+local Exported = ____decorators.Exported
+local ____ISCFeature = require("src.enums.ISCFeature")
+local ISCFeature = ____ISCFeature.ISCFeature
+local ____entities = require("src.functions.entities")
+local removeEntities = ____entities.removeEntities
+local ____pickupsSpecific = require("src.functions.pickupsSpecific")
+local getCoins = ____pickupsSpecific.getCoins
+local spawnSackWithSeed = ____pickupsSpecific.spawnSackWithSeed
+local ____Feature = require("src.classes.private.Feature")
+local Feature = ____Feature.Feature
+--- Hard-coding this makes it easier to clean up the pickups afterwards.
+local SACK_SEED_THAT_SPAWNS_TWO_COINS = 6
+____exports.StartAmbush = __TS__Class()
+local StartAmbush = ____exports.StartAmbush
+StartAmbush.name = "StartAmbush"
+__TS__ClassExtends(StartAmbush, Feature)
+function StartAmbush.prototype.____constructor(self, runInNFrames)
+    Feature.prototype.____constructor(self)
+    self.featuresUsed = {ISCFeature.RUN_IN_N_FRAMES}
+    self.runInNFrames = runInNFrames
+end
+function StartAmbush.prototype.startAmbush(self)
+    local player = Isaac.GetPlayer()
+    local sack = spawnSackWithSeed(nil, SackSubType.NULL, player.Position, SACK_SEED_THAT_SPAWNS_TWO_COINS)
+    local sprite = sack:GetSprite()
+    sprite:Stop()
+    local sackPtr = EntityPtr(sack)
+    self.runInNFrames:runNextGameFrame(function()
+        local futureSack = sackPtr.Ref
+        if futureSack == nil then
+            return
+        end
+        futureSack:Remove()
+        local sackPtrHash = GetPtrHash(futureSack)
+        local coins = getCoins(nil)
+        local coinsFromSack = __TS__ArrayFilter(
+            coins,
+            function(____, pickup) return pickup.SpawnerEntity ~= nil and GetPtrHash(pickup.SpawnerEntity) == sackPtrHash end
+        )
+        removeEntities(nil, coinsFromSack)
+    end)
+end
+__TS__Decorate({Exported}, StartAmbush.prototype, "startAmbush", true)
+return ____exports

package/dist/src/classes/features/other/TaintedLazarusPlayers.d.ts

@@ -0,0 +1,36 @@
+/// <reference types="isaac-typescript-definitions" />
+import { Feature } from "../../private/Feature";
+/**
+ * This feature provides a way for end-users to get the `EntityPlayer` object for the other Tainted
+ * Lazarus.
+ */
+export declare class TaintedLazarusPlayers extends Feature {
+    vConditionalFunc: () => boolean;
+    private postPlayerInit;
+    /**
+     * Indexes are the `PtrHash`, values are the `EntityPtr` of the *other* Lazarus.
+     *
+     * When starting a run, the `POST_PLAYER_INIT` callback will fire first for Dead Tainted Lazarus,
+     * then for Tainted Lazarus. When continuing a run, the `POST_PLAYER_INIT` callback will fire
+     * first for the character that is currently active. Thus, since the order of the characters is
+     * not certain, we insert each of their pointers into a queue, and then only populate the map when
+     * we have one Tainted Lazarus and one Dead Tainted Lazarus.
+     */
+    private checkDequeue;
+    /**
+     * Helper function to get the other version of Tainted Lazarus.
+     *
+     * - On Tainted Lazarus, returns the player object for Dead Tainted Lazarus.
+     * - On Dead Tainted Lazarus, returns the player object for Tainted Lazarus.
+     * - Returns undefined if player object retrieval failed for any reason.
+     *
+     * If you call the `EntityPlayer.Exists` method on the returned object, it will return false.
+     * However, you can still call the other methods like you normally would (e.g.
+     * `EntityPlayer.AddCollectible`).
+     *
+     * In order to use this function, you must upgrade your mod with
+     * `ISCFeature.CHARACTER_HEALTH_CONVERSION`.
+     */
+    getTaintedLazarusSubPlayer(player: EntityPlayer): EntityPlayer | undefined;
+}
+//# sourceMappingURL=TaintedLazarusPlayers.d.ts.map

package/dist/src/classes/features/other/TaintedLazarusPlayers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaintedLazarusPlayers.d.ts","sourceRoot":"","sources":["../../../../../src/classes/features/other/TaintedLazarusPlayers.ts"],"names":[],"mappings":";AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAEhD;;;GAGG;AACH,qBAAa,qBAAsB,SAAQ,OAAO;IAyBhC,gBAAgB,QAAO,OAAO,CAAU;IAYxD,OAAO,CAAC,cAAc,CAYpB;IAEF;;;;;;;;OAQG;IACH,OAAO,CAAC,YAAY;IA6BpB;;;;;;;;;;;;;OAaG;IAEI,0BAA0B,CAC/B,MAAM,EAAE,YAAY,GACnB,YAAY,GAAG,SAAS;CAI5B"}

package/dist/src/classes/features/other/TaintedLazarusPlayers.lua

@@ -0,0 +1,69 @@
+local ____lualib = require("lualib_bundle")
+local __TS__Class = ____lualib.__TS__Class
+local __TS__ClassExtends = ____lualib.__TS__ClassExtends
+local Map = ____lualib.Map
+local __TS__New = ____lualib.__TS__New
+local __TS__Decorate = ____lualib.__TS__Decorate
+local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local ModCallback = ____isaac_2Dtypescript_2Ddefinitions.ModCallback
+local PlayerType = ____isaac_2Dtypescript_2Ddefinitions.PlayerType
+local ____decorators = require("src.decorators")
+local Exported = ____decorators.Exported
+local ____logMisc = require("src.functions.logMisc")
+local logError = ____logMisc.logError
+local ____Feature = require("src.classes.private.Feature")
+local Feature = ____Feature.Feature
+--- This feature provides a way for end-users to get the `EntityPlayer` object for the other Tainted
+-- Lazarus.
+____exports.TaintedLazarusPlayers = __TS__Class()
+local TaintedLazarusPlayers = ____exports.TaintedLazarusPlayers
+TaintedLazarusPlayers.name = "TaintedLazarusPlayers"
+__TS__ClassExtends(TaintedLazarusPlayers, Feature)
+function TaintedLazarusPlayers.prototype.____constructor(self)
+    Feature.prototype.____constructor(self)
+    self.v = {run = {
+        queuedTaintedLazarus = {},
+        queuedDeadTaintedLazarus = {},
+        subPlayerMap = __TS__New(Map)
+    }}
+    self.vConditionalFunc = function() return false end
+    self.postPlayerInit = function(____, player)
+        local character = player:GetPlayerType()
+        if character == PlayerType.LAZARUS_B then
+            local ____self_v_run_queuedTaintedLazarus_0 = self.v.run.queuedTaintedLazarus
+            ____self_v_run_queuedTaintedLazarus_0[#____self_v_run_queuedTaintedLazarus_0 + 1] = player
+        elseif character == PlayerType.LAZARUS_2_B then
+            local ____self_v_run_queuedDeadTaintedLazarus_1 = self.v.run.queuedDeadTaintedLazarus
+            ____self_v_run_queuedDeadTaintedLazarus_1[#____self_v_run_queuedDeadTaintedLazarus_1 + 1] = player
+        else
+            return
+        end
+        self:checkDequeue()
+    end
+    self.callbacksUsed = {{ModCallback.POST_PLAYER_INIT, {self.postPlayerInit}}}
+end
+function TaintedLazarusPlayers.prototype.checkDequeue(self)
+    if #self.v.run.queuedTaintedLazarus == 0 or #self.v.run.queuedDeadTaintedLazarus == 0 then
+        return
+    end
+    local taintedLazarus = table.remove(self.v.run.queuedTaintedLazarus, 1)
+    local deadTaintedLazarus = table.remove(self.v.run.queuedDeadTaintedLazarus, 1)
+    if taintedLazarus == nil or deadTaintedLazarus == nil then
+        return
+    end
+    local taintedLazarusPtrHash = GetPtrHash(taintedLazarus)
+    local deadTaintedLazarusPtrHash = GetPtrHash(deadTaintedLazarus)
+    if taintedLazarusPtrHash == deadTaintedLazarusPtrHash then
+        logError(nil, "Failed to cache the Tainted Lazarus player objects, since the hash for Tainted Lazarus and Dead Tainted Lazarus were the same.")
+        return
+    end
+    self.v.run.subPlayerMap:set(taintedLazarusPtrHash, deadTaintedLazarus)
+    self.v.run.subPlayerMap:set(deadTaintedLazarusPtrHash, taintedLazarus)
+end
+function TaintedLazarusPlayers.prototype.getTaintedLazarusSubPlayer(self, player)
+    local ptrHash = GetPtrHash(player)
+    return self.v.run.subPlayerMap:get(ptrHash)
+end
+__TS__Decorate({Exported}, TaintedLazarusPlayers.prototype, "getTaintedLazarusSubPlayer", true)
+return ____exports

package/dist/src/classes/features/other/customStages/backdrop.d.ts

@@ -0,0 +1,3 @@
+import { CustomStage } from "../../../../interfaces/private/CustomStage";
+export declare function setCustomStageBackdrop(customStage: CustomStage): void;
+//# sourceMappingURL=backdrop.d.ts.map

package/dist/src/classes/features/other/customStages/backdrop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backdrop.d.ts","sourceRoot":"","sources":["../../../../../../src/classes/features/other/customStages/backdrop.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,WAAW,EAAE,MAAM,4CAA4C,CAAC;AA2EzE,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI,CAcrE"}

package/dist/src/classes/features/other/customStages/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, DEFAULT_BACKDROP, ROOM_SHAPE_WALL_ANM2_LAYERS, ROOM_SHAPE_WALL_EXTRA_ANM2_LAYERS, WALL_OFFSET, L_FLOOR_ANM2_LAYERS, N_FLOOR_ANM2_LAYERS, BACKDROP_EFFECT_VARIANT, BACKDROP_EFFECT_SUB_TYPE
+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("src.core.cachedClasses")
+local game = ____cachedClasses.game
+local ____constants = require("src.core.constants")
+local VectorZero = ____constants.VectorZero
+local ____LadderSubTypeCustom = require("src.enums.LadderSubTypeCustom")
+local LadderSubTypeCustom = ____LadderSubTypeCustom.LadderSubTypeCustom
+local ____array = require("src.functions.array")
+local getRandomArrayElement = ____array.getRandomArrayElement
+local ____entitiesSpecific = require("src.functions.entitiesSpecific")
+local spawnEffectWithSeed = ____entitiesSpecific.spawnEffectWithSeed
+local ____rng = require("src.functions.rng")
+local newRNG = ____rng.newRNG
+local ____roomShape = require("src.functions.roomShape")
+local isLRoom = ____roomShape.isLRoom
+local isNarrowRoom = ____roomShape.isNarrowRoom
+local ____string = require("src.functions.string")
+local removeCharactersBefore = ____string.removeCharactersBefore
+local trimPrefix = ____string.trimPrefix
+local ____utils = require("src.functions.utils")
+local eRange = ____utils.eRange
+local iRange = ____utils.iRange
+local ____constants = require("src.classes.features.other.customStages.constants")
+local ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH = ____constants.ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH
+function getBackdropPNGPath(self, customStage, backdropKind, rng)
+    local backdrop = customStage.backdropPNGPaths == nil and DEFAULT_BACKDROP or customStage.backdropPNGPaths
+    local pathArray = backdrop[backdropKind]
+    local randomPath = getRandomArrayElement(nil, pathArray, rng)
+    return removeCharactersBefore(nil, randomPath, "gfx/")
+end
+function spawnWallEntity(self, customStage, rng, isExtraWall)
+    local room = game:GetRoom()
+    local roomShape = room:GetRoomShape()
+    local seed = 1
+    local wallEffect = spawnEffectWithSeed(
+        nil,
+        BACKDROP_EFFECT_VARIANT,
+        BACKDROP_EFFECT_SUB_TYPE,
+        VectorZero,
+        seed
+    )
+    wallEffect:AddEntityFlags(EntityFlag.RENDER_WALL)
+    local sprite = wallEffect:GetSprite()
+    sprite:Load(ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH .. "/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 seed = 1
+    local floorEffect = spawnEffectWithSeed(
+        nil,
+        BACKDROP_EFFECT_VARIANT,
+        0,
+        VectorZero,
+        seed
+    )
+    floorEffect:AddEntityFlags(EntityFlag.RENDER_FLOOR)
+    local sprite = floorEffect:GetSprite()
+    sprite:Load(ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH .. "/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
+    elseif isLRoom(nil, roomShape) then
+        for ____, layerID in ipairs(L_FLOOR_ANM2_LAYERS) do
+            local LFloorPNGPath = getBackdropPNGPath(nil, customStage, BackdropKind.L_FLOOR, rng)
+            sprite:ReplaceSpritesheet(layerID, LFloorPNGPath)
+        end
+    elseif isNarrowRoom(nil, roomShape) then
+        for ____, layerID in ipairs(N_FLOOR_ANM2_LAYERS) 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.N_FLOOR = "nFloors"
+BackdropKind.L_FLOOR = "lFloors"
+BackdropKind.WALL = "walls"
+BackdropKind.CORNER = "corners"
+DEFAULT_BACKDROP = {nFloors = {ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH .. "/backdrop/nfloor.png"}, lFloors = {ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH .. "/backdrop/lfloor.png"}, walls = {ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH .. "/backdrop/wall.png"}, corners = {ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH .. "/backdrop/corner.png"}}
+ROOM_SHAPE_WALL_ANM2_LAYERS = {
+    [RoomShape.SHAPE_1x1] = 44,
+    [RoomShape.IH] = 36,
+    [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)
+L_FLOOR_ANM2_LAYERS = {16, 17}
+N_FLOOR_ANM2_LAYERS = {18, 19}
+BACKDROP_EFFECT_VARIANT = EffectVariant.LADDER
+BACKDROP_EFFECT_SUB_TYPE = LadderSubTypeCustom.CUSTOM_BACKDROP
+local BACKDROP_ROOM_TYPE_SET = __TS__New(Set, {RoomType.DEFAULT, RoomType.BOSS, RoomType.MINI_BOSS})
+function ____exports.setCustomStageBackdrop(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/dist/src/classes/features/other/customStages/constants.d.ts

@@ -0,0 +1,17 @@
+import { LevelStage, StageType } from "isaac-typescript-definitions";
+export declare const CUSTOM_STAGE_FEATURE_NAME = "CustomStage";
+export declare const ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH = "gfx/isaacscript-custom-stage";
+export declare const DEFAULT_BASE_STAGE = LevelStage.BASEMENT_2;
+export declare const DEFAULT_BASE_STAGE_TYPE = StageType.ORIGINAL;
+/**
+ * Equal to -1. Setting the stage to an invalid stage value is useful in that it prevents backdrops
+ * and shadows from loading.
+ */
+export declare const CUSTOM_FLOOR_STAGE: LevelStage;
+/**
+ * We must use `StageType.WRATH_OF_THE_LAMB` instead of `StageType.ORIGINAL` or else the walls will
+ * not render properly. DeadInfinity suspects that this might be because it is trying to use the
+ * Dark Room's backdrop (instead of The Chest).
+ */
+export declare const CUSTOM_FLOOR_STAGE_TYPE = StageType.WRATH_OF_THE_LAMB;
+//# sourceMappingURL=constants.d.ts.map

package/dist/src/classes/features/other/customStages/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../../../src/classes/features/other/customStages/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAErE,eAAO,MAAM,yBAAyB,gBAAgB,CAAC;AAEvD,eAAO,MAAM,iCAAiC,iCAAiC,CAAC;AAEhF,eAAO,MAAM,kBAAkB,wBAAwB,CAAC;AACxD,eAAO,MAAM,uBAAuB,qBAAqB,CAAC;AAE1D;;;GAGG;AACH,eAAO,MAAM,kBAAkB,YAAmB,CAAC;AAEnD;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,8BAA8B,CAAC"}

package/dist/src/classes/features/other/customStages/constants.lua

@@ -0,0 +1,16 @@
+local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local LevelStage = ____isaac_2Dtypescript_2Ddefinitions.LevelStage
+local StageType = ____isaac_2Dtypescript_2Ddefinitions.StageType
+____exports.CUSTOM_STAGE_FEATURE_NAME = "CustomStage"
+____exports.ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH = "gfx/isaacscript-custom-stage"
+____exports.DEFAULT_BASE_STAGE = LevelStage.BASEMENT_2
+____exports.DEFAULT_BASE_STAGE_TYPE = StageType.ORIGINAL
+--- Equal to -1. Setting the stage to an invalid stage value is useful in that it prevents backdrops
+-- and shadows from loading.
+____exports.CUSTOM_FLOOR_STAGE = -1
+--- We must use `StageType.WRATH_OF_THE_LAMB` instead of `StageType.ORIGINAL` or else the walls will
+-- not render properly. DeadInfinity suspects that this might be because it is trying to use the
+-- Dark Room's backdrop (instead of The Chest).
+____exports.CUSTOM_FLOOR_STAGE_TYPE = StageType.WRATH_OF_THE_LAMB
+return ____exports

package/dist/src/classes/features/other/customStages/gridEntities.d.ts

@@ -0,0 +1,13 @@
+/// <reference types="isaac-typescript-definitions" />
+import { CustomStage } from "../../../../interfaces/private/CustomStage";
+import { CustomTrapdoors } from "../CustomTrapdoors";
+/** 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;
+export declare function convertVanillaTrapdoors(customStage: CustomStage, gridEntity: GridEntity, isFirstFloor: boolean, customTrapdoors: CustomTrapdoors): void;
+//# sourceMappingURL=gridEntities.d.ts.map

package/dist/src/classes/features/other/customStages/gridEntities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gridEntities.d.ts","sourceRoot":"","sources":["../../../../../../src/classes/features/other/customStages/gridEntities.ts"],"names":[],"mappings":";AAIA,OAAO,EAAE,WAAW,EAAE,MAAM,4CAA4C,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGrD,2CAA2C;AAC3C,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,UAAU,GACrB,IAAI,CAoCN;AAED,qCAAqC;AACrC,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,UAAU,GACrB,IAAI,CAqDN;AAED,oCAAoC;AACpC,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,UAAU,GACrB,IAAI,CAoBN;AAED,sCAAsC;AACtC,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,UAAU,GACrB,IAAI,CAoBN;AAuDD,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,UAAU,EACtB,YAAY,EAAE,OAAO,EACrB,eAAe,EAAE,eAAe,GAC/B,IAAI,CAiCN"}