isaacscript-common 2.0.15 → 2.0.18

package/dist/functions/collectibleSet.lua

@@ -5,6 +5,7 @@ local ____exports = {}
 local ____cachedClasses = require("cachedClasses")
 local itemConfig = ____cachedClasses.itemConfig
 local ____constantsMax = require("constantsMax")
+local FIRST_COLLECTIBLE_TYPE = ____constantsMax.FIRST_COLLECTIBLE_TYPE
 local MAX_COLLECTIBLE_TYPE = ____constantsMax.MAX_COLLECTIBLE_TYPE
 local ____set = require("functions.set")
 local copySet = ____set.copySet
@@ -12,7 +13,8 @@ local ____utils = require("functions.utils")
 local irange = ____utils.irange
 local COLLECTIBLE_SET = __TS__New(Set)
 local function initCollectibleSet(self)
-    for ____, collectibleType in ipairs(irange(nil, 1, MAX_COLLECTIBLE_TYPE)) do
+    for ____, collectibleTypeInt in ipairs(irange(nil, FIRST_COLLECTIBLE_TYPE, MAX_COLLECTIBLE_TYPE)) do
+        local collectibleType = collectibleTypeInt
         local itemConfigItem = itemConfig:GetCollectible(collectibleType)
         if itemConfigItem ~= nil then
             COLLECTIBLE_SET:add(collectibleType)

package/dist/functions/collectibleTag.lua

@@ -9,6 +9,7 @@ local ItemConfigTag = ____isaac_2Dtypescript_2Ddefinitions.ItemConfigTag
 local ____cachedClasses = require("cachedClasses")
 local itemConfig = ____cachedClasses.itemConfig
 local ____constantsMax = require("constantsMax")
+local FIRST_COLLECTIBLE_TYPE = ____constantsMax.FIRST_COLLECTIBLE_TYPE
 local MAX_COLLECTIBLE_TYPE = ____constantsMax.MAX_COLLECTIBLE_TYPE
 local ____enums = require("functions.enums")
 local getEnumValues = ____enums.getEnumValues
@@ -35,7 +36,8 @@ local function initTagMap(self)
             __TS__New(Set)
         )
     end
-    for ____, collectibleType in ipairs(irange(nil, 1, MAX_COLLECTIBLE_TYPE)) do
+    for ____, collectibleTypeInt in ipairs(irange(nil, FIRST_COLLECTIBLE_TYPE, MAX_COLLECTIBLE_TYPE)) do
+        local collectibleType = collectibleTypeInt
         for ____, itemConfigTag in ipairs(getEnumValues(nil, ItemConfigTag)) do
             do
                 if not ____exports.collectibleHasTag(nil, collectibleType, itemConfigTag) then

package/dist/functions/collectibles.d.ts

@@ -123,6 +123,7 @@ export declare function isPassiveCollectible(collectibleType: CollectibleType):
  * dynamically know if a modded item will disappear.
  */
 export declare function isSingleUseCollectible(collectibleType: CollectibleType): boolean;
