isaacscript-common 6.16.2 → 6.18.0

package/src/functions/rockAlt.ts

@@ -5,7 +5,6 @@ import {
   EffectVariant,
   EntityType,
   HeartSubType,
-  ItemPoolType,
   PillColor,
   RoomType,
   TrinketType,
@@ -15,7 +14,6 @@ import { DISTANCE_OF_GRID_TILE } from "../constants";
 import { RockAltType } from "../enums/RockAltType";
 import { BACKDROP_TYPE_TO_ROCK_ALT_TYPE } from "../objects/backdropTypeToRockAltType";
 import { spawnEffectWithSeed, spawnNPCWithSeed } from "./entitiesSpecific";
-import { isCollectibleInItemPool } from "./itemPool";
 import {
   spawnCardWithSeed,
   spawnCoinWithSeed,
@@ -31,13 +29,13 @@ import { repeat } from "./utils";
 import { getRandomVector } from "./vector";
 
 const ROCK_ALT_CHANCES = {
-  Nothing: 0.68,
-  BasicDrop: 0.0967,
+  NOTHING: 0.68,
+  BASIC_DROP: 0.0967,
 
   /** Also used for e.g. black hearts from skulls. */
-  Trinket: 0.025,
+  TRINKET: 0.025,
 
-  Collectible: 0.005,
+  COLLECTIBLE: 0.005,
 } as const;
 
 const POLYP_PROJECTILE_SPEED = 10;
@@ -71,10 +69,10 @@ export function getRockAltType(): RockAltType {
  * Most of the time, this function will do nothing, similar to how most of the time, when an
  * individual urn is destroyed, nothing will spawn.
  *
- * Note that in vanilla, trinkets will not spawn if they have already been removed from the trinket
- * pool. This function cannot replicate that behavior because there is no way to check to see if a
- * trinket is still in the pool. Thus, it will always have a chance to spawn the respective trinket
- * (e.g. Swallowed Penny from urns).
+ * Note that in vanilla, collectibles and trinkets will not spawn if they have already been removed
+ * from the respective pool. This function cannot replicate that behavior because there is no way to
+ * check to see if a collectible or trinket is still in the pool. Thus, it will always have a chance
+ * to spawn the respective collectible/trinket (e.g. Swallowed Penny from urns).
  *
  * The logic in this function is based on the rewards listed on the wiki:
  * https://bindingofisaacrebirth.fandom.com/wiki/Rocks
@@ -126,12 +124,12 @@ function spawnRockAltRewardUrn(position: Vector, rng: RNG): boolean {
   const chance = getRandom(rng);
   let totalChance = 0;
 
-  totalChance += ROCK_ALT_CHANCES.Nothing;
+  totalChance += ROCK_ALT_CHANCES.NOTHING;
   if (chance < totalChance) {
     return false;
   }
 
-  totalChance += ROCK_ALT_CHANCES.BasicDrop;
+  totalChance += ROCK_ALT_CHANCES.BASIC_DROP;
   if (chance < totalChance) {
     const numCoinsChance = getRandom(rng);
     const numCoins = numCoinsChance < 0.5 ? 1 : 2;
@@ -144,24 +142,16 @@ function spawnRockAltRewardUrn(position: Vector, rng: RNG): boolean {
     return true;
   }
 
-  totalChance += ROCK_ALT_CHANCES.Trinket;
+  totalChance += ROCK_ALT_CHANCES.TRINKET;
   if (chance < totalChance) {
     spawnTrinketWithSeed(TrinketType.SWALLOWED_PENNY, position, rng);
     return true;
   }
 
-  totalChance += ROCK_ALT_CHANCES.Collectible;
+  totalChance += ROCK_ALT_CHANCES.COLLECTIBLE;
   if (chance < totalChance) {
-    const stillInPools = isCollectibleInItemPool(
-      CollectibleType.QUARTER,
-      ItemPoolType.DEVIL,
-    );
-    if (stillInPools) {
-      spawnCollectible(CollectibleType.QUARTER, position, rng);
-      return true;
-    }
-
-    return false;
+    spawnCollectible(CollectibleType.QUARTER, position, rng);
+    return true;
   }
 
   // Since the detrimental effect is the final option, we don't need to check the chance.
@@ -184,68 +174,40 @@ function spawnRockAltRewardMushroom(position: Vector, rng: RNG): boolean {
   const chance = getRandom(rng);
   let totalChance = 0;
 
-  totalChance += ROCK_ALT_CHANCES.Nothing;
+  totalChance += ROCK_ALT_CHANCES.NOTHING;
   if (chance < totalChance) {
     return false;
   }
 
-  totalChance += ROCK_ALT_CHANCES.BasicDrop;
+  totalChance += ROCK_ALT_CHANCES.BASIC_DROP;
   if (chance < totalChance) {
     spawnPillWithSeed(PillColor.NULL, position, rng);
     return true;
   }
 
-  totalChance += ROCK_ALT_CHANCES.Trinket;
+  totalChance += ROCK_ALT_CHANCES.TRINKET;
   if (chance < totalChance) {
     spawnTrinketWithSeed(TrinketType.LIBERTY_CAP, position, rng);
     return true;
   }
 
-  totalChance += ROCK_ALT_CHANCES.Collectible;
+  totalChance += ROCK_ALT_CHANCES.COLLECTIBLE;
   if (chance < totalChance) {
     if (roomType === RoomType.SECRET) {
       const wavyCapChance = getRandom(rng);
       if (wavyCapChance < 0.0272) {
-        const stillInPools = isCollectibleInItemPool(
-          CollectibleType.WAVY_CAP,
-          ItemPoolType.SECRET,
-        );
-        if (stillInPools) {
-          spawnCollectible(CollectibleType.WAVY_CAP, position, rng);
-          return true;
-        }
+        spawnCollectible(CollectibleType.WAVY_CAP, position, rng);
+        return true;
       }
     }
 
-    const magicMushroomStillInPools = isCollectibleInItemPool(
-      CollectibleType.MAGIC_MUSHROOM,
-      ItemPoolType.TREASURE,
-    );
-    const miniMushStillInPools = isCollectibleInItemPool(
-      CollectibleType.MINI_MUSH,
-      ItemPoolType.TREASURE,
-    );
-    if (magicMushroomStillInPools && miniMushStillInPools) {
-      const collectibleChance = getRandom(rng);
-      const collectibleType =
-        collectibleChance < 0.5
-          ? CollectibleType.MAGIC_MUSHROOM // 12
-          : CollectibleType.MINI_MUSH; // 71
-      spawnCollectible(collectibleType, position, rng);
-      return true;
-    }
-
-    if (magicMushroomStillInPools) {
-      spawnCollectible(CollectibleType.MINI_MUSH, position, rng);
-      return true;
-    }
-
-    if (miniMushStillInPools) {
-      spawnCollectible(CollectibleType.MAGIC_MUSHROOM, position, rng);
-      return true;
-    }
-
-    return false;
+    const collectibleChance = getRandom(rng);
+    const collectibleType =
+      collectibleChance < 0.5
+        ? CollectibleType.MAGIC_MUSHROOM // 12
+        : CollectibleType.MINI_MUSH; // 71
+    spawnCollectible(collectibleType, position, rng);
+    return true;
   }
 
   // Since the detrimental effect is the final option, we don't need to check the chance.
@@ -257,54 +219,32 @@ function spawnRockAltRewardSkull(position: Vector, rng: RNG): boolean {
   const chance = getRandom(rng);
   let totalChance = 0;
 
-  totalChance += ROCK_ALT_CHANCES.Nothing;
+  totalChance += ROCK_ALT_CHANCES.NOTHING;
   if (chance < totalChance) {
     return false;
   }
 
-  totalChance += ROCK_ALT_CHANCES.BasicDrop;
+  totalChance += ROCK_ALT_CHANCES.BASIC_DROP;
   if (chance < totalChance) {
     spawnCardWithSeed(Card.NULL, position, rng);
     return true;
   }
 
-  totalChance += ROCK_ALT_CHANCES.Trinket;
+  totalChance += ROCK_ALT_CHANCES.TRINKET;
   if (chance < totalChance) {
     spawnHeartWithSeed(HeartSubType.BLACK, position, rng);
     return true;
   }
 
-  totalChance += ROCK_ALT_CHANCES.Collectible;
+  totalChance += ROCK_ALT_CHANCES.COLLECTIBLE;
   if (chance < totalChance) {
-    const ghostBabyStillInPools = isCollectibleInItemPool(
-      CollectibleType.GHOST_BABY,
-      ItemPoolType.TREASURE,
-    );
-    const dryBabyStillInPools = isCollectibleInItemPool(
-      CollectibleType.DRY_BABY,
-      ItemPoolType.TREASURE,
-    );
-    if (ghostBabyStillInPools && dryBabyStillInPools) {
-      const collectibleChance = getRandom(rng);
-      const collectibleType =
-        collectibleChance < 0.5
-          ? CollectibleType.GHOST_BABY // 163
-          : CollectibleType.DRY_BABY; // 265
-      spawnCollectible(collectibleType, position, rng);
-      return true;
-    }
-
-    if (ghostBabyStillInPools) {
-      spawnCollectible(CollectibleType.DRY_BABY, position, rng);
-      return true;
-    }
-
-    if (dryBabyStillInPools) {
-      spawnCollectible(CollectibleType.GHOST_BABY, position, rng);
-      return true;
-    }
-
-    return false;
+    const collectibleChance = getRandom(rng);
+    const collectibleType =
+      collectibleChance < 0.5
+        ? CollectibleType.GHOST_BABY // 163
+        : CollectibleType.DRY_BABY; // 265
+    spawnCollectible(collectibleType, position, rng);
+    return true;
   }
 
   // Since the detrimental effect is the final option, we don't need to check the chance.
@@ -316,54 +256,32 @@ function spawnRockAltRewardPolyp(position: Vector, rng: RNG): boolean {
   const chance = getRandom(rng);
   let totalChance = 0;
 
-  totalChance += ROCK_ALT_CHANCES.Nothing;
+  totalChance += ROCK_ALT_CHANCES.NOTHING;
   if (chance < totalChance) {
     return false;
   }
 
-  totalChance += ROCK_ALT_CHANCES.BasicDrop;
+  totalChance += ROCK_ALT_CHANCES.BASIC_DROP;
   if (chance < totalChance) {
     spawnHeartWithSeed(HeartSubType.NULL, position, rng);
     return true;
   }
 
-  totalChance += ROCK_ALT_CHANCES.Trinket;
+  totalChance += ROCK_ALT_CHANCES.TRINKET;
   if (chance < totalChance) {
     spawnTrinketWithSeed(TrinketType.UMBILICAL_CORD, position, rng);
     return true;
   }
 
-  totalChance += ROCK_ALT_CHANCES.Collectible;
+  totalChance += ROCK_ALT_CHANCES.COLLECTIBLE;
   if (chance < totalChance) {
-    const placentaStillInPools = isCollectibleInItemPool(
-      CollectibleType.PLACENTA,
-      ItemPoolType.BOSS,
-    );
-    const bloodClotStillInPools = isCollectibleInItemPool(
-      CollectibleType.BLOOD_CLOT,
-      ItemPoolType.BOSS,
-    );
-    if (bloodClotStillInPools && placentaStillInPools) {
-      const collectibleChance = getRandom(rng);
-      const collectibleType =
-        collectibleChance < 0.5
-          ? CollectibleType.PLACENTA // 218
-          : CollectibleType.BLOOD_CLOT; // 254
-      spawnCollectible(collectibleType, position, rng);
-      return true;
-    }
-
-    if (bloodClotStillInPools) {
-      spawnCollectible(CollectibleType.MINI_MUSH, position, rng);
-      return true;
-    }
-
-    if (placentaStillInPools) {
-      spawnCollectible(CollectibleType.MAGIC_MUSHROOM, position, rng);
-      return true;
-    }
-
-    return false;
+    const collectibleChance = getRandom(rng);
+    const collectibleType =
+      collectibleChance < 0.5
+        ? CollectibleType.PLACENTA // 218
+        : CollectibleType.BLOOD_CLOT; // 254
+    spawnCollectible(collectibleType, position, rng);
+    return true;
   }
 
   // Since the detrimental effect is the final option, we don't need to check the chance.
@@ -386,7 +304,7 @@ function spawnRockAltRewardBucket(
   const chance = getRandom(rng);
   let totalChance = 0;
 
-  totalChance += ROCK_ALT_CHANCES.Nothing;
+  totalChance += ROCK_ALT_CHANCES.NOTHING;
   if (chance < totalChance) {
     return false;
   }

package/src/functions/saveFile.ts

@@ -1,6 +1,28 @@
-import { CollectibleType, ItemPoolType } from "isaac-typescript-definitions";
-import { isCollectibleInItemPool } from "./itemPool";
-import { anyPlayerHasCollectible } from "./players";
+import {
+  CollectibleType,
+  ItemConfigTag,
+  ItemPoolType,
+  PlayerType,
+  TrinketType,
+} from "isaac-typescript-definitions";
+import { game } from "../cachedClasses";
+import { PlayerIndex } from "../types/PlayerIndex";
+import { getCollectibleSet } from "./collectibleSet";
+import { collectibleHasTag } from "./collectibleTag";
+import { mapGetPlayer, mapSetPlayer } from "./playerDataStructures";
+import { getPlayers } from "./playerIndex";
+import { anyPlayerHasCollectible, getPlayersOfType } from "./players";
+import { repeat } from "./utils";
+
+const COLLECTIBLES_THAT_AFFECT_ITEM_POOLS: readonly CollectibleType[] = [
+  CollectibleType.CHAOS, // 402
+  CollectibleType.SACRED_ORB, // 691
+  CollectibleType.TMTRAINER, // 721
+];
+
+const TRINKETS_THAT_AFFECT_ITEM_POOLS: readonly TrinketType[] = [
+  TrinketType.NO,
+];
 
 /**
  * Helper function to see if the given collectible is unlocked on the current save file. This
@@ -15,6 +37,11 @@ import { anyPlayerHasCollectible } from "./players";
  * - If the collectible is non-offensive, any Tainted Losts will be temporarily changed to Isaac and
  *   then changed back. (This is because Tainted Lost is not able to retrieve non-offensive
  *   collectibles from item pools).
+ *
+ * Under the hood, this function works by using the `ItemPool.AddRoomBlacklist` method to blacklist
+ * every collectible except for the one provided. Unfortunately, this is not a general-purpose
+ * "isCollectibleInItemPool" algorithm, because when a pool is depleted, it will automatically pull
+ * items from the Treasure Room pool, and there is no way to distinguish when this happens.
  */
 export function isCollectibleUnlocked(
   collectibleType: CollectibleType,
@@ -24,5 +51,120 @@ export function isCollectibleUnlocked(
     return true;
   }
 
-  return isCollectibleInItemPool(collectibleType, itemPoolType);
+  // On Tainted Lost, it is impossible to retrieve non-offensive collectibles from pools, so we
+  // temporarily change the character to Isaac.
+  const taintedLosts = getPlayersOfType(PlayerType.THE_LOST_B);
+  const isOffensive = collectibleHasTag(
+    collectibleType,
+    ItemConfigTag.OFFENSIVE,
+  );
+  let changedPlayerTypes = false;
+  if (!isOffensive) {
+    changedPlayerTypes = true;
+    for (const player of taintedLosts) {
+      player.ChangePlayerType(PlayerType.ISAAC);
+    }
+  }
+
+  const [removedItemsMap, removedTrinketsMap] =
+    removeItemsAndTrinketsThatAffectItemPools();
+
+  // Blacklist every collectible in the game except for the provided collectible.
+  const itemPool = game.GetItemPool();
+  const collectibleSet = getCollectibleSet();
+  for (const collectibleTypeInSet of collectibleSet.values()) {
+    if (collectibleTypeInSet !== collectibleType) {
+      itemPool.AddRoomBlacklist(collectibleTypeInSet);
+    }
+  }
+
+  // Get a collectible from the pool and see if it is the intended collectible. (We can use any
+  // arbitrary value as the seed since it should not influence the result.)
+  const seed = 1 as Seed;
+  const retrievedCollectibleType = itemPool.GetCollectible(
+    itemPoolType,
+    false,
+    seed,
+  );
+
+  const collectibleUnlocked = retrievedCollectibleType === collectibleType;
+
+  // Reset the blacklist
+  itemPool.ResetRoomBlacklist();
+
+  restoreItemsAndTrinketsThatAffectItemPools(
+    removedItemsMap,
+    removedTrinketsMap,
+  );
+
+  // Change any players back to Tainted Lost, if necessary.
+  if (changedPlayerTypes) {
+    for (const player of taintedLosts) {
+      player.ChangePlayerType(PlayerType.THE_LOST_B);
+    }
+  }
+
+  return collectibleUnlocked;
+}
+
+/**
+ * Before checking the item pools, remove any collectibles or trinkets that would affect the
+ * retrieved collectible types.
+ */
+function removeItemsAndTrinketsThatAffectItemPools(): [
+  removedItemsMap: Map<PlayerIndex, CollectibleType[]>,
+  removedTrinketsMap: Map<PlayerIndex, TrinketType[]>,
+] {
+  const removedItemsMap = new Map<PlayerIndex, CollectibleType[]>();
+  const removedTrinketsMap = new Map<PlayerIndex, TrinketType[]>();
+  for (const player of getPlayers()) {
+    const removedItems: CollectibleType[] = [];
+    for (const itemToRemove of COLLECTIBLES_THAT_AFFECT_ITEM_POOLS) {
+      if (player.HasCollectible(itemToRemove)) {
+        const numCollectibles = player.GetCollectibleNum(itemToRemove);
+        repeat(numCollectibles, () => {
+          player.RemoveCollectible(itemToRemove);
+          removedItems.push(itemToRemove);
+        });
+      }
+    }
+
+    mapSetPlayer(removedItemsMap, player, removedItems);
+
+    const removedTrinkets: TrinketType[] = [];
+    for (const trinketToRemove of TRINKETS_THAT_AFFECT_ITEM_POOLS) {
+      if (player.HasTrinket(trinketToRemove)) {
+        const numTrinkets = player.GetTrinketMultiplier(trinketToRemove);
+        repeat(numTrinkets, () => {
+          player.TryRemoveTrinket(trinketToRemove);
+          removedTrinkets.push(trinketToRemove);
+        });
+      }
+    }
+
+    mapSetPlayer(removedTrinketsMap, player, removedTrinkets);
+  }
+
+  return [removedItemsMap, removedTrinketsMap];
+}
+
+function restoreItemsAndTrinketsThatAffectItemPools(
+  removedItemsMap: Map<PlayerIndex, CollectibleType[]>,
+  removedTrinketsMap: Map<PlayerIndex, TrinketType[]>,
+) {
+  for (const player of getPlayers()) {
+    const removedItems = mapGetPlayer(removedItemsMap, player);
+    if (removedItems !== undefined) {
+      for (const collectibleType of removedItems) {
+        player.AddCollectible(collectibleType, 0, false); // Prevent Chaos from spawning pickups
+      }
+    }
+
+    const removedTrinkets = mapGetPlayer(removedTrinketsMap, player);
+    if (removedTrinkets !== undefined) {
+      for (const trinketType of removedTrinkets) {
+        player.AddTrinket(trinketType, false);
+      }
+    }
+  }
 }

package/src/index.ts

@@ -23,7 +23,7 @@ export {
 export { registerCharacterStats } from "./features/characterStats";
 export { getCollectibleItemPoolType } from "./features/collectibleItemPoolType";
 export {
-  removeCustomGrid,
+  removeCustomGridEntity as removeCustomGrid,
   spawnCustomGridEntity as spawnCustomGrid,
 } from "./features/customGridEntity";
 export * from "./features/customStage/exports";
@@ -117,7 +117,6 @@ export * from "./functions/gridEntities";
 export * from "./functions/gridEntitiesSpecific";
 export * from "./functions/input";
 export * from "./functions/isaacAPIClass";
-export * from "./functions/itemPool";
 export * from "./functions/jsonHelpers";
 export * from "./functions/jsonRoom";
 export * from "./functions/kColor";

package/src/interfaces/{CustomGridEntityData.ts → GridEntityCustomData.ts}

@@ -3,7 +3,7 @@ import {
   GridEntityType,
 } from "isaac-typescript-definitions";
 
-export interface CustomGridEntityData {
+export interface GridEntityCustomData {
   /**
    * This is not a real `GridEntityType`; rather it is an arbitrary integer selected by end-user
    * mods.

package/src/interfaces/PlayerHealth.ts

@@ -5,12 +5,23 @@ export interface PlayerHealth {
   maxHearts: int;
   hearts: int;
   eternalHearts: int;
+
+  /** For soul hearts to apply, they also have to be specified in the `soulHeartTypes` array. */
   soulHearts: int;
+
+  /** For bone hearts to apply, they also have to be specified in the `soulHeartTypes` array. */
   boneHearts: int;
+
   goldenHearts: int;
   rottenHearts: int;
   brokenHearts: int;
   soulCharges: int;
   bloodCharges: int;
-  soulHeartTypes: HeartSubType[];
+
+  soulHeartTypes: SoulHeartType[];
 }
+
+export type SoulHeartType =
+  | HeartSubType.SOUL // 3
+  | HeartSubType.BLACK // 6
+  | HeartSubType.BONE; // 11

package/src/interfaces/RoomDescription.ts

@@ -16,4 +16,5 @@ export interface RoomDescription {
   roomName: string;
   roomGridIndex: int;
   roomListIndex: int;
+  roomVisitedCount: int;
 }

package/dist/functions/itemPool.d.ts

@@ -1,10 +0,0 @@
-import { CollectibleType, ItemPoolType } from "isaac-typescript-definitions";
-/**
- * Helper function to see if the given collectible is still present in the given item pool.
- *
- * If the collectible is non-offensive, any Tainted Losts will be temporarily changed to Isaac and
- * then changed back. (This is because Tainted Lost is not able to retrieve non-offensive
- * collectibles from item pools).
- */
-export declare function isCollectibleInItemPool(collectibleType: CollectibleType, itemPoolType: ItemPoolType): boolean;
-//# sourceMappingURL=itemPool.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"itemPool.d.ts","sourceRoot":"","sources":["../../src/functions/itemPool.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EAEf,YAAY,EAGb,MAAM,8BAA8B,CAAC;AAoBtC;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,eAAe,EAAE,eAAe,EAChC,YAAY,EAAE,YAAY,GACzB,OAAO,CAsDT"}

package/dist/functions/itemPool.lua

@@ -1,116 +0,0 @@
-local ____lualib = require("lualib_bundle")
-local Map = ____lualib.Map
-local __TS__Iterator = ____lualib.__TS__Iterator
-local __TS__New = ____lualib.__TS__New
-local ____exports = {}
-local removeItemsAndTrinketsThatAffectItemPools, restoreItemsAndTrinketsThatAffectItemPools, COLLECTIBLES_THAT_AFFECT_ITEM_POOLS, TRINKETS_THAT_AFFECT_ITEM_POOLS
-local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
-local CollectibleType = ____isaac_2Dtypescript_2Ddefinitions.CollectibleType
-local ItemConfigTag = ____isaac_2Dtypescript_2Ddefinitions.ItemConfigTag
-local PlayerType = ____isaac_2Dtypescript_2Ddefinitions.PlayerType
-local TrinketType = ____isaac_2Dtypescript_2Ddefinitions.TrinketType
-local ____cachedClasses = require("cachedClasses")
-local game = ____cachedClasses.game
-local ____collectibleSet = require("functions.collectibleSet")
-local getCollectibleSet = ____collectibleSet.getCollectibleSet
-local ____collectibleTag = require("functions.collectibleTag")
-local collectibleHasTag = ____collectibleTag.collectibleHasTag
-local ____playerDataStructures = require("functions.playerDataStructures")
-local mapGetPlayer = ____playerDataStructures.mapGetPlayer
-local mapSetPlayer = ____playerDataStructures.mapSetPlayer
-local ____playerIndex = require("functions.playerIndex")
-local getPlayers = ____playerIndex.getPlayers
-local ____players = require("functions.players")
-local getPlayersOfType = ____players.getPlayersOfType
-local ____utils = require("functions.utils")
-local ____repeat = ____utils["repeat"]
-function removeItemsAndTrinketsThatAffectItemPools(self)
-    local removedItemsMap = __TS__New(Map)
-    local removedTrinketsMap = __TS__New(Map)
-    for ____, player in ipairs(getPlayers(nil)) do
-        local removedItems = {}
-        for ____, itemToRemove in ipairs(COLLECTIBLES_THAT_AFFECT_ITEM_POOLS) do
-            if player:HasCollectible(itemToRemove) then
-                local numCollectibles = player:GetCollectibleNum(itemToRemove)
-                ____repeat(
-                    nil,
-                    numCollectibles,
-                    function()
-                        player:RemoveCollectible(itemToRemove)
-                        removedItems[#removedItems + 1] = itemToRemove
-                    end
-                )
-            end
-        end
-        mapSetPlayer(nil, removedItemsMap, player, removedItems)
-        local removedTrinkets = {}
-        for ____, trinketToRemove in ipairs(TRINKETS_THAT_AFFECT_ITEM_POOLS) do
-            if player:HasTrinket(trinketToRemove) then
-                local numTrinkets = player:GetTrinketMultiplier(trinketToRemove)
-                ____repeat(
-                    nil,
-                    numTrinkets,
-                    function()
-                        player:TryRemoveTrinket(trinketToRemove)
-                        removedTrinkets[#removedTrinkets + 1] = trinketToRemove
-                    end
-                )
-            end
-        end
-        mapSetPlayer(nil, removedTrinketsMap, player, removedTrinkets)
-    end
-    return {removedItemsMap, removedTrinketsMap}
-end
-function restoreItemsAndTrinketsThatAffectItemPools(self, removedItemsMap, removedTrinketsMap)
-    for ____, player in ipairs(getPlayers(nil)) do
-        local removedItems = mapGetPlayer(nil, removedItemsMap, player)
-        if removedItems ~= nil then
-            for ____, collectibleType in ipairs(removedItems) do
-                player:AddCollectible(collectibleType, 0, false)
-            end
-        end
-        local removedTrinkets = mapGetPlayer(nil, removedTrinketsMap, player)
-        if removedTrinkets ~= nil then
-            for ____, trinketType in ipairs(removedTrinkets) do
-                player:AddTrinket(trinketType, false)
-            end
-        end
-    end
-end
-COLLECTIBLES_THAT_AFFECT_ITEM_POOLS = {CollectibleType.CHAOS, CollectibleType.SACRED_ORB, CollectibleType.TMTRAINER}
-TRINKETS_THAT_AFFECT_ITEM_POOLS = {TrinketType.NO}
---- Helper function to see if the given collectible is still present in the given item pool.
--- 
--- If the collectible is non-offensive, any Tainted Losts will be temporarily changed to Isaac and
--- then changed back. (This is because Tainted Lost is not able to retrieve non-offensive
--- collectibles from item pools).
-function ____exports.isCollectibleInItemPool(self, collectibleType, itemPoolType)
-    local taintedLosts = getPlayersOfType(nil, PlayerType.THE_LOST_B)
-    local isOffensive = collectibleHasTag(nil, collectibleType, ItemConfigTag.OFFENSIVE)
-    local changedPlayerTypes = false
-    if not isOffensive then
-        changedPlayerTypes = true
-        for ____, player in ipairs(taintedLosts) do
-            player:ChangePlayerType(PlayerType.ISAAC)
-        end
-    end
-    local removedItemsMap, removedTrinketsMap = table.unpack(removeItemsAndTrinketsThatAffectItemPools(nil))
-    local itemPool = game:GetItemPool()
-    local collectibleSet = getCollectibleSet(nil)
-    for ____, collectibleTypeInSet in __TS__Iterator(collectibleSet:values()) do
-        if collectibleTypeInSet ~= collectibleType then
-            itemPool:AddRoomBlacklist(collectibleTypeInSet)
-        end
-    end
-    local retrievedCollectibleType = itemPool:GetCollectible(itemPoolType, false, 1)
-    local collectibleUnlocked = retrievedCollectibleType == collectibleType
-    itemPool:ResetRoomBlacklist()
-    restoreItemsAndTrinketsThatAffectItemPools(nil, removedItemsMap, removedTrinketsMap)
-    if changedPlayerTypes then
-        for ____, player in ipairs(taintedLosts) do
-            player:ChangePlayerType(PlayerType.THE_LOST_B)
-        end
-    end
-    return collectibleUnlocked
-end
-return ____exports