isaacscript-common 8.5.0 → 8.8.0

package/dist/enums/ModCallbackCustom.d.ts

@@ -892,7 +892,7 @@ export declare enum ModCallbackCustom {
     POST_PLAYER_CHANGE_TYPE = 57,
     /**
      * Fires from the `POST_PEFFECT_UPDATE` callback when a player's collectible count is higher than
-     * what it was on the previous frame.
+     * what it was on the previous frame or when a new active collectible is acquired.
      *
      * When registering the callback, takes an optional second argument that will make the callback
      * only fire if the collectible matches the `CollectibleType` provided.
@@ -907,7 +907,7 @@ export declare enum ModCallbackCustom {
     POST_PLAYER_COLLECTIBLE_ADDED = 58,
     /**
      * Fires from the `POST_PEFFECT_UPDATE` callback when a player's collectible count is lower than
-     * what it was on the previous frame.
+     * what it was on the previous frame or when an active collectible is no longer present.
      *
      * When registering the callback, takes an optional second argument that will make the callback
      * only fire if the collectible matches the `CollectibleType` provided.

package/dist/features/playerInventory.d.ts

@@ -3,9 +3,6 @@ import { CollectibleType } from "isaac-typescript-definitions";
  * Helper function to get all of the collectibles that the player has gotten so far on this run, in
  * order.
  *
- * Note that this does not include active collectibles that have since been dropped for other
- * collectibles.
- *
  * In the case of inventory initialization or the case where the player rerolls their build in the
  * middle of the run (e.g. with D4), the order of the inventory will not correspond to the order
  * that the items were actually given to the player. In this case, the inventory will be in the
@@ -17,6 +14,17 @@ import { CollectibleType } from "isaac-typescript-definitions";
  * would not be updated. In vanilla, this situation would never happen, but another mod might do
  * this for some reason. (With that said, the next time that a collectible is normally added or
  * removed, it would trigger a re-scan, and the previous changes would be picked up.)
+ *
+ * @param player The player to get the inventory for.
+ * @param includeActiveCollectibles Optional. If true, will include all active collectibles. Default
+ *                                 is true.
  */
 export declare function getPlayerInventory(player: EntityPlayer, includeActiveCollectibles?: boolean): CollectibleType[];
+/**
+ * Helper function to get the last passive collectible that the player picked up. In most cases,
+ * this will be the passive that is removed when the player would use Clicker.
+ *
+ * Returns undefined if the player does not have any passive collectibles.
+ */
+export declare function getPlayerLastPassiveCollectible(player: EntityPlayer): CollectibleType | undefined;
 //# sourceMappingURL=playerInventory.d.ts.map

package/dist/features/playerInventory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"playerInventory.d.ts","sourceRoot":"","sources":["../../src/features/playerInventory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAe,MAAM,8BAA8B,CAAC;AAyG5E;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,YAAY,EACpB,yBAAyB,UAAO,GAC/B,eAAe,EAAE,CAanB"}
+{"version":3,"file":"playerInventory.d.ts","sourceRoot":"","sources":["../../src/features/playerInventory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAe,MAAM,8BAA8B,CAAC;AAsH5E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,YAAY,EACpB,yBAAyB,UAAO,GAC/B,eAAe,EAAE,CAanB;AAED;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,YAAY,GACnB,eAAe,GAAG,SAAS,CAK7B"}

package/dist/features/playerInventory.lua

@@ -15,6 +15,7 @@ local errorIfFeaturesNotInitialized = ____featuresInitialized.errorIfFeaturesNot
 local ____array = require("functions.array")
 local arrayRemoveInPlace = ____array.arrayRemoveInPlace
 local copyArray = ____array.copyArray
+local getLastElement = ____array.getLastElement
 local ____collectibles = require("functions.collectibles")
 local isActiveCollectible = ____collectibles.isActiveCollectible
 local ____collectibleSet = require("functions.collectibleSet")
@@ -32,14 +33,16 @@ local saveDataManager = ____exports.saveDataManager
 function newPlayerInventory(self, player)
     local inventory = {}
     for ____, collectibleType in ipairs(getCollectibleArray(nil)) do
-        local numCollectibles = player:GetCollectibleNum(collectibleType, true)
-        ____repeat(
-            nil,
-            numCollectibles,
-            function()
-                inventory[#inventory + 1] = collectibleType
-            end
-        )
+        if player:HasCollectible(collectibleType) then
+            local numCollectibles = player:GetCollectibleNum(collectibleType, true)
+            ____repeat(
+                nil,
+                numCollectibles,
+                function()
+                    inventory[#inventory + 1] = collectibleType
+                end
+            )
+        end
     end
     return inventory
 end
@@ -84,9 +87,6 @@ end
 --- Helper function to get all of the collectibles that the player has gotten so far on this run, in
 -- order.
 -- 
--- Note that this does not include active collectibles that have since been dropped for other
--- collectibles.
--- 
 -- In the case of inventory initialization or the case where the player rerolls their build in the
 -- middle of the run (e.g. with D4), the order of the inventory will not correspond to the order
 -- that the items were actually given to the player. In this case, the inventory will be in the
@@ -98,6 +98,10 @@ end
 -- would not be updated. In vanilla, this situation would never happen, but another mod might do
 -- this for some reason. (With that said, the next time that a collectible is normally added or
 -- removed, it would trigger a re-scan, and the previous changes would be picked up.)
+-- 
+-- @param player The player to get the inventory for.
+-- @param includeActiveCollectibles Optional. If true, will include all active collectibles. Default
+-- is true.
 function ____exports.getPlayerInventory(self, player, includeActiveCollectibles)
     if includeActiveCollectibles == nil then
         includeActiveCollectibles = true
@@ -113,4 +117,13 @@ function ____exports.getPlayerInventory(self, player, includeActiveCollectibles)
         function(____, collectibleType) return not isActiveCollectible(nil, collectibleType) end
     )
 end
+--- Helper function to get the last passive collectible that the player picked up. In most cases,
+-- this will be the passive that is removed when the player would use Clicker.
+-- 
+-- Returns undefined if the player does not have any passive collectibles.
+function ____exports.getPlayerLastPassiveCollectible(self, player)
+    errorIfFeaturesNotInitialized(nil, FEATURE_NAME)
+    local inventory = ____exports.getPlayerInventory(nil, player, false)
+    return getLastElement(nil, inventory)
+end
 return ____exports

package/dist/functions/bosses.d.ts

@@ -19,6 +19,9 @@ export declare function getAliveBosses(entityType?: EntityType, variant?: number
  *
  * The set contains strings with the entity type and variant, separated by a period.
  *
+ * Note that this set does not include bosses that do not appear in Boss Rooms (e.g. Krampus, Uriel,
+ * and Gabriel.).
+ *
  * Also see the `getBossSet` and `getCombinedBossSet` functions.
  *
  * @param includeStoryBosses Optional. Whether to include "story" bosses like Mom and It Lives!

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

@@ -1 +1 @@
-{"version":3,"file":"bosses.d.ts","sourceRoot":"","sources":["../../src/functions/bosses.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EAEV,SAAS,EACV,MAAM,8BAA8B,CAAC;AAyBtC;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAC5B,UAAU,GAAE,UAAe,EAC3B,OAAO,SAAK,EACZ,OAAO,SAAK,EACZ,cAAc,UAAQ,GACrB,SAAS,EAAE,CAGb;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,kBAAkB,UAAO,GACxB,WAAW,CAAC,MAAM,CAAC,CAIrB;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,GAAG,EACV,SAAS,EAAE,SAAS,GACnB,WAAW,CAAC,MAAM,CAAC,GAAG,SAAS,CAYjC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CACvB,UAAU,CAAC,EAAE,UAAU,EACvB,OAAO,CAAC,EAAE,GAAG,EACb,OAAO,CAAC,EAAE,GAAG,EACb,cAAc,UAAQ,GACrB,SAAS,EAAE,CAGb;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,GAAG,GACT,WAAW,CAAC,MAAM,CAAC,GAAG,SAAS,CAOjC;AAED,6FAA6F;AAC7F,wBAAgB,KAAK,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAE7C;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CACvB,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,GAAG,EACZ,OAAO,EAAE,GAAG,EACZ,QAAQ,EAAE,MAAM,EAChB,QAAQ,GAAE,MAAmB,EAC7B,OAAO,GAAE,MAAM,GAAG,SAAqB,EACvC,SAAS,GAAE,IAAI,GAAG,GAAG,GAAG,SAAqB,EAC7C,WAAW,CAAC,EAAE,GAAG,GAChB,SAAS,CAyBX;AAmCD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,GAAG,EACZ,OAAO,EAAE,GAAG,EACZ,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,IAAI,GAAG,GAAG,EACrB,QAAQ,GAAE,MAAmB,EAC7B,OAAO,GAAE,MAAM,GAAG,SAAqB,EACvC,WAAW,CAAC,EAAE,GAAG,GAChB,SAAS,CAYX"}
+{"version":3,"file":"bosses.d.ts","sourceRoot":"","sources":["../../src/functions/bosses.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EAEV,SAAS,EACV,MAAM,8BAA8B,CAAC;AAyBtC;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAC5B,UAAU,GAAE,UAAe,EAC3B,OAAO,SAAK,EACZ,OAAO,SAAK,EACZ,cAAc,UAAQ,GACrB,SAAS,EAAE,CAGb;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAC7B,kBAAkB,UAAO,GACxB,WAAW,CAAC,MAAM,CAAC,CAIrB;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,GAAG,EACV,SAAS,EAAE,SAAS,GACnB,WAAW,CAAC,MAAM,CAAC,GAAG,SAAS,CAYjC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CACvB,UAAU,CAAC,EAAE,UAAU,EACvB,OAAO,CAAC,EAAE,GAAG,EACb,OAAO,CAAC,EAAE,GAAG,EACb,cAAc,UAAQ,GACrB,SAAS,EAAE,CAGb;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,GAAG,GACT,WAAW,CAAC,MAAM,CAAC,GAAG,SAAS,CAOjC;AAED,6FAA6F;AAC7F,wBAAgB,KAAK,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAE7C;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CACvB,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,GAAG,EACZ,OAAO,EAAE,GAAG,EACZ,QAAQ,EAAE,MAAM,EAChB,QAAQ,GAAE,MAAmB,EAC7B,OAAO,GAAE,MAAM,GAAG,SAAqB,EACvC,SAAS,GAAE,IAAI,GAAG,GAAG,GAAG,SAAqB,EAC7C,WAAW,CAAC,EAAE,GAAG,GAChB,SAAS,CAyBX;AAmCD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,GAAG,EACZ,OAAO,EAAE,GAAG,EACZ,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,IAAI,GAAG,GAAG,EACrB,QAAQ,GAAE,MAAmB,EAC7B,OAAO,GAAE,MAAM,GAAG,SAAqB,EACvC,WAAW,CAAC,EAAE,GAAG,GAChB,SAAS,CAYX"}

package/dist/functions/bosses.lua

@@ -107,6 +107,9 @@ end
 -- 
 -- The set contains strings with the entity type and variant, separated by a period.
 -- 
+-- Note that this set does not include bosses that do not appear in Boss Rooms (e.g. Krampus, Uriel,
+-- and Gabriel.).
+-- 
 -- Also see the `getBossSet` and `getCombinedBossSet` functions.
 -- 
 -- @param includeStoryBosses Optional. Whether to include "story" bosses like Mom and It Lives!

package/dist/functions/collectibles.d.ts

@@ -19,8 +19,12 @@ export declare function getCollectibleDevilCoinPrice(collectibleType: Collectibl
  */
 export declare function getCollectibleDevilHeartPrice(collectibleType: CollectibleType, player: EntityPlayer): PickupPrice;
 /**
- * Helper function to get the path to a collectible's sprite. Returns the path to the question mark
+ * Helper function to get the path to a collectible PNG file. Returns the path to the question mark
  * sprite (i.e. from Curse of the Blind) if the provided collectible type was not valid.
+ *
+ * Note that this does not return the file name, but the full path to the collectible's PNG file.
+ * The function is named "GfxFilename" to correspond to the associated `ItemConfigItem.GfxFileName`
+ * field.
  */
 export declare function getCollectibleGfxFilename(collectibleType: CollectibleType): string;
 /**
@@ -163,6 +167,11 @@ export declare function isPassiveCollectible(collectibleType: CollectibleType):
 export declare function isSingleUseCollectible(collectibleType: CollectibleType): boolean;
 export declare function isValidCollectibleType(collectibleType: CollectibleType): boolean;
 export declare function isVanillaCollectibleType(collectibleType: CollectibleType): boolean;
+/**
+ * Helper function to generate a new sprite based on a collectible. If the provided collectible type
+ * is invalid, a sprite with a Curse of the Blind question mark will be returned.
+ */
+export declare function newCollectibleSprite(collectibleType: CollectibleType): Sprite;
 /**
  * Helper function to put a message in the log.txt file to let the Rebirth Item Tracker know that it
  * should remove an item.

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

@@ -1 +1 @@
-{"version":3,"file":"collectibles.d.ts","sourceRoot":"","sources":["../../src/functions/collectibles.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"collectibles.d.ts","sourceRoot":"","sources":["../../src/functions/collectibles.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,eAAe,EAEf,aAAa,EAEb,QAAQ,EACR,WAAW,EAGZ,MAAM,8BAA8B,CAAC;AAgBtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AA0B7D,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,YAAY,GAAG,IAAI,CAEtE;AAED,6FAA6F;AAC7F,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,OAAO,CAsBT;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,eAAe,EAAE,eAAe,GAC/B,MAAM,CAeR;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,eAAe,EAAE,eAAe,GAC/B,GAAG,CAYL;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAC3C,eAAe,EAAE,eAAe,EAChC,MAAM,EAAE,YAAY,GACnB,WAAW,CAyBb;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,eAAe,EAAE,eAAe,GAC/B,MAAM,CAOR;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,YAAY,GACxB,gBAAgB,CAsBlB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,eAAe,EAAE,eAAe,GAC/B,GAAG,CAOL;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,eAAe,EAAE,eAAe,GAC/B,QAAQ,CAOV;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,eAAe,EAAE,eAAe,GAC/B,GAAG,CAOL;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,eAAe,EAAE,eAAe,GAAG,MAAM,CAc3E;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,YAAY,GACxB,uBAAuB,CAUzB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,eAAe,EAAE,eAAe,GAAG,GAAG,CAO3E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,eAAe,EAAE,eAAe,GAC/B,QAAQ,CAAC,aAAa,CAAC,CAGzB;AAED;;;;;;;;GAQG;AACH,wBAAgB,8BAA8B,IAAI,eAAe,EAAE,CAElE;AAED,2FAA2F;AAC3F,wBAAgB,mBAAmB,CAAC,eAAe,EAAE,eAAe,GAAG,OAAO,CAG7E;AAED,sEAAsE;AACtE,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,YAAY,GAAG,OAAO,CAcrE;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAKnE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,eAAe,EAAE,eAAe,GAAG,OAAO,CAG7E;AAED,wBAAgB,uBAAuB,CACrC,eAAe,EAAE,eAAe,GAC/B,OAAO,CAET;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,eAAe,EAAE,eAAe,GAC/B,OAAO,CAGT;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,eAAe,EAAE,eAAe,GAC/B,OAAO,CAET;AAED,wBAAgB,sBAAsB,CACpC,eAAe,EAAE,eAAe,GAC/B,OAAO,CAGT;AAED,wBAAgB,wBAAwB,CACtC,eAAe,EAAE,eAAe,GAC/B,OAAO,CAET;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,eAAe,EAAE,eAAe,GAAG,MAAM,CAa7E;AAED;;;;;;GAMG;AACH,wBAAgB,gCAAgC,CAC9C,eAAe,EAAE,eAAe,GAC/B,IAAI,CAQN;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,WAAW,EAAE,YAAY,GAAG,IAAI,CAS5E;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,YAAY,GAAG,IAAI,CASnE;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,YAAY,GAAG,IAAI,CAUnE;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,YAAY,GAAG,IAAI,CAuBtE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,YAAY,EACzB,OAAO,EAAE,MAAM,GAAG,SAAS,GAC1B,IAAI,CAeN;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,YAAY,EACzB,kBAAkB,EAAE,eAAe,GAClC,IAAI,CA2BN;AAED;;;GAGG;AACH,wBAAgB,qCAAqC,IAAI,IAAI,CAK5D"}

package/dist/functions/collectibles.lua

@@ -105,6 +105,7 @@ function ____exports.setCollectibleSubType(self, collectible, newCollectibleType
         true
     )
 end
+local COLLECTIBLE_ANM2_PATH = "gfx/005.100_collectible.anm2"
 COLLECTIBLE_SPRITE_LAYER = 1
 COLLECTIBLE_SHADOW_LAYER = 4
 local GLITCHED_ITEM_THRESHOLD = 4000000000
@@ -174,8 +175,12 @@ function ____exports.getCollectibleDevilHeartPrice(self, collectibleType, player
     local twoHeartPrice = maxHearts == 2 and PickupPrice.ONE_HEART_AND_TWO_SOUL_HEARTS or PickupPrice.TWO_HEARTS
     return itemConfigItem.DevilPrice == 2 and twoHeartPrice or PickupPrice.ONE_HEART
 end
---- Helper function to get the path to a collectible's sprite. Returns the path to the question mark
+--- Helper function to get the path to a collectible PNG file. Returns the path to the question mark
 -- sprite (i.e. from Curse of the Blind) if the provided collectible type was not valid.
+-- 
+-- Note that this does not return the file name, but the full path to the collectible's PNG file.
+-- The function is named "GfxFilename" to correspond to the associated `ItemConfigItem.GfxFileName`
+-- field.
 function ____exports.getCollectibleGfxFilename(self, collectibleType)
     local itemConfigItem = itemConfig:GetCollectible(collectibleType)
     if itemConfigItem == nil then
@@ -386,6 +391,17 @@ function ____exports.isValidCollectibleType(self, collectibleType)
     local itemConfigItem = itemConfig:GetCollectible(collectibleType)
     return itemConfigItem ~= nil
 end
+--- Helper function to generate a new sprite based on a collectible. If the provided collectible type
+-- is invalid, a sprite with a Curse of the Blind question mark will be returned.
+function ____exports.newCollectibleSprite(self, collectibleType)
+    local sprite = Sprite()
+    sprite:Load(COLLECTIBLE_ANM2_PATH, false)
+    clearSprite(nil, sprite)
+    local gfxFileName = ____exports.getCollectibleGfxFilename(nil, collectibleType)
+    sprite:ReplaceSpritesheet(COLLECTIBLE_SPRITE_LAYER, gfxFileName)
+    sprite:LoadGraphics()
+    return sprite
+end
 --- Helper function to put a message in the log.txt file to let the Rebirth Item Tracker know that it
 -- should remove an item.
 -- 

package/dist/functions/curses.d.ts

@@ -1,3 +1,12 @@
 import { LevelCurse } from "isaac-typescript-definitions";
+/**
+ * Helper function to get the actual bit flag for modded curses.
+ *
+ * Will throw a runtime error if the provided curse does not exist.
+ *
+ * Use this over the `Isaac.GetCurseIdByName` method because that will return an integer instead of
+ * a bit flag.
+ */
+export declare function getCurseIDByName(name: string): LevelCurse;
 export declare function hasCurse(curse: LevelCurse): boolean;
 //# sourceMappingURL=curses.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"curses.d.ts","sourceRoot":"","sources":["../../src/functions/curses.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAI1D,wBAAgB,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAInD"}
+{"version":3,"file":"curses.d.ts","sourceRoot":"","sources":["../../src/functions/curses.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAI1D;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAWzD;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAInD"}

package/dist/functions/curses.lua

@@ -3,6 +3,19 @@ local ____cachedClasses = require("core.cachedClasses")
 local game = ____cachedClasses.game
 local ____flag = require("functions.flag")
 local hasFlag = ____flag.hasFlag
+--- Helper function to get the actual bit flag for modded curses.
+-- 
+-- Will throw a runtime error if the provided curse does not exist.
+-- 
+-- Use this over the `Isaac.GetCurseIdByName` method because that will return an integer instead of
+-- a bit flag.
+function ____exports.getCurseIDByName(self, name)
+    local curseID = Isaac.GetCurseIdByName(name)
+    if curseID == -1 then
+        error(("Failed to get the curse ID corresponding to the curse name of \"" .. tostring(curseID)) .. "\". Does this name match what you put in the \"content/curses.xml\" file?")
+    end
+    return 1 << curseID - 1
+end
 function ____exports.hasCurse(self, curse)
     local level = game:GetLevel()
     local curses = level:GetCurses()

package/dist/functions/trinkets.d.ts

@@ -26,6 +26,15 @@ export declare function getOpenTrinketSlot(player: EntityPlayer): int | undefine
  * trinket type was not valid.
  */
 export declare function getTrinketDescription(trinketType: TrinketType): string;
+/**
+ * Helper function to get the path to a trinket PNG file. Returns the path to the question mark
+ * sprite (i.e. from Curse of the Blind) if the provided trinket type was not valid.
+ *
+ * Note that this does not return the file name, but the full path to the trinket's PNG file. The
+ * function is named "GfxFilename" to correspond to the associated `ItemConfigItem.GfxFileName`
+ * field.
+ */
+export declare function getTrinketGfxFilename(trinketType: TrinketType): string;
 /**
  * Helper function to get the name of a trinket. Returns "Unknown" if the provided trinket type is
  * not valid.
@@ -51,6 +60,11 @@ export declare function hasOpenTrinketSlot(player: EntityPlayer): boolean;
 export declare function isGoldenTrinketType(trinketType: TrinketType): boolean;
 export declare function isModdedTrinketType(trinketType: TrinketType): boolean;
 export declare function isVanillaTrinketType(trinketType: TrinketType): boolean;
+/**
+ * Helper function to generate a new sprite based on a collectible. If the provided collectible type
+ * is invalid, a sprite with a Curse of the Blind question mark will be returned.
+ */
+export declare function newTrinketSprite(trinketType: TrinketType): Sprite;
 /**
  * Helper function to change the sprite of a trinket entity.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"trinkets.d.ts","sourceRoot":"","sources":["../../src/functions/trinkets.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,WAAW,EACZ,MAAM,8BAA8B,CAAC;AA6BtC;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,WAAW,GAAG,WAAW,CAE1E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,GAAG,GAAG,SAAS,CAkBxE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CActE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CAc/D;AAED,kFAAkF;AAClF,wBAAgB,sBAAsB,IAAI,WAAW,EAAE,CAEtD;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAOhE;AAED,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAErE;AAED,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAErE;AAED,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAEtE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,MAAM,GAAG,SAAS,GAC1B,IAAI,CAeN"}
+{"version":3,"file":"trinkets.d.ts","sourceRoot":"","sources":["../../src/functions/trinkets.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,WAAW,EACZ,MAAM,8BAA8B,CAAC;AA+BtC;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,WAAW,GAAG,WAAW,CAE1E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,GAAG,GAAG,SAAS,CAkBxE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CActE;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CAOtE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CAc/D;AAED,kFAAkF;AAClF,wBAAgB,sBAAsB,IAAI,WAAW,EAAE,CAEtD;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAOhE;AAED,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAErE;AAED,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAErE;AAED,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAEtE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CASjE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,MAAM,GAAG,SAAS,GAC1B,IAAI,CAeN"}

package/dist/functions/trinkets.lua

@@ -5,6 +5,8 @@ local TrinketSlot = ____isaac_2Dtypescript_2Ddefinitions.TrinketSlot
 local TrinketType = ____isaac_2Dtypescript_2Ddefinitions.TrinketType
 local ____cachedClasses = require("core.cachedClasses")
 local itemConfig = ____cachedClasses.itemConfig
+local ____constants = require("core.constants")
+local BLIND_ITEM_PNG_PATH = ____constants.BLIND_ITEM_PNG_PATH
 local ____constantsFirstLast = require("core.constantsFirstLast")
 local FIRST_TRINKET_TYPE = ____constantsFirstLast.FIRST_TRINKET_TYPE
 local LAST_VANILLA_TRINKET_TYPE = ____constantsFirstLast.LAST_VANILLA_TRINKET_TYPE
@@ -35,6 +37,7 @@ end
 -- 
 -- 1 << 15
 local GOLDEN_TRINKET_ADJUSTMENT = 32768
+local TRINKET_ANM2_PATH = "gfx/005.350_trinket.anm2"
 local TRINKET_SPRITE_LAYER = 0
 --- Helper function to get the corresponding golden trinket type from a normal trinket type.
 -- 
@@ -83,6 +86,19 @@ function ____exports.getTrinketDescription(self, trinketType)
     end
     return DEFAULT_TRINKET_DESCRIPTION
 end
+--- Helper function to get the path to a trinket PNG file. Returns the path to the question mark
+-- sprite (i.e. from Curse of the Blind) if the provided trinket type was not valid.
+-- 
+-- Note that this does not return the file name, but the full path to the trinket's PNG file. The
+-- function is named "GfxFilename" to correspond to the associated `ItemConfigItem.GfxFileName`
+-- field.
+function ____exports.getTrinketGfxFilename(self, trinketType)
+    local itemConfigItem = itemConfig:GetTrinket(trinketType)
+    if itemConfigItem == nil then
+        return BLIND_ITEM_PNG_PATH
+    end
+    return itemConfigItem.GfxFileName
+end
 --- Helper function to get the name of a trinket. Returns "Unknown" if the provided trinket type is
 -- not valid.
 -- 
@@ -125,6 +141,16 @@ end
 function ____exports.isModdedTrinketType(self, trinketType)
     return not ____exports.isVanillaTrinketType(nil, trinketType)
 end
+--- Helper function to generate a new sprite based on a collectible. If the provided collectible type
+-- is invalid, a sprite with a Curse of the Blind question mark will be returned.
+function ____exports.newTrinketSprite(self, trinketType)
+    local sprite = Sprite()
+    sprite:Load(TRINKET_ANM2_PATH, false)
+    local gfxFileName = ____exports.getTrinketGfxFilename(nil, trinketType)
+    sprite:ReplaceSpritesheet(TRINKET_SPRITE_LAYER, gfxFileName)
+    sprite:LoadGraphics()
+    return sprite
+end
 --- Helper function to change the sprite of a trinket entity.
 -- 
 -- For more information about removing the trinket sprite, see the documentation for the

package/dist/index.d.ts

@@ -2280,6 +2280,9 @@ export declare function getAliveNPCs(entityType?: EntityType, variant?: number,
  *
  * The set contains strings with the entity type and variant, separated by a period.
  *
+ * Note that this set does not include bosses that do not appear in Boss Rooms (e.g. Krampus, Uriel,
+ * and Gabriel.).
+ *
  * Also see the `getBossSet` and `getCombinedBossSet` functions.
  *
  * @param includeStoryBosses Optional. Whether to include "story" bosses like Mom and It Lives!
@@ -2592,8 +2595,12 @@ export declare function getCollectibleDevilCoinPrice(collectibleType: Collectibl
 export declare function getCollectibleDevilHeartPrice(collectibleType: CollectibleType, player: EntityPlayer): PickupPrice;
 
 /**
- * Helper function to get the path to a collectible's sprite. Returns the path to the question mark
+ * Helper function to get the path to a collectible PNG file. Returns the path to the question mark
  * sprite (i.e. from Curse of the Blind) if the provided collectible type was not valid.
+ *
+ * Note that this does not return the file name, but the full path to the collectible's PNG file.
+ * The function is named "GfxFilename" to correspond to the associated `ItemConfigItem.GfxFileName`
+ * field.
  */
 export declare function getCollectibleGfxFilename(collectibleType: CollectibleType): string;
 
@@ -2798,6 +2805,16 @@ export declare function getCombinedBossSet(stage: int): ReadonlySet<string> | un
  */
 export declare function getCrawlSpaces(crawlSpaceVariant?: CrawlSpaceVariant): GridEntity[];
 
+/**
+ * Helper function to get the actual bit flag for modded curses.
+ *
+ * Will throw a runtime error if the provided curse does not exist.
+ *
+ * Use this over the `Isaac.GetCurseIdByName` method because that will return an integer instead of
+ * a bit flag.
+ */
+export declare function getCurseIDByName(name: string): LevelCurse;
+
 /**
  * Helper function to get the custom grid entities in the current room. Returns an array of tuples
  * containing the raw decoration grid entity and the associated entity data.
@@ -4022,9 +4039,6 @@ export declare function getPlayerIndexVanilla(playerToFind: EntityPlayer): int |
  * Helper function to get all of the collectibles that the player has gotten so far on this run, in
  * order.
  *
- * Note that this does not include active collectibles that have since been dropped for other
- * collectibles.
- *
  * In the case of inventory initialization or the case where the player rerolls their build in the
  * middle of the run (e.g. with D4), the order of the inventory will not correspond to the order
  * that the items were actually given to the player. In this case, the inventory will be in the
@@ -4036,6 +4050,10 @@ export declare function getPlayerIndexVanilla(playerToFind: EntityPlayer): int |
  * would not be updated. In vanilla, this situation would never happen, but another mod might do
  * this for some reason. (With that said, the next time that a collectible is normally added or
  * removed, it would trigger a re-scan, and the previous changes would be picked up.)
+ *
+ * @param player The player to get the inventory for.
+ * @param includeActiveCollectibles Optional. If true, will include all active collectibles. Default
+ *                                 is true.
  */
 export declare function getPlayerInventory(player: EntityPlayer, includeActiveCollectibles?: boolean): CollectibleType[];
 
@@ -4045,6 +4063,14 @@ export declare function getPlayerInventory(player: EntityPlayer, includeActiveCo
  */
 export declare function getPlayerLastHeart(player: EntityPlayer): HealthType;
 
+/**
+ * Helper function to get the last passive collectible that the player picked up. In most cases,
+ * this will be the passive that is removed when the player would use Clicker.
+ *
+ * Returns undefined if the player does not have any passive collectibles.
+ */
+export declare function getPlayerLastPassiveCollectible(player: EntityPlayer): CollectibleType | undefined;
+
 /**
  * Returns the maximum heart containers that the provided player can have. Normally, this is 12, but
  * it can change depending on the character (e.g. Keeper) and other things (e.g. Mother's Kiss).
@@ -5016,6 +5042,16 @@ export declare function getTrinketArray(): readonly TrinketType[];
  */
 export declare function getTrinketDescription(trinketType: TrinketType): string;
 
+/**
+ * Helper function to get the path to a trinket PNG file. Returns the path to the question mark
+ * sprite (i.e. from Curse of the Blind) if the provided trinket type was not valid.
+ *
+ * Note that this does not return the file name, but the full path to the trinket's PNG file. The
+ * function is named "GfxFilename" to correspond to the associated `ItemConfigItem.GfxFileName`
+ * field.
+ */
+export declare function getTrinketGfxFilename(trinketType: TrinketType): string;
+
 /**
  * Helper function to get the name of a trinket. Returns "Unknown" if the provided trinket type is
  * not valid.
@@ -7548,7 +7584,7 @@ export declare enum ModCallbackCustom {
     POST_PLAYER_CHANGE_TYPE = 57,
     /**
      * Fires from the `POST_PEFFECT_UPDATE` callback when a player's collectible count is higher than
-     * what it was on the previous frame.
+     * what it was on the previous frame or when a new active collectible is acquired.
      *
      * When registering the callback, takes an optional second argument that will make the callback
      * only fire if the collectible matches the `CollectibleType` provided.
@@ -7563,7 +7599,7 @@ export declare enum ModCallbackCustom {
     POST_PLAYER_COLLECTIBLE_ADDED = 58,
     /**
      * Fires from the `POST_PEFFECT_UPDATE` callback when a player's collectible count is lower than
-     * what it was on the previous frame.
+     * what it was on the previous frame or when an active collectible is no longer present.
      *
      * When registering the callback, takes an optional second argument that will make the callback
      * only fire if the collectible matches the `CollectibleType` provided.
@@ -8119,6 +8155,12 @@ export declare const NEW_RUN_PLAYER_STARTING_POSITION: Vector;
  */
 export declare function newChargeBarSprites(maxCharges: int): ChargeBarSprites;
 
+/**
+ * Helper function to generate a new sprite based on a collectible. If the provided collectible type
+ * is invalid, a sprite with a Curse of the Blind question mark will be returned.
+ */
+export declare function newCollectibleSprite(collectibleType: CollectibleType): Sprite;
+
 export declare function newPickingUpItem(): PickingUpItem;
 
 /** Returns a `PlayerHealth` object with all zeros. */
@@ -8145,6 +8187,12 @@ export declare function newRNG(seed?: Seed): RNG;
  */
 export declare function newRoom(): int | undefined;
 
+/**
+ * Helper function to generate a new sprite based on a collectible. If the provided collectible type
+ * is invalid, a sprite with a Curse of the Blind question mark will be returned.
+ */
+export declare function newTrinketSprite(trinketType: TrinketType): Sprite;
+
 /**
  * Initializes a new TypeScriptToLua class in the situation where you do not know what kind of class
  * it is. This function requires that you provide an instantiated class of the same type, as it will

package/dist/sets/bossSets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bossSets.d.ts","sourceRoot":"","sources":["../../src/sets/bossSets.ts"],"names":[],"mappings":";AAibA,eAAO,MAAM,mCAAmC,EAAE,WAAW,CAC3D,GAAG,EACH,WAAW,CAAC,GAAG,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAarC,CAAC;AAEH,eAAO,MAAM,8BAA8B,EAAE,WAAW,CACtD,GAAG,EACH,WAAW,CAAC,MAAM,CAAC,CAanB,CAAC;AAEH,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,MAAM,CAQ7C,CAAC;AAiBH,eAAO,MAAM,qCAAqC,EAAE,WAAW,CAAC,MAAM,CACpC,CAAC"}
+{"version":3,"file":"bossSets.d.ts","sourceRoot":"","sources":["../../src/sets/bossSets.ts"],"names":[],"mappings":";AAibA,eAAO,MAAM,mCAAmC,EAAE,WAAW,CAC3D,GAAG,EACH,WAAW,CAAC,GAAG,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAarC,CAAC;AAEH,eAAO,MAAM,8BAA8B,EAAE,WAAW,CACtD,GAAG,EACH,WAAW,CAAC,MAAM,CAAC,CAanB,CAAC;AAEH,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,MAAM,CAQ7C,CAAC;AAEH,eAAO,MAAM,qCAAqC,qBACX,CAAC"}

package/dist/sets/bossSets.lua

@@ -7,6 +7,7 @@ local __TS__SparseArrayPush = ____lualib.__TS__SparseArrayPush
 local __TS__SparseArraySpread = ____lualib.__TS__SparseArraySpread
 local Map = ____lualib.Map
 local ____exports = {}
+local getAllBossesExcludingStoryBossesSet
 local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
 local BigHornVariant = ____isaac_2Dtypescript_2Ddefinitions.BigHornVariant
 local ChubVariant = ____isaac_2Dtypescript_2Ddefinitions.ChubVariant
@@ -43,6 +44,21 @@ local ____set = require("functions.set")
 local copySet = ____set.copySet
 local ____storyBossesSet = require("sets.storyBossesSet")
 local STORY_BOSSES_SET = ____storyBossesSet.STORY_BOSSES_SET
+function getAllBossesExcludingStoryBossesSet(self)
+    local allBossesExcludingStoryBossesSet = copySet(nil, ____exports.ALL_BOSSES_SET)
+    local allBosses = {__TS__Spread(____exports.ALL_BOSSES_SET:values())}
+    for ____, entityTypeVariantString in ipairs(allBosses) do
+        local tuple = parseEntityTypeVariantString(nil, entityTypeVariantString)
+        if tuple == nil then
+            error("Failed to parse a boss tuple when constructing the story boss set.")
+        end
+        local entityType, _variant = table.unpack(tuple)
+        if STORY_BOSSES_SET:has(entityType) then
+            allBossesExcludingStoryBossesSet:delete(entityTypeVariantString)
+        end
+    end
+    return allBossesExcludingStoryBossesSet
+end
 --- Contains just the bosses in Basement (not e.g. Burning Basement).
 local BASEMENT_BOSSES_SET = __TS__New(
     Set,
@@ -557,17 +573,5 @@ ____exports.ALL_BOSSES_SET = __TS__New(
     ____Set_13,
     {__TS__SparseArraySpread(____array_12)}
 )
-local allBossesExcludingStoryBossesSet = copySet(nil, ____exports.ALL_BOSSES_SET)
-local allBosses = {__TS__Spread(____exports.ALL_BOSSES_SET:values())}
-for ____, entityTypeVariantString in ipairs(allBosses) do
-    local tuple = parseEntityTypeVariantString(nil, entityTypeVariantString)
-    if tuple == nil then
-        error("Failed to parse a boss tuple when constructing the story boss set.")
-    end
-    local entityType, _variant = table.unpack(tuple)
-    if STORY_BOSSES_SET:has(entityType) then
-        allBossesExcludingStoryBossesSet:delete(entityTypeVariantString)
-    end
-end
-____exports.ALL_BOSSES_EXCLUDING_STORY_BOSSES_SET = allBossesExcludingStoryBossesSet
+____exports.ALL_BOSSES_EXCLUDING_STORY_BOSSES_SET = getAllBossesExcludingStoryBossesSet(nil)
 return ____exports

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacscript-common",
-  "version": "8.5.0",
+  "version": "8.8.0",
   "description": "Helper functions and features for IsaacScript mods.",
   "keywords": [
     "isaac",

package/src/enums/ModCallbackCustom.ts

@@ -959,7 +959,7 @@ export enum ModCallbackCustom {
 
   /**
    * Fires from the `POST_PEFFECT_UPDATE` callback when a player's collectible count is higher than
-   * what it was on the previous frame.
+   * what it was on the previous frame or when a new active collectible is acquired.
    *
    * When registering the callback, takes an optional second argument that will make the callback
    * only fire if the collectible matches the `CollectibleType` provided.
@@ -975,7 +975,7 @@ export enum ModCallbackCustom {
 
   /**
    * Fires from the `POST_PEFFECT_UPDATE` callback when a player's collectible count is lower than
-   * what it was on the previous frame.
+   * what it was on the previous frame or when an active collectible is no longer present.
    *
    * When registering the callback, takes an optional second argument that will make the callback
    * only fire if the collectible matches the `CollectibleType` provided.

package/src/features/playerInventory.ts

@@ -3,7 +3,11 @@ import { DefaultMap } from "../classes/DefaultMap";
 import { ModUpgraded } from "../classes/ModUpgraded";
 import { ModCallbackCustom } from "../enums/ModCallbackCustom";
 import { errorIfFeaturesNotInitialized } from "../featuresInitialized";
-import { arrayRemoveInPlace, copyArray } from "../functions/array";
+import {
+  arrayRemoveInPlace,
+  copyArray,
+  getLastElement,
+} from "../functions/array";
 import { isActiveCollectible } from "../functions/collectibles";
 import { getCollectibleArray } from "../functions/collectibleSet";
 import {
@@ -31,10 +35,16 @@ function newPlayerInventory(player: EntityPlayer) {
   const inventory: CollectibleType[] = [];
 
   for (const collectibleType of getCollectibleArray()) {
-    const numCollectibles = player.GetCollectibleNum(collectibleType, true);
-    repeat(numCollectibles, () => {
-      inventory.push(collectibleType);
-    });
+    // We have to use the `EntityPlayer.HasCollectible` method in addition to the
+    // `EntityPlayer.GetCollectibleNum` method in order to mitigate situations like Lilith's Incubus
+    // counting as a collectible. (The former method will return false for her innate Incubus, but
+    // the latter method will return 1.)
+    if (player.HasCollectible(collectibleType)) {
+      const numCollectibles = player.GetCollectibleNum(collectibleType, true);
+      repeat(numCollectibles, () => {
+        inventory.push(collectibleType);
+      });
+    }
   }
 
   return inventory;
@@ -68,6 +78,9 @@ function useItemD4(
   _rng: RNG,
   player: EntityPlayer,
 ): boolean | undefined {
+  // This function is also triggered when the player uses D100, D Infinity, a 1-pip dice room, or a
+  // 6-pip dice room. (Genesis should be automatically handled by the
+  // `POST_PLAYER_COLLECTIBLE_REMOVED` callback.)
   resetInventory(player);
 
   return undefined;
@@ -107,9 +120,6 @@ function postCollectibleRemoved(
  * Helper function to get all of the collectibles that the player has gotten so far on this run, in
  * order.
  *
- * Note that this does not include active collectibles that have since been dropped for other
- * collectibles.
- *
  * In the case of inventory initialization or the case where the player rerolls their build in the
  * middle of the run (e.g. with D4), the order of the inventory will not correspond to the order
  * that the items were actually given to the player. In this case, the inventory will be in the
@@ -121,6 +131,10 @@ function postCollectibleRemoved(
  * would not be updated. In vanilla, this situation would never happen, but another mod might do
  * this for some reason. (With that said, the next time that a collectible is normally added or
  * removed, it would trigger a re-scan, and the previous changes would be picked up.)
+ *
+ * @param player The player to get the inventory for.
+ * @param includeActiveCollectibles Optional. If true, will include all active collectibles. Default
+ *                                 is true.
  */
 export function getPlayerInventory(
   player: EntityPlayer,
@@ -139,3 +153,18 @@ export function getPlayerInventory(
     (collectibleType) => !isActiveCollectible(collectibleType),
   );
 }
+
+/**
+ * Helper function to get the last passive collectible that the player picked up. In most cases,
+ * this will be the passive that is removed when the player would use Clicker.
+ *
+ * Returns undefined if the player does not have any passive collectibles.
+ */
+export function getPlayerLastPassiveCollectible(
+  player: EntityPlayer,
+): CollectibleType | undefined {
+  errorIfFeaturesNotInitialized(FEATURE_NAME);
+
+  const inventory = getPlayerInventory(player, false);
+  return getLastElement(inventory);
+}

package/src/functions/bosses.ts

@@ -56,6 +56,9 @@ export function getAliveBosses(
  *
  * The set contains strings with the entity type and variant, separated by a period.
  *
+ * Note that this set does not include bosses that do not appear in Boss Rooms (e.g. Krampus, Uriel,
+ * and Gabriel.).
+ *
  * Also see the `getBossSet` and `getCombinedBossSet` functions.
  *
  * @param includeStoryBosses Optional. Whether to include "story" bosses like Mom and It Lives!

package/src/functions/collectibles.ts

@@ -31,6 +31,7 @@ import { getRoomListIndex } from "./roomData";
 import { clearSprite, spriteEquals } from "./sprites";
 import { irange } from "./utils";
 
+const COLLECTIBLE_ANM2_PATH = "gfx/005.100_collectible.anm2";
 const COLLECTIBLE_SPRITE_LAYER = 1;
 const COLLECTIBLE_SHADOW_LAYER = 4;
 
@@ -159,8 +160,12 @@ export function getCollectibleDevilHeartPrice(
 }
 
 /**
- * Helper function to get the path to a collectible's sprite. Returns the path to the question mark
+ * Helper function to get the path to a collectible PNG file. Returns the path to the question mark
  * sprite (i.e. from Curse of the Blind) if the provided collectible type was not valid.
+ *
+ * Note that this does not return the file name, but the full path to the collectible's PNG file.
+ * The function is named "GfxFilename" to correspond to the associated `ItemConfigItem.GfxFileName`
+ * field.
  */
 export function getCollectibleGfxFilename(
   collectibleType: CollectibleType,
@@ -469,6 +474,25 @@ export function isVanillaCollectibleType(
   return collectibleType <= LAST_VANILLA_COLLECTIBLE_TYPE;
 }
 
+/**
+ * Helper function to generate a new sprite based on a collectible. If the provided collectible type
+ * is invalid, a sprite with a Curse of the Blind question mark will be returned.
+ */
+export function newCollectibleSprite(collectibleType: CollectibleType): Sprite {
+  const sprite = Sprite();
+  sprite.Load(COLLECTIBLE_ANM2_PATH, false);
+
+  // We want to clear the pedestal layers so that the returned sprite only has the collectible
+  // image.
+  clearSprite(sprite);
+
+  const gfxFileName = getCollectibleGfxFilename(collectibleType);
+  sprite.ReplaceSpritesheet(COLLECTIBLE_SPRITE_LAYER, gfxFileName);
+  sprite.LoadGraphics();
+
+  return sprite;
+}
+
 /**
  * Helper function to put a message in the log.txt file to let the Rebirth Item Tracker know that it
  * should remove an item.

package/src/functions/curses.ts

@@ -2,6 +2,27 @@ import { LevelCurse } from "isaac-typescript-definitions";
 import { game } from "../core/cachedClasses";
 import { hasFlag } from "./flag";
 
+/**
+ * Helper function to get the actual bit flag for modded curses.
+ *
+ * Will throw a runtime error if the provided curse does not exist.
+ *
+ * Use this over the `Isaac.GetCurseIdByName` method because that will return an integer instead of
+ * a bit flag.
+ */
+export function getCurseIDByName(name: string): LevelCurse {
+  const curseID = Isaac.GetCurseIdByName(name);
+  if (curseID === -1) {
+    error(
+      `Failed to get the curse ID corresponding to the curse name of "${curseID}". Does this name match what you put in the "content/curses.xml" file?`,
+    );
+  }
+
+  // For example, the final vanilla curse is "Curse of the Giant", which has an ID of 8. This
+  // corresponds to `LevelCurse.GIANT`, which has a value of `1 << 7`.
+  return (1 << (curseID - 1)) as LevelCurse;
+}
+
 export function hasCurse(curse: LevelCurse): boolean {
   const level = game.GetLevel();
   const curses = level.GetCurses();

package/src/functions/trinkets.ts

@@ -4,6 +4,7 @@ import {
   TrinketType,
 } from "isaac-typescript-definitions";
 import { itemConfig } from "../core/cachedClasses";
+import { BLIND_ITEM_PNG_PATH } from "../core/constants";
 import {
   FIRST_TRINKET_TYPE,
   LAST_VANILLA_TRINKET_TYPE,
@@ -29,6 +30,7 @@ import { irange } from "./utils";
  */
 const GOLDEN_TRINKET_ADJUSTMENT = 32768;
 
+const TRINKET_ANM2_PATH = "gfx/005.350_trinket.anm2";
 const TRINKET_SPRITE_LAYER = 0;
 
 /**
@@ -95,6 +97,23 @@ export function getTrinketDescription(trinketType: TrinketType): string {
   return DEFAULT_TRINKET_DESCRIPTION;
 }
 
+/**
+ * Helper function to get the path to a trinket PNG file. Returns the path to the question mark
+ * sprite (i.e. from Curse of the Blind) if the provided trinket type was not valid.
+ *
+ * Note that this does not return the file name, but the full path to the trinket's PNG file. The
+ * function is named "GfxFilename" to correspond to the associated `ItemConfigItem.GfxFileName`
+ * field.
+ */
+export function getTrinketGfxFilename(trinketType: TrinketType): string {
+  const itemConfigItem = itemConfig.GetTrinket(trinketType);
+  if (itemConfigItem === undefined) {
+    return BLIND_ITEM_PNG_PATH;
+  }
+
+  return itemConfigItem.GfxFileName;
+}
+
 /**
  * Helper function to get the name of a trinket. Returns "Unknown" if the provided trinket type is
  * not valid.
@@ -155,6 +174,21 @@ export function isVanillaTrinketType(trinketType: TrinketType): boolean {
   return trinketType <= LAST_VANILLA_TRINKET_TYPE;
 }
 
+/**
+ * Helper function to generate a new sprite based on a collectible. If the provided collectible type
+ * is invalid, a sprite with a Curse of the Blind question mark will be returned.
+ */
+export function newTrinketSprite(trinketType: TrinketType): Sprite {
+  const sprite = Sprite();
+  sprite.Load(TRINKET_ANM2_PATH, false);
+
+  const gfxFileName = getTrinketGfxFilename(trinketType);
+  sprite.ReplaceSpritesheet(TRINKET_SPRITE_LAYER, gfxFileName);
+  sprite.LoadGraphics();
+
+  return sprite;
+}
+
 /**
  * Helper function to change the sprite of a trinket entity.
  *

package/src/sets/bossSets.ts

@@ -475,20 +475,29 @@ export const ALL_BOSSES_SET: ReadonlySet<string> = new Set([
   ...ALL_STAGE_11_BOSSES_SET.values(),
 ]);
 
-// Since story bosses are stored by entity type, we copy the existing bosses and filter them (to
-// avoid having to hard-code story boss variants).
-const allBossesExcludingStoryBossesSet = copySet(ALL_BOSSES_SET);
-const allBosses = [...ALL_BOSSES_SET.values()];
-for (const entityTypeVariantString of allBosses) {
-  const tuple = parseEntityTypeVariantString(entityTypeVariantString);
-  if (tuple === undefined) {
-    error("Failed to parse a boss tuple when constructing the story boss set.");
+export const ALL_BOSSES_EXCLUDING_STORY_BOSSES_SET =
+  getAllBossesExcludingStoryBossesSet();
+
+/**
+ * Since story bosses are stored by entity type, we copy the existing bosses and filter them (to
+ * avoid having to hard-code story boss variants).
+ */
+function getAllBossesExcludingStoryBossesSet(): ReadonlySet<string> {
+  const allBossesExcludingStoryBossesSet = copySet(ALL_BOSSES_SET);
+  const allBosses = [...ALL_BOSSES_SET.values()];
+  for (const entityTypeVariantString of allBosses) {
+    const tuple = parseEntityTypeVariantString(entityTypeVariantString);
+    if (tuple === undefined) {
+      error(
+        "Failed to parse a boss tuple when constructing the story boss set.",
+      );
+    }
+
+    const [entityType, _variant] = tuple;
+    if (STORY_BOSSES_SET.has(entityType)) {
+      allBossesExcludingStoryBossesSet.delete(entityTypeVariantString);
+    }
   }
 
-  const [entityType, _variant] = tuple;
-  if (STORY_BOSSES_SET.has(entityType)) {
-    allBossesExcludingStoryBossesSet.delete(entityTypeVariantString);
-  }
+  return allBossesExcludingStoryBossesSet;
 }
-export const ALL_BOSSES_EXCLUDING_STORY_BOSSES_SET: ReadonlySet<string> =
-  allBossesExcludingStoryBossesSet;