+export declare function isValidCollectibleType(collectibleType: CollectibleType): boolean;
 /**
  * Helper function to put a message in the log.txt file to let the Rebirth Item Tracker know that it
  * should remove an item.

package/dist/functions/collectibles.lua

@@ -21,8 +21,12 @@ local COLLECTIBLE_NAME_MAP = ____collectibleNameMap.COLLECTIBLE_NAME_MAP
 local DEFAULT_COLLECTIBLE_NAME = ____collectibleNameMap.DEFAULT_COLLECTIBLE_NAME
 local ____singleUseActiveCollectibleTypesSet = require("sets.singleUseActiveCollectibleTypesSet")
 local SINGLE_USE_ACTIVE_COLLECTIBLE_TYPES_SET = ____singleUseActiveCollectibleTypesSet.SINGLE_USE_ACTIVE_COLLECTIBLE_TYPES_SET
+local ____entity = require("functions.entity")
+local getEntityID = ____entity.getEntityID
 local ____flag = require("functions.flag")
 local hasFlag = ____flag.hasFlag
+local ____pickupVariants = require("functions.pickupVariants")
+local isCollectible = ____pickupVariants.isCollectible
 local ____roomData = require("functions.roomData")
 local getRoomListIndex = ____roomData.getRoomListIndex
 local ____sprite = require("functions.sprite")
@@ -36,8 +40,9 @@ function initQuestionMarkSprite(self)
     return sprite
 end
 function ____exports.setCollectibleSprite(self, collectible, pngPath)
-    if collectible.Variant ~= PickupVariant.COLLECTIBLE then
-        error("You cannot set a collectible sprite for pickups of variant: " .. tostring(collectible.Variant))
+    if not isCollectible(nil, collectible) then
+        local entityID = getEntityID(nil, collectible)
+        error("The \"setCollectibleSprite\" function was given a non-collectible: " .. entityID)
     end
     local sprite = collectible:GetSprite()
     if pngPath == nil then
@@ -116,8 +121,9 @@ function ____exports.getCollectibleGfxFilename(self, collectibleType)
     return itemConfigItem.GfxFileName
 end
 function ____exports.getCollectibleIndex(self, collectible)
-    if collectible.Variant ~= PickupVariant.COLLECTIBLE then
-        error("You cannot get a collectible index for pickups of variant: " .. tostring(collectible.Variant))
+    if not isCollectible(nil, collectible) then
+        local entityID = getEntityID(nil, collectible)
+        error("The \"getCollectibleIndex\" function was given a non-collectible: " .. entityID)
     end
     local level = game:GetLevel()
     local stage = level:GetStage()
@@ -164,8 +170,9 @@ function ____exports.getCollectibleName(self, collectibleType)
     return DEFAULT_COLLECTIBLE_NAME
 end
 function ____exports.getCollectiblePedestalType(self, collectible)
-    if collectible.Variant ~= PickupVariant.COLLECTIBLE then
-        error("You cannot get the pedestal type for pickups of variant: " .. tostring(collectible.Variant))
+    if not isCollectible(nil, collectible) then
+        local entityID = getEntityID(nil, collectible)
+        error("The \"getCollectiblePedestalType\" function was given a non-collectible: " .. entityID)
     end
     local sprite = collectible:GetSprite()
     return sprite:GetOverlayFrame()
@@ -186,8 +193,9 @@ function ____exports.isActiveCollectible(self, collectibleType)
     return itemType == ItemType.ACTIVE
 end
 function ____exports.isBlindCollectible(self, collectible)
-    if collectible.Variant ~= PickupVariant.COLLECTIBLE then
-        error("You cannot get check for question mark sprites for pickups of variant: " .. tostring(collectible.Variant))
+    if not isCollectible(nil, collectible) then
+        local entityID = getEntityID(nil, collectible)
+        error("The \"isBlindCollectible\" function was given a non-collectible: " .. entityID)
     end
     local sprite = collectible:GetSprite()
     local animation = sprite:GetAnimation()
@@ -205,32 +213,40 @@ end
 function ____exports.isSingleUseCollectible(self, collectibleType)
     return SINGLE_USE_ACTIVE_COLLECTIBLE_TYPES_SET:has(collectibleType)
 end
+function ____exports.isValidCollectibleType(self, collectibleType)
+    local itemConfigItem = itemConfig:GetCollectible(collectibleType)
+    return itemConfigItem ~= nil
+end
 function ____exports.removeCollectibleFromItemTracker(self, collectibleType)
     local collectibleName = ____exports.getCollectibleName(nil, collectibleType)
     Isaac.DebugString(((("Removing collectible " .. tostring(collectibleType)) .. " (") .. collectibleName) .. ") on player 0 (Player)")
 end
 function ____exports.removeCollectiblePickupDelay(self, collectible)
-    if collectible.Variant ~= PickupVariant.COLLECTIBLE then
-        error("You cannot remove pickup delay for pickups of variant: " .. tostring(collectible.Variant))
+    if not isCollectible(nil, collectible) then
+        local entityID = getEntityID(nil, collectible)
+        error("The \"removeCollectiblePickupDelay\" function was given a non-collectible: " .. entityID)
     end
     collectible.Wait = 0
 end
 function ____exports.setCollectibleBlind(self, collectible)
-    if collectible.Variant ~= PickupVariant.COLLECTIBLE then
-        error("You cannot set a collectible to be blind for pickups of variant: " .. tostring(collectible.Variant))
+    if not isCollectible(nil, collectible) then
+        local entityID = getEntityID(nil, collectible)
+        error("The \"setCollectibleBlind\" function was given a non-collectible: " .. entityID)
     end
     ____exports.setCollectibleSprite(nil, collectible, BLIND_ITEM_PNG_PATH)
 end
 function ____exports.setCollectibleEmpty(self, collectible)
-    if collectible.Variant ~= PickupVariant.COLLECTIBLE then
-        error("You cannot set a collectible to be empty for pickups of variant: " .. tostring(collectible.Variant))
+    if not isCollectible(nil, collectible) then
+        local entityID = getEntityID(nil, collectible)
+        error("The \"setCollectibleEmpty\" function was given a non-collectible: " .. entityID)
     end
     collectible.SubType = CollectibleType.NULL
     ____exports.clearCollectibleSprite(nil, collectible)
 end
 function ____exports.setCollectibleSubType(self, collectible, newCollectibleType)
-    if collectible.Variant ~= PickupVariant.COLLECTIBLE then
-        error("You cannot set a collectible sub-type for pickups of variant: " .. tostring(collectible.Variant))
+    if not isCollectible(nil, collectible) then
+        local entityID = getEntityID(nil, collectible)
+        error("The \"setCollectibleSubType\" function was given a non-collectible: " .. entityID)
     end
     if newCollectibleType == CollectibleType.NULL then
         ____exports.setCollectibleEmpty(nil, collectible)

package/dist/functions/entity.d.ts

@@ -98,7 +98,7 @@ export declare function parseEntityTypeVariantString(entityTypeVariantString: st
  * @param cap Optional. If specified, will only remove the given amount of collectibles.
  * @returns True if one or more entities were removed, false otherwise.
  */
