isaacscript-common 1.0.461 → 1.0.465

package/dist/features/deployJSONRoom.d.ts

@@ -0,0 +1,38 @@
+/// <reference types="isaac-typescript-definitions" />
+import { JSONRoom } from "../types/JSONRoom";
+import { ModUpgraded } from "../types/ModUpgraded";
+/** @hidden */
+export declare function deployJSONRoomInit(mod: ModUpgraded): void;
+/**
+ * Helper function to deconstruct a vanilla room and set up a custom room in its place.
+ * Specifically, this will clear the current room of all entities and grid entities, and then spawn
+ * all of the entries and grid entities in the provided JSON room.
+ *
+ * This function is meant to be used in the PostNewRoom callback.
+ *
+ * @returns The iterated seed, which can be used in subsequent room deployments. (The seed is used
+ * to spawn every entity contained within the custom room.)
+ */
+export declare function deployJSONRoom(jsonRoom: JSONRoom, seed?: number): int;
+/**
+ * Helper function to deconstruct a vanilla room and set up a custom room in its place.
+ * Specifically, this will clear the current room of all entities and grid entities, and then spawn
+ * all of the entries and grid entities in one of the provided JSON rooms.
+ *
+ * This function is meant to be used in the PostNewRoom callback.
+ *
+ * @returns The iterated seed, which can be used in subsequent room deployments. (The seed is used
+ * to spawn every entity contained within the custom room.)
+ */
+export declare function deployRandomJSONRoom(jsonRooms: JSONRoom[], seed?: number): int;
+/**
+ * Helper function to remove all naturally spawning entities and grid entities from a room. Notably,
+ * this will not remove players (1), tears (2), familiars (3), lasers (7), knives (8),
+ * projectiles (9), blacklisted NPCs such as Dark Esau, charmed NPCs, friendly NPCs, and persistent
+ * NPCs.
+ *
+ * @param fillWithDecorations Optional. Set to true to fill every grid tile with an invisible
+ * decoration, which prevents vanilla entities in the room from respawning the next time that the
+ * player enters. False by default.
+ */
+export declare function emptyRoom(fillWithDecorations: boolean): void;

package/dist/features/deployJSONRoom.lua

