isaacscript-common 6.6.5 → 6.8.0

package/dist/functions/log.lua

@@ -8,6 +8,7 @@ local __TS__ArraySort = ____lualib.__TS__ArraySort
 local __TS__TypeOf = ____lualib.__TS__TypeOf
 local __TS__ObjectKeys = ____lualib.__TS__ObjectKeys
 local ____exports = {}
+local getEntityLogLine, getGridEntityLogLine
 local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
 local DamageFlag = ____isaac_2Dtypescript_2Ddefinitions.DamageFlag
 local EffectVariant = ____isaac_2Dtypescript_2Ddefinitions.EffectVariant
@@ -28,22 +29,23 @@ local ____array = require("functions.array")
 local arrayToString = ____array.arrayToString
 local ____collectibles = require("functions.collectibles")
 local getCollectibleName = ____collectibles.getCollectibleName
-local ____entity = require("functions.entity")
-local getEntities = ____entity.getEntities
-local getEntityID = ____entity.getEntityID
+local ____entities = require("functions.entities")
+local getEntities = ____entities.getEntities
+local getEntityID = ____entities.getEntityID
 local ____enums = require("functions.enums")
 local getEnumEntries = ____enums.getEnumEntries
 local ____flag = require("functions.flag")
 local hasFlag = ____flag.hasFlag
-local ____gridEntity = require("functions.gridEntity")
-local getGridEntities = ____gridEntity.getGridEntities
+local ____gridEntities = require("functions.gridEntities")
+local getGridEntities = ____gridEntities.getGridEntities
+local getGridEntityID = ____gridEntities.getGridEntityID
 local ____isaacAPIClass = require("functions.isaacAPIClass")
 local getIsaacAPIClassName = ____isaacAPIClass.getIsaacAPIClassName
-local ____player = require("functions.player")
-local getEffectsList = ____player.getEffectsList
-local getPlayerName = ____player.getPlayerName
 local ____playerHealth = require("functions.playerHealth")
 local getPlayerHealth = ____playerHealth.getPlayerHealth
+local ____players = require("functions.players")
+local getEffectsList = ____players.getEffectsList
+local getPlayerName = ____players.getPlayerName
 local ____roomData = require("functions.roomData")
 local getRoomData = ____roomData.getRoomData
 local getRoomGridIndex = ____roomData.getRoomGridIndex
@@ -86,6 +88,70 @@ function ____exports.log(msg)
     local debugMsg = ____exports.getDebugPrependString(nil, msg)
     Isaac.DebugString(debugMsg)
 end