-export declare function removeAllMatchingEntities(entityType: int, entityVariant?: number, entitySubType?: number, cap?: int | undefined): boolean;
+export declare function removeAllMatchingEntities(entityType: EntityType, entityVariant?: number, entitySubType?: number, cap?: int | undefined): boolean;
 /**
  * Helper function to remove all of the entities in the supplied array.
  *

package/dist/functions/entitySpecific.d.ts

@@ -1,5 +1,4 @@
 import { BombVariant, EffectVariant, EntityType, FamiliarVariant, KnifeVariant, LaserVariant, PickupVariant, ProjectileVariant, SlotVariant, TearVariant } from "isaac-typescript-definitions";
-import { EntityTypeNonNPC } from "../types/EntityTypeNonNPC";
 /**
  * Helper function to get all of the `EntityType.BOMB` in the room.
  *
@@ -105,7 +104,7 @@ export declare function getProjectiles(projectileVariant?: ProjectileVariant, su
  * }
  * ```
  */
-export declare function getSlots(slotVariant?: SlotVariant, subType?: number): Entity[];
+export declare function getSlots(slotVariant?: SlotVariant, subType?: number): EntitySlot[];
 /**
  * Helper function to get all of the `EntityType.TEAR` in the room.
  *
@@ -230,9 +229,9 @@ export declare function spawnLaser(laserVariant: LaserVariant, subType: int, pos
 /** Helper function to spawn a `EntityType.LASER` (7) with a specific seed. */
 export declare function spawnLaserWithSeed(laserVariant: LaserVariant, subType: int, position: Vector, seed: Seed, velocity?: Readonly<Vector>, spawner?: Entity | undefined): EntityLaser;
 /** Helper function to spawn an NPC. */
-export declare function spawnNPC<T extends EntityType>(entityType: T extends EntityTypeNonNPC ? never : T, variant: int, subType: int, position: Vector, velocity?: Readonly<Vector>, spawner?: Entity | undefined, seed?: Seed | undefined): EntityNPC;
+export declare function spawnNPC(entityType: EntityType, variant: int, subType: int, position: Vector, velocity?: Readonly<Vector>, spawner?: Entity | undefined, seed?: Seed | undefined): EntityNPC;
 /** Helper function to spawn an NPC with a specific seed. */
-export declare function spawnNPCWithSeed<T extends EntityType>(entityType: T extends EntityTypeNonNPC ? never : T, variant: int, subType: int, position: Vector, seed: Seed, velocity?: Readonly<Vector>, spawner?: Entity | undefined): EntityNPC;
+export declare function spawnNPCWithSeed(entityType: EntityType, variant: int, subType: int, position: Vector, seed: Seed, velocity?: Readonly<Vector>, spawner?: Entity | undefined): EntityNPC;
 /** Helper function to spawn a `EntityType.PICKUP` (5). */
 export declare function spawnPickup(pickupVariant: PickupVariant, subType: int, position: Vector, velocity?: Readonly<Vector>, spawner?: Entity | undefined, seed?: Seed | undefined): EntityPickup;
 /** Helper function to spawn a `EntityType.PICKUP` (5) with a specific seed. */