@@ -0,0 +1,385 @@
+--[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
+require("lualib_bundle");
+local ____exports = {}
+local postNewRoom, setDecorationsInvisible, respawnPersistentEntities, removeSpecificNPCs, fillRoomWithDecorations, spawnAllEntities, spawnGridEntity, spawnNormalEntity, storePersistentEntity, fixPitGraphics, getPitMap, getPitFrame, FEATURE_NAME, NPCS_TO_NOT_REMOVE, PERSISTENT_ENTITY_TYPES, initialized, v
+local ____errors = require("errors")
+local getUpgradeErrorMsg = ____errors.getUpgradeErrorMsg
+local ____entity = require("functions.entity")
+local removeAllBombs = ____entity.removeAllBombs
+local removeAllMatchingEntities = ____entity.removeAllMatchingEntities
+local removeAllPickups = ____entity.removeAllPickups
+local ____gridEntity = require("functions.gridEntity")
+local convertXMLGridEntityType = ____gridEntity.convertXMLGridEntityType
+local getGridEntities = ____gridEntity.getGridEntities
+local setGridEntityInvisible = ____gridEntity.setGridEntityInvisible
+local ____jsonRoom = require("functions.jsonRoom")
+local getRandomJSONRoom = ____jsonRoom.getRandomJSONRoom
+local ____npc = require("functions.npc")
+local getNPCs = ____npc.getNPCs
+local ____random = require("functions.random")
+local nextSeed = ____random.nextSeed
+local ____rooms = require("functions.rooms")
+local getRoomIndex = ____rooms.getRoomIndex
+local gridToPos = ____rooms.gridToPos
+local setRoomCleared = ____rooms.setRoomCleared
+local setRoomUncleared = ____rooms.setRoomUncleared
+local ____spawnCollectible = require("functions.spawnCollectible")
+local spawnCollectible = ____spawnCollectible.spawnCollectible
+local ____exports = require("features.saveDataManager.exports")
+local saveDataManager = ____exports.saveDataManager
+function postNewRoom(self)
+    local roomIndex = getRoomIndex(nil)
+    if not v.level.deployedRoomIndexes:has(roomIndex) then
+        return
+    end
+    setDecorationsInvisible(nil)
+    respawnPersistentEntities(nil)
+end
+function setDecorationsInvisible(self)
+    local game = Game()
+    local room = game:GetRoom()
+    local roomIndex = getRoomIndex(nil)
+    local decorationGridIndexes = v.level.decorationGridIndexes:get(roomIndex)
+    if decorationGridIndexes == nil then
+        return
+    end
+    for ____, gridIndex in ipairs(decorationGridIndexes) do
+        local gridEntity = room:GetGridEntity(gridIndex)
+        if gridEntity ~= nil then
+            setGridEntityInvisible(nil, gridEntity)
+        end
+    end
+end
+function respawnPersistentEntities(self)
+    local game = Game()
+    local room = game:GetRoom()
+    local roomIndex = getRoomIndex(nil)
+    local persistentEntities = v.level.persistentEntities:get(roomIndex)
+    if persistentEntities == nil then
+        return
+    end
+    for ____, persistentEntity in ipairs(persistentEntities) do
+        local position = room:GetGridPosition(persistentEntity.gridIndex)
+        Isaac.Spawn(persistentEntity.type, persistentEntity.variant, persistentEntity.subType, position, Vector.Zero, nil)
+    end
+end
+function ____exports.emptyRoom(self, fillWithDecorations)
+    if not initialized then
+        local msg = getUpgradeErrorMsg(nil, FEATURE_NAME)
+        error(msg)
+    end
+    local roomIndex = getRoomIndex(nil)
+    v.level.deployedRoomIndexes:add(roomIndex)
+    removeAllBombs(nil)
+    removeAllPickups(nil)
+    removeAllMatchingEntities(nil, EntityType.ENTITY_SLOT)
+    removeSpecificNPCs(nil)
+    setRoomCleared(nil)
+    if fillWithDecorations then
+        fillRoomWithDecorations(nil)
+    end
+end
+function removeSpecificNPCs(self)
+    local game = Game()
+    local room = game:GetRoom()
+    for ____, npc in ipairs(
+        getNPCs(nil)
+    ) do
+        do
+            if NPCS_TO_NOT_REMOVE:has(npc.Type) then
+                goto __continue20
+            end
+            if (npc:HasEntityFlags(EntityFlag.FLAG_CHARM) or npc:HasEntityFlags(EntityFlag.FLAG_FRIENDLY)) or npc:HasEntityFlags(EntityFlag.FLAG_PERSISTENT) then
+                goto __continue20
+            end
+            npc:ClearEntityFlags(EntityFlag.FLAG_APPEAR)
+            npc:Remove()
+            if npc.Type == EntityType.ENTITY_FIREPLACE then
+                local gridIndex = room:GetGridIndex(npc.Position)
+                room:SetGridPath(gridIndex, 0)
+            end
+        end
+        ::__continue20::
+    end
+end
+function fillRoomWithDecorations(self)
+    local game = Game()
+    local room = game:GetRoom()
+    local gridSize = room:GetGridSize()
+    local roomIndex = getRoomIndex(nil)
+    local decorationGridIndexes = v.level.decorationGridIndexes:get(roomIndex)
+    if decorationGridIndexes == nil then
+        decorationGridIndexes = {}
+        v.level.decorationGridIndexes:set(roomIndex, decorationGridIndexes)
+    end
+    do
+        local gridIndex = 0
+        while gridIndex < gridSize do
+            do
+                local existingGridEntity = room:GetGridEntity(gridIndex)
+                if existingGridEntity ~= nil then
+                    goto __continue26
+                end
+                local position = room:GetGridPosition(gridIndex)
+                local decoration = Isaac.GridSpawn(GridEntityType.GRID_DECORATION, 0, position, true)
+                setGridEntityInvisible(nil, decoration)
+                __TS__ArrayPush(decorationGridIndexes, gridIndex)
+            end
+            ::__continue26::
+            gridIndex = gridIndex + 1
+        end
+    end
+end
+function spawnAllEntities(self, jsonRoom, seed)
+    local shouldUnclearRoom = false
+    for ____, spawn in ipairs(jsonRoom.spawn) do
+        local xString = spawn["$"].x
+        local x = tonumber(xString)
+        if x == nil then
+            error("Failed to convert the following x coordinate to a number (for a spawn): " .. xString)
+        end
+        local yString = spawn["$"].y
+        local y = tonumber(yString)
+        if y == nil then
+            error("Failed to convert the following y coordinate to a number (for a spawn): " .. yString)
+        end
+        local entityTypeString = spawn.entity["$"].type
+        local entityType = tonumber(entityTypeString)
+        if entityType == nil then
+            error("Failed to convert the entity type to a number: " .. entityTypeString)
+        end
+        local variantString = spawn.entity["$"].variant
+        local variant = tonumber(variantString)
+        if variant == nil then
+            error(
+                "Failed to convert the entity variant to a number: " .. tostring(variant)
+            )
+        end
+        local subTypeString = spawn.entity["$"].subtype
+        local subType = tonumber(subTypeString)
+        if subType == nil then
+            error(
+                "Failed to convert the entity sub-type to a number: " .. tostring(subType)
+            )
+        end
+        if entityType >= 1000 then
+            spawnGridEntity(nil, entityType, variant, x, y)
+        else
+            seed = nextSeed(nil, seed)
+            local entity = spawnNormalEntity(nil, entityType, variant, subType, x, y, seed)
+            local npc = entity:ToNPC()
+            if (npc ~= nil) and npc.CanShutDoors then
+                shouldUnclearRoom = true
+            end
+        end
+    end
+    if shouldUnclearRoom then
+        setRoomUncleared(nil)
+    end
+    return seed
+end
+function spawnGridEntity(self, xmlEntityType, xmlEntityVariant, x, y)
+    local gridEntityArray = convertXMLGridEntityType(nil, xmlEntityType, xmlEntityVariant)
+    if gridEntityArray == nil then
+        return nil
+    end
+    local entityType, variant = table.unpack(gridEntityArray)
+    local position = gridToPos(nil, x, y)
+    local gridEntity = Isaac.GridSpawn(entityType, variant, position, true)
+    if entityType == GridEntityType.GRID_PIT then
+        local pit = gridEntity:ToPit()
+        if pit ~= nil then
+            pit:UpdateCollision()
+        end
+    end
+    if entityType == GridEntityType.GRID_POOP then
+        local sprite = gridEntity:GetSprite()
+        sprite:Play("State1", true)
+        sprite:SetLastFrame()
+    end
+    return gridEntity
+end
+function spawnNormalEntity(self, entityType, variant, subType, x, y, seed)
+    local game = Game()
+    local room = game:GetRoom()
+    local roomType = room:GetType()
+    local position = gridToPos(nil, x, y)
+    local entity
+    if (entityType == EntityType.ENTITY_PICKUP) and (variant == PickupVariant.PICKUP_COLLECTIBLE) then
+        local options = roomType == RoomType.ROOM_ANGEL
+        entity = spawnCollectible(nil, subType, position, seed, options)
+    else
+        entity = game:Spawn(entityType, variant, position, Vector.Zero, nil, subType, seed)
+    end
+    if (entityType == EntityType.ENTITY_PITFALL) and (variant == 0) then
+        entity.EntityCollisionClass = EntityCollisionClass.ENTCOLL_ENEMIES
+        entity.GridCollisionClass = EntityGridCollisionClass.GRIDCOLL_WALLS
+    end
+    storePersistentEntity(nil, entity)
+    return entity
+end
+function storePersistentEntity(self, entity)
+    if not PERSISTENT_ENTITY_TYPES:has(entity.Type) then
+        return
+    end
+    local game = Game()
+    local room = game:GetRoom()
+    local gridIndex = room:GetGridIndex(entity.Position)
+    local roomIndex = getRoomIndex(nil)
+    local persistentEntity = {gridIndex = gridIndex, type = entity.Type, variant = entity.Variant, subType = entity.SubType}
+    local persistentEntities = v.level.persistentEntities:get(roomIndex)
+    if persistentEntities == nil then
+        persistentEntities = {}
+        v.level.persistentEntities:set(roomIndex, persistentEntities)
+    end
+    __TS__ArrayPush(persistentEntities, persistentEntity)
+end
+function fixPitGraphics(self)
+    local game = Game()
+    local room = game:GetRoom()
+    local gridWidth = room:GetGridWidth()
+    local pitMap = getPitMap(nil)
+    for ____, ____value in __TS__Iterator(
+        pitMap:entries()
+    ) do
+        local gridIndex
+        gridIndex = ____value[1]
+        local gridEntity
+        gridEntity = ____value[2]
+        local gridIndexLeft = gridIndex - 1
+        local L = pitMap:has(gridIndexLeft)
+        local gridIndexRight = gridIndex + 1
+        local R = pitMap:has(gridIndexRight)
+        local gridIndexUp = gridIndex - gridWidth
+        local U = pitMap:has(gridIndexUp)
+        local gridIndexDown = gridIndex + gridWidth
+        local D = pitMap:has(gridIndexDown)
+        local gridIndexUpLeft = (gridIndex - gridWidth) - 1
+        local UL = pitMap:has(gridIndexUpLeft)
+        local gridIndexUpRight = (gridIndex - gridWidth) + 1
+        local UR = pitMap:has(gridIndexUpRight)
+        local gridIndexDownLeft = (gridIndex + gridWidth) - 1
+        local DL = pitMap:has(gridIndexDownLeft)
+        local gridIndexDownRight = (gridIndex + gridWidth) + 1
+        local DR = pitMap:has(gridIndexDownRight)
+        local pitFrame = getPitFrame(nil, L, R, U, D, UL, UR, DL, DR)
+        local sprite = gridEntity:GetSprite()
+        sprite:SetFrame(pitFrame)
+    end
+end
+function getPitMap(self)
+    local pitMap = __TS__New(Map)
+    for ____, gridEntity in ipairs(
+        getGridEntities(nil, GridEntityType.GRID_PIT)
+    ) do
+        local gridIndex = gridEntity:GetGridIndex()
+        pitMap:set(gridIndex, gridEntity)
+    end
+    return pitMap
+end
+function getPitFrame(self, L, R, U, D, UL, UR, DL, DR)
+    local F = 0
+    if L then
+        F = F | 1
+    end
+    if U then
+        F = F | 2
+    end
+    if R then
+        F = F | 4
+    end
+    if D then
+        F = F | 8
+    end
+    if (((U and L) and (not UL)) and (not R)) and (not D) then
+        F = 17
+    end
+    if (((U and R) and (not UR)) and (not L)) and (not D) then
+        F = 18
+    end
+    if (((L and D) and (not DL)) and (not U)) and (not R) then
+        F = 19
+    end
+    if (((R and D) and (not DR)) and (not L)) and (not U) then
+        F = 20
+    end
+    if (((L and U) and R) and D) and (not UL) then
+        F = 21
+    end
+    if (((L and U) and R) and D) and (not UR) then
+        F = 22
+    end
+    if (((U and R) and D) and (not L)) and (not UR) then
+        F = 25
+    end
+    if (((L and U) and D) and (not R)) and (not UL) then
+        F = 26
+    end
+    if ((((L and U) and R) and D) and (not DL)) and (not DR) then
+        F = 24
+    end
+    if ((((L and U) and R) and D) and (not UR)) and (not UL) then
+        F = 23
+    end
+    if ((((L and U) and R) and UL) and (not UR)) and (not D) then
+        F = 27
+    end
+    if ((((L and U) and R) and UR) and (not UL)) and (not D) then
+        F = 28
+    end
+    if ((((L and U) and R) and (not D)) and (not UR)) and (not UL) then
+        F = 29
+    end
+    if ((((L and R) and D) and DL) and (not U)) and (not DR) then
+        F = 30
+    end
+    if ((((L and R) and D) and DR) and (not U)) and (not DL) then
+        F = 31
+    end
+    if ((((L and R) and D) and (not U)) and (not DL)) and (not DR) then
+        F = 32
+    end
+    return F
+end
+FEATURE_NAME = "JSON room deployer"
+NPCS_TO_NOT_REMOVE = __TS__New(Set, {EntityType.ENTITY_DARK_ESAU})
+PERSISTENT_ENTITY_TYPES = __TS__New(Set, {EntityType.ENTITY_WALL_HUGGER})
+initialized = false
+v = {
+    level = {
+        deployedRoomIndexes = __TS__New(Set),
+        persistentEntities = __TS__New(Map),
+        decorationGridIndexes = __TS__New(Map)
+    }
+}
+function ____exports.deployJSONRoomInit(self, mod)
+    initialized = true
+    saveDataManager(nil, "deployJSONRoom", v)
+    mod:AddCallback(ModCallbacks.MC_POST_NEW_ROOM, postNewRoom)
+end
+function ____exports.deployJSONRoom(self, jsonRoom, seed)
+    if seed == nil then
+        seed = Random()
+    end
+    if not initialized then
+        local msg = getUpgradeErrorMsg(nil, FEATURE_NAME)
+        error(msg)
+    end
+    ____exports.emptyRoom(nil, false)
+    local newSeed = spawnAllEntities(nil, jsonRoom, seed)
+    fixPitGraphics(nil)
+    fillRoomWithDecorations(nil)
+    return newSeed
+end
+function ____exports.deployRandomJSONRoom(self, jsonRooms, seed)
+    if seed == nil then
+        seed = Random()
+    end
+    if not initialized then
+        local msg = getUpgradeErrorMsg(nil, FEATURE_NAME)
+        error(msg)
+    end
+    local randomJSONRoom = getRandomJSONRoom(nil, jsonRooms, seed)
+    return ____exports.deployJSONRoom(nil, randomJSONRoom, seed)
+end
+return ____exports

package/dist/features/preventCollectibleRotate.d.ts

@@ -0,0 +1,13 @@
+/// <reference types="isaac-typescript-definitions" />
+import { ModUpgraded } from "../types/ModUpgraded";
+export declare function preventCollectibleRotateInit(mod: ModUpgraded): void;
+/**
+ * Helper function to prevent a collectible from being affected by Tainted Isaac's rotation
+ * mechanic. (This mechanic also happens from Glitched Crown and Binge Eater.) This is useful
+ * because quest items that are manually spawned by mods will be automatically be affected by this
+ * mechanic.
+ *
+ * It is required to pass the intended collectible type to this function since it is possible for
+ * collectibles to rotate on the first frame that they are spawned.
+ */
+export declare function preventCollectibleRotate(collectible: EntityPickup, collectibleType: CollectibleType | int): void;

package/dist/features/preventCollectibleRotate.lua

@@ -0,0 +1,49 @@
+--[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
+require("lualib_bundle");
+local ____exports = {}
+local useCardSoulOfIsaac, postPickupUpdateCollectible, v
+local ____errors = require("errors")
+local getUpgradeErrorMsg = ____errors.getUpgradeErrorMsg
+local ____collectibles = require("functions.collectibles")
+local setCollectibleSubType = ____collectibles.setCollectibleSubType
+local ____exports = require("features.saveDataManager.exports")
+local saveDataManager = ____exports.saveDataManager
+function useCardSoulOfIsaac(self)
+    v.room.trackedItems:clear()
+end
+function postPickupUpdateCollectible(self, pickup)
+    if pickup.SubType == CollectibleType.COLLECTIBLE_NULL then
+        return
+    end
+    local trackedCollectibleType = v.room.trackedItems:get(pickup.InitSeed)
+    if (trackedCollectibleType ~= nil) and (pickup.SubType ~= trackedCollectibleType) then
+        setCollectibleSubType(nil, pickup, trackedCollectibleType)
+    end
+end
+local FEATURE_NAME = "prevent collectible rotation"
+local initialized = false
+v = {
+    room = {
+        trackedItems = __TS__New(Map)
+    }
+}
+function ____exports.preventCollectibleRotateInit(self, mod)
+    initialized = true
+    saveDataManager(nil, "preventCollectibleRotate", v)
+    mod:AddCallback(ModCallbacks.MC_USE_CARD, useCardSoulOfIsaac, Card.CARD_SOUL_ISAAC)
+    mod:AddCallback(ModCallbacks.MC_POST_PICKUP_UPDATE, postPickupUpdateCollectible, PickupVariant.PICKUP_COLLECTIBLE)
+end
+function ____exports.preventCollectibleRotate(self, collectible, collectibleType)
+    if not initialized then
+        local msg = getUpgradeErrorMsg(nil, FEATURE_NAME)
+        error(msg)
+    end
+    if collectible.Variant ~= PickupVariant.PICKUP_COLLECTIBLE then
+        error(
+            "You cannot prevent the rotation for pickups of variant: " .. tostring(collectible.Variant)
+        )
+    end
+    v.room.trackedItems:set(collectible.InitSeed, collectibleType)
+    postPickupUpdateCollectible(nil, collectible)
+end
+return ____exports

package/dist/functions/collectibleSet.lua

@@ -6,7 +6,7 @@ local getMaxCollectibleID = ____collectibles.getMaxCollectibleID
 local ____util = require("functions.util")
 local copySet = ____util.copySet
 local COLLECTIBLE_SET = __TS__New(Set)
-local function initSet(self)
+local function initCollectibleSet(self)
     local itemConfig = Isaac.GetItemConfig()
     do
         local collectibleType = 1
@@ -21,7 +21,7 @@ local function initSet(self)
 end
 function ____exports.getCollectibleSet(self)
     if COLLECTIBLE_SET.size == 0 then
-        initSet(nil)
+        initCollectibleSet(nil)
     end
     return copySet(nil, COLLECTIBLE_SET)
 end

package/dist/functions/collectibles.d.ts

@@ -42,10 +42,10 @@ export declare function removeAllCollectibles(): void;
  * Python program located at: https://github.com/Rchardon/RebirthItemTracker
  */
 export declare function removeCollectibleFromItemTracker(collectibleType: CollectibleType | int): void;
-export declare function setCollectibleBlind(pickup: EntityPickup): void;
-export declare function setCollectibleSprite(pickup: EntityPickup, pngPath: string): void;
+export declare function setCollectibleBlind(collectible: EntityPickup): void;
+export declare function setCollectibleSprite(collectible: EntityPickup, pngPath: string): void;
 /**
- * Helper function to change the item on an item pedestal. Simply updating the SubType is not
- * sufficient because you also need to update the sprite.
+ * Helper function to change the collectible on a pedestal. Simply updating the SubType property is
+ * not sufficient because the sprite will not change.
  */
 export declare function setCollectibleSubType(collectible: EntityPickup, newCollectibleType: CollectibleType | int): void;

package/dist/functions/collectibles.lua

@@ -6,13 +6,13 @@ local ____collectibleNameMap = require("collectibleNameMap")
 local COLLECTIBLE_NAME_MAP = ____collectibleNameMap.COLLECTIBLE_NAME_MAP
 local ____entity = require("functions.entity")
 local removeAllMatchingEntities = ____entity.removeAllMatchingEntities
-function ____exports.setCollectibleSprite(self, pickup, pngPath)
-    if pickup.Variant ~= PickupVariant.PICKUP_COLLECTIBLE then
+function ____exports.setCollectibleSprite(self, collectible, pngPath)
+    if collectible.Variant ~= PickupVariant.PICKUP_COLLECTIBLE then
         error(
-            "You cannot set a collectible sprite for pickups of variant: " .. tostring(pickup.Variant)
+            "You cannot set a collectible sprite for pickups of variant: " .. tostring(collectible.Variant)
         )
     end
-    local sprite = pickup:GetSprite()
+    local sprite = collectible:GetSprite()
     sprite:ReplaceSpritesheet(COLLECTIBLE_SPRITE_LAYER, pngPath)
     sprite:LoadGraphics()
 end
@@ -121,18 +121,20 @@ function ____exports.removeCollectibleFromItemTracker(self, collectibleType)
         ((("Removing collectible " .. tostring(collectibleType)) .. " (") .. collectibleName) .. ") on player 0 (Player)"
     )
 end
-function ____exports.setCollectibleBlind(self, pickup)
-    ____exports.setCollectibleSprite(nil, pickup, BLIND_ITEM_PNG_PATH)
+function ____exports.setCollectibleBlind(self, collectible)
+    if collectible.Variant ~= PickupVariant.PICKUP_COLLECTIBLE then
+        error(
+            "You cannot set a collectible to be blind for pickups of variant: " .. tostring(collectible.Variant)
+        )
+    end
+    ____exports.setCollectibleSprite(nil, collectible, BLIND_ITEM_PNG_PATH)
 end
 function ____exports.setCollectibleSubType(self, collectible, newCollectibleType)
-    collectible.SubType = newCollectibleType
-    local itemConfig = Isaac.GetItemConfig()
-    local itemConfigItem = itemConfig:GetCollectible(newCollectibleType)
-    if itemConfigItem == nil then
+    if collectible.Variant ~= PickupVariant.PICKUP_COLLECTIBLE then
         error(
-            "Failed to get the item config for: " .. tostring(newCollectibleType)
+            "You cannot set a collectible sub type for pickups of variant: " .. tostring(collectible.Variant)
         )
     end
-    ____exports.setCollectibleSprite(nil, collectible, itemConfigItem.GfxFileName)
+    collectible:Morph(EntityType.ENTITY_PICKUP, PickupVariant.PICKUP_COLLECTIBLE, newCollectibleType, true, true, true)
 end
 return ____exports

package/dist/functions/doors.d.ts

@@ -1,4 +1,5 @@
 /// <reference types="isaac-typescript-definitions" />
+export declare function closeAllDoors(): void;
 export declare function getDoors(roomType?: RoomType): GridEntityDoor[];
 export declare function getAngelRoomDoor(): GridEntityDoor | undefined;
 export declare function getDevilRoomDoor(): GridEntityDoor | undefined;

package/dist/functions/doors.lua

@@ -3,20 +3,6 @@ require("lualib_bundle");
 local ____exports = {}
 local ____constants = require("constants")
 local MAX_NUM_DOORS = ____constants.MAX_NUM_DOORS
-function ____exports.isAngelRoomDoor(self, door)
-    return door.TargetRoomType == RoomType.ROOM_ANGEL
-end
-function ____exports.isDevilRoomDoor(self, door)
-    return door.TargetRoomType == RoomType.ROOM_DEVIL
-end
-function ____exports.isRepentanceDoor(self, door)
-    return door.TargetRoomIndex == GridRooms.ROOM_SECRET_EXIT_IDX
-end
-function ____exports.isSecretRoomDoor(self, door)
-    local sprite = door:GetSprite()
-    local filename = sprite:GetFilename()
-    return filename == "gfx/grid/Door_08_HoleInWall.anm2"
-end
 function ____exports.getDoors(self, roomType)
     local game = Game()
     local room = game:GetRoom()
@@ -27,7 +13,7 @@ function ____exports.getDoors(self, roomType)
             do
                 local door = room:GetDoor(i)
                 if door == nil then
-                    goto __continue3
+                    goto __continue5
                 end
                 if roomType == nil then
                     __TS__ArrayPush(doors, door)
@@ -35,12 +21,35 @@ function ____exports.getDoors(self, roomType)
                     __TS__ArrayPush(doors, door)
                 end
             end
-            ::__continue3::
+            ::__continue5::
             i = i + 1
         end
     end
     return doors
 end
+function ____exports.isAngelRoomDoor(self, door)
+    return door.TargetRoomType == RoomType.ROOM_ANGEL
+end
+function ____exports.isDevilRoomDoor(self, door)
+    return door.TargetRoomType == RoomType.ROOM_DEVIL
+end
+function ____exports.isRepentanceDoor(self, door)
+    return door.TargetRoomIndex == GridRooms.ROOM_SECRET_EXIT_IDX
+end
+function ____exports.isSecretRoomDoor(self, door)
+    local sprite = door:GetSprite()
+    local filename = sprite:GetFilename()
+    return filename == "gfx/grid/Door_08_HoleInWall.anm2"
+end
+function ____exports.closeAllDoors(self)
+    for ____, door in ipairs(
+        ____exports.getDoors(nil)
+    ) do
+        door.State = DoorState.STATE_CLOSED
+        local sprite = door:GetSprite()
+        sprite:Play("Close", true)
+    end
+end
 function ____exports.getAngelRoomDoor(self)
     for ____, door in ipairs(
         ____exports.getDoors(nil)

package/dist/functions/gridEntity.d.ts

@@ -1,4 +1,10 @@
 /// <reference types="isaac-typescript-definitions" />
+/**
+ * Helper function to convert the grid entity type found in a room XML file to the corresponding
+ * grid entity type and variant normally used by the game. For example, a rock is represented as
+ * 1000.0 in a room XML file, but `GridEntityType.GRID_ROCK` is equal to 2.
+ */
+export declare function convertXMLGridEntityType(gridEntityXMLType: int, gridEntityXMLVariant: int): [int, int] | undefined;
 /**
  * Helper function to get every grid entity in the current room. Use it with no arguments to get
  * every grid entity, or specify a variadic amount of arguments to match specific grid entity types.
@@ -35,6 +41,14 @@ export declare function isPostBossVoidPortal(gridEntity: GridEntity): boolean;
 export declare function removeAllGridEntitiesExceptFor(...gridEntityTypes: GridEntityType[]): void;
 export declare function removeAllMatchingGridEntities(gridEntityType: GridEntityType): void;
 export declare function removeGridEntity(gridEntity: GridEntity): void;
+/**
+ * Helper function to make a grid entity invisible. This is accomplished by setting its sprite to
+ * "gfx/none.png" (a non-existent PNG file).
+ *
+ * Using this function will cause spurious errors in the "log.txt file". If you want to remove them,
+ * create a transparent 1 pixel PNG file in your resources folder at "gfx/none.png".
+ */
+export declare function setGridEntityInvisible(gridEntity: GridEntity): void;
 export declare function spawnGiantPoop(topLeftGridIndex: int): void;
 export declare function spawnGridEntity(gridEntityType: GridEntityType, gridIndex: int): GridEntity;
 export declare function spawnGridEntityWithVariant(gridEntityType: GridEntityType, variant: int, gridIndex: int): GridEntity;