isaacscript-common 1.2.76 → 1.2.79

package/dist/functions/pickups.lua

@@ -1,12 +1,33 @@
 --[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
 local ____lualib = require("lualib_bundle")
-local Set = ____lualib.Set
-local __TS__New = ____lualib.__TS__New
+local __TS__ArrayPush = ____lualib.__TS__ArrayPush
 local ____exports = {}
+local ____constants = require("constants")
+local CHEST_PICKUP_VARIANTS = ____constants.CHEST_PICKUP_VARIANTS
 local ____array = require("functions.array")
 local getRandomArrayElement = ____array.getRandomArrayElement
+local ____entity = require("functions.entity")
+local getEntities = ____entity.getEntities
+local removeEntities = ____entity.removeEntities
 local ____utils = require("functions.utils")
 local getEnumValues = ____utils.getEnumValues
+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.getRandomHeartSubType(self, seed, exceptions)
     if seed == nil then
         seed = Random()
@@ -17,21 +38,11 @@ function ____exports.getRandomHeartSubType(self, seed, exceptions)
     local heartSubTypes = getEnumValues(nil, HeartSubType)
     return getRandomArrayElement(nil, heartSubTypes, seed, exceptions)
 end
-local CHEST_PICKUP_VARIANTS = __TS__New(Set, {
-    PickupVariant.PICKUP_CHEST,
-    PickupVariant.PICKUP_BOMBCHEST,
-    PickupVariant.PICKUP_SPIKEDCHEST,
-    PickupVariant.PICKUP_ETERNALCHEST,
-    PickupVariant.PICKUP_MIMICCHEST,
-    PickupVariant.PICKUP_OLDCHEST,
-    PickupVariant.PICKUP_WOODENCHEST,
-    PickupVariant.PICKUP_MEGACHEST,
-    PickupVariant.PICKUP_HAUNTEDCHEST,
-    PickupVariant.PICKUP_LOCKEDCHEST,
-    PickupVariant.PICKUP_REDCHEST,
-    PickupVariant.PICKUP_MOMSCHEST
-})
 function ____exports.isChest(self, pickup)
     return CHEST_PICKUP_VARIANTS:has(pickup.Variant)
 end
+function ____exports.removeAllPickups(self, variant, subType, cap)
+    local pickups = ____exports.getPickups(nil, variant, subType)
+    return removeEntities(nil, pickups, cap)
+end
 return ____exports

package/dist/functions/player.lua

@@ -22,6 +22,7 @@ local MAX_VANILLA_CHARACTER = ____constants.MAX_VANILLA_CHARACTER
 local ____HealthType = require("types.HealthType")
 local HealthType = ____HealthType.HealthType
 local ____array = require("functions.array")
+local getLastElement = ____array.getLastElement
 local sumArray = ____array.sumArray
 local ____bitwise = require("functions.bitwise")
 local getKBitOfN = ____bitwise.getKBitOfN
@@ -336,7 +337,7 @@ function ____exports.getEffectsList(self, player)
 end
 function ____exports.getFinalPlayer(self)
     local players = ____exports.getPlayers(nil)
-    return players[#players]
+    return getLastElement(nil, players)
 end
 function ____exports.getLastHeart(self, player)
     local hearts = player:GetHearts()

package/dist/functions/positionVelocity.d.ts

@@ -0,0 +1,59 @@
+/// <reference types="isaac-typescript-definitions" />
+/**
+ * Helper function to get a room position that is not overlapping with a grid entity, a heaven door,
+ * or a player. The `Room.FindFreePickupSpawnPosition()` function will return locations that overlap
+ * with heaven doors and partially overlap with players, if the thing being spawned is bigger than a
+ * tile (like a Blood Donation Machine). Use this function instead if you want to account for those
+ * specific situations.
+ *
+ * @param startingPosition The position to start searching from. If this position is not overlapping
+ * with anything, then it will be returned.
+ * @param avoidActiveEntities Optional. False by default.
+ */
+export declare function findFreePosition(startingPosition: Vector, avoidActiveEntities?: boolean): Vector;
+/**
+ * Helper function to get a map containing the positions of every entity in the current room.
+ *
+ * This is useful for rewinding entity positions at a later time. Also see `setEntityPositions()`.
+ *
+ * @param entities Optional. If provided, will only get the positions of the provided entities. This
+ * can be used to cache the entities to avoid invoking `Isaac.GetRoomEntities()` multiple times.
+ */
+export declare function getEntityPositions(entities?: Entity[]): Map<PtrHash, Vector>;
+/**
+ * Helper function to get a map containing the velocities of every entity in the current room.
+ *
+ * This is useful for rewinding entity velocities at a later time. Also see `setEntityVelocities()`.
+ *
+ * @param entities Optional. If provided, will only get the velocities of the provided entities.
+ * This can be used to cache the entities to avoid invoking `Isaac.GetRoomEntities()` multiple
+ * times.
+ */
+export declare function getEntityVelocities(entities?: Entity[]): Map<PtrHash, Vector>;
+/**
+ * Helper function to set the position of every entity in the room based on a map of positions. If
+ * an entity is found that does not have matching element in the provided map, then that entity will
+ * be skipped.
+ *
+ * This function is useful for rewinding entity positions at a later time. Also see
+ * `getEntityPositions()`.
+ *
+ * @param entityPositions The map providing the positions for every entity.
+ * @param entities Optional. If provided, will only set the positions of the provided entities. This
+ * can be used to cache the entities to avoid invoking `Isaac.GetRoomEntities()` multiple times.
+ */
+export declare function setEntityPositions(entityPositions: Map<PtrHash, Vector>, entities?: Entity[]): void;
+/**
+ * Helper function to set the velocity of every entity in the room based on a map of velocities. If
+ * an entity is found that does not have matching element in the provided map, then that entity will
+ * be skipped.
+ *
+ * This function is useful for rewinding entity velocities at a later time. Also see
+ * `getEntityVelocities()`.
+ *
+ * @param entityVelocities The map providing the velocities for every entity.
+ * @param entities Optional. If provided, will only set the velocities of the provided entities.
+ * This can be used to cache the entities to avoid invoking `Isaac.GetRoomEntities()` multiple
+ * times.
+ */
+export declare function setEntityVelocities(entityVelocities: Map<PtrHash, Vector>, entities?: Entity[]): void;

package/dist/functions/positionVelocity.lua

@@ -0,0 +1,90 @@
+--[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
+local ____lualib = require("lualib_bundle")
+local Map = ____lualib.Map
+local __TS__New = ____lualib.__TS__New
+local ____exports = {}
+local ____constants = require("constants")
+local DISTANCE_OF_GRID_TILE = ____constants.DISTANCE_OF_GRID_TILE
+local ____entity = require("functions.entity")
+local anyEntityCloserThan = ____entity.anyEntityCloserThan
+local getEntities = ____entity.getEntities
+local ____entitySpecific = require("functions.entitySpecific")
+local getEffects = ____entitySpecific.getEffects
+local ____player = require("functions.player")
+local getPlayerCloserThan = ____player.getPlayerCloserThan
+local MAX_FIND_FREE_POSITION_ATTEMPTS = 100
+function ____exports.findFreePosition(self, startingPosition, avoidActiveEntities)
+    if avoidActiveEntities == nil then
+        avoidActiveEntities = false
+    end
+    local game = Game()
+    local room = game:GetRoom()
+    local heavenDoors = getEffects(nil, EffectVariant.HEAVEN_LIGHT_DOOR, 0)
+    do
+        local i = 0
+        while i < MAX_FIND_FREE_POSITION_ATTEMPTS do
+            do
+                local position = room:FindFreePickupSpawnPosition(startingPosition, i, avoidActiveEntities)
+                local closePlayer = getPlayerCloserThan(nil, position, DISTANCE_OF_GRID_TILE)
+                if closePlayer ~= nil then
+                    goto __continue3
+                end
+                local isCloseHeavenDoor = anyEntityCloserThan(nil, heavenDoors, position, DISTANCE_OF_GRID_TILE)
+                if isCloseHeavenDoor then
+                    goto __continue3
+                end
+                return position
+            end
+            ::__continue3::
+            i = i + 1
+        end
+    end
+    return room:FindFreePickupSpawnPosition(startingPosition)
+end
+function ____exports.getEntityPositions(self, entities)
+    if entities == nil then
+        entities = getEntities(nil)
+    end
+    local entityPositions = __TS__New(Map)
+    for ____, entity in ipairs(entities) do
+        local ptrHash = GetPtrHash(entity)
+        entityPositions:set(ptrHash, entity.Position)
+    end
+    return entityPositions
+end
+function ____exports.getEntityVelocities(self, entities)
+    if entities == nil then
+        entities = getEntities(nil)
+    end
+    local entityVelocities = __TS__New(Map)
+    for ____, entity in ipairs(entities) do
+        local ptrHash = GetPtrHash(entity)
+        entityVelocities:set(ptrHash, entity.Velocity)
+    end
+    return entityVelocities
+end
+function ____exports.setEntityPositions(self, entityPositions, entities)
+    if entities == nil then
+        entities = getEntities(nil)
+    end
+    for ____, entity in ipairs(entities) do
+        local ptrHash = GetPtrHash(entity)
+        local entityPosition = entityPositions:get(ptrHash)
+        if entityPosition ~= nil then
+            entity.Position = entityPosition
+        end
+    end
+end
+function ____exports.setEntityVelocities(self, entityVelocities, entities)
+    if entities == nil then
+        entities = getEntities(nil)
+    end
+    for ____, entity in ipairs(entities) do
+        local ptrHash = GetPtrHash(entity)
+        local entityVelocity = entityVelocities:get(ptrHash)
+        if entityVelocity ~= nil then
+            entity.Velocity = entityVelocity
+        end
+    end
+end
+return ____exports

package/dist/functions/rooms.lua

@@ -21,14 +21,15 @@ local isHiddenSecretRoomDoor = ____doors.isHiddenSecretRoomDoor
 local openDoorFast = ____doors.openDoorFast
 local ____entity = require("functions.entity")
 local getEntities = ____entity.getEntities
-local getEntityPositions = ____entity.getEntityPositions
-local getEntityVelocities = ____entity.getEntityVelocities
-local setEntityPositions = ____entity.setEntityPositions
-local setEntityVelocities = ____entity.setEntityVelocities
 local ____flag = require("functions.flag")
 local hasFlag = ____flag.hasFlag
 local ____math = require("functions.math")
 local range = ____math.range
+local ____positionVelocity = require("functions.positionVelocity")
+local getEntityPositions = ____positionVelocity.getEntityPositions
+local getEntityVelocities = ____positionVelocity.getEntityVelocities
+local setEntityPositions = ____positionVelocity.setEntityPositions
+local setEntityVelocities = ____positionVelocity.setEntityVelocities
 function ____exports.getCurrentRoomDescriptorReadOnly(self)
     local game = Game()
     local level = game:GetLevel()

package/dist/functions/trinkets.lua

@@ -6,10 +6,10 @@ local ____trinketDescriptionMap = require("maps.trinketDescriptionMap")
 local TRINKET_DESCRIPTION_MAP = ____trinketDescriptionMap.TRINKET_DESCRIPTION_MAP
 local ____trinketNameMap = require("maps.trinketNameMap")
 local TRINKET_NAME_MAP = ____trinketNameMap.TRINKET_NAME_MAP
-local ____entity = require("functions.entity")
-local getPickups = ____entity.getPickups
 local ____flag = require("functions.flag")
 local hasFlag = ____flag.hasFlag
+local ____pickups = require("functions.pickups")
+local getPickups = ____pickups.getPickups
 local ____player = require("functions.player")
 local useActiveItemTemp = ____player.useActiveItemTemp
 local ____trinketGive = require("functions.trinketGive")

package/dist/index.d.ts

@@ -22,6 +22,7 @@ export { deepCopy } from "./functions/deepCopy";
 export { deepCopyTests } from "./functions/deepCopyTests";
 export * from "./functions/doors";
 export * from "./functions/entity";
+export * from "./functions/entitySpecific";
 export * from "./functions/familiars";
 export * from "./functions/flag";
 export * from "./functions/flying";
@@ -40,7 +41,7 @@ export * from "./functions/pills";
 export * from "./functions/player";
 export * from "./functions/playerHealth";
 export * from "./functions/pocketItems";
-export * from "./functions/position";
+export * from "./functions/positionVelocity";
 export * from "./functions/random";
 export * from "./functions/revive";
 export * from "./functions/rooms";

package/dist/index.lua

@@ -186,6 +186,14 @@ do
         end
     end
 end
+do
+    local ____export = require("functions.entitySpecific")
+    for ____exportKey, ____exportValue in pairs(____export) do
+        if ____exportKey ~= "default" then
+            ____exports[____exportKey] = ____exportValue
+        end
+    end
+end
 do
     local ____export = require("functions.familiars")
     for ____exportKey, ____exportValue in pairs(____export) do
@@ -331,7 +339,7 @@ do
     end
 end
 do
-    local ____export = require("functions.position")
+    local ____export = require("functions.positionVelocity")
     for ____exportKey, ____exportValue in pairs(____export) do
         if ____exportKey ~= "default" then
             ____exports[____exportKey] = ____exportValue

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacscript-common",
-  "version": "1.2.76",
+  "version": "1.2.79",
   "description": "Helper functions for IsaacScript mods",
   "keywords": [
     "isaac",