@@ -244,7 +243,7 @@ export declare function spawnProjectileWithSeed(projectileVariant: ProjectileVar
 /** Helper function to spawn a `EntityType.SLOT` (6). */
 export declare function spawnSlot(slotVariant: SlotVariant, subType: int, position: Vector, velocity?: Readonly<Vector>, spawner?: Entity | undefined, seed?: Seed | undefined): Entity;
 /** Helper function to spawn a `EntityType.SLOT` (6) with a specific seed. */
-export declare function spawnSlotWithSeed(slotVariant: int | SlotVariant, subType: int, position: Vector, seed: Seed, velocity?: Readonly<Vector>, spawner?: Entity | undefined): Entity;
+export declare function spawnSlotWithSeed(slotVariant: SlotVariant, subType: int, position: Vector, seed: Seed, velocity?: Readonly<Vector>, spawner?: Entity | undefined): Entity;
 /** Helper function to spawn a `EntityType.TEAR` (2). */
 export declare function spawnTear(tearVariant: TearVariant, subType: int, position: Vector, velocity?: Readonly<Vector>, spawner?: Entity | undefined, seed?: Seed | undefined): EntityTear;
 /** Helper function to spawn a `EntityType.EntityType` (2) with a specific seed. */

package/dist/functions/entityTypes.d.ts

@@ -0,0 +1,5 @@
+/// <reference types="isaac-typescript-definitions" />
+/** For EntityType.RAGLING (246) */
+export declare function isSlot(entity: Entity): entity is EntitySlot;
+/** For EntityType.RAGLING (246) */
+export declare function isRagling(npc: EntityNPC): npc is EntityNPCRagling;

package/dist/functions/entityTypes.lua

@@ -0,0 +1,10 @@
+local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local EntityType = ____isaac_2Dtypescript_2Ddefinitions.EntityType
+function ____exports.isSlot(self, entity)
+    return entity.Type == EntityType.SLOT
+end
+function ____exports.isRagling(self, npc)
+    return npc.Type == EntityType.RAGLING
+end
+return ____exports

package/dist/functions/familiars.d.ts

@@ -1,4 +1,4 @@
-/// <reference types="isaac-typescript-definitions" />
+import { CollectibleType, FamiliarVariant } from "isaac-typescript-definitions";
 /**
  * Helper function to add and remove familiars based on a target amount that you specify.
  *
@@ -28,7 +28,7 @@
  *                        specified, it will search for existing familiars of all sub-types, and
  *                        spawn new familiars with a sub-type of 0.
  */
-export declare function checkFamiliar(player: EntityPlayer, collectibleType: int, targetCount: int, familiarVariant: int, familiarSubType?: int): void;
+export declare function checkFamiliar(player: EntityPlayer, collectibleType: CollectibleType, targetCount: int, familiarVariant: FamiliarVariant, familiarSubType?: int): void;
 /**
  * Helper function to add and remove familiars based on the amount of associated collectibles that a
  * player has.
@@ -56,5 +56,5 @@ export declare function checkFamiliar(player: EntityPlayer, collectibleType: int
  *                        specified, it will search for existing familiars of all sub-types, and
  *                        spawn new familiars with a sub-type of 0.
  */
-export declare function checkFamiliarFromCollectibles(player: EntityPlayer, collectibleType: int, familiarVariant: int, familiarSubType?: int): void;
+export declare function checkFamiliarFromCollectibles(player: EntityPlayer, collectibleType: CollectibleType, familiarVariant: FamiliarVariant, familiarSubType?: int): void;
 export declare function isFamiliarThatShootsPlayerTears(familiar: EntityFamiliar): boolean;

package/dist/functions/gridEntity.d.ts

@@ -55,11 +55,6 @@ export declare function getTopLeftWall(): GridEntity | undefined;
  * room shape is.)
  */
 export declare function getTopLeftWallGridIndex(): int;