+--- Helper function to log information about a specific entity.
+function ____exports.logEntity(entity)
+    local msg = getEntityLogLine(nil, entity)
+    ____exports.log(msg)
+end
+function getEntityLogLine(self, entity, num)
+    local msg = num == nil and "" or tostring(num) .. ") "
+    msg = msg .. getEntityID(nil, entity)
+    local bomb = entity:ToBomb()
+    if bomb ~= nil then
+        msg = msg .. " (bomb)"
+    end
+    local effect = entity:ToEffect()
+    if effect ~= nil then
+        msg = msg .. (" (effect) (State: " .. tostring(effect.State)) .. ")"
+    end
+    local familiar = entity:ToFamiliar()
+    if familiar ~= nil then
+        msg = msg .. (" (familiar) (State: " .. tostring(familiar.State)) .. ")"
+    end
+    local knife = entity:ToKnife()
+    if knife ~= nil then
+        msg = msg .. " (knife)"
+    end
+    local laser = entity:ToLaser()
+    if laser ~= nil then
+        msg = msg .. " (laser)"
+    end
+    local npc = entity:ToNPC()
+    if npc ~= nil then
+        msg = msg .. (" (NPC) (State: " .. tostring(npc.State)) .. ")"
+    end
+    local pickup = entity:ToPickup()
+    if pickup ~= nil then
+        msg = msg .. (" (pickup) (State: " .. tostring(pickup.State)) .. ")"
+    end
+    local player = entity:ToPlayer()
+    if player ~= nil then
+        msg = msg .. " (player)"
+    end
+    local projectile = entity:ToProjectile()
+    if projectile ~= nil then
+        msg = msg .. " (projectile)"
+    end
+    local tear = entity:ToTear()
+    if tear ~= nil then
+        msg = msg .. " (tear)"
+    end
+    msg = msg .. "\n"
+    msg = msg .. ("  - Index: " .. tostring(entity.Index)) .. "\n"
+    msg = msg .. ("  - InitSeed: " .. tostring(entity.InitSeed)) .. "\n"
+    msg = msg .. ("  - DropSeed: " .. tostring(entity.DropSeed)) .. "\n"
+    msg = msg .. ((("  - Position: (" .. tostring(entity.Position.X)) .. ", ") .. tostring(entity.Position.Y)) .. ")\n"
+    msg = msg .. ((("  - Velocity: (" .. tostring(entity.Velocity.X)) .. ", ") .. tostring(entity.Velocity.Y)) .. ")\n"
+    msg = msg .. ((("  - HP: " .. tostring(entity.HitPoints)) .. " / ") .. tostring(entity.MaxHitPoints)) .. "\n"
+    msg = msg .. ("  - Parent: " .. tostring(entity.Parent)) .. "\n"
+    msg = msg .. ("  - Child: " .. tostring(entity.Child)) .. "\n"
+    msg = msg .. ("  - SpawnerEntity: " .. tostring(entity.SpawnerEntity)) .. "\n"
+    msg = msg .. ((("  - SpawnerType / SpawnerVariant: " .. tostring(entity.SpawnerType)) .. ".") .. tostring(entity.SpawnerVariant)) .. "\n"
+    if npc ~= nil then
+        msg = msg .. ("  - CanShutDoors: " .. tostring(npc.CanShutDoors)) .. "\n"
+    end
+    return msg
+end
 --- Helper function for printing out every flag that is turned on. Useful when debugging.
 function ____exports.logFlags(flags, flagEnum, description)
     if description == nil then
@@ -108,6 +174,56 @@ function ____exports.logFlags(flags, flagEnum, description)
         ____exports.log("  n/a (no flags)")
     end
 end
+--- Helper function for log information about a specific grid entity.
+function ____exports.logGridEntity(gridEntity)
+    local msg = getGridEntityLogLine(nil, gridEntity)
+    ____exports.log(msg)
+end
+function getGridEntityLogLine(self, gridEntity, num)
+    local gridEntityDesc = gridEntity:GetSaveState()
+    local msg = num == nil and "" or tostring(num) .. ") "
+    msg = msg .. getGridEntityID(nil, gridEntity)
+    local door = gridEntity:ToDoor()
+    if door ~= nil then
+        msg = msg .. " (door)"
+    end
+    local pit = gridEntity:ToPit()
+    if pit ~= nil then
+        msg = msg .. " (pit)"
+    end
+    local poop = gridEntity:ToPoop()
+    if poop ~= nil then
+        msg = msg .. " (poop)"
+    end
+    local pressurePlate = gridEntity:ToPressurePlate()
+    if pressurePlate ~= nil then
+        msg = msg .. " (pressurePlate)"
+    end
+    local rock = gridEntity:ToRock()
+    if rock ~= nil then
+        msg = msg .. " (rock)"
+    end
+    local spikes = gridEntity:ToSpikes()
+    if spikes ~= nil then
+        msg = msg .. " (spikes)"
+    end
+    local tnt = gridEntity:ToTNT()
+    if tnt ~= nil then
+        msg = msg .. " (TNT)"
+    end
+    msg = msg .. ("  - State: " .. tostring(gridEntity.State)) .. "\n"
+    msg = msg .. ("  - VarData: " .. tostring(gridEntity.VarData)) .. "\n"
+    msg = msg .. ((("  - Position: (" .. tostring(gridEntity.Position.X)) .. ", ") .. tostring(gridEntity.Position.Y)) .. ")\n"
+    msg = msg .. ("  - SpawnSeed: " .. tostring(gridEntityDesc.SpawnSeed)) .. "\n"
+    msg = msg .. ("  - VariableSeed: " .. tostring(gridEntityDesc.VariableSeed)) .. ")\n"
+    if door ~= nil then
+        msg = msg .. ("  - Slot: " .. tostring(door.Slot)) .. "\n"
+        msg = msg .. ("  - Direction: " .. tostring(door.Direction)) .. "\n"
+        msg = msg .. ("  - TargetRoomIndex: " .. tostring(door.TargetRoomIndex)) .. "\n"
+        msg = msg .. ("  - TargetRoomType: " .. tostring(door.TargetRoomType)) .. "\n"
+    end
+    return msg
+end
 local IGNORE_EFFECT_VARIANTS = __TS__New(Set, {
     EffectVariant.BLOOD_EXPLOSION,
     EffectVariant.BLOOD_PARTICLE,
@@ -119,6 +235,71 @@ local IGNORE_EFFECT_VARIANTS = __TS__New(Set, {
     EffectVariant.LIGHT,
     EffectVariant.TADPOLE
 })
+--- Helper function for printing out every entity (or filtered entity) in the current room.
+function ____exports.logAllEntities(includeBackgroundEffects, entityTypeFilter)
+    local msg = "Entities in the room"
+    if entityTypeFilter ~= nil then
+        msg = msg .. (" (filtered to entity type " .. tostring(entityTypeFilter)) .. ")"
+    elseif not includeBackgroundEffects then
+        msg = msg .. " (not including background effects)"
+    end
+    msg = msg .. ":\n"
+    local entities = getEntities(nil)
+    local numMatchedEntities = 0
+    __TS__ArrayForEach(
+        entities,
+        function(____, entity, i)
+            if entityTypeFilter ~= nil and entity.Type ~= entityTypeFilter then
+                return
+            end
+            local effect = entity:ToEffect()
+            if not includeBackgroundEffects and effect ~= nil and IGNORE_EFFECT_VARIANTS:has(effect.Variant) then
+                return
+            end
+            msg = msg .. getEntityLogLine(nil, entity, i + 1)
+            numMatchedEntities = numMatchedEntities + 1
+        end
+    )
+    if numMatchedEntities == 0 then
+        msg = msg .. "(no entities matched)\n"
+    else
+        msg = msg .. ((("(" .. tostring(numMatchedEntities)) .. " total ") .. (numMatchedEntities == 1 and "entity" or "entities")) .. ")\n"
+    end
+    ____exports.log(msg)
+end
+--- Helper function for printing out every grid entity (or filtered grid entity) in the current room.
+function ____exports.logAllGridEntities(includeWalls, gridEntityTypeFilter)
+    local msg = "Grid entities in the room"
+    if gridEntityTypeFilter ~= nil then
+        msg = msg .. (" (filtered to grid entity type " .. tostring(gridEntityTypeFilter)) .. ")"
+    elseif not includeWalls then
+        msg = msg .. " (not including walls)"
+    end
+    msg = msg .. ":\n"
+    local gridEntities = getGridEntities(nil)
+    local numMatchedEntities = 0
+    __TS__ArrayForEach(
+        gridEntities,
+        function(____, gridEntity)
+            local gridEntityIndex = gridEntity:GetGridIndex()
+            local gridEntityType = gridEntity:GetType()
+            if gridEntityTypeFilter ~= nil and gridEntityType ~= gridEntityTypeFilter then
+                return
+            end
+            if not includeWalls and gridEntityType == GridEntityType.WALL and gridEntityTypeFilter ~= GridEntityType.WALL then
+                return
+            end
+            msg = msg .. getGridEntityLogLine(nil, gridEntity, gridEntityIndex)
+            numMatchedEntities = numMatchedEntities + 1
+        end
+    )
+    if numMatchedEntities == 0 then
+        msg = msg .. "(no grid entities matched)\n"
+    else
+        msg = msg .. ((("(" .. tostring(numMatchedEntities)) .. " total grid ") .. (numMatchedEntities == 1 and "entity" or "entities")) .. ")\n"
+    end
+    ____exports.log(msg)
+end
 function ____exports.logArray(array)
     local arrayString = arrayToString(nil, array)
     ____exports.log("Array: " .. arrayString)
@@ -156,91 +337,11 @@ function ____exports.logEffects(player)
         end
     )
 end
---- Helper function for printing out every entity (or filtered entity) in the current room.
-function ____exports.logEntities(includeBackgroundEffects, entityTypeFilter)
-    local msg = "Entities in the room"
-    if entityTypeFilter ~= nil then
-        msg = msg .. (" (filtered to entity type " .. tostring(entityTypeFilter)) .. ")"
-    elseif not includeBackgroundEffects then
-        msg = msg .. " (not including background effects)"
-    end
-    msg = msg .. ":\n"
-    local entities = getEntities(nil)
-    local numMatchedEntities = 0
-    __TS__ArrayForEach(
-        entities,
-        function(____, entity, i)
-            if entityTypeFilter ~= nil and entity.Type ~= entityTypeFilter then
-                return
-            end
-            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)
-            msg = msg .. (tostring(i + 1) .. ") ") .. entityID
-            local bomb = entity:ToBomb()
-            if bomb ~= nil then
-                msg = msg .. " (bomb)"
-            end
-            if effect ~= nil then
-                msg = msg .. (" (effect) (State: " .. tostring(effect.State)) .. ")"
-            end
-            local familiar = entity:ToFamiliar()
-            if familiar ~= nil then
-                msg = msg .. (" (familiar) (State: " .. tostring(familiar.State)) .. ")"
-            end
-            local knife = entity:ToKnife()
-            if knife ~= nil then
-                msg = msg .. " (knife)"
-            end
-            local laser = entity:ToLaser()
-            if laser ~= nil then
-                msg = msg .. " (laser)"
-            end
-            local npc = entity:ToNPC()
-            if npc ~= nil then
-                msg = msg .. (" (NPC) (State: " .. tostring(npc.State)) .. ")"
-            end
-            local pickup = entity:ToPickup()
-            if pickup ~= nil then
-                msg = msg .. (" (pickup) (State: " .. tostring(pickup.State)) .. ")"
-            end
-            local player = entity:ToPlayer()
-            if player ~= nil then
-                msg = msg .. " (player)"
-            end
-            local projectile = entity:ToProjectile()
-            if projectile ~= nil then
-                msg = msg .. " (projectile)"
-            end
-            local tear = entity:ToTear()
-            if tear ~= nil then
-                msg = msg .. " (tear)"
-            end
-            msg = msg .. "\n"
-            msg = msg .. ("  - Index: " .. tostring(entity.Index)) .. "\n"
-            msg = msg .. ("  - InitSeed: " .. tostring(entity.InitSeed)) .. "\n"
-            msg = msg .. ("  - DropSeed: " .. tostring(entity.DropSeed)) .. "\n"
-            msg = msg .. ((("  - Position: (" .. tostring(entity.Position.X)) .. ", ") .. tostring(entity.Position.Y)) .. ")\n"
-            msg = msg .. ((("  - Velocity: (" .. tostring(entity.Velocity.X)) .. ", ") .. tostring(entity.Velocity.Y)) .. ")\n"
-            msg = msg .. ((("  - HP: " .. tostring(entity.HitPoints)) .. " / ") .. tostring(entity.MaxHitPoints)) .. "\n"
-            msg = msg .. ("  - Parent: " .. tostring(entity.Parent)) .. "\n"
-            msg = msg .. ("  - Child: " .. tostring(entity.Child)) .. "\n"
-            msg = msg .. ("  - SpawnerEntity: " .. tostring(entity.SpawnerEntity)) .. "\n"
-            msg = msg .. ((("  - SpawnerType / SpawnerVariant: " .. tostring(entity.SpawnerType)) .. ".") .. tostring(entity.SpawnerVariant)) .. "\n"
-            if npc ~= nil then
-                msg = msg .. ("  - CanShutDoors: " .. tostring(npc.CanShutDoors)) .. "\n"
-            end
-            numMatchedEntities = numMatchedEntities + 1
-        end
-    )
-    if numMatchedEntities == 0 then
-        msg = msg .. "(no entities matched)\n"
-    else
-        msg = msg .. ((("(" .. tostring(numMatchedEntities)) .. " total ") .. (numMatchedEntities == 1 and "entity" or "entities")) .. ")\n"
+--- Helper function for logging an array of specific entities.
+function ____exports.logEntities(entities)
+    for ____, entity in ipairs(entities) do
+        ____exports.logEntity(entity)
     end
-    ____exports.log(msg)
 end
 --- Helper function for printing out every entity flag that is turned on. Useful when debugging.
 function ____exports.logEntityFlags(flags)
@@ -277,78 +378,11 @@ function ____exports.logGameStateFlags()
         ____exports.log("  n/a (no flags)")
     end
 end
---- Helper function for printing out every grid entity (or filtered grid entity) in the current room.
-function ____exports.logGridEntities(includeWalls, gridEntityTypeFilter)
-    local msg = "Grid entities in the room"
-    if gridEntityTypeFilter ~= nil then
-        msg = msg .. (" (filtered to grid entity type " .. tostring(gridEntityTypeFilter)) .. ")"
-    elseif not includeWalls then
-        msg = msg .. " (not including walls)"
+--- Helper function for logging an array of specific grid entities.
+function ____exports.logGridEntities(gridEntities)
+    for ____, gridEntity in ipairs(gridEntities) do
+        ____exports.logGridEntity(gridEntity)
     end
-    msg = msg .. ":\n"
-    local gridEntities = getGridEntities(nil)
-    local numMatchedEntities = 0
-    __TS__ArrayForEach(
-        gridEntities,
-        function(____, gridEntity)
-            local gridEntityIndex = gridEntity:GetGridIndex()
-            local gridEntityType = gridEntity:GetType()
-            local gridEntityVariant = gridEntity:GetVariant()
-            local gridEntityDesc = gridEntity:GetSaveState()
-            if gridEntityTypeFilter ~= nil and gridEntityType ~= gridEntityTypeFilter then
-                return
-            end
-            if not includeWalls and gridEntityType == GridEntityType.WALL and gridEntityTypeFilter ~= GridEntityType.WALL then
-                return
-            end
-            msg = msg .. (((((tostring(gridEntityIndex) .. ") ") .. tostring(gridEntityType)) .. ".") .. tostring(gridEntityVariant)) .. ".") .. tostring(gridEntity.State)
-            local door = gridEntity:ToDoor()
-            if door ~= nil then
-                msg = msg .. " (door)"
-            end
-            local pit = gridEntity:ToPit()
-            if pit ~= nil then
-                msg = msg .. " (pit)"
-            end
-            local poop = gridEntity:ToPoop()
-            if poop ~= nil then
-                msg = msg .. " (poop)"
-            end
-            local pressurePlate = gridEntity:ToPressurePlate()
-            if pressurePlate ~= nil then
-                msg = msg .. " (pressurePlate)"
-            end
-            local rock = gridEntity:ToRock()
-            if rock ~= nil then
-                msg = msg .. " (rock)"
-            end
-            local spikes = gridEntity:ToSpikes()
-            if spikes ~= nil then
-                msg = msg .. " (spikes)"
-            end
-            local tnt = gridEntity:ToTNT()
-            if tnt ~= nil then
-                msg = msg .. " (TNT)"
-            end
-            msg = msg .. ("  - VarData: " .. tostring(gridEntity.VarData)) .. "\n"
-            msg = msg .. ((("  - Position: (" .. tostring(gridEntity.Position.X)) .. ", ") .. tostring(gridEntity.Position.Y)) .. ")\n"
-            msg = msg .. ("  - SpawnSeed: " .. tostring(gridEntityDesc.SpawnSeed)) .. "\n"
-            msg = msg .. ("  - VariableSeed: " .. tostring(gridEntityDesc.VariableSeed)) .. ")\n"
-            if door ~= nil then
-                msg = msg .. ("  - Slot: " .. tostring(door.Slot)) .. "\n"
-                msg = msg .. ("  - Direction: " .. tostring(door.Direction)) .. "\n"
-                msg = msg .. ("  - TargetRoomIndex: " .. tostring(door.TargetRoomIndex)) .. "\n"
-                msg = msg .. ("  - TargetRoomType: " .. tostring(door.TargetRoomType)) .. "\n"
-            end
-            numMatchedEntities = numMatchedEntities + 1
-        end
-    )
-    if numMatchedEntities == 0 then
-        msg = msg .. "(no grid entities matched)\n"
-    else
-        msg = msg .. ((("(" .. tostring(numMatchedEntities)) .. " total grid ") .. (numMatchedEntities == 1 and "entity" or "entities")) .. ")\n"
-    end
-    ____exports.log(msg)
 end
 function ____exports.logKColor(kColor)
     ____exports.log((((((("Color: R" .. tostring(kColor.Red)) .. ", G") .. tostring(kColor.Green)) .. ", B") .. tostring(kColor.Blue)) .. ", A") .. tostring(kColor.Alpha))
@@ -567,17 +601,21 @@ end
 function ____exports.setLogFunctionsGlobal(self)
     local globals = _G
     globals.log = ____exports.log
+    globals.logAllEntities = ____exports.logAllEntities
+    globals.logAllGridEntities = ____exports.logAllGridEntities
     globals.logArray = ____exports.logArray
     globals.logColor = ____exports.logColor
     globals.logDamageFlags = ____exports.logDamageFlags
     globals.logEffects = ____exports.logEffects
     globals.logEntities = ____exports.logEntities
+    globals.logEntity = ____exports.logEntity
     globals.logEntityID = ____exports.logEntityID
     globals.logEntityFlags = ____exports.logEntityFlags
     globals.logError = ____exports.logError
     globals.logFlags = ____exports.logFlags
     globals.logGameStateFlags = ____exports.logGameStateFlags
     globals.logGridEntities = ____exports.logGridEntities
+    globals.logGridEntity = ____exports.logGridEntity
     globals.logKColor = ____exports.logKColor
     globals.logLevelStateFlags = ____exports.logLevelStateFlags
     globals.logMap = ____exports.logMap

package/dist/functions/{npc.d.ts → npcs.d.ts}

@@ -18,8 +18,16 @@ export declare function fireProjectiles(npc: EntityNPC, position: Vector, veloci
  *
  * This function will not include NPCs on an internal blacklist, such as Death's scythes or Big Horn
  * holes.
+ *
+ * @param entityType Optional. If specified, will only get the NPCs that match the type. Default is
+ *                   -1, which matches every type.
+ * @param variant Optional. If specified, will only get the NPCs that match the variant. Default is
+ *                -1, which matches every variant.
+ * @param subType Optional. If specified, will only get the NPCs that match the sub-type. Default is
+ *                -1, which matches every sub-type.
+ * @param ignoreFriendly Optional. Default is false.
  */
-export declare function getAliveNPCs(matchingEntityType?: EntityType, matchingVariant?: int, matchingSubType?: int, ignoreFriendly?: boolean): EntityNPC[];
+export declare function getAliveNPCs(entityType?: EntityType, variant?: number, subType?: number, ignoreFriendly?: boolean): EntityNPC[];
 /**
  * Checks for specific NPCs that have "CanShutDoors" set to true naturally by the game, but should
  * not actually keep the doors closed (like Death's scythes).
@@ -38,4 +46,18 @@ export declare function isDyingEggyWithNoSpidersLeft(npc: EntityNPC): boolean;
  * enemies.
  */
 export declare function isRaglingDeathPatch(npc: EntityNPC): boolean;
-//# sourceMappingURL=npc.d.ts.map
+/**
+ * The base game `EntityNPC.FireProjectiles` method does not return anything, which is a problem in
+ * situations where you need to work with the fired projectiles. This function invokes that method,
+ * and then returns the projectiles that were spawned.
+ *
+ * @param npc The EntityNPC firing projectiles.
+ * @param position The starting position of the projectiles.
+ * @param velocity The starting velocity of the projectiles.
+ * @param projectilesMode A ProjectilesMode enum value defining how to fire the projectiles.
+ * @param projectileParams A ProjectileParams object containing various parameters for the
+ *                         projectiles.
+ * @returns An array of EntityProjectiles containing all fired projectiles.
+ */
+export declare function npcFireProjectiles(npc: EntityNPC, position: Vector, velocity: Vector, projectilesMode: ProjectilesMode, projectileParams: ProjectileParams): EntityProjectile[];
+//# sourceMappingURL=npcs.d.ts.map

package/dist/functions/npcs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"npcs.d.ts","sourceRoot":"","sources":["../../src/functions/npcs.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,UAAU,EAMV,eAAe,EAGhB,MAAM,8BAA8B,CAAC;AAgCtC;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,SAAS,EACd,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,eAAe,GAAE,eAAgD,EACjE,gBAAgB,GAAE,gBAAqC,GACtD,gBAAgB,EAAE,CAMpB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAC1B,UAAU,GAAE,UAAe,EAC3B,OAAO,SAAK,EACZ,OAAO,SAAK,EACZ,cAAc,UAAQ,GACrB,SAAS,EAAE,CAGb;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAoB3D;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAKpE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAO3D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,SAAS,EACd,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,eAAe,EAChC,gBAAgB,EAAE,gBAAgB,GACjC,gBAAgB,EAAE,CAOpB"}

package/dist/functions/{npc.lua → npcs.lua}

@@ -22,11 +22,11 @@ local RaglingVariant = ____isaac_2Dtypescript_2Ddefinitions.RaglingVariant
 local VisVariant = ____isaac_2Dtypescript_2Ddefinitions.VisVariant
 local ____constants = require("constants")
 local EGGY_STATE_FRAME_OF_FINAL_SPIDER = ____constants.EGGY_STATE_FRAME_OF_FINAL_SPIDER
-local ____entity = require("functions.entity")
-local getFilteredNewEntities = ____entity.getFilteredNewEntities
-local ____entitySpecific = require("functions.entitySpecific")
-local getNPCs = ____entitySpecific.getNPCs
-local getProjectiles = ____entitySpecific.getProjectiles
+local ____entities = require("functions.entities")
+local getFilteredNewEntities = ____entities.getFilteredNewEntities
+local ____entitiesSpecific = require("functions.entitiesSpecific")
+local getNPCs = ____entitiesSpecific.getNPCs
+local getProjectiles = ____entitiesSpecific.getProjectiles
 --- Checks for specific NPCs that have "CanShutDoors" set to true naturally by the game, but should
 -- not actually keep the doors closed (like Death's scythes).
 function ____exports.isAliveExceptionNPC(self, npc)
@@ -109,15 +109,32 @@ end
 -- 
 -- This function will not include NPCs on an internal blacklist, such as Death's scythes or Big Horn
 -- holes.
-function ____exports.getAliveNPCs(self, matchingEntityType, matchingVariant, matchingSubType, ignoreFriendly)
+-- 
+-- @param entityType Optional. If specified, will only get the NPCs that match the type. Default is
+-- -1, which matches every type.
+-- @param variant Optional. If specified, will only get the NPCs that match the variant. Default is
+-- -1, which matches every variant.
+-- @param subType Optional. If specified, will only get the NPCs that match the sub-type. Default is
+-- -1, which matches every sub-type.
+-- @param ignoreFriendly Optional. Default is false.
+function ____exports.getAliveNPCs(self, entityType, variant, subType, ignoreFriendly)
+    if entityType == nil then
+        entityType = -1
+    end
+    if variant == nil then
+        variant = -1
+    end
+    if subType == nil then
+        subType = -1
+    end
     if ignoreFriendly == nil then
         ignoreFriendly = false
     end
     local npcs = getNPCs(
         nil,
-        matchingEntityType,
-        matchingVariant,
-        matchingSubType,
+        entityType,
+        variant,
+        subType,
         ignoreFriendly
     )
     return __TS__ArrayFilter(
@@ -125,4 +142,22 @@ function ____exports.getAliveNPCs(self, matchingEntityType, matchingVariant, mat
         function(____, npc) return not npc:IsDead() and not ____exports.isAliveExceptionNPC(nil, npc) end
     )
 end
+--- The base game `EntityNPC.FireProjectiles` method does not return anything, which is a problem in
+-- situations where you need to work with the fired projectiles. This function invokes that method,
+-- and then returns the projectiles that were spawned.
+-- 
+-- @param npc The EntityNPC firing projectiles.
+-- @param position The starting position of the projectiles.
+-- @param velocity The starting velocity of the projectiles.
+-- @param projectilesMode A ProjectilesMode enum value defining how to fire the projectiles.
+-- @param projectileParams A ProjectileParams object containing various parameters for the
+-- projectiles.
+-- @returns An array of EntityProjectiles containing all fired projectiles.
+function ____exports.npcFireProjectiles(self, npc, position, velocity, projectilesMode, projectileParams)
+    local oldEntities = getProjectiles(nil)
+    npc:FireProjectiles(position, velocity, projectilesMode, projectileParams)
+    local newEntities = getProjectiles(nil)
+    local filteredNewEntities = getFilteredNewEntities(nil, oldEntities, newEntities)
+    return filteredNewEntities
+end
 return ____exports