isaacscript-common 1.2.236 → 1.2.239

package/dist/functions/entitySpecific.lua

@@ -1,9 +1,12 @@
 local ____lualib = require("lualib_bundle")
 local __TS__ArrayPush = ____lualib.__TS__ArrayPush
 local ____exports = {}
+local ____constants = require("constants")
+local VectorZero = ____constants.VectorZero
 local ____entity = require("functions.entity")
 local getEntities = ____entity.getEntities
 local removeEntities = ____entity.removeEntities
+local spawn = ____entity.spawn
 function ____exports.getBombs(self, matchingVariant, matchingSubType)
     if matchingVariant == nil then
         matchingVariant = -1
@@ -38,6 +41,23 @@ function ____exports.getEffects(self, matchingVariant, matchingSubType)
     end
     return effects
 end
+function ____exports.getFamiliars(self, matchingVariant, matchingSubType)
+    if matchingVariant == nil then
+        matchingVariant = -1
+    end
+    if matchingSubType == nil then
+        matchingSubType = -1
+    end
+    local entities = getEntities(nil, EntityType.ENTITY_FAMILIAR, matchingVariant, matchingSubType)
+    local familiars = {}
+    for ____, entity in ipairs(entities) do
+        local familiar = entity:ToFamiliar()
+        if familiar ~= nil then
+            __TS__ArrayPush(familiars, familiar)
+        end
+    end
+    return familiars
+end
 function ____exports.getKnives(self, matchingVariant, matchingSubType)
     if matchingVariant == nil then
         matchingVariant = -1
@@ -72,6 +92,43 @@ function ____exports.getLasers(self, matchingVariant, matchingSubType)
     end
     return lasers
 end
+function ____exports.getNPCs(self, matchingEntityType, matchingVariant, matchingSubType, ignoreFriendly)
+    if ignoreFriendly == nil then
+        ignoreFriendly = false
+    end
+    local entities = getEntities(
+        nil,
+        matchingEntityType,
+        matchingVariant,
+        matchingSubType,
+        ignoreFriendly
+    )
+    local npcs = {}
+    for ____, entity in ipairs(entities) do
+        local npc = entity:ToNPC()
+        if npc ~= nil then
+            __TS__ArrayPush(npcs, npc)
+        end
+    end
+    return npcs
+end
+function ____exports.getPickups(self, matchingVariant, matchingSubType)
+    if matchingVariant == nil then
+        matchingVariant = -1
+    end
+    if matchingSubType == nil then
+        matchingSubType = -1
+    end
+    local entities = getEntities(nil, EntityType.ENTITY_PICKUP, matchingVariant, matchingSubType)
+    local pickups = {}
+    for ____, entity in ipairs(entities) do
+        local pickup = entity:ToPickup()
+        if pickup ~= nil then
+            __TS__ArrayPush(pickups, pickup)
+        end
+    end
+    return pickups
+end
 function ____exports.getProjectiles(self, matchingVariant, matchingSubType)
     if matchingVariant == nil then
         matchingVariant = -1
@@ -124,6 +181,10 @@ function ____exports.removeAllEffects(self, variant, subType, cap)
     local effects = ____exports.getEffects(nil, variant, subType)
     return removeEntities(nil, effects, cap)
 end
+function ____exports.removeAllFamiliars(self, variant, subType, cap)
+    local familiars = ____exports.getFamiliars(nil, variant, subType)
+    return removeEntities(nil, familiars, cap)
+end
 function ____exports.removeAllKnives(self, variant, subType, cap)
     local knives = ____exports.getKnives(nil, variant, subType)
     return removeEntities(nil, knives, cap)
@@ -132,6 +193,14 @@ function ____exports.removeAllLasers(self, variant, subType, cap)
     local lasers = ____exports.getLasers(nil, variant, subType)
     return removeEntities(nil, lasers, cap)
 end