-/**
- * Helper function to determine if all of the pressure plates in the current room are pushed.
- * Returns true if there are no pressure plates in the room.
- */
-export declare function isAllPressurePlatesPushed(): boolean;
 export declare function isGridEntityBreakableByExplosion(gridEntity: GridEntity): boolean;
 /**
  * Helper function to see if the provided gridEntity is in its respective broken state. See the

package/dist/functions/gridEntity.lua

@@ -3,14 +3,12 @@ local Set = ____lualib.Set
 local __TS__New = ____lualib.__TS__New
 local __TS__ArrayFilter = ____lualib.__TS__ArrayFilter
 local Map = ____lualib.Map
-local __TS__ArrayEvery = ____lualib.__TS__ArrayEvery
 local ____exports = {}
 local getAllGridEntities
 local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
 local GridCollisionClass = ____isaac_2Dtypescript_2Ddefinitions.GridCollisionClass
 local GridEntityType = ____isaac_2Dtypescript_2Ddefinitions.GridEntityType
 local PoopGridEntityVariant = ____isaac_2Dtypescript_2Ddefinitions.PoopGridEntityVariant
-local PressurePlateState = ____isaac_2Dtypescript_2Ddefinitions.PressurePlateState
 local StatueVariant = ____isaac_2Dtypescript_2Ddefinitions.StatueVariant
 local TrapdoorVariant = ____isaac_2Dtypescript_2Ddefinitions.TrapdoorVariant
 local ____cachedClasses = require("cachedClasses")
@@ -191,18 +189,6 @@ function ____exports.getTopLeftWall(self)
     local topLeftWallGridIndex = ____exports.getTopLeftWallGridIndex(nil)
     return room:GetGridEntity(topLeftWallGridIndex)
 end
-function ____exports.isAllPressurePlatesPushed(self)
-    local room = game:GetRoom()
-    local hasPressurePlates = room:HasTriggerPressurePlates()
-    if not hasPressurePlates then
-        return true
-    end
-    local pressurePlates = ____exports.getGridEntities(nil, GridEntityType.PRESSURE_PLATE)
-    return __TS__ArrayEvery(
-        pressurePlates,
-        function(____, pressurePlate) return pressurePlate.State == PressurePlateState.PRESSURE_PLATE_PRESSED end
-    )
-end
 function ____exports.isGridEntityBreakableByExplosion(self, gridEntity)
     local gridEntityType = gridEntity:GetType()
     local gridEntityVariant = gridEntity:GetVariant()

package/dist/functions/gridEntitySpecific.d.ts

@@ -0,0 +1,18 @@
+/// <reference types="isaac-typescript-definitions" />
+/** Helper function to get all of the `GridEntityPit` in the room. */
+export declare function getPits(): GridEntityPit[];
+/** Helper function to get all of the `GridEntityPoop` in the room. */
+export declare function getPoops(): GridEntityPoop[];
+/** Helper function to get all of the `GridEntityPressurePlate` in the room. */
+export declare function getPressurePlates(): GridEntityPressurePlate[];
+/** Helper function to get all of the `GridEntityRock` in the room. */
+export declare function getRocks(): GridEntityRock[];
+/** Helper function to get all of the `GridEntitySpikes` in the room. */
+export declare function getSpikes(): GridEntitySpikes[];
+/** Helper function to get all of the `GridEntityTNT` in the room. */
+export declare function getTNT(): GridEntityTNT[];
+/**
+ * Helper function to determine if all of the pressure plates in the current room are pushed.
+ * Returns true if there are no pressure plates in the room.
+ */
+export declare function isAllPressurePlatesPushed(): boolean;

package/dist/functions/gridEntitySpecific.lua

@@ -0,0 +1,88 @@
+local ____lualib = require("lualib_bundle")
+local __TS__ArrayEvery = ____lualib.__TS__ArrayEvery
+local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local PressurePlateState = ____isaac_2Dtypescript_2Ddefinitions.PressurePlateState
+local ____cachedClasses = require("cachedClasses")
+local game = ____cachedClasses.game
+local ____gridEntity = require("functions.gridEntity")
+local getGridEntities = ____gridEntity.getGridEntities
+function ____exports.getPits(self)
+    local gridEntities = getGridEntities(nil)
+    local pits = {}
+    for ____, gridEntity in ipairs(gridEntities) do
+        local pit = gridEntity:ToPit()
+        if pit ~= nil then
+            pits[#pits + 1] = pit
+        end
+    end
+    return pits
+end
+function ____exports.getPoops(self)
+    local gridEntities = getGridEntities(nil)
+    local poops = {}
+    for ____, gridEntity in ipairs(gridEntities) do
+        local poop = gridEntity:ToPoop()
+        if poop ~= nil then
+            poops[#poops + 1] = poop
+        end
+    end
+    return poops
+end
+function ____exports.getPressurePlates(self)
+    local gridEntities = getGridEntities(nil)
+    local pressurePlates = {}
+    for ____, gridEntity in ipairs(gridEntities) do
+        local pressurePlate = gridEntity:ToPressurePlate()
+        if pressurePlate ~= nil then
+            pressurePlates[#pressurePlates + 1] = pressurePlate
+        end
+    end
+    return pressurePlates
+end
+function ____exports.getRocks(self)
+    local gridEntities = getGridEntities(nil)
+    local rocks = {}
+    for ____, gridEntity in ipairs(gridEntities) do
+        local rock = gridEntity:ToRock()
+        if rock ~= nil then
+            rocks[#rocks + 1] = rock
+        end
+    end
+    return rocks
+end
+function ____exports.getSpikes(self)
+    local gridEntities = getGridEntities(nil)
+    local spikes = {}
+    for ____, gridEntity in ipairs(gridEntities) do
+        local spike = gridEntity:ToSpikes()
+        if spike ~= nil then
+            spikes[#spikes + 1] = spike
+        end
+    end
+    return spikes
+end
+function ____exports.getTNT(self)
+    local gridEntities = getGridEntities(nil)
+    local tntArray = {}
+    for ____, gridEntity in ipairs(gridEntities) do
+        local tnt = gridEntity:ToTNT()
+        if tnt ~= nil then
+            tntArray[#tntArray + 1] = tnt
+        end
+    end
+    return tntArray
+end
+function ____exports.isAllPressurePlatesPushed(self)
+    local room = game:GetRoom()
+    local hasPressurePlates = room:HasTriggerPressurePlates()
+    if not hasPressurePlates then
+        return true
+    end
+    local pressurePlates = ____exports.getPressurePlates(nil)
+    return __TS__ArrayEvery(
+        pressurePlates,
+        function(____, pressurePlate) return pressurePlate.State == PressurePlateState.PRESSURE_PLATE_PRESSED end
+    )
+end
+return ____exports

package/dist/functions/log.lua

@@ -10,7 +10,6 @@ local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitio
 local DamageFlag = ____isaac_2Dtypescript_2Ddefinitions.DamageFlag
 local EffectVariant = ____isaac_2Dtypescript_2Ddefinitions.EffectVariant
 local EntityFlag = ____isaac_2Dtypescript_2Ddefinitions.EntityFlag
-local EntityType = ____isaac_2Dtypescript_2Ddefinitions.EntityType
 local GameStateFlag = ____isaac_2Dtypescript_2Ddefinitions.GameStateFlag
 local GridEntityType = ____isaac_2Dtypescript_2Ddefinitions.GridEntityType
 local LevelStateFlag = ____isaac_2Dtypescript_2Ddefinitions.LevelStateFlag
@@ -157,7 +156,8 @@ function ____exports.logEntities(includeBackgroundEffects, entityTypeFilter)
             if entityTypeFilter ~= nil and entity.Type ~= entityTypeFilter then
                 return
             end
-            if not includeBackgroundEffects and entity.Type == EntityType.EFFECT and IGNORE_EFFECT_VARIANTS:has(entity.Variant) then
+            local effect = entity:ToEffect()
+            if not includeBackgroundEffects and effect ~= nil and IGNORE_EFFECT_VARIANTS:has(effect.Variant) then
                 return
             end
             local entityID = getEntityID(nil, entity)
@@ -166,7 +166,6 @@ function ____exports.logEntities(includeBackgroundEffects, entityTypeFilter)
             if bomb ~= nil then
                 msg = msg .. " (bomb)"
             end
-            local effect = entity:ToEffect()
             if effect ~= nil then
                 msg = msg .. (" (effect) (State: " .. tostring(effect.State)) .. ")"
             end

package/dist/functions/npc.lua

@@ -27,6 +27,8 @@ local getFilteredNewEntities = ____entity.getFilteredNewEntities
 local ____entitySpecific = require("functions.entitySpecific")
 local getNPCs = ____entitySpecific.getNPCs
 local getProjectiles = ____entitySpecific.getProjectiles
+local ____entityTypes = require("functions.entityTypes")
+local isRagling = ____entityTypes.isRagling
 function ____exports.isAliveExceptionNPC(self, npc)
     local entityTypeVariant = (tostring(npc.Type) .. ".") .. tostring(npc.Variant)
     if NON_ALIVE_NPCS_TYPE_VARIANT:has(entityTypeVariant) then
@@ -48,7 +50,7 @@ function ____exports.isDyingEggyWithNoSpidersLeft(self, npc)
     return npc.State == NpcState.SUICIDE and npc.StateFrame >= EGGY_STATE_FRAME_OF_FINAL_SPIDER
 end
 function ____exports.isRaglingDeathPatch(self, npc)
-    return npc.Type == EntityType.RAGLING and npc.Variant == RaglingVariant.RAG_MANS_RAGLING and npc.State == NpcState.SPECIAL
+    return isRagling(nil, npc) and npc.Variant == RaglingVariant.RAG_MANS_RAGLING and npc.State == NpcState.SPECIAL
 end
 NON_ALIVE_NPCS_TYPE_VARIANT = __TS__New(
     Set,

package/dist/functions/npcTypes.d.ts

@@ -0,0 +1,3 @@
+/// <reference types="isaac-typescript-definitions" />
+/** For EntityType.RAGLING (246) */
+export declare function isRagling(npc: EntityNPC): npc is EntityNPCRagling;

package/dist/functions/npcTypes.lua

@@ -0,0 +1,7 @@
+local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local EntityType = ____isaac_2Dtypescript_2Ddefinitions.EntityType
+function ____exports.isRagling(self, npc)
+    return npc.Type == EntityType.RAGLING
+end
+return ____exports

package/dist/functions/pickupVariants.d.ts

@@ -0,0 +1,13 @@
+/// <reference types="isaac-typescript-definitions" />
+/** For PickupVariant.HEART (10) */
+export declare function isHeart(pickup: EntityPickup): pickup is EntityPickupHeart;
+/** For PickupVariant.COIN (20) */
+export declare function isCoin(pickup: EntityPickup): pickup is EntityPickupCoin;
+/** For PickupVariant.KEY (30) */
+export declare function isKey(pickup: EntityPickup): pickup is EntityPickupKey;
+/** For PickupVariant.BOMB (40) */
+export declare function isBomb(pickup: EntityPickup): pickup is EntityPickupBomb;
+/** For PickupVariant.COLLECTIBLE (100) */
+export declare function isCollectible(pickup: EntityPickup): pickup is EntityPickupCollectible;
+/** For PickupVariant.TRINKET (350) */
+export declare function isTrinket(pickup: EntityPickup): pickup is EntityPickupTrinket;

package/dist/functions/pickupVariants.lua

@@ -0,0 +1,22 @@
+local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local PickupVariant = ____isaac_2Dtypescript_2Ddefinitions.PickupVariant
+function ____exports.isHeart(self, pickup)
+    return pickup.Variant == PickupVariant.HEART
+end
+function ____exports.isCoin(self, pickup)
+    return pickup.Variant == PickupVariant.COIN
+end
+function ____exports.isKey(self, pickup)
+    return pickup.Variant == PickupVariant.KEY
+end
+function ____exports.isBomb(self, pickup)
+    return pickup.Variant == PickupVariant.BOMB
+end
+function ____exports.isCollectible(self, pickup)
+    return pickup.Variant == PickupVariant.COLLECTIBLE
+end
+function ____exports.isTrinket(self, pickup)
+    return pickup.Variant == PickupVariant.TRINKET
+end
+return ____exports

package/dist/functions/pickups.lua

@@ -16,6 +16,8 @@ local ____entitySpecific = require("functions.entitySpecific")
 local getPickups = ____entitySpecific.getPickups
 local removeAllPickups = ____entitySpecific.removeAllPickups
 local spawnPickup = ____entitySpecific.spawnPickup
+local ____pickupVariants = require("functions.pickupVariants")
+local isHeart = ____pickupVariants.isHeart
 function ____exports.getBatteries(self, matchingSubType)
     if matchingSubType == nil then
         matchingSubType = -1
@@ -85,7 +87,7 @@ function ____exports.isChest(self, pickup)
     return CHEST_PICKUP_VARIANTS:has(pickup.Variant)
 end
 function ____exports.isRedHeart(self, pickup)
-    return pickup.Variant == PickupVariant.HEART and RED_HEART_SUB_TYPES_SET:has(pickup.SubType)
+    return isHeart(nil, pickup) and RED_HEART_SUB_TYPES_SET:has(pickup.SubType)
 end
 function ____exports.removeAllBatteries(self, batterySubType, cap)
     return removeAllPickups(nil, PickupVariant.LIL_BATTERY, batterySubType, cap)

package/dist/functions/player.d.ts

@@ -160,6 +160,13 @@ export declare function getPlayersOfType(...characters: PlayerType[]): EntityPla
  * check for. It only returns the players that have all of the collectibles.
  */
 export declare function getPlayersWithCollectible(...collectibleTypes: CollectibleType[]): EntityPlayer[];
+/**
+ * Helper function to get only the players that have a certain trinket.
+ *
+ * This function is variadic, meaning that you can supply as many trinket types as you want to check
+ * for. It only returns the players that have all of the trinkets.
+ */
+export declare function getPlayersWithTrinket(...trinketTypes: TrinketType[]): EntityPlayer[];
 /**
  * Helper function to determine how many heart containers that Tainted Magdalene has that will not
  * be automatically depleted over time. By default, this is 2, but this function will return 4 so

package/dist/functions/player.lua

@@ -398,6 +398,17 @@ function ____exports.getPlayersWithCollectible(self, ...)
         ) end
     )
 end
+function ____exports.getPlayersWithTrinket(self, ...)
+    local trinketTypes = {...}
+    local players = getPlayers(nil)
+    return __TS__ArrayFilter(
+        players,
+        function(____, player) return __TS__ArrayEvery(
+            trinketTypes,
+            function(____, trinketType) return player:HasTrinket(trinketType) end
+        ) end
+    )
+end
 function ____exports.getTaintedMagdaleneNonTemporaryMaxHearts(self, player)
     local maxHearts = player:GetMaxHearts()
     local hasBirthright = player:HasCollectible(CollectibleType.BIRTHRIGHT)
@@ -516,9 +527,9 @@ function ____exports.setActiveItem(self, player, collectibleType, activeSlot, ch
         itemPool:RemoveCollectible(collectibleType)
     end
     repeat
-        local ____switch110 = activeSlot
-        local ____cond110 = ____switch110 == ActiveSlot.PRIMARY
-        if ____cond110 then
+        local ____switch113 = activeSlot
+        local ____cond113 = ____switch113 == ActiveSlot.PRIMARY
+        if ____cond113 then
             do
                 if primaryCollectibleType ~= CollectibleType.NULL then
                     player:RemoveCollectible(primaryCollectibleType)
@@ -527,8 +538,8 @@ function ____exports.setActiveItem(self, player, collectibleType, activeSlot, ch
                 break
             end
         end
-        ____cond110 = ____cond110 or ____switch110 == ActiveSlot.SECONDARY
-        if ____cond110 then
+        ____cond113 = ____cond113 or ____switch113 == ActiveSlot.SECONDARY
+        if ____cond113 then
             do
                 if primaryCollectibleType ~= CollectibleType.NULL then
                     player:RemoveCollectible(primaryCollectibleType)
@@ -543,16 +554,16 @@ function ____exports.setActiveItem(self, player, collectibleType, activeSlot, ch
                 break
             end
         end
-        ____cond110 = ____cond110 or ____switch110 == ActiveSlot.POCKET
-        if ____cond110 then
+        ____cond113 = ____cond113 or ____switch113 == ActiveSlot.POCKET
+        if ____cond113 then
             do
                 player:SetPocketActiveItem(collectibleType, activeSlot, keepInPools)
                 player:SetActiveCharge(charge, activeSlot)
                 break
             end
         end
-        ____cond110 = ____cond110 or ____switch110 == ActiveSlot.POCKET_SINGLE_USE
-        if ____cond110 then
+        ____cond113 = ____cond113 or ____switch113 == ActiveSlot.POCKET_SINGLE_USE
+        if ____cond113 then
             do
                 player:SetPocketActiveItem(collectibleType, activeSlot, keepInPools)
                 break

package/dist/functions/playerIndex.d.ts

@@ -51,8 +51,8 @@ export declare function getPlayerIndexVanilla(playerToFind: EntityPlayer): int |
  * If this is not desired, use the `getAllPlayers` helper function instead.
  *
  * @param performCharacterExclusions Whether or not to exclude characters that are not directly
- *                                   controlled by the player (i.e. Esau & Tainted Soul). Default is
- *                                   false.
+ *                                 controlled by the player (i.e. Esau & Tainted Soul). Default is
+ *                                 false.
  */
 export declare function getPlayers(performCharacterExclusions?: boolean): EntityPlayer[];
 /**

package/dist/functions/rooms.d.ts

@@ -53,9 +53,8 @@ export declare function getRoomTypeName(roomType: RoomType): string;
  * the list.
  *
  * @param includeExtraDimensionalRooms Optional. On some floors (e.g. Downpour 2, Mines 2),
- *                                     extra-dimensional rooms are automatically be generated and
- *                                     can be seen when you iterate over the `RoomList`. Default is
- *                                     false.
+ *                                 extra-dimensional rooms are automatically be generated and can be
+ *                                 seen when you iterate over the `RoomList`. Default is false.
  */
 export declare function getRooms(includeExtraDimensionalRooms?: boolean): RoomDescriptor[];
 /**