isaacscript-common 17.2.1 → 17.4.0

package/dist/src/functions/pickupsSpecific.lua

@@ -209,7 +209,7 @@ function ____exports.removeAllTrinkets(self, trinketType, cap)
     return removeAllPickups(nil, PickupVariant.TRINKET, trinketType, cap)
 end
 --- Helper function to spawn a `EntityType.PICKUP` (5) with variant `PickupVariant.LIL_BATTERY` (90).
-function ____exports.spawnBattery(self, batterySubType, position, velocity, spawner, seedOrRNG)
+function ____exports.spawnBattery(self, batterySubType, positionOrGridIndex, velocity, spawner, seedOrRNG)
     if velocity == nil then
         velocity = VectorZero
     end
@@ -223,7 +223,7 @@ function ____exports.spawnBattery(self, batterySubType, position, velocity, spaw
         nil,
         PickupVariant.LIL_BATTERY,
         batterySubType,
-        position,
+        positionOrGridIndex,
         velocity,
         spawner,
         seedOrRNG
@@ -231,7 +231,7 @@ function ____exports.spawnBattery(self, batterySubType, position, velocity, spaw
 end
 --- Helper function to spawn a `EntityType.PICKUP` (5) with variant `PickupVariant.LIL_BATTERY` (90)
 -- and a specific seed.
-function ____exports.spawnBatteryWithSeed(self, batterySubType, position, seedOrRNG, velocity, spawner)
+function ____exports.spawnBatteryWithSeed(self, batterySubType, positionOrGridIndex, seedOrRNG, velocity, spawner)
     if velocity == nil then
         velocity = VectorZero
     end
@@ -241,14 +241,14 @@ function ____exports.spawnBatteryWithSeed(self, batterySubType, position, seedOr
     return ____exports.spawnBattery(
         nil,
         batterySubType,
-        position,
+        positionOrGridIndex,
         velocity,
         spawner,
         seedOrRNG
     )
 end
 --- Helper function to spawn a `EntityType.PICKUP` (5) with variant `PickupVariant.BOMB` (40).
-function ____exports.spawnBombPickup(self, bombSubType, position, velocity, spawner, seedOrRNG)
+function ____exports.spawnBombPickup(self, bombSubType, positionOrGridIndex, velocity, spawner, seedOrRNG)
     if velocity == nil then
         velocity = VectorZero
     end
@@ -262,7 +262,7 @@ function ____exports.spawnBombPickup(self, bombSubType, position, velocity, spaw
         nil,
         PickupVariant.BOMB,
         bombSubType,
-        position,
+        positionOrGridIndex,
         velocity,
         spawner,
         seedOrRNG
@@ -270,7 +270,7 @@ function ____exports.spawnBombPickup(self, bombSubType, position, velocity, spaw
 end
 --- Helper function to spawn a `EntityType.PICKUP` (5) with variant `PickupVariant.BOMB` (40) and a
 -- specific seed.
-function ____exports.spawnBombPickupWithSeed(self, bombSubType, position, seedOrRNG, velocity, spawner)
+function ____exports.spawnBombPickupWithSeed(self, bombSubType, positionOrGridIndex, seedOrRNG, velocity, spawner)
     if velocity == nil then
         velocity = VectorZero
     end
@@ -280,14 +280,14 @@ function ____exports.spawnBombPickupWithSeed(self, bombSubType, position, seedOr
     return ____exports.spawnBombPickup(
         nil,
         bombSubType,
-        position,
+        positionOrGridIndex,
         velocity,
         spawner,
         seedOrRNG
     )
 end
 --- Helper function to spawn a `EntityType.PICKUP` (5) with variant `PickupVariant.TAROT_CARD` (300).
-function ____exports.spawnCard(self, cardType, position, velocity, spawner, seedOrRNG)
+function ____exports.spawnCard(self, cardType, positionOrGridIndex, velocity, spawner, seedOrRNG)
     if velocity == nil then
         velocity = VectorZero
     end
@@ -301,7 +301,7 @@ function ____exports.spawnCard(self, cardType, position, velocity, spawner, seed
         nil,
         PickupVariant.TAROT_CARD,
         cardType,
-        position,
+        positionOrGridIndex,
         velocity,
         spawner,
         seedOrRNG
@@ -309,7 +309,7 @@ function ____exports.spawnCard(self, cardType, position, velocity, spawner, seed
 end
 --- Helper function to spawn a `EntityType.PICKUP` (5) with variant `PickupVariant.TAROT_CARD` (300)
 -- and a specific seed.
-function ____exports.spawnCardWithSeed(self, cardType, position, seedOrRNG, velocity, spawner)
+function ____exports.spawnCardWithSeed(self, cardType, positionOrGridIndex, seedOrRNG, velocity, spawner)
     if velocity == nil then
         velocity = VectorZero
     end
@@ -319,14 +319,14 @@ function ____exports.spawnCardWithSeed(self, cardType, position, seedOrRNG, velo
     return ____exports.spawnCard(
         nil,
         cardType,
-        position,
+        positionOrGridIndex,
         velocity,
         spawner,
         seedOrRNG
     )
 end
 --- Helper function to spawn a `EntityType.PICKUP` (5) with variant `PickupVariant.COIN` (20).
-function ____exports.spawnCoin(self, coinSubType, position, velocity, spawner, seedOrRNG)
+function ____exports.spawnCoin(self, coinSubType, positionOrGridIndex, velocity, spawner, seedOrRNG)
     if velocity == nil then
         velocity = VectorZero
     end
@@ -340,7 +340,7 @@ function ____exports.spawnCoin(self, coinSubType, position, velocity, spawner, s
         nil,
         PickupVariant.COIN,
         coinSubType,
-        position,
+        positionOrGridIndex,
         velocity,
         spawner,
         seedOrRNG
@@ -348,7 +348,7 @@ function ____exports.spawnCoin(self, coinSubType, position, velocity, spawner, s
 end
 --- Helper function to spawn a `EntityType.PICKUP` (5) with variant `PickupVariant.COIN` (20) and a
 -- specific seed.
-function ____exports.spawnCoinWithSeed(self, coinSubType, position, seedOrRNG, velocity, spawner)
+function ____exports.spawnCoinWithSeed(self, coinSubType, positionOrGridIndex, seedOrRNG, velocity, spawner)
     if velocity == nil then
         velocity = VectorZero
     end
@@ -358,14 +358,14 @@ function ____exports.spawnCoinWithSeed(self, coinSubType, position, seedOrRNG, v
     return ____exports.spawnCoin(
         nil,
         coinSubType,
-        position,
+        positionOrGridIndex,
         velocity,
         spawner,
         seedOrRNG
     )
 end
 --- Helper function to spawn a `EntityType.PICKUP` (5) with variant `PickupVariant.HEART` (10).
-function ____exports.spawnHeart(self, heartSubType, position, velocity, spawner, seedOrRNG)
+function ____exports.spawnHeart(self, heartSubType, positionOrGridIndex, velocity, spawner, seedOrRNG)
     if velocity == nil then
         velocity = VectorZero
     end
@@ -379,13 +379,13 @@ function ____exports.spawnHeart(self, heartSubType, position, velocity, spawner,
         nil,
         PickupVariant.HEART,
         heartSubType,
-        position,
+        positionOrGridIndex,
         velocity,
         spawner,
         seedOrRNG
     )
 end
-function ____exports.spawnHeartWithSeed(self, heartSubType, position, seedOrRNG, velocity, spawner)
+function ____exports.spawnHeartWithSeed(self, heartSubType, positionOrGridIndex, seedOrRNG, velocity, spawner)
     if velocity == nil then
         velocity = VectorZero
     end
@@ -395,14 +395,14 @@ function ____exports.spawnHeartWithSeed(self, heartSubType, position, seedOrRNG,
     return ____exports.spawnHeart(
         nil,
         heartSubType,
-        position,
+        positionOrGridIndex,
         velocity,
         spawner,
         seedOrRNG
     )
 end
 --- Helper function to spawn a `EntityType.PICKUP` (5) with variant `PickupVariant.KEY` (30).
-function ____exports.spawnKey(self, keySubType, position, velocity, spawner, seedOrRNG)
+function ____exports.spawnKey(self, keySubType, positionOrGridIndex, velocity, spawner, seedOrRNG)
     if velocity == nil then
         velocity = VectorZero
     end
@@ -416,7 +416,7 @@ function ____exports.spawnKey(self, keySubType, position, velocity, spawner, see
         nil,
         PickupVariant.KEY,
         keySubType,
-        position,
+        positionOrGridIndex,
         velocity,
         spawner,
         seedOrRNG
@@ -424,7 +424,7 @@ function ____exports.spawnKey(self, keySubType, position, velocity, spawner, see
 end
 --- Helper function to spawn a `EntityType.PICKUP` (5) with variant `PickupVariant.KEY` (30) and a
 -- specific seed.
-function ____exports.spawnKeyWithSeed(self, keySubType, position, seedOrRNG, velocity, spawner)
+function ____exports.spawnKeyWithSeed(self, keySubType, positionOrGridIndex, seedOrRNG, velocity, spawner)
     if velocity == nil then
         velocity = VectorZero
     end
@@ -434,14 +434,14 @@ function ____exports.spawnKeyWithSeed(self, keySubType, position, seedOrRNG, vel
     return ____exports.spawnKey(
         nil,
         keySubType,
-        position,
+        positionOrGridIndex,
         velocity,
         spawner,
         seedOrRNG
     )
 end
 --- Helper function to spawn a `EntityType.PICKUP` (5) with variant `PickupVariant.PILL` (70).
-function ____exports.spawnPill(self, pillColor, position, velocity, spawner, seedOrRNG)
+function ____exports.spawnPill(self, pillColor, positionOrGridIndex, velocity, spawner, seedOrRNG)
     if velocity == nil then
         velocity = VectorZero
     end
@@ -455,7 +455,7 @@ function ____exports.spawnPill(self, pillColor, position, velocity, spawner, see
         nil,
         PickupVariant.PILL,
         pillColor,
-        position,
+        positionOrGridIndex,
         velocity,
         spawner,
         seedOrRNG
@@ -463,7 +463,7 @@ function ____exports.spawnPill(self, pillColor, position, velocity, spawner, see
 end
 --- Helper function to spawn a `EntityType.PICKUP` (5) with variant `PickupVariant.PILL` (70) and a
 -- specific seed.
-function ____exports.spawnPillWithSeed(self, pillColor, position, seedOrRNG, velocity, spawner)
+function ____exports.spawnPillWithSeed(self, pillColor, positionOrGridIndex, seedOrRNG, velocity, spawner)
     if velocity == nil then
         velocity = VectorZero
     end
@@ -473,14 +473,14 @@ function ____exports.spawnPillWithSeed(self, pillColor, position, seedOrRNG, vel
     return ____exports.spawnPill(
         nil,
         pillColor,
-        position,
+        positionOrGridIndex,
         velocity,
         spawner,
         seedOrRNG
     )
 end
 --- Helper function to spawn a `EntityType.PICKUP` (5) with variant `PickupVariant.SACK` (69).
-function ____exports.spawnSack(self, sackSubType, position, velocity, spawner, seedOrRNG)
+function ____exports.spawnSack(self, sackSubType, positionOrGridIndex, velocity, spawner, seedOrRNG)
     if velocity == nil then
         velocity = VectorZero
     end
@@ -494,7 +494,7 @@ function ____exports.spawnSack(self, sackSubType, position, velocity, spawner, s
         nil,
         PickupVariant.SACK,
         sackSubType,
-        position,
+        positionOrGridIndex,
         velocity,
         spawner,
         seedOrRNG
@@ -502,7 +502,7 @@ function ____exports.spawnSack(self, sackSubType, position, velocity, spawner, s
 end
 --- Helper function to spawn a `EntityType.PICKUP` (5) with variant `PickupVariant.SACK` (69) and a
 -- specific seed.
-function ____exports.spawnSackWithSeed(self, sackSubType, position, seedOrRNG, velocity, spawner)
+function ____exports.spawnSackWithSeed(self, sackSubType, positionOrGridIndex, seedOrRNG, velocity, spawner)
     if velocity == nil then
         velocity = VectorZero
     end
@@ -512,14 +512,14 @@ function ____exports.spawnSackWithSeed(self, sackSubType, position, seedOrRNG, v
     return ____exports.spawnSack(
         nil,
         sackSubType,
-        position,
+        positionOrGridIndex,
         velocity,
         spawner,
         seedOrRNG
     )
 end
 --- Helper function to spawn a `EntityType.PICKUP` (5) with variant `PickupVariant.TRINKET` (350).
-function ____exports.spawnTrinket(self, trinketType, position, velocity, spawner, seedOrRNG)
+function ____exports.spawnTrinket(self, trinketType, positionOrGridIndex, velocity, spawner, seedOrRNG)
     if velocity == nil then
         velocity = VectorZero
     end
@@ -533,7 +533,7 @@ function ____exports.spawnTrinket(self, trinketType, position, velocity, spawner
         nil,
         PickupVariant.TRINKET,
         trinketType,
-        position,
+        positionOrGridIndex,
         velocity,
         spawner,
         seedOrRNG
@@ -541,7 +541,7 @@ function ____exports.spawnTrinket(self, trinketType, position, velocity, spawner
 end
 --- Helper function to spawn a `EntityType.PICKUP` (5) with variant `PickupVariant.TRINKET` (350) and
 -- a specific seed.
-function ____exports.spawnTrinketWithSeed(self, trinketType, position, seedOrRNG, velocity, spawner)
+function ____exports.spawnTrinketWithSeed(self, trinketType, positionOrGridIndex, seedOrRNG, velocity, spawner)
     if velocity == nil then
         velocity = VectorZero
     end
@@ -551,7 +551,7 @@ function ____exports.spawnTrinketWithSeed(self, trinketType, position, seedOrRNG
     return ____exports.spawnTrinket(
         nil,
         trinketType,
-        position,
+        positionOrGridIndex,
         velocity,
         spawner,
         seedOrRNG

package/dist/src/functions/players.d.ts

@@ -20,6 +20,13 @@ export declare function anyPlayerIs(...matchingCharacters: PlayerType[]): boolea
  * - the player has Stompy (transformation 13)
  */
 export declare function canPlayerCrushRocks(player: EntityPlayer): boolean;
+/**
+ * Helper function to remove a collectible or trinket that is currently queued to go into a player's
+ * inventory (i.e. the item is being held over their head).
+ *
+ * Returns whether or not an item was actually dequeued.
+ */
+export declare function dequeueItem(player: EntityPlayer): boolean;
 /**
  * Helper function to find the active slot that the player has the corresponding collectible type
  * in. Returns undefined if the player does not have the collectible in any active slot.

package/dist/src/functions/players.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"players.d.ts","sourceRoot":"","sources":["../../../src/functions/players.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"players.d.ts","sourceRoot":"","sources":["../../../src/functions/players.ts"],"names":[],"mappings":"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"}

package/dist/src/functions/players.lua

@@ -122,6 +122,19 @@ function ____exports.canPlayerCrushRocks(self, player)
     local effects = player:GetEffects()
     return player:HasCollectible(CollectibleType.LEO) or player:HasCollectible(CollectibleType.THUNDER_THIGHS) or effects:HasCollectibleEffect(CollectibleType.MEGA_MUSH) or player:HasPlayerForm(PlayerForm.STOMPY)
 end
+--- Helper function to remove a collectible or trinket that is currently queued to go into a player's
+-- inventory (i.e. the item is being held over their head).
+-- 
+-- Returns whether or not an item was actually dequeued.
+function ____exports.dequeueItem(self, player)
+    if player.QueuedItem.Item == nil then
+        return false
+    end
+    local queue = player.QueuedItem
+    queue.Item = nil
+    player.QueuedItem = queue
+    return true
+end
 --- Helper function to find the active slot that the player has the corresponding collectible type
 -- in. Returns undefined if the player does not have the collectible in any active slot.
 function ____exports.getActiveItemSlot(self, player, collectibleType)
@@ -496,7 +509,7 @@ function ____exports.removeAllActiveItems(self, player)
         do
             local collectibleType = player:GetActiveItem(activeSlot)
             if collectibleType == CollectibleType.NULL then
-                goto __continue89
+                goto __continue91
             end
             local hasCollectible
             repeat
@@ -506,7 +519,7 @@ function ____exports.removeAllActiveItems(self, player)
                 end
             until not hasCollectible
         end
-        ::__continue89::
+        ::__continue91::
     end
 end
 --- Helper function to remove all of the held trinkets from a player.
@@ -518,7 +531,7 @@ function ____exports.removeAllPlayerTrinkets(self, player)
         do
             local trinketType = player:GetTrinket(trinketSlot)
             if trinketType == TrinketType.NULL then
-                goto __continue94
+                goto __continue96
             end
             local hasTrinket
             repeat
@@ -528,7 +541,7 @@ function ____exports.removeAllPlayerTrinkets(self, player)
                 end
             until not hasTrinket
         end
-        ::__continue94::
+        ::__continue96::
     end
 end
 --- Helper function to remove a collectible costume from a player. Use this helper function to avoid
@@ -609,9 +622,9 @@ function ____exports.setActiveItem(self, player, collectibleType, activeSlot, ch
         itemPool:RemoveCollectible(collectibleType)
     end
     repeat
-        local ____switch113 = activeSlot
-        local ____cond113 = ____switch113 == ActiveSlot.PRIMARY
-        if ____cond113 then
+        local ____switch115 = activeSlot
+        local ____cond115 = ____switch115 == ActiveSlot.PRIMARY
+        if ____cond115 then
             do
                 if primaryCollectibleType ~= CollectibleType.NULL then
                     player:RemoveCollectible(primaryCollectibleType)
@@ -620,8 +633,8 @@ function ____exports.setActiveItem(self, player, collectibleType, activeSlot, ch
                 break
             end
         end
-        ____cond113 = ____cond113 or ____switch113 == ActiveSlot.SECONDARY
-        if ____cond113 then
+        ____cond115 = ____cond115 or ____switch115 == ActiveSlot.SECONDARY
+        if ____cond115 then
             do
                 if primaryCollectibleType ~= CollectibleType.NULL then
                     player:RemoveCollectible(primaryCollectibleType)
@@ -636,16 +649,16 @@ function ____exports.setActiveItem(self, player, collectibleType, activeSlot, ch
                 break
             end
         end
-        ____cond113 = ____cond113 or ____switch113 == ActiveSlot.POCKET
-        if ____cond113 then
+        ____cond115 = ____cond115 or ____switch115 == ActiveSlot.POCKET
+        if ____cond115 then
             do
                 player:SetPocketActiveItem(collectibleType, activeSlot, keepInPools)
                 player:SetActiveCharge(charge, activeSlot)
                 break
             end
         end
-        ____cond113 = ____cond113 or ____switch113 == ActiveSlot.POCKET_SINGLE_USE
-        if ____cond113 then
+        ____cond115 = ____cond115 or ____switch115 == ActiveSlot.POCKET_SINGLE_USE
+        if ____cond115 then
             do
                 player:SetPocketActiveItem(collectibleType, activeSlot, keepInPools)
                 break

package/dist/src/functions/spawnCollectible.d.ts

@@ -10,7 +10,7 @@ import { CollectibleType } from "isaac-typescript-definitions";
  * (which is provided by `ISCFeature.SPAWN_COLLECTIBLE`).
  *
  * @param collectibleType The collectible type to spawn.
- * @param position The position to spawn the collectible at.
+ * @param positionOrGridIndex The position or grid index to spawn the collectible at.
  * @param seedOrRNG Optional. The `Seed` or `RNG` object to use. If an `RNG` object is provided, the
  *                  `RNG.Next` method will be called. Default is `getRandomSeed()`.
  * @param options Optional. Set to true to make the collectible a "There's Options" style
@@ -19,7 +19,7 @@ import { CollectibleType } from "isaac-typescript-definitions";
  *                      Tainted Keeper. Default is false.
  * @param spawner Optional.
  */
-export declare function spawnCollectibleUnsafe(collectibleType: CollectibleType, position: Vector, seedOrRNG?: Seed | RNG, options?: boolean, forceFreeItem?: boolean, spawner?: Entity): EntityPickupCollectible;
+export declare function spawnCollectibleUnsafe(collectibleType: CollectibleType, positionOrGridIndex: Vector | int, seedOrRNG?: Seed | RNG, options?: boolean, forceFreeItem?: boolean, spawner?: Entity): EntityPickupCollectible;
 /**
  * Helper function to spawn an empty collectible. Doing this is tricky since spawning a collectible
  * with `CollectibleType.NULL` will result in spawning a collectible with a random type from the
@@ -28,9 +28,9 @@ export declare function spawnCollectibleUnsafe(collectibleType: CollectibleType,
  * Instead, this function arbitrarily spawns a collectible with `CollectibleType.SAD_ONION`, and
  * then converts it to an empty pedestal afterward.
  *
- * @param position The position to spawn the empty collectible at.
+ * @param positionOrGridIndex The position or grid index to spawn the empty collectible at.
  * @param seedOrRNG The `Seed` or `RNG` object to use. If an `RNG` object is provided, the
  *                  `RNG.Next` method will be called. Default is `getRandomSeed()`.
  */
-export declare function spawnEmptyCollectible(position: Vector, seedOrRNG?: Seed | RNG): EntityPickup;
+export declare function spawnEmptyCollectible(positionOrGridIndex: Vector | int, seedOrRNG?: Seed | RNG): EntityPickup;
 //# sourceMappingURL=spawnCollectible.d.ts.map

package/dist/src/functions/spawnCollectible.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spawnCollectible.d.ts","sourceRoot":"","sources":["../../../src/functions/spawnCollectible.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EAGhB,MAAM,8BAA8B,CAAC;AAQtC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,sBAAsB,CACpC,eAAe,EAAE,eAAe,EAChC,QAAQ,EAAE,MAAM,EAChB,SAAS,GAAE,IAAI,GAAG,GAAqB,EACvC,OAAO,UAAQ,EACf,aAAa,UAAQ,EACrB,OAAO,CAAC,EAAE,MAAM,GACf,uBAAuB,CAiCzB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,SAAS,GAAE,IAAI,GAAG,GAAqB,GACtC,YAAY,CAWd"}
+{"version":3,"file":"spawnCollectible.d.ts","sourceRoot":"","sources":["../../../src/functions/spawnCollectible.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EAGhB,MAAM,8BAA8B,CAAC;AAQtC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,sBAAsB,CACpC,eAAe,EAAE,eAAe,EAChC,mBAAmB,EAAE,MAAM,GAAG,GAAG,EACjC,SAAS,GAAE,IAAI,GAAG,GAAqB,EACvC,OAAO,UAAQ,EACf,aAAa,UAAQ,EACrB,OAAO,CAAC,EAAE,MAAM,GACf,uBAAuB,CAiCzB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CACnC,mBAAmB,EAAE,MAAM,GAAG,GAAG,EACjC,SAAS,GAAE,IAAI,GAAG,GAAqB,GACtC,YAAY,CAWd"}

package/dist/src/functions/spawnCollectible.lua

@@ -26,7 +26,7 @@ local isRNG = ____rng.isRNG
 -- (which is provided by `ISCFeature.SPAWN_COLLECTIBLE`).
 -- 
 -- @param collectibleType The collectible type to spawn.
--- @param position The position to spawn the collectible at.
+-- @param positionOrGridIndex The position or grid index to spawn the collectible at.
 -- @param seedOrRNG Optional. The `Seed` or `RNG` object to use. If an `RNG` object is provided, the
 -- `RNG.Next` method will be called. Default is `getRandomSeed()`.
 -- @param options Optional. Set to true to make the collectible a "There's Options" style
@@ -34,7 +34,7 @@ local isRNG = ____rng.isRNG
 -- @param forceFreeItem Optional. Set to true to disable the logic that gives the item a price for
 -- Tainted Keeper. Default is false.
 -- @param spawner Optional.
-function ____exports.spawnCollectibleUnsafe(self, collectibleType, position, seedOrRNG, options, forceFreeItem, spawner)
+function ____exports.spawnCollectibleUnsafe(self, collectibleType, positionOrGridIndex, seedOrRNG, options, forceFreeItem, spawner)
     if seedOrRNG == nil then
         seedOrRNG = getRandomSeed(nil)
     end
@@ -49,7 +49,7 @@ function ____exports.spawnCollectibleUnsafe(self, collectibleType, position, see
         nil,
         PickupVariant.COLLECTIBLE,
         collectibleType,
-        position,
+        positionOrGridIndex,
         seed,
         VectorZero,
         spawner
@@ -70,17 +70,17 @@ end
 -- Instead, this function arbitrarily spawns a collectible with `CollectibleType.SAD_ONION`, and
 -- then converts it to an empty pedestal afterward.
 -- 
--- @param position The position to spawn the empty collectible at.
+-- @param positionOrGridIndex The position or grid index to spawn the empty collectible at.
 -- @param seedOrRNG The `Seed` or `RNG` object to use. If an `RNG` object is provided, the
 -- `RNG.Next` method will be called. Default is `getRandomSeed()`.
-function ____exports.spawnEmptyCollectible(self, position, seedOrRNG)
+function ____exports.spawnEmptyCollectible(self, positionOrGridIndex, seedOrRNG)
     if seedOrRNG == nil then
         seedOrRNG = getRandomSeed(nil)
     end
     local collectible = ____exports.spawnCollectibleUnsafe(
         nil,
         CollectibleType.SAD_ONION,
-        position,
+        positionOrGridIndex,
         seedOrRNG,
         false,
         true

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacscript-common",
-  "version": "17.2.1",
+  "version": "17.4.0",
   "description": "Helper functions and features for IsaacScript mods.",
   "keywords": [
     "isaac",
@@ -22,6 +22,6 @@
   "main": "dist/src/index",
   "types": "dist/src/index.d.ts",
   "dependencies": {
-    "isaac-typescript-definitions": "^10.0.3"
+    "isaac-typescript-definitions": "^10.0.4"
   }
 }

package/src/classes/features/other/CustomHotkeys.ts

@@ -67,6 +67,8 @@ export class CustomHotkeys extends Feature {
    * This can be used to easily set up custom hotkeys to facilitate custom game features or to
    * assist in debugging.
    *
+   * Inputs are checked for in the `POST_RENDER` callback.
+   *
    * This is different from the `setHotkey` function in that the keyboard activation key is not
    * hardcoded and is instead the return value of a provided function. This is useful for situations
    * where the key can change (like if end-users can specify a custom hotkey using Mod Config Menu).
@@ -97,6 +99,8 @@ export class CustomHotkeys extends Feature {
    * This can be used to easily set up custom hotkeys to facilitate custom game features or to
    * assist in debugging.
    *
+   * Inputs are checked for in the `POST_RENDER` callback.
+   *
    * In order to use this function, you must upgrade your mod with `ISCFeature.CUSTOM_HOTKEYS`.
    *
    * @param keyboard The key that you want to trigger the hotkey.

package/src/classes/features/other/SpawnCollectible.ts

@@ -34,7 +34,7 @@ export class SpawnCollectible extends Feature {
    * In order to use this function, you must upgrade your mod with `ISCFeature.SPAWN_COLLECTIBLE`.
    *
    * @param collectibleType The collectible type to spawn.
-   * @param position The position to spawn the collectible at.
+   * @param positionOrGridIndex The position or grid index to spawn the collectible at.
    * @param seedOrRNG Optional. The `Seed` or `RNG` object to use. If an `RNG` object is provided,
    *                  the `RNG.Next` method will be called. Default is `getRandomSeed()`.
    * @param options Optional. Set to true to make the collectible a "There's Options" style
@@ -46,7 +46,7 @@ export class SpawnCollectible extends Feature {
   @Exported
   public spawnCollectible(
     collectibleType: CollectibleType,
-    position: Vector,
+    positionOrGridIndex: Vector | int,
     seedOrRNG: Seed | RNG = getRandomSeed(),
     options = false,
     forceFreeItem = false,
@@ -54,7 +54,7 @@ export class SpawnCollectible extends Feature {
   ): EntityPickupCollectible {
     const collectible = spawnCollectibleUnsafe(
       collectibleType,
-      position,
+      positionOrGridIndex,
       seedOrRNG,
       options,
       forceFreeItem,
@@ -81,7 +81,7 @@ export class SpawnCollectible extends Feature {
    * In order to use this function, you must upgrade your mod with `ISCFeature.SPAWN_COLLECTIBLE`.
    *
    * @param itemPoolType The item pool to draw the collectible type from.
-   * @param position The position to spawn the collectible at.
+   * @param positionOrGridIndex The position or grid index to spawn the collectible at.
    * @param seedOrRNG Optional. The `Seed` or `RNG` object to use. If an `RNG` object is provided,
    *                  the `RNG.Next` method will be called. Default is `getRandomSeed()`.
    * @param options Optional. Set to true to make the collectible a "There's Options" style
@@ -93,7 +93,7 @@ export class SpawnCollectible extends Feature {
   @Exported
   public spawnCollectibleFromPool(
     itemPoolType: ItemPoolType,
-    position: Vector,
+    positionOrGridIndex: Vector | int,
     seedOrRNG: Seed | RNG = getRandomSeed(),
     options = false,
     forceFreeItem = false,
@@ -104,7 +104,7 @@ export class SpawnCollectible extends Feature {
 
     return this.spawnCollectible(
       collectibleType,
-      position,
+      positionOrGridIndex,
       seedOrRNG,
       options,
       forceFreeItem,

package/src/classes/features/other/SpawnRockAltRewards.ts

@@ -31,7 +31,7 @@ import { getRandom } from "../../../functions/random";
 import { getRandomSeed, isRNG, newRNG } from "../../../functions/rng";
 import { spawnCollectibleUnsafe } from "../../../functions/spawnCollectible";
 import { repeat } from "../../../functions/utils";
-import { getRandomVector } from "../../../functions/vector";
+import { getRandomVector, isVector } from "../../../functions/vector";
 import { Feature } from "../../private/Feature";
 import { ItemPoolDetection } from "./ItemPoolDetection";
 
@@ -92,7 +92,7 @@ export class SpawnRockAltRewards extends Feature {
    * In order to use this function, you must upgrade your mod with
    * `ISCFeature.SPAWN_ALT_ROCK_REWARDS`.
    *
-   * @param position The place to spawn the reward.
+   * @param positionOrGridIndex The position or grid index to spawn the reward.
    * @param rockAltType The type of reward to spawn. For example, `RockAltType.URN` will have a
    *                    chance at spawning coins and spiders.
    * @param seedOrRNG Optional. The `Seed` or `RNG` object to use. If an `RNG` object is provided,
@@ -102,10 +102,14 @@ export class SpawnRockAltRewards extends Feature {
    */
   @Exported
   public spawnRockAltReward(
-    position: Vector,
+    positionOrGridIndex: Vector | int,
     rockAltType: RockAltType,
     seedOrRNG: Seed | RNG = getRandomSeed(),
   ): boolean {
+    const room = game.GetRoom();
+    const position = isVector(positionOrGridIndex)
+      ? positionOrGridIndex
+      : room.GetGridPosition(positionOrGridIndex);
     const rng = isRNG(seedOrRNG) ? seedOrRNG : newRNG(seedOrRNG);
 
     switch (rockAltType) {