isaacscript-common 1.2.107 → 1.2.108

package/dist/callbacks/postPurchase.lua

@@ -64,7 +64,14 @@ function storePickupsInMap(self, pickups)
         function(____, pickup) return pickup.Price ~= 0 end
     )
     for ____, pickup in ipairs(pickupsWithPrice) do
-        v.room.pickupMap:set(pickup.Index, {variant = pickup.Variant, subType = pickup.SubType, price = pickup.Price, initSeed = pickup.InitSeed})
+        v.room.pickupMap:set(pickup.Index, {
+            variant = pickup.Variant,
+            subType = pickup.SubType,
+            position = pickup.Position,
+            velocity = pickup.Velocity,
+            price = pickup.Price,
+            initSeed = pickup.InitSeed
+        })
     end
 end
 function storePlayersInMap(self, players)

package/dist/functions/collectibles.d.ts

@@ -1,5 +1,6 @@
 /// <reference types="isaac-typescript-definitions" />
 export declare function collectibleHasTag(collectibleType: CollectibleType | int, tag: ItemConfigTag): boolean;
+export declare function clearCollectibleSprite(collectible: EntityPickup): void;
 export declare function collectibleHasCacheFlag(collectibleType: CollectibleType | int, cacheFlag: CacheFlag): boolean;
 /**
  * Helper function to get the in-game description for a collectible. Returns "Unknown" if the
@@ -98,24 +99,24 @@ export declare function setCollectiblesRerolledForItemTracker(): void;
 export declare function setCollectibleBlind(collectible: EntityPickup): void;
 /**
  * Helper function to remove the collectible from a collectible pedestal and make it appear as if a
- * player has already taken the item. This is accomplished by setting its sprite to an empty/missing
- * PNG file.
+ * player has already taken the item. This is accomplished by changing the sub-type to
+ * `CollectibleType.COLLECTIBLE_NULL` and then setting the sprite to an empty/missing PNG file.
  *
- * For more information, see the documentation for the "emptySprite" helper function.
+ * For more information, see the documentation for the "clearSprite" helper function.
  */
 export declare function setCollectibleEmpty(collectible: EntityPickup): void;
 /**
  * Helper function to change the sprite of a collectible pedestal entity.
  *
  * For more information about removing the collectible sprite, see the documentation for the
- * "emptySprite" helper function.
+ * "clearSprite" helper function.
  *
  * @param collectible The collectible whose sprite you want to modify.
- * @param pngPath Optional. Equal to the spritesheet path to load (e.g.
- * "gfx/items/collectibles/collectibles_001_thesadonion.png"). If not specified, will remove the
- * sprite, making it appear like the collectible has already been taken by the player.
+ * @param pngPath Equal to either the spritesheet path to load (e.g.
+ * "gfx/items/collectibles/collectibles_001_thesadonion.png") or undefined. If undefined, the sprite
+ * will be removed, making it appear like the collectible has already been taken by the player.
  */
-export declare function setCollectibleSprite(collectible: EntityPickup, pngPath?: string): void;
+export declare function setCollectibleSprite(collectible: EntityPickup, pngPath: string | undefined): void;
 /**
  * Helper function to change the collectible on a pedestal. Simply updating the SubType property is
  * not sufficient because the sprite will not change.

package/dist/functions/collectibles.lua

@@ -38,6 +38,9 @@ function ____exports.collectibleHasTag(self, collectibleType, tag)
     end
     return itemConfigItem:HasTags(tag)
 end
+function ____exports.clearCollectibleSprite(self, collectible)
+    ____exports.setCollectibleSprite(nil, collectible, nil)
+end
 function ____exports.collectibleHasCacheFlag(self, collectibleType, cacheFlag)
     local itemConfig = Isaac.GetItemConfig()
     local itemConfigItem = itemConfig:GetCollectible(collectibleType)
@@ -185,7 +188,7 @@ function ____exports.setCollectibleEmpty(self, collectible)
         error("You cannot set a collectible to be empty for pickups of variant: " .. tostring(collectible.Variant))
     end
     collectible.SubType = CollectibleType.COLLECTIBLE_NULL
-    ____exports.setCollectibleSprite(nil, collectible)
+    ____exports.clearCollectibleSprite(nil, collectible)
 end
 function ____exports.setCollectibleSubType(self, collectible, newCollectibleType)
     if collectible.Variant ~= PickupVariant.PICKUP_COLLECTIBLE then

package/dist/functions/spawnCollectible.d.ts

@@ -13,3 +13,12 @@
  * Tainted Keeper. False by default.
  */
 export declare function spawnCollectible(collectibleType: CollectibleType | int, position: Vector, seed?: number, options?: boolean, forceFreeItem?: boolean): EntityPickup;
+/**
+ * Helper function to spawn an empty collectible. Doing this is tricky since spawning a collectible
+ * with `CollectibleType.COLLECTIBLE_NULL` will result in spawning a collectible with a random type
+ * from the current room's item pool.
+ *
+ * Instead, this function arbitrarily spawns a collectible with
+ * `CollectibleType.COLLECTIBLE_SAD_ONION`, and then converts it to an empty pedestal afterward.
+ */
+export declare function spawnEmptyCollectible(position: Vector, seed?: number): void;

package/dist/functions/spawnCollectible.lua

@@ -6,6 +6,7 @@ local ____featuresInitialized = require("featuresInitialized")
 local areFeaturesInitialized = ____featuresInitialized.areFeaturesInitialized
 local ____collectibles = require("functions.collectibles")
 local isQuestCollectible = ____collectibles.isQuestCollectible
+local setCollectibleEmpty = ____collectibles.setCollectibleEmpty
 local ____player = require("functions.player")
 local anyPlayerIs = ____player.anyPlayerIs
 function ____exports.spawnCollectible(self, collectibleType, position, seed, options, forceFreeItem)
@@ -46,4 +47,18 @@ function ____exports.spawnCollectible(self, collectibleType, position, seed, opt
     end
     return collectible
 end
+function ____exports.spawnEmptyCollectible(self, position, seed)
+    if seed == nil then
+        seed = Random()
+    end
+    local collectible = ____exports.spawnCollectible(
+        nil,
+        CollectibleType.COLLECTIBLE_SAD_ONION,
+        position,
+        seed,
+        false,
+        true
+    )
+    setCollectibleEmpty(nil, collectible)
+end
 return ____exports

package/dist/types/PickupDescription.d.ts

@@ -2,6 +2,8 @@
 export interface PickupDescription {
     variant: PickupVariant | int;
     subType: int;
+    position: Vector;
+    velocity: Vector;
     price: int;
     initSeed: int;
 }

package/package.json

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