+function ____exports.removeAllNPCs(self, cap)
+    local npcs = ____exports.getNPCs(nil)
+    return removeEntities(nil, npcs, cap)
+end
+function ____exports.removeAllPickups(self, variant, subType, cap)
+    local pickups = ____exports.getPickups(nil, variant, subType)
+    return removeEntities(nil, pickups, cap)
+end
 function ____exports.removeAllProjectiles(self, variant, subType, cap)
     local projectiles = ____exports.getProjectiles(nil, variant, subType)
     return removeEntities(nil, projectiles, cap)
@@ -144,4 +213,386 @@ function ____exports.removeAllTears(self, variant, subType, cap)
     local tears = ____exports.getTears(nil, variant, subType)
     return removeEntities(nil, tears, cap)
 end
+function ____exports.spawnBomb(self, variant, subType, position, velocity, spawner, seed)
+    if velocity == nil then
+        velocity = VectorZero
+    end
+    if spawner == nil then
+        spawner = nil
+    end
+    if seed == nil then
+        seed = nil
+    end
+    local entity = spawn(
+        nil,
+        EntityType.ENTITY_BOMB,
+        variant,
+        subType,
+        position,
+        velocity,
+        spawner,
+        seed
+    )
+    local bomb = entity:ToBomb()
+    if bomb == nil then
+        error("Failed to spawn a bomb.")
+    end
+    return bomb
+end
+function ____exports.spawnBombWithSeed(self, variant, subType, position, seed, velocity, spawner)
+    if velocity == nil then
+        velocity = VectorZero
+    end
+    if spawner == nil then
+        spawner = nil
+    end
+    return ____exports.spawnBomb(
+        nil,
+        variant,
+        subType,
+        position,
+        velocity,
+        spawner,
+        seed
+    )
+end
+function ____exports.spawnEffect(self, variant, subType, position, velocity, spawner, seed)
+    if velocity == nil then
+        velocity = VectorZero
+    end
+    if spawner == nil then
+        spawner = nil
+    end
+    if seed == nil then
+        seed = nil
+    end
+    local entity = spawn(
+        nil,
+        EntityType.ENTITY_EFFECT,
+        variant,
+        subType,
+        position,
+        velocity,
+        spawner,
+        seed
+    )
+    local effect = entity:ToEffect()
+    if effect == nil then
+        error("Failed to spawn an effect.")
+    end
+    return effect
+end
+function ____exports.spawnEffectWithSeed(self, variant, subType, position, seed, velocity, spawner)
+    if velocity == nil then
+        velocity = VectorZero
+    end
+    if spawner == nil then
+        spawner = nil
+    end
+    return ____exports.spawnEffect(
+        nil,
+        variant,
+        subType,
+        position,
+        velocity,
+        spawner,
+        seed
+    )
+end
+function ____exports.spawnFamiliar(self, variant, subType, position, velocity, spawner, seed)
+    if velocity == nil then
+        velocity = VectorZero
+    end
+    if spawner == nil then
+        spawner = nil
+    end
+    if seed == nil then
+        seed = nil
+    end
+    local entity = spawn(
+        nil,
+        EntityType.ENTITY_FAMILIAR,
+        variant,
+        subType,
+        position,
+        velocity,
+        spawner,
+        seed
+    )
+    local familiar = entity:ToFamiliar()
+    if familiar == nil then
+        error("Failed to spawn a familiar.")
+    end
+    return familiar
+end
+function ____exports.spawnFamiliarWithSeed(self, variant, subType, position, seed, velocity, spawner)
+    if velocity == nil then
+        velocity = VectorZero
+    end
+    if spawner == nil then
+        spawner = nil
+    end
+    return ____exports.spawnFamiliar(
+        nil,
+        variant,
+        subType,
+        position,
+        velocity,
+        spawner,
+        seed
+    )
+end
+function ____exports.spawnKnife(self, variant, subType, position, velocity, spawner, seed)
+    if velocity == nil then
+        velocity = VectorZero
+    end
+    if spawner == nil then
+        spawner = nil
+    end
+    if seed == nil then
+        seed = nil
+    end
+    local entity = spawn(
+        nil,
+        EntityType.ENTITY_KNIFE,
+        variant,
+        subType,
+        position,
+        velocity,
+        spawner,
+        seed
+    )
+    local knife = entity:ToKnife()
+    if knife == nil then
+        error("Failed to spawn a knife.")
+    end
+    return knife
+end
+function ____exports.spawnKnifeWithSeed(self, variant, subType, position, seed, velocity, spawner)
+    if velocity == nil then
+        velocity = VectorZero
+    end
+    if spawner == nil then
+        spawner = nil
+    end
+    return ____exports.spawnKnife(
+        nil,
+        variant,
+        subType,
+        position,
+        velocity,
+        spawner,
+        seed
+    )
+end
+function ____exports.spawnLaser(self, variant, subType, position, velocity, spawner, seed)
+    if velocity == nil then
+        velocity = VectorZero
+    end
+    if spawner == nil then
+        spawner = nil
+    end
+    if seed == nil then
+        seed = nil
+    end
+    local entity = spawn(
+        nil,
+        EntityType.ENTITY_LASER,
+        variant,
+        subType,
+        position,
+        velocity,
+        spawner,
+        seed
+    )
+    local laser = entity:ToLaser()
+    if laser == nil then
+        error("Failed to spawn a laser.")
+    end
+    return laser
+end
+function ____exports.spawnLaserWithSeed(self, variant, subType, position, seed, velocity, spawner)
+    if velocity == nil then
+        velocity = VectorZero
+    end
+    if spawner == nil then
+        spawner = nil
+    end
+    return ____exports.spawnLaser(
+        nil,
+        variant,
+        subType,
+        position,
+        velocity,
+        spawner,
+        seed
+    )
+end
+function ____exports.spawnPickup(self, variant, subType, position, velocity, spawner, seed)
+    if velocity == nil then
+        velocity = VectorZero
+    end
+    if spawner == nil then
+        spawner = nil
+    end
+    if seed == nil then
+        seed = nil
+    end
+    local entity = spawn(
+        nil,
+        EntityType.ENTITY_PICKUP,
+        variant,
+        subType,
+        position,
+        velocity,
+        spawner,
+        seed
+    )
+    local pickup = entity:ToPickup()
+    if pickup == nil then
+        error("Failed to spawn a pickup.")
+    end
+    return pickup
+end
+function ____exports.spawnPickupWithSeed(self, variant, subType, position, seed, velocity, spawner)
+    if velocity == nil then
+        velocity = VectorZero
+    end
+    if spawner == nil then
+        spawner = nil
+    end
+    return ____exports.spawnPickup(
+        nil,
+        variant,
+        subType,
+        position,
+        velocity,
+        spawner,
+        seed
+    )
+end
+function ____exports.spawnProjectile(self, variant, subType, position, velocity, spawner, seed)
+    if velocity == nil then
+        velocity = VectorZero
+    end
+    if spawner == nil then
+        spawner = nil
+    end
+    if seed == nil then
+        seed = nil
+    end
+    local entity = spawn(
+        nil,
+        EntityType.ENTITY_PROJECTILE,
+        variant,
+        subType,
+        position,
+        velocity,
+        spawner,
+        seed
+    )
+    local projectile = entity:ToProjectile()
+    if projectile == nil then
+        error("Failed to spawn a projectile.")
+    end
+    return projectile
+end
+function ____exports.spawnProjectileWithSeed(self, variant, subType, position, seed, velocity, spawner)
+    if velocity == nil then
+        velocity = VectorZero
+    end
+    if spawner == nil then
+        spawner = nil
+    end
+    return ____exports.spawnProjectile(
+        nil,
+        variant,
+        subType,
+        position,
+        velocity,
+        spawner,
+        seed
+    )
+end
+function ____exports.spawnSlot(self, variant, subType, position, velocity, spawner, seed)
+    if velocity == nil then
+        velocity = VectorZero
+    end
+    if spawner == nil then
+        spawner = nil
+    end
+    if seed == nil then
+        seed = nil
+    end
+    return spawn(
+        nil,
+        EntityType.ENTITY_SLOT,
+        variant,
+        subType,
+        position,
+        velocity,
+        spawner,
+        seed
+    )
+end
+function ____exports.spawnSlotWithSeed(self, variant, subType, position, seed, velocity, spawner)
+    if velocity == nil then
+        velocity = VectorZero
+    end
+    if spawner == nil then
+        spawner = nil
+    end
+    return ____exports.spawnSlot(
+        nil,
+        variant,
+        subType,
+        position,
+        velocity,
+        spawner,
+        seed
+    )
+end
+function ____exports.spawnTear(self, variant, subType, position, velocity, spawner, seed)
+    if velocity == nil then
+        velocity = VectorZero
+    end
+    if spawner == nil then
+        spawner = nil
+    end
+    if seed == nil then
+        seed = nil
+    end
+    local entity = spawn(
+        nil,
+        EntityType.ENTITY_TEAR,
+        variant,
+        subType,
+        position,
+        velocity,
+        spawner,
+        seed
+    )
+    local tear = entity:ToTear()
+    if tear == nil then
+        error("Failed to spawn a tear.")
+    end
+    return tear
+end
+function ____exports.spawnTearWithSeed(self, variant, subType, position, seed, velocity, spawner)
+    if velocity == nil then
+        velocity = VectorZero
+    end
+    if spawner == nil then
+        spawner = nil
+    end
+    return ____exports.spawnTear(
+        nil,
+        variant,
+        subType,
+        position,
+        velocity,
+        spawner,
+        seed
+    )
+end
 return ____exports

package/dist/functions/familiars.d.ts

@@ -48,25 +48,4 @@ export declare function checkFamiliar(player: EntityPlayer, collectibleType: int
  * -2.
  */
 export declare function checkFamiliarFromCollectibles(player: EntityPlayer, collectibleType: int, familiarVariant: int, familiarSubType?: int): int;
-/**
- * Helper function to get all of the familiars in the room.
- *
- * Example:
- * ```ts
- * // Make all of the familiars in the room invisible
- * for (const familiar of getFamiliars()) {
- *   familiar.Visible = false;
- * }
- * ```
- */
-export declare function getFamiliars(matchingVariant?: FamiliarVariant | int, matchingSubType?: number): EntityFamiliar[];
 export declare function isFamiliarThatShootsPlayerTears(familiar: EntityFamiliar): boolean;
-/**
- * Helper function to remove all of the familiars in the room.
- *
- * @param variant Optional. If specified, will only remove familiars that match this variant.
- * @param subType Optional. If specified, will only remove familiars that match this sub-type.
- * @param cap Optional. If specified, will only remove the given amount of familiars.
- * @returns True if one or more familiars was removed, false otherwise.
- */
-export declare function removeAllFamiliars(variant?: FamiliarVariant | int, subType?: int, cap?: int): boolean;

package/dist/functions/familiars.lua

@@ -1,41 +1,21 @@
 local ____lualib = require("lualib_bundle")
 local __TS__ArrayFilter = ____lualib.__TS__ArrayFilter
-local __TS__ArrayPush = ____lualib.__TS__ArrayPush
 local ____exports = {}
-local ____cachedClasses = require("cachedClasses")
-local game = ____cachedClasses.game
-local ____constants = require("constants")
-local VectorZero = ____constants.VectorZero
 local ____familiarsThatShootPlayerTearsSet = require("sets.familiarsThatShootPlayerTearsSet")
 local FAMILIARS_THAT_SHOOT_PLAYER_TEARS_SET = ____familiarsThatShootPlayerTearsSet.FAMILIARS_THAT_SHOOT_PLAYER_TEARS_SET
 local ____array = require("functions.array")
 local copyArray = ____array.copyArray
 local ____entity = require("functions.entity")
-local getEntities = ____entity.getEntities
 local removeEntities = ____entity.removeEntities
+local ____entitySpecific = require("functions.entitySpecific")
+local getFamiliars = ____entitySpecific.getFamiliars
+local spawnFamiliarWithSeed = ____entitySpecific.spawnFamiliarWithSeed
 local ____utils = require("functions.utils")
 local ____repeat = ____utils["repeat"]
-function ____exports.getFamiliars(self, matchingVariant, matchingSubType)
-    if matchingVariant == nil then
-        matchingVariant = -1
-    end
-    if matchingSubType == nil then
-        matchingSubType = -1
-    end
-    local entities = getEntities(nil, EntityType.ENTITY_FAMILIAR, matchingVariant, matchingSubType)
-    local familiars = {}
-    for ____, entity in ipairs(entities) do
-        local familiar = entity:ToFamiliar()
-        if familiar ~= nil then
-            __TS__ArrayPush(familiars, familiar)
-        end
-    end
-    return familiars
-end
 function ____exports.checkFamiliar(self, player, collectibleType, numTargetFamiliars, familiarVariant, familiarSubType)
     local familiarSubTypeToSearchFor = familiarSubType == nil and -1 or familiarSubType
     local playerPtrHash = GetPtrHash(player)
-    local familiars = ____exports.getFamiliars(nil, familiarVariant, familiarSubTypeToSearchFor)
+    local familiars = getFamiliars(nil, familiarVariant, familiarSubTypeToSearchFor)
     local familiarsForThisPlayer = __TS__ArrayFilter(
         familiars,
         function(____, familiar) return GetPtrHash(familiar.Player) == playerPtrHash end
@@ -57,18 +37,14 @@ function ____exports.checkFamiliar(self, player, collectibleType, numTargetFamil
         numFamiliarsToSpawn,
         function()
             local seed = collectibleRNG:Next()
-            local familiar = game:Spawn(
-                EntityType.ENTITY_FAMILIAR,
+            local familiar = spawnFamiliarWithSeed(
+                nil,
                 familiarVariant,
-                player.Position,
-                VectorZero,
-                player,
                 familiarSubTypeToUse,
+                player.Position,
                 seed
-            ):ToFamiliar()
-            if familiar ~= nil then
-                familiar.Player = player
-            end
+            )
+            familiar.Player = player
         end
     )
     return numFamiliarsToSpawn
@@ -90,8 +66,4 @@ end
 function ____exports.isFamiliarThatShootsPlayerTears(self, familiar)
     return FAMILIARS_THAT_SHOOT_PLAYER_TEARS_SET:has(familiar.Type)
 end
-function ____exports.removeAllFamiliars(self, variant, subType, cap)
-    local familiars = ____exports.getFamiliars(nil, variant, subType)
-    return removeEntities(nil, familiars, cap)
-end
 return ____exports

package/dist/functions/gridEntity.d.ts

@@ -83,7 +83,7 @@ export declare function isPostBossVoidPortal(gridEntity: GridEntity): boolean;
  * );
  * ```
  *
- * @returns True if one or more grid entities was removed, false otherwise.
+ * @returns True if one or more grid entities were removed, false otherwise.
  */
 export declare function removeAllGridEntitiesExceptFor(...gridEntityTypes: GridEntityType[]): boolean;
 /**
@@ -99,7 +99,7 @@ export declare function removeAllGridEntitiesExceptFor(...gridEntityTypes: GridE
  * );
  * ```
  *
- * @returns True if one or more grid entities was removed, false otherwise.
+ * @returns True if one or more grid entities were removed, false otherwise.
  */
 export declare function removeAllMatchingGridEntities(...gridEntityType: GridEntityType[]): boolean;
 /**

package/dist/functions/npc.d.ts

@@ -29,8 +29,6 @@ export declare function getAliveBosses(matchingEntityType?: EntityType | int, ma
 export declare function getAliveNPCs(matchingEntityType?: EntityType | int, matchingVariant?: int, matchingSubType?: int, ignoreFriendly?: boolean): EntityNPC[];
 /** Helper function to get all of the bosses in the room. */
 export declare function getBosses(matchingEntityType?: EntityType | int, matchingVariant?: int, matchingSubType?: int, ignoreFriendly?: boolean): EntityNPC[];
-/** The same thing as the `getEntities` function, but returns only NPCs. */
-export declare function getNPCs(matchingEntityType?: EntityType | int, matchingVariant?: int, matchingSubType?: int, 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).
@@ -51,10 +49,3 @@ export declare function isDyingEggyWithNoSpidersLeft(npc: EntityNPC): boolean;
 export declare function isRaglingDeathPatch(npc: EntityNPC): boolean;
 /** Helper function to check if the provided NPC is a Sin miniboss, such as Sloth or Lust. */
 export declare function isSin(npc: EntityNPC): boolean;
-/**
- * Helper function to remove all NPCs in the room.
- *
- * @param cap Optional. If specified, will only remove the given amount of NPCs.
- * @returns True if one or more NPCs was removed, false otherwise.
- */
-export declare function removeAllNPCs(cap?: int): boolean;

package/dist/functions/npc.lua

@@ -2,7 +2,6 @@ local ____lualib = require("lualib_bundle")
 local Set = ____lualib.Set
 local __TS__New = ____lualib.__TS__New
 local __TS__ArrayFilter = ____lualib.__TS__ArrayFilter
-local __TS__ArrayPush = ____lualib.__TS__ArrayPush
 local ____exports = {}
 local NON_ALIVE_NPCS_TYPE_VARIANT, NON_ALIVE_NPCS_TYPE_VARIANT_SUBTYPE
 local ____constants = require("constants")
@@ -10,16 +9,15 @@ local EGGY_STATE_FRAME_OF_FINAL_SPIDER = ____constants.EGGY_STATE_FRAME_OF_FINAL
 local ____sinEntityTypesSet = require("sets.sinEntityTypesSet")
 local SIN_ENTITY_TYPES_SET = ____sinEntityTypesSet.SIN_ENTITY_TYPES_SET
 local ____entity = require("functions.entity")
-local getEntities = ____entity.getEntities
 local getFilteredNewEntities = ____entity.getFilteredNewEntities
-local removeEntities = ____entity.removeEntities
 local ____entitySpecific = require("functions.entitySpecific")
+local getNPCs = ____entitySpecific.getNPCs
 local getProjectiles = ____entitySpecific.getProjectiles
 function ____exports.getAliveNPCs(self, matchingEntityType, matchingVariant, matchingSubType, ignoreFriendly)
     if ignoreFriendly == nil then
         ignoreFriendly = false
     end
-    local npcs = ____exports.getNPCs(
+    local npcs = getNPCs(
         nil,
         matchingEntityType,
         matchingVariant,
@@ -31,26 +29,6 @@ function ____exports.getAliveNPCs(self, matchingEntityType, matchingVariant, mat
         function(____, npc) return not npc:IsDead() and not ____exports.isAliveExceptionNPC(nil, npc) end
     )
 end
-function ____exports.getNPCs(self, matchingEntityType, matchingVariant, matchingSubType, ignoreFriendly)
-    if ignoreFriendly == nil then
-        ignoreFriendly = false
-    end
-    local entities = getEntities(
-        nil,
-        matchingEntityType,
-        matchingVariant,
-        matchingSubType,
-        ignoreFriendly
-    )
-    local npcs = {}
-    for ____, entity in ipairs(entities) do
-        local npc = entity:ToNPC()
-        if npc ~= nil then
-            __TS__ArrayPush(npcs, npc)
-        end
-    end
-    return npcs
-end
 function ____exports.isAliveExceptionNPC(self, npc)
     local entityTypeVariant = (tostring(npc.Type) .. ".") .. tostring(npc.Variant)
     if NON_ALIVE_NPCS_TYPE_VARIANT:has(entityTypeVariant) then
@@ -129,7 +107,7 @@ function ____exports.getBosses(self, matchingEntityType, matchingVariant, matchi
     if ignoreFriendly == nil then
         ignoreFriendly = false
     end
-    local npcs = ____exports.getNPCs(
+    local npcs = getNPCs(
         nil,
         matchingEntityType,
         matchingVariant,
@@ -144,8 +122,4 @@ end
 function ____exports.isSin(self, npc)
     return SIN_ENTITY_TYPES_SET:has(npc.Type)
 end
-function ____exports.removeAllNPCs(self, cap)
-    local npcs = ____exports.getNPCs(nil)
-    return removeEntities(nil, npcs, cap)
-end
 return ____exports