isaacscript-common 3.1.1 → 3.4.0

package/functions/color.lua

@@ -14,8 +14,6 @@ local tableHasKeys = ____table.tableHasKeys
 local ____utils = require("functions.utils")
 local ensureAllCases = ____utils.ensureAllCases
 --- Helper function to check if something is an instantiated Color object.
--- 
--- @category color
 function ____exports.isColor(self, object)
     return isIsaacAPIClassOfType(nil, object, OBJECT_NAME)
 end
@@ -29,8 +27,6 @@ local KEYS = {
     "BO"
 }
 OBJECT_NAME = "Color"
----
--- @category color
 function ____exports.colorEquals(self, color1, color2)
     return isaacAPIClassEquals(nil, color1, color2, KEYS)
 end
@@ -39,7 +35,6 @@ end
 -- @param color The Color object to copy. In the case of deserialization, this will actually be a
 -- Lua table instead of an instantiated Color class.
 -- @param serializationType Default is `SerializationType.NONE`.
--- @category color
 function ____exports.copyColor(self, color, serializationType)
     if serializationType == nil then
         serializationType = SerializationType.NONE
@@ -116,15 +111,11 @@ function ____exports.copyColor(self, color, serializationType)
     until true
 end
 --- Returns `Color(1, 1, 1)`.
--- 
--- @category color
 function ____exports.getDefaultColor(self)
     return Color(1, 1, 1)
 end
 --- Used to determine is the given table is a serialized `Color` object created by the save data
 -- manager and/or the `deepCopy` function.
--- 
--- @category color
 function ____exports.isSerializedColor(self, object)
     local objectType = type(object)
     if objectType ~= "table" then

package/functions/entity.d.ts

@@ -11,6 +11,16 @@ import { AnyEntity } from "../types/AnyEntity";
  * @param ignoreFriendly Default is false.
  */
 export declare function countEntities(entityType?: EntityType, variant?: number, subType?: number, ignoreFriendly?: boolean): int;
+/**
+ * Helper function to check if one or more of a specific kind of entity is present in the current
+ * room. It uses the `countEntities` helper function to determine this.
+ *
+ * @param entityType Default is -1. -1 matches every entity type.
+ * @param variant Default is -1. -1 matches every variant.
+ * @param subType Default is -1. -1 matches every sub-type.
+ * @param ignoreFriendly Default is false.
+ */
+export declare function doesEntityExist(entityType?: EntityType, variant?: number, subType?: number, ignoreFriendly?: boolean): boolean;
 /**
  * Given an array of entities, this helper function returns the closest one to a provided reference
  * entity.

package/functions/entity.lua

@@ -66,6 +66,35 @@ function ____exports.countEntities(self, entityType, variant, subType, ignoreFri
     )
     return #entities
 end
+--- Helper function to check if one or more of a specific kind of entity is present in the current
+-- room. It uses the `countEntities` helper function to determine this.
+-- 
+-- @param entityType Default is -1. -1 matches every entity type.
+-- @param variant Default is -1. -1 matches every variant.
+-- @param subType Default is -1. -1 matches every sub-type.
+-- @param ignoreFriendly Default is false.
+function ____exports.doesEntityExist(self, entityType, variant, subType, ignoreFriendly)
+    if entityType == nil then
+        entityType = -1
+    end
+    if variant == nil then
+        variant = -1
+    end
+    if subType == nil then
+        subType = -1
+    end
+    if ignoreFriendly == nil then
+        ignoreFriendly = false
+    end
+    local count = ____exports.countEntities(
+        nil,
+        entityType,
+        variant,
+        subType,
+        ignoreFriendly
+    )
+    return count > 0
+end
 --- Given an array of entities, this helper function returns the closest one to a provided reference
 -- entity.
 -- 

package/functions/log.lua

@@ -229,7 +229,7 @@ function ____exports.logEntities(includeBackgroundEffects, entityTypeFilter)
     if numMatchedEntities == 0 then
         msg = msg .. "(no entities matched)\n"
     else
-        msg = msg .. ("(" .. tostring(numMatchedEntities)) .. " total entities)\n"
+        msg = msg .. ((("(" .. tostring(numMatchedEntities)) .. " total ") .. (numMatchedEntities == 1 and "entity" or "entities")) .. ")\n"
     end
     ____exports.log(msg)
 end
@@ -336,7 +336,7 @@ function ____exports.logGridEntities(includeWalls, gridEntityTypeFilter)
     if numMatchedEntities == 0 then
         msg = msg .. "(no grid entities matched)\n"
     else
-        msg = msg .. ("(" .. tostring(numMatchedEntities)) .. " total grid entities)\n"
+        msg = msg .. ((("(" .. tostring(numMatchedEntities)) .. " total grid ") .. (numMatchedEntities == 1 and "entity" or "entities")) .. ")\n"
     end
     ____exports.log(msg)
 end

package/functions/pills.d.ts

@@ -8,6 +8,11 @@ export declare function getAllPillColors(): PillColor[];
  * Helper function to get an array with every valid pill effect. This includes modded pill effects.
  */
 export declare function getAllPillEffects(): PillEffect[];
+/**
+ * Helper function to get the associated pill effect after False PHD is acquired. If a pill effect
+ * is not altered by False PHD, then the same pill effect will be returned.
+ */
+export declare function getFalsePHDPillEffect(pillEffect: PillEffect): PillEffect;
 /**
  * Helper function to get the corresponding horse pill color from a normal pill color.
  *
@@ -33,6 +38,11 @@ export declare function getModdedPillEffects(): PillEffect[];
 export declare function getNormalPillColorFromHorse(pillColor: PillColor): PillColor;
 /** Helper function to get an array with every non-gold and non-horse pill color. */
 export declare function getNormalPillColors(): PillColor[];
+/**
+ * Helper function to get the associated pill effect after PHD is acquired. If a pill effect is not
+ * altered by PHD, then the same pill effect will be returned.
+ */
+export declare function getPHDPillEffect(pillEffect: PillEffect): PillEffect;
 /**
  * Helper function to get a pill effect class from a PillEffect enum value. In this context, the
  * class is equal to the numerical prefix in the "class" tag in the "pocketitems.xml" file. Use the

package/functions/pills.lua

@@ -14,6 +14,10 @@ local LAST_HORSE_PILL_COLOR = ____constantsFirstLast.LAST_HORSE_PILL_COLOR
 local LAST_NORMAL_PILL_COLOR = ____constantsFirstLast.LAST_NORMAL_PILL_COLOR
 local LAST_PILL_EFFECT = ____constantsFirstLast.LAST_PILL_EFFECT
 local LAST_VANILLA_PILL_EFFECT = ____constantsFirstLast.LAST_VANILLA_PILL_EFFECT
+local ____falsePHDPillConversions = require("maps.falsePHDPillConversions")
+local FALSE_PHD_PILL_CONVERSIONS = ____falsePHDPillConversions.FALSE_PHD_PILL_CONVERSIONS
+local ____PHDPillConversions = require("maps.PHDPillConversions")
+local PHD_PILL_CONVERSIONS = ____PHDPillConversions.PHD_PILL_CONVERSIONS
 local ____pillEffectClasses = require("objects.pillEffectClasses")
 local DEFAULT_PILL_EFFECT_CLASS = ____pillEffectClasses.DEFAULT_PILL_EFFECT_CLASS
 local PILL_EFFECT_CLASSES = ____pillEffectClasses.PILL_EFFECT_CLASSES
@@ -44,6 +48,12 @@ end
 function ____exports.getAllPillEffects(self)
     return irange(nil, FIRST_PILL_EFFECT, LAST_PILL_EFFECT)
 end
+--- Helper function to get the associated pill effect after False PHD is acquired. If a pill effect
+-- is not altered by False PHD, then the same pill effect will be returned.
+function ____exports.getFalsePHDPillEffect(self, pillEffect)
+    local convertedPillEffect = FALSE_PHD_PILL_CONVERSIONS:get(pillEffect)
+    return convertedPillEffect == nil and pillEffect or convertedPillEffect
+end
 --- Helper function to get the corresponding horse pill color from a normal pill color.
 -- 
 -- For example, passing `PillColor.BLUE_BLUE` would result in 2049, which is the value that
@@ -77,6 +87,12 @@ end
 function ____exports.getNormalPillColors(self)
     return irange(nil, FIRST_PILL_COLOR, LAST_NORMAL_PILL_COLOR)
 end
+--- Helper function to get the associated pill effect after PHD is acquired. If a pill effect is not
+-- altered by PHD, then the same pill effect will be returned.
+function ____exports.getPHDPillEffect(self, pillEffect)
+    local convertedPillEffect = PHD_PILL_CONVERSIONS:get(pillEffect)
+    return convertedPillEffect == nil and pillEffect or convertedPillEffect
+end
 --- Helper function to get a pill effect class from a PillEffect enum value. In this context, the
 -- class is equal to the numerical prefix in the "class" tag in the "pocketitems.xml" file. Use the
 -- `getPillEffectType` helper function to determine whether or not the pill effect is positive,

package/functions/roomData.d.ts

@@ -1,9 +1,4 @@
 import { DoorSlot, RoomShape, RoomType, StageID } from "isaac-typescript-definitions";
-/**
- * Alias for the `Level.GetCurrentRoomDesc` method. Use this to make it more clear what type of
- * `RoomDescriptor` object that you are retrieving.
- */
-export declare function getCurrentRoomDescriptorReadOnly(): ReadonlyRoomDescriptor;
 /**
  * Helper function to get the set of allowed door slots for the room at the supplied grid index.
  * This corresponds to the doors that are enabled in the STB/XML file for the room.
@@ -21,6 +16,11 @@ export declare function getRoomData(roomGridIndex?: int): RoomConfig | undefined
  * @param roomGridIndex Optional. Default is the current room index.
  */
 export declare function getRoomDescriptor(roomGridIndex?: int): RoomDescriptor;
+/**
+ * Alias for the `Level.GetCurrentRoomDesc` method. Use this to make it more clear what type of
+ * `RoomDescriptor` object that you are retrieving.
+ */
+export declare function getRoomDescriptorReadOnly(): ReadonlyRoomDescriptor;
 /**
  * Helper function to get the grid index of the current room.
  *

package/functions/roomData.lua

@@ -12,12 +12,6 @@ local ____enums = require("functions.enums")
 local getEnumValues = ____enums.getEnumValues
 local ____flag = require("functions.flag")
 local hasFlag = ____flag.hasFlag
---- Alias for the `Level.GetCurrentRoomDesc` method. Use this to make it more clear what type of
--- `RoomDescriptor` object that you are retrieving.
-function ____exports.getCurrentRoomDescriptorReadOnly(self)
-    local level = game:GetLevel()
-    return level:GetCurrentRoomDesc()
-end
 --- Helper function to get the room data for the provided room.
 -- 
 -- @param roomGridIndex Optional. Default is the current room index.
@@ -35,6 +29,12 @@ function ____exports.getRoomDescriptor(self, roomGridIndex)
     end
     return level:GetRoomByIdx(roomGridIndex)
 end
+--- Alias for the `Level.GetCurrentRoomDesc` method. Use this to make it more clear what type of
+-- `RoomDescriptor` object that you are retrieving.
+function ____exports.getRoomDescriptorReadOnly(self)
+    local level = game:GetLevel()
+    return level:GetCurrentRoomDesc()
+end
 --- Helper function to get the grid index of the current room.
 -- 
 -- - If the current room is inside of the grid, this function will return the `SafeGridIndex` from
@@ -55,7 +55,7 @@ function ____exports.getRoomGridIndex(self)
     if currentRoomIndex < 0 then
         return currentRoomIndex
     end
-    local roomDescriptor = ____exports.getCurrentRoomDescriptorReadOnly(nil)
+    local roomDescriptor = ____exports.getRoomDescriptorReadOnly(nil)
     return roomDescriptor.SafeGridIndex
 end
 --- Helper function to get the set of allowed door slots for the room at the supplied grid index.

package/functions/rooms.d.ts

@@ -13,11 +13,8 @@ export declare function getAllRoomGridIndexes(): int[];
 /**
  * Helper function to get the current dimension. Most of the time, this will be `Dimension.MAIN`,
  * but it can change if e.g. the player is in the mirror world of Downpour/Dross.
- *
- * Note that this function correctly handles detecting the Death Certificate dimension, which is
- * tricky to properly detect.
  */
-export declare function getCurrentDimension(): Dimension;
+export declare function getDimension(): Dimension;
 /**
  * Helper function to get the number of rooms that are currently on the floor layout. This does not
  * include off-grid rooms, like the Devil Room.

package/functions/rooms.lua

@@ -51,10 +51,10 @@ local getEntityVelocities = ____positionVelocity.getEntityVelocities
 local setEntityPositions = ____positionVelocity.setEntityPositions
 local setEntityVelocities = ____positionVelocity.setEntityVelocities
 local ____roomData = require("functions.roomData")
-local getCurrentRoomDescriptorReadOnly = ____roomData.getCurrentRoomDescriptorReadOnly
 local getRoomAllowedDoors = ____roomData.getRoomAllowedDoors
 local getRoomData = ____roomData.getRoomData
 local getRoomDescriptor = ____roomData.getRoomDescriptor
+local getRoomDescriptorReadOnly = ____roomData.getRoomDescriptorReadOnly
 local getRoomGridIndex = ____roomData.getRoomGridIndex
 local getRoomName = ____roomData.getRoomName
 local getRoomShape = ____roomData.getRoomShape
@@ -103,13 +103,6 @@ function ____exports.getRooms(self, includeExtraDimensionalRooms)
     end
     return {__TS__Spread(roomsMap:values())}
 end
---- We cannot use the standard code in the `inDimension` function for this purpose since it is bugged
--- with the Death Certificate area.
-function ____exports.inDeathCertificateArea(self)
-    local roomStageID = getRoomStageID(nil)
-    local roomSubType = getRoomSubType(nil)
-    return roomStageID == StageID.HOME and (roomSubType == HomeRoomSubType.DEATH_CERTIFICATE_ENTRANCE or roomSubType == HomeRoomSubType.DEATH_CERTIFICATE_ITEMS)
-end
 --- Helper function to check if a room exists at the given room grid index.
 function ____exports.roomExists(self, roomGridIndex)
     local roomData = getRoomData(nil, roomGridIndex)
@@ -140,25 +133,19 @@ function ____exports.getAllRoomGridIndexes(self)
 end
 --- Helper function to get the current dimension. Most of the time, this will be `Dimension.MAIN`,
 -- but it can change if e.g. the player is in the mirror world of Downpour/Dross.
--- 
--- Note that this function correctly handles detecting the Death Certificate dimension, which is
--- tricky to properly detect.
-function ____exports.getCurrentDimension(self)
+function ____exports.getDimension(self)
     local level = game:GetLevel()
-    if ____exports.inDeathCertificateArea(nil) then
-        return Dimension.DEATH_CERTIFICATE
-    end
-    local startingRoomGridIndex = level:GetStartingRoomIndex()
-    local startingRoomDescription = level:GetRoomByIdx(startingRoomGridIndex, Dimension.CURRENT)
-    local startingRoomHash = GetPtrHash(startingRoomDescription)
+    local roomGridIndex = getRoomGridIndex(nil)
+    local roomDescription = level:GetRoomByIdx(roomGridIndex, Dimension.CURRENT)
+    local currentRoomHash = GetPtrHash(roomDescription)
     for ____, dimension in ipairs(____exports.getAllDimensions(nil)) do
-        local dimensionRoomDescription = level:GetRoomByIdx(startingRoomGridIndex, dimension)
+        local dimensionRoomDescription = level:GetRoomByIdx(roomGridIndex, dimension)
         local dimensionRoomHash = GetPtrHash(dimensionRoomDescription)
-        if dimensionRoomHash == startingRoomHash then
+        if dimensionRoomHash == currentRoomHash then
             return dimension
         end
     end
-    return error("Failed to get the current dimension using the starting room index of: " .. tostring(startingRoomGridIndex))
+    return error("Failed to get the current dimension.")
 end
 --- Helper function to get the number of rooms that are currently on the floor layout. This does not
 -- include off-grid rooms, like the Devil Room.
@@ -277,15 +264,22 @@ function ____exports.inCrawlspace(self)
     local roomSubType = getRoomSubType(nil)
     return roomType == RoomType.DUNGEON and roomSubType == DungeonSubType.NORMAL
 end
+--- We cannot use the standard code in the `inDimension` function for this purpose since it is bugged
+-- with the Death Certificate area.
+function ____exports.inDeathCertificateArea(self)
+    local roomStageID = getRoomStageID(nil)
+    local roomSubType = getRoomSubType(nil)
+    return roomStageID == StageID.HOME and (roomSubType == HomeRoomSubType.DEATH_CERTIFICATE_ENTRANCE or roomSubType == HomeRoomSubType.DEATH_CERTIFICATE_ITEMS)
+end
 --- Helper function to detect if the current room is a Treasure Room created when entering with a
 -- Devil's Crown trinket. Under the hood, this checks for the `RoomDescriptorFlag.DEVIL_TREASURE`
 -- flag.
 function ____exports.inDevilsCrownTreasureRoom(self)
-    local roomDescriptor = getCurrentRoomDescriptorReadOnly(nil)
+    local roomDescriptor = getRoomDescriptorReadOnly(nil)
     return hasFlag(nil, roomDescriptor.Flags, RoomDescriptorFlag.DEVIL_TREASURE)
 end
 function ____exports.inDimension(self, dimension)
-    return dimension == ____exports.getCurrentDimension(nil)
+    return dimension == ____exports.getDimension(nil)
 end
 function ____exports.inDoubleTrouble(self)
     local room = game:GetRoom()
@@ -438,12 +432,12 @@ function ____exports.setRoomCleared(self)
     for ____, door in ipairs(getDoors(nil)) do
         do
             if isHiddenSecretRoomDoor(nil, door) then
-                goto __continue68
+                goto __continue67
             end
             openDoorFast(nil, door)
             door.ExtraVisible = false
         end
-        ::__continue68::
+        ::__continue67::
     end
     sfxManager:Stop(SoundEffect.DOOR_HEAVY_OPEN)
     game:ShakeScreen(0)

package/functions/saveFile.d.ts

@@ -0,0 +1,15 @@
+import { CollectibleType, ItemPoolType } from "isaac-typescript-definitions";
+/**
+ * Helper function to see if the given collectible is unlocked on the player's save file. This
+ * requires providing the corresponding item pool that the collectible is located in.
+ *
+ * - If any player currently has the item, then it is assumed to be unlocked. (This is because Eden
+ *   may have randomly started with the provided collectible, and it will be subsequently removed
+ *   from all pools.)
+ * - If the collectible is located in more than one item pool, then any item pool can be provided.
+ * - If the collectible is not located in any item pools, then this function will always return
+ *   false.
+ * - If any player is Tainted Lost, they will be temporarily changed to Isaac and then temporarily
+ *   changed back (because Tainted Lost is not able to retrieve some collectibles from item pools).
+ */
+export declare function isCollectibleUnlocked(collectibleTypeToCheckFor: CollectibleType, itemPoolToCheckFor: ItemPoolType): boolean;

package/functions/saveFile.lua

@@ -0,0 +1,105 @@
+local ____lualib = require("lualib_bundle")
+local Map = ____lualib.Map
+local __TS__New = ____lualib.__TS__New
+local __TS__Iterator = ____lualib.__TS__Iterator
+local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local CollectibleType = ____isaac_2Dtypescript_2Ddefinitions.CollectibleType
+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 ____player = require("functions.player")
+local anyPlayerHasCollectible = ____player.anyPlayerHasCollectible
+local getPlayersOfType = ____player.getPlayersOfType
+local ____playerDataStructures = require("functions.playerDataStructures")
+local mapGetPlayer = ____playerDataStructures.mapGetPlayer
+local mapSetPlayer = ____playerDataStructures.mapSetPlayer
+local ____playerIndex = require("functions.playerIndex")
+local getPlayers = ____playerIndex.getPlayers
+local ____utils = require("functions.utils")
+local ____repeat = ____utils["repeat"]
+local COLLECTIBLES_THAT_AFFECT_ITEM_POOLS = {CollectibleType.CHAOS, CollectibleType.SACRED_ORB, CollectibleType.TMTRAINER}
+local TRINKETS_THAT_AFFECT_ITEM_POOLS = {TrinketType.NO}
+--- Helper function to see if the given collectible is unlocked on the player's save file. This
+-- requires providing the corresponding item pool that the collectible is located in.
+-- 
+-- - If any player currently has the item, then it is assumed to be unlocked. (This is because Eden
+--   may have randomly started with the provided collectible, and it will be subsequently removed
+--   from all pools.)
+-- - If the collectible is located in more than one item pool, then any item pool can be provided.
+-- - If the collectible is not located in any item pools, then this function will always return
+--   false.
+-- - If any player is Tainted Lost, they will be temporarily changed to Isaac and then temporarily
+--   changed back (because Tainted Lost is not able to retrieve some collectibles from item pools).
+function ____exports.isCollectibleUnlocked(self, collectibleTypeToCheckFor, itemPoolToCheckFor)
+    if anyPlayerHasCollectible(nil, collectibleTypeToCheckFor) then
+        return true
+    end
+    local taintedLosts = getPlayersOfType(nil, PlayerType.THE_LOST_B)
+    for ____, player in ipairs(taintedLosts) do
+        player:ChangePlayerType(PlayerType.ISAAC)
+    end
+    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
+    local itemPool = game:GetItemPool()
+    local collectibleSet = getCollectibleSet(nil)
+    for ____, collectibleType in __TS__Iterator(collectibleSet:values()) do
+        if collectibleType ~= collectibleTypeToCheckFor then
+            itemPool:AddRoomBlacklist(collectibleType)
+        end
+    end
+    local retrievedCollectibleType = itemPool:GetCollectible(itemPoolToCheckFor, false, 1)
+    local collectibleUnlocked = retrievedCollectibleType == collectibleTypeToCheckFor
+    itemPool:ResetRoomBlacklist()
+    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
+    return collectibleUnlocked
+end
+return ____exports

package/index.d.ts

@@ -20,7 +20,8 @@ export { removeFadeIn, restoreFadeIn } from "./features/fadeInRemover";
 export { disableFastReset, enableFastReset } from "./features/fastReset";
 export { forgottenSwitch } from "./features/forgottenSwitch";
 export { getCollectibleItemPoolType } from "./features/getCollectibleItemPoolType";
-export { addCollectible, getPlayerInventory } from "./features/playerInventory";
+export { removePersistentEntity, spawnPersistentEntity, } from "./features/persistentEntities";
+export { getPlayerInventory } from "./features/playerInventory";
 export * from "./features/ponyDetection";
 export { preventCollectibleRotation } from "./features/preventCollectibleRotation";
 export { runInNGameFrames, runInNRenderFrames, runNextGameFrame, runNextRenderFrame, } from "./features/runInNFrames";
@@ -89,6 +90,7 @@ export * from "./functions/roomGrid";
 export * from "./functions/rooms";
 export * from "./functions/roomShape";
 export * from "./functions/run";
+export * from "./functions/saveFile";
 export * from "./functions/seeds";
 export * from "./functions/serialization";
 export * from "./functions/set";

package/index.lua

@@ -167,11 +167,16 @@ do
     local getCollectibleItemPoolType = ____getCollectibleItemPoolType.getCollectibleItemPoolType
     ____exports.getCollectibleItemPoolType = getCollectibleItemPoolType
 end
+do
+    local ____persistentEntities = require("features.persistentEntities")
+    local removePersistentEntity = ____persistentEntities.removePersistentEntity
+    local spawnPersistentEntity = ____persistentEntities.spawnPersistentEntity
+    ____exports.removePersistentEntity = removePersistentEntity
+    ____exports.spawnPersistentEntity = spawnPersistentEntity
+end
 do
     local ____playerInventory = require("features.playerInventory")
-    local addCollectible = ____playerInventory.addCollectible
     local getPlayerInventory = ____playerInventory.getPlayerInventory
-    ____exports.addCollectible = addCollectible
     ____exports.getPlayerInventory = getPlayerInventory
 end
 do
@@ -705,6 +710,14 @@ do
         end
     end
 end
+do
+    local ____export = require("functions.saveFile")
+    for ____exportKey, ____exportValue in pairs(____export) do
+        if ____exportKey ~= "default" then
+            ____exports[____exportKey] = ____exportValue
+        end
+    end
+end
 do
     local ____export = require("functions.seeds")
     for ____exportKey, ____exportValue in pairs(____export) do

package/initCustomCallbacks.lua

@@ -65,6 +65,8 @@ local ____postPlayerChangeHealth = require("callbacks.postPlayerChangeHealth")
 local postPlayerChangeHealthCallbackInit = ____postPlayerChangeHealth.postPlayerChangeHealthCallbackInit
 local ____postPlayerChangeType = require("callbacks.postPlayerChangeType")
 local postPlayerChangeTypeCallbackInit = ____postPlayerChangeType.postPlayerChangeTypeCallbackInit
+local ____postPlayerCollectible = require("callbacks.postPlayerCollectible")
+local postPlayerCollectibleCallbackInit = ____postPlayerCollectible.postPlayerCollectibleCallbackInit
 local ____postPlayerFatalDamage = require("callbacks.postPlayerFatalDamage")
 local postPlayerFatalDamageCallbackInit = ____postPlayerFatalDamage.postPlayerFatalDamageCallbackInit
 local ____postPlayerInitLate = require("callbacks.postPlayerInitLate")
@@ -153,6 +155,7 @@ function ____exports.initCustomCallbacks(self, mod)
     postPitUpdateInit(nil, mod)
     postPlayerChangeHealthCallbackInit(nil, mod)
     postPlayerChangeTypeCallbackInit(nil, mod)
+    postPlayerCollectibleCallbackInit(nil, mod)
     postPlayerFatalDamageCallbackInit(nil, mod)
     postPlayerInitLateCallbackInit(nil, mod)
     postPlayerReorderedCallbacksInit(nil, mod)

package/initFeatures.lua

@@ -17,6 +17,8 @@ local ____forgottenSwitch = require("features.forgottenSwitch")
 local forgottenSwitchInit = ____forgottenSwitch.forgottenSwitchInit
 local ____getCollectibleItemPoolType = require("features.getCollectibleItemPoolType")
 local getCollectibleItemPoolTypeInit = ____getCollectibleItemPoolType.getCollectibleItemPoolTypeInit
+local ____persistentEntities = require("features.persistentEntities")
+local persistentEntitiesInit = ____persistentEntities.persistentEntitiesInit
 local ____playerInventory = require("features.playerInventory")
 local playerInventoryInit = ____playerInventory.playerInventoryInit
 local ____ponyDetection = require("features.ponyDetection")
@@ -42,6 +44,7 @@ function ____exports.initFeaturesMinor(self, mod)
     fastResetInit(nil, mod)
     forgottenSwitchInit(nil, mod)
     getCollectibleItemPoolTypeInit(nil, mod)
+    persistentEntitiesInit(nil, mod)
     playerInventoryInit(nil, mod)
     ponyDetectionInit(nil, mod)
     preventCollectibleRotationInit(nil, mod)

package/interfaces/AddCallbackParameterCustom.d.ts

@@ -42,6 +42,8 @@ import { PostPitRenderRegisterParameters } from "../callbacks/subscriptions/post
 import { PostPitUpdateRegisterParameters } from "../callbacks/subscriptions/postPitUpdate";
 import { PostPlayerChangeHealthRegisterParameters } from "../callbacks/subscriptions/postPlayerChangeHealth";
 import { PostPlayerChangeTypeRegisterParameters } from "../callbacks/subscriptions/postPlayerChangeType";
+import { PostPlayerCollectibleAddedRegisterParameters } from "../callbacks/subscriptions/postPlayerCollectibleAdded";
+import { PostPlayerCollectibleRemovedRegisterParameters } from "../callbacks/subscriptions/postPlayerCollectibleRemoved";
 import { PostPlayerFatalDamageRegisterParameters } from "../callbacks/subscriptions/postPlayerFatalDamage";
 import { PostPlayerInitLateRegisterParameters } from "../callbacks/subscriptions/postPlayerInitLate";
 import { PostPlayerInitReorderedRegisterParameters } from "../callbacks/subscriptions/postPlayerInitReordered";
@@ -120,6 +122,8 @@ export interface AddCallbackParameterCustom {
     [ModCallbackCustom.POST_PIT_UPDATE]: PostPitUpdateRegisterParameters;
     [ModCallbackCustom.POST_PLAYER_CHANGE_HEALTH]: PostPlayerChangeHealthRegisterParameters;
     [ModCallbackCustom.POST_PLAYER_CHANGE_TYPE]: PostPlayerChangeTypeRegisterParameters;
+    [ModCallbackCustom.POST_PLAYER_COLLECTIBLE_ADDED]: PostPlayerCollectibleAddedRegisterParameters;
+    [ModCallbackCustom.POST_PLAYER_COLLECTIBLE_REMOVED]: PostPlayerCollectibleRemovedRegisterParameters;
     [ModCallbackCustom.POST_PLAYER_FATAL_DAMAGE]: PostPlayerFatalDamageRegisterParameters;
     [ModCallbackCustom.POST_PLAYER_INIT_LATE]: PostPlayerInitLateRegisterParameters;
     [ModCallbackCustom.POST_PLAYER_INIT_REORDERED]: PostPlayerInitReorderedRegisterParameters;

package/maps/PHDPillConversions.d.ts

@@ -0,0 +1,2 @@
+import { PillEffect } from "isaac-typescript-definitions";
+export declare const PHD_PILL_CONVERSIONS: ReadonlyMap<PillEffect, PillEffect>;

package/maps/PHDPillConversions.lua

@@ -0,0 +1,25 @@
+local ____lualib = require("lualib_bundle")
+local Map = ____lualib.Map
+local __TS__New = ____lualib.__TS__New
+local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local PillEffect = ____isaac_2Dtypescript_2Ddefinitions.PillEffect
+____exports.PHD_PILL_CONVERSIONS = __TS__New(Map, {
+    {PillEffect.BAD_TRIP, PillEffect.BALLS_OF_STEEL},
+    {PillEffect.HEALTH_DOWN, PillEffect.HEALTH_UP},
+    {PillEffect.RANGE_DOWN, PillEffect.RANGE_UP},
+    {PillEffect.SPEED_DOWN, PillEffect.SPEED_UP},
+    {PillEffect.TEARS_DOWN, PillEffect.TEARS_UP},
+    {PillEffect.LUCK_DOWN, PillEffect.LUCK_UP},
+    {PillEffect.PARALYSIS, PillEffect.PHEROMONES},
+    {PillEffect.AMNESIA, PillEffect.I_CAN_SEE_FOREVER},
+    {PillEffect.R_U_A_WIZARD, PillEffect.POWER},
+    {PillEffect.ADDICTED, PillEffect.PERCS},
+    {PillEffect.QUESTION_MARKS, PillEffect.TELEPILLS},
+    {PillEffect.RETRO_VISION, PillEffect.I_CAN_SEE_FOREVER},
+    {PillEffect.X_LAX, PillEffect.SOMETHINGS_WRONG},
+    {PillEffect.IM_EXCITED, PillEffect.IM_DROWSY},
+    {PillEffect.HORF, PillEffect.GULP},
+    {PillEffect.SHOT_SPEED_DOWN, PillEffect.SHOT_SPEED_UP}
+})
+return ____exports

package/maps/falsePHDPillConversions.d.ts

@@ -0,0 +1,2 @@
+import { PillEffect } from "isaac-typescript-definitions";
+export declare const FALSE_PHD_PILL_CONVERSIONS: ReadonlyMap<PillEffect, PillEffect>;

package/maps/falsePHDPillConversions.lua

@@ -0,0 +1,39 @@
+local ____lualib = require("lualib_bundle")
+local Map = ____lualib.Map
+local __TS__New = ____lualib.__TS__New
+local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local PillEffect = ____isaac_2Dtypescript_2Ddefinitions.PillEffect
+____exports.FALSE_PHD_PILL_CONVERSIONS = __TS__New(Map, {
+    {PillEffect.BAD_GAS, PillEffect.HEALTH_DOWN},
+    {PillEffect.BALLS_OF_STEEL, PillEffect.BAD_TRIP},
+    {PillEffect.BOMBS_ARE_KEYS, PillEffect.TEARS_DOWN},
+    {PillEffect.EXPLOSIVE_DIARRHEA, PillEffect.RANGE_DOWN},
+    {PillEffect.FULL_HEALTH, PillEffect.BAD_TRIP},
+    {PillEffect.HEALTH_UP, PillEffect.HEALTH_DOWN},
+    {PillEffect.PRETTY_FLY, PillEffect.LUCK_DOWN},
+    {PillEffect.RANGE_UP, PillEffect.RANGE_DOWN},
+    {PillEffect.SPEED_UP, PillEffect.SPEED_DOWN},
+    {PillEffect.TEARS_UP, PillEffect.TEARS_DOWN},
+    {PillEffect.LUCK_UP, PillEffect.LUCK_DOWN},
+    {PillEffect.TELEPILLS, PillEffect.QUESTION_MARKS},
+    {PillEffect.FORTY_EIGHT_HOUR_ENERGY, PillEffect.SPEED_DOWN},
+    {PillEffect.HEMATEMESIS, PillEffect.BAD_TRIP},
+    {PillEffect.I_CAN_SEE_FOREVER, PillEffect.AMNESIA},
+    {PillEffect.PHEROMONES, PillEffect.PARALYSIS},
+    {PillEffect.LEMON_PARTY, PillEffect.AMNESIA},
+    {PillEffect.PERCS, PillEffect.ADDICTED},
+    {PillEffect.ONE_MAKES_YOU_LARGER, PillEffect.RANGE_DOWN},
+    {PillEffect.ONE_MAKES_YOU_SMALL, PillEffect.SPEED_DOWN},
+    {PillEffect.INFESTED_EXCLAMATION, PillEffect.TEARS_DOWN},
+    {PillEffect.INFESTED_QUESTION, PillEffect.LUCK_DOWN},
+    {PillEffect.POWER, PillEffect.R_U_A_WIZARD},
+    {PillEffect.FRIENDS_TILL_THE_END, PillEffect.HEALTH_DOWN},
+    {PillEffect.SOMETHINGS_WRONG, PillEffect.X_LAX},
+    {PillEffect.IM_DROWSY, PillEffect.IM_EXCITED},
+    {PillEffect.GULP, PillEffect.HORF},
+    {PillEffect.FEELS_LIKE_IM_WALKING_ON_SUNSHINE, PillEffect.RETRO_VISION},
+    {PillEffect.VURP, PillEffect.HORF},
+    {PillEffect.SHOT_SPEED_UP, PillEffect.SHOT_SPEED_DOWN}
+})
+return ____exports