isaacscript-common 6.11.0 → 6.12.0

package/dist/features/pickupIndex.lua

@@ -0,0 +1,197 @@
+local ____lualib = require("lualib_bundle")
+local Map = ____lualib.Map
+local __TS__New = ____lualib.__TS__New
+local __TS__Iterator = ____lualib.__TS__Iterator
+local ____exports = {}
+local postPickupInit, postEntityRemovePickup, checkDespawningFromPlayerLeavingRoom, trackDespawningPickupMetadata, postNewRoomReordered, getStoredPickupIndex, getPostAscentPickupIndex, v
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local EntityType = ____isaac_2Dtypescript_2Ddefinitions.EntityType
+local ModCallback = ____isaac_2Dtypescript_2Ddefinitions.ModCallback
+local RoomType = ____isaac_2Dtypescript_2Ddefinitions.RoomType
+local ____cachedClasses = require("cachedClasses")
+local game = ____cachedClasses.game
+local ____DefaultMap = require("classes.DefaultMap")
+local DefaultMap = ____DefaultMap.DefaultMap
+local ____ModCallbackCustom = require("enums.ModCallbackCustom")
+local ModCallbackCustom = ____ModCallbackCustom.ModCallbackCustom
+local ____featuresInitialized = require("featuresInitialized")
+local errorIfFeaturesNotInitialized = ____featuresInitialized.errorIfFeaturesNotInitialized
+local ____entities = require("functions.entities")
+local getEntityID = ____entities.getEntityID
+local ____entitiesSpecific = require("functions.entitiesSpecific")
+local getPickups = ____entitiesSpecific.getPickups
+local ____roomData = require("functions.roomData")
+local getRoomListIndex = ____roomData.getRoomListIndex
+local ____stage = require("functions.stage")
+local onAscent = ____stage.onAscent
+local ____vector = require("functions.vector")
+local vectorEquals = ____vector.vectorEquals
+local ____roomHistory = require("features.roomHistory")
+local getLatestRoomDescription = ____roomHistory.getLatestRoomDescription
+local ____exports = require("features.saveDataManager.exports")
+local saveDataManager = ____exports.saveDataManager
+function postPickupInit(self, pickup)
+    local ptrHash = GetPtrHash(pickup)
+    if v.room.pickupIndexes:has(ptrHash) then
+        return
+    end
+    local room = game:GetRoom()
+    local isFirstVisit = room:IsFirstVisit()
+    local roomFrameCount = room:GetFrameCount()
+    if not isFirstVisit and roomFrameCount <= 0 then
+        return
+    end
+    local ____v_run_0, ____pickupCounter_1 = v.run, "pickupCounter"
+    ____v_run_0[____pickupCounter_1] = ____v_run_0[____pickupCounter_1] + 1
+    v.room.pickupIndexes:set(ptrHash, v.run.pickupCounter)
+    v.run.currentRoomListIndex = getRoomListIndex(nil)
+end
+function postEntityRemovePickup(self, entity)
+    checkDespawningFromPlayerLeavingRoom(nil, entity)
+end
+function checkDespawningFromPlayerLeavingRoom(self, entity)
+    local ptrHash = GetPtrHash(entity)
+    local pickupIndex = v.room.pickupIndexes:get(ptrHash)
+    if pickupIndex == nil then
+        return
+    end
+    local roomListIndex = getRoomListIndex(nil)
+    if roomListIndex == v.run.currentRoomListIndex then
+        return
+    end
+    trackDespawningPickupMetadata(nil, entity, pickupIndex)
+end
+function trackDespawningPickupMetadata(self, entity, pickupIndex)
+    local previousRoomDescription = getLatestRoomDescription(nil)
+    local previousRoomListIndex = previousRoomDescription.roomListIndex
+    local pickupDescriptions = v.level.pickupData:getAndSetDefault(previousRoomListIndex)
+    local pickupDescription = {position = entity.Position, initSeed = entity.InitSeed}
+    pickupDescriptions:set(pickupIndex, pickupDescription)
+    if onAscent(nil) then
+        return
+    end
+    local room = game:GetRoom()
+    local roomType = room:GetType()
+    repeat
+        local ____switch13 = roomType
+        local ____cond13 = ____switch13 == RoomType.TREASURE
+        if ____cond13 then
+            do
+                v.run.pickupDataTreasureRooms:set(pickupIndex, pickupDescription)
+                break
+            end
+        end
+        ____cond13 = ____cond13 or ____switch13 == RoomType.BOSS
+        if ____cond13 then
+            do
+                v.run.pickupDataBossRooms:set(pickupIndex, pickupDescription)
+                break
+            end
+        end
+        do
+            do
+                break
+            end
+        end
+    until true
+end
+function postNewRoomReordered(self)
+    local room = game:GetRoom()
+    local isFirstVisit = room:IsFirstVisit()
+    if isFirstVisit then
+        return
+    end
+    local roomListIndex = getRoomListIndex(nil)
+    local pickupDescriptions = v.level.pickupData:getAndSetDefault(roomListIndex)
+    for ____, pickup in ipairs(getPickups(nil)) do
+        local pickupIndex = getStoredPickupIndex(nil, pickup, pickupDescriptions)
+        if pickupIndex == nil then
+            pickupIndex = getPostAscentPickupIndex(nil, pickup)
+        end
+        if pickupIndex == nil then
+            local entityID = getEntityID(nil, pickup)
+            error("Failed to find a pickup index corresponding to existing pickup: " .. entityID)
+        end
+        local ptrHash = GetPtrHash(pickup)
+        v.room.pickupIndexes:set(ptrHash, pickupIndex)
+    end
+end
+function getStoredPickupIndex(self, pickup, pickupDescriptions)
+    for ____, ____value in __TS__Iterator(pickupDescriptions:entries()) do
+        local pickupIndex = ____value[1]
+        local pickupDescription = ____value[2]
+        if vectorEquals(nil, pickupDescription.position, pickup.Position) and pickupDescription.initSeed == pickup.InitSeed then
+            return pickupIndex
+        end
+    end
+    return nil
+end
+function getPostAscentPickupIndex(self, pickup)
+    if not onAscent(nil) then
+        return nil
+    end
+    local room = game:GetRoom()
+    local roomType = room:GetType()
+    repeat
+        local ____switch29 = roomType
+        local ____cond29 = ____switch29 == RoomType.TREASURE
+        if ____cond29 then
+            do
+                return getStoredPickupIndex(nil, pickup, v.run.pickupDataTreasureRooms)
+            end
+        end
+        ____cond29 = ____cond29 or ____switch29 == RoomType.BOSS
+        if ____cond29 then
+            do
+                return getStoredPickupIndex(nil, pickup, v.run.pickupDataBossRooms)
+            end
+        end
+        do
+            do
+                return nil
+            end
+        end
+    until true
+end
+local FEATURE_NAME = "pickupIndex"
+v = {
+    run = {
+        pickupCounter = 0,
+        currentRoomListIndex = 0,
+        pickupDataTreasureRooms = __TS__New(Map),
+        pickupDataBossRooms = __TS__New(Map)
+    },
+    level = {pickupData = __TS__New(
+        DefaultMap,
+        function() return __TS__New(Map) end
+    )},
+    room = {pickupIndexes = __TS__New(Map)}
+}
+function ____exports.pickupIndexInit(self, mod)
+    saveDataManager(nil, FEATURE_NAME, v)
+    mod:AddCallback(ModCallback.POST_PICKUP_INIT, postPickupInit)
+    mod:AddCallback(ModCallback.POST_ENTITY_REMOVE, postEntityRemovePickup, EntityType.PICKUP)
+    mod:AddCallbackCustom(ModCallbackCustom.POST_NEW_ROOM_REORDERED, postNewRoomReordered)
+end
+--- Mods often have to track variables relating to a pickups. Finding an index for these kinds of
+-- data structures is difficult, since pickups are respawned every time a player re-enters a room,
+-- so the `PtrHash` will change.
+-- 
+-- Use this function to get a unique index for a pickup to use in these data structures.
+-- 
+-- Specifically, `PickupIndex` is a number that represents the spawn order of the pickup on the
+-- current run. For example, the first pickup spawned will have an index of 1, the second one will
+-- have an index of 2, and so on.
+-- 
+-- Tracking pickups requires stateful tracking, so using pickup indexes requires an upgraded mod.
+function ____exports.getPickupIndex(self, pickup)
+    errorIfFeaturesNotInitialized(nil, FEATURE_NAME)
+    local ptrHash = GetPtrHash(pickup)
+    local pickupIndex = v.room.pickupIndexes:get(ptrHash)
+    if pickupIndex == nil then
+        local entityID = getEntityID(nil, pickup)
+        error((("Failed to get a pickup index for entity " .. entityID) .. " with hash: ") .. tostring(ptrHash))
+    end
+    return pickupIndex
+end
+return ____exports

package/dist/features/roomHistory.d.ts

@@ -0,0 +1,24 @@
+import { RoomDescription } from "../interfaces/RoomDescription";
+/**
+ * Helper function to get information about all of the rooms that a player has visited thus far on
+ * this run.
+ */
+export declare function getRoomHistory(): readonly RoomDescription[];
+/**
+ * Helper function to get information about the room that was previously visited.
+ *
+ * In the special case of only one room having been visited thus far (i.e. the starting room of the
+ * run), the starting room will be returned.
+ */
+export declare function getPreviousRoomDescription(): RoomDescription;
+/**
+ * Helper function to get information about the most recent room that is stored in the room history
+ * array.
+ *
+ * This is useful in the `POST_ENTITY_REMOVE` callback, since if an entity is despawning due to a
+ * player having left the room, the current room will have changed already, but the `POST_NEW_ROOM`
+ * callback will not have fired yet, and there will not be an entry in the room history array for
+ * the current room.
+ */
+export declare function getLatestRoomDescription(): RoomDescription;
+//# sourceMappingURL=roomHistory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"roomHistory.d.ts","sourceRoot":"","sources":["../../src/features/roomHistory.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAiDhE;;;GAGG;AACH,wBAAgB,cAAc,IAAI,SAAS,eAAe,EAAE,CAG3D;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,IAAI,eAAe,CAe5D;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,IAAI,eAAe,CAS1D"}

package/dist/features/roomHistory.lua

@@ -0,0 +1,89 @@
+local ____exports = {}
+local postNewRoomEarly, v
+local ____cachedClasses = require("cachedClasses")
+local game = ____cachedClasses.game
+local ____ModCallbackCustom = require("enums.ModCallbackCustom")
+local ModCallbackCustom = ____ModCallbackCustom.ModCallbackCustom
+local ____featuresInitialized = require("featuresInitialized")
+local errorIfFeaturesNotInitialized = ____featuresInitialized.errorIfFeaturesNotInitialized
+local ____array = require("functions.array")
+local getLastElement = ____array.getLastElement
+local ____roomData = require("functions.roomData")
+local getRoomGridIndex = ____roomData.getRoomGridIndex
+local getRoomListIndex = ____roomData.getRoomListIndex
+local getRoomName = ____roomData.getRoomName
+local getRoomStageID = ____roomData.getRoomStageID
+local getRoomSubType = ____roomData.getRoomSubType
+local getRoomVariant = ____roomData.getRoomVariant
+local ____exports = require("features.saveDataManager.exports")
+local saveDataManager = ____exports.saveDataManager
+function postNewRoomEarly(self)
+    local level = game:GetLevel()
+    local stage = level:GetStage()
+    local stageType = level:GetStageType()
+    local room = game:GetRoom()
+    local roomType = room:GetType()
+    local stageID = getRoomStageID(nil)
+    local roomVariant = getRoomVariant(nil)
+    local roomSubType = getRoomSubType(nil)
+    local roomName = getRoomName(nil)
+    local roomGridIndex = getRoomGridIndex(nil)
+    local roomListIndex = getRoomListIndex(nil)
+    local roomDescription = {
+        stage = stage,
+        stageType = stageType,
+        stageID = stageID,
+        roomType = roomType,
+        roomVariant = roomVariant,
+        roomSubType = roomSubType,
+        roomName = roomName,
+        roomGridIndex = roomGridIndex,
+        roomListIndex = roomListIndex
+    }
+    local ____v_run_roomHistory_0 = v.run.roomHistory
+    ____v_run_roomHistory_0[#____v_run_roomHistory_0 + 1] = roomDescription
+end
+local FEATURE_NAME = "roomHistory"
+v = {run = {roomHistory = {}}}
+---
+-- @internal
+function ____exports.roomHistoryInit(self, mod)
+    saveDataManager(nil, FEATURE_NAME, v)
+    mod:AddCallbackCustom(ModCallbackCustom.POST_NEW_ROOM_EARLY, postNewRoomEarly)
+end
+--- Helper function to get information about all of the rooms that a player has visited thus far on
+-- this run.
+function ____exports.getRoomHistory(self)
+    errorIfFeaturesNotInitialized(nil, FEATURE_NAME)
+    return v.run.roomHistory
+end
+--- Helper function to get information about the room that was previously visited.
+-- 
+-- In the special case of only one room having been visited thus far (i.e. the starting room of the
+-- run), the starting room will be returned.
+function ____exports.getPreviousRoomDescription(self)
+    local previousRoomDescription = v.run.roomHistory[#v.run.roomHistory - 2 + 1]
+    if previousRoomDescription ~= nil then
+        return previousRoomDescription
+    end
+    local startingRoomDescription = v.run.roomHistory[1]
+    if startingRoomDescription ~= nil then
+        return startingRoomDescription
+    end
+    error("Failed to find a room description for any rooms thus far on this run.")
+end
+--- Helper function to get information about the most recent room that is stored in the room history
+-- array.
+-- 
+-- This is useful in the `POST_ENTITY_REMOVE` callback, since if an entity is despawning due to a
+-- player having left the room, the current room will have changed already, but the `POST_NEW_ROOM`
+-- callback will not have fired yet, and there will not be an entry in the room history array for
+-- the current room.
+function ____exports.getLatestRoomDescription(self)
+    local latestRoomDescription = getLastElement(nil, v.run.roomHistory)
+    if latestRoomDescription == nil then
+        error("Failed to get the latest room description since the room history array was empty.")
+    end
+    return latestRoomDescription
+end
+return ____exports

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

@@ -1 +1 @@
-{"version":3,"file":"taintedLazarusPlayers.d.ts","sourceRoot":"","sources":["../../src/features/taintedLazarusPlayers.ts"],"names":[],"mappings":";AAoFA;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,YAAY,GACnB,YAAY,GAAG,SAAS,CAe1B"}
+{"version":3,"file":"taintedLazarusPlayers.d.ts","sourceRoot":"","sources":["../../src/features/taintedLazarusPlayers.ts"],"names":[],"mappings":";AA+FA;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,YAAY,GACnB,YAAY,GAAG,SAAS,CAK1B"}

package/dist/features/taintedLazarusPlayers.lua

@@ -8,17 +8,18 @@ local ModCallback = ____isaac_2Dtypescript_2Ddefinitions.ModCallback
 local PlayerType = ____isaac_2Dtypescript_2Ddefinitions.PlayerType
 local ____featuresInitialized = require("featuresInitialized")
 local errorIfFeaturesNotInitialized = ____featuresInitialized.errorIfFeaturesNotInitialized
+local ____log = require("functions.log")
+local logError = ____log.logError
 local ____exports = require("features.saveDataManager.exports")
 local saveDataManager = ____exports.saveDataManager
 function postPlayerInit(self, player)
-    local entityPtr = EntityPtr(player)
     local character = player:GetPlayerType()
     if character == PlayerType.LAZARUS_B then
         local ____v_run_queuedTaintedLazarus_0 = v.run.queuedTaintedLazarus
-        ____v_run_queuedTaintedLazarus_0[#____v_run_queuedTaintedLazarus_0 + 1] = entityPtr
+        ____v_run_queuedTaintedLazarus_0[#____v_run_queuedTaintedLazarus_0 + 1] = player
     elseif character == PlayerType.LAZARUS_2_B then
         local ____v_run_queuedDeadTaintedLazarus_1 = v.run.queuedDeadTaintedLazarus
-        ____v_run_queuedDeadTaintedLazarus_1[#____v_run_queuedDeadTaintedLazarus_1 + 1] = entityPtr
+        ____v_run_queuedDeadTaintedLazarus_1[#____v_run_queuedDeadTaintedLazarus_1 + 1] = player
     else
         return
     end
@@ -28,20 +29,19 @@ function checkDequeue(self)
     if #v.run.queuedTaintedLazarus == 0 or #v.run.queuedDeadTaintedLazarus == 0 then
         return
     end
-    local taintedLazarusPtr = table.remove(v.run.queuedTaintedLazarus, 1)
-    local deadTaintedLazarusPtr = table.remove(v.run.queuedDeadTaintedLazarus, 1)
-    if taintedLazarusPtr == nil or deadTaintedLazarusPtr == nil then
-        return
-    end
-    local taintedLazarus = taintedLazarusPtr.Ref
-    local deadTaintedLazarus = deadTaintedLazarusPtr.Ref
+    local taintedLazarus = table.remove(v.run.queuedTaintedLazarus, 1)
+    local deadTaintedLazarus = table.remove(v.run.queuedDeadTaintedLazarus, 1)
     if taintedLazarus == nil or deadTaintedLazarus == nil then
         return
     end
     local taintedLazarusPtrHash = GetPtrHash(taintedLazarus)
     local deadTaintedLazarusPtrHash = GetPtrHash(deadTaintedLazarus)
-    v.run.subPlayerMap:set(taintedLazarusPtrHash, deadTaintedLazarusPtr)
-    v.run.subPlayerMap:set(deadTaintedLazarusPtrHash, taintedLazarusPtr)
+    if taintedLazarusPtrHash == deadTaintedLazarusPtrHash then
+        logError("Failed to cache the Tainted Lazarus player objects, since the hash for Tainted Lazarus and Dead Tainted Lazarus were the same.")
+        return
+    end
+    v.run.subPlayerMap:set(taintedLazarusPtrHash, deadTaintedLazarus)
+    v.run.subPlayerMap:set(deadTaintedLazarusPtrHash, taintedLazarus)
 end
 local FEATURE_NAME = "taintedLazarusPlayers"
 v = {run = {
@@ -72,14 +72,6 @@ end
 function ____exports.getTaintedLazarusSubPlayer(self, player)
     errorIfFeaturesNotInitialized(nil, FEATURE_NAME)
     local ptrHash = GetPtrHash(player)
-    local entityPtr = v.run.subPlayerMap:get(ptrHash)
-    if entityPtr == nil then
-        return nil
-    end
-    local entity = entityPtr.Ref
-    if entity == nil then
-        return nil
-    end
-    return entity:ToPlayer()
+    return v.run.subPlayerMap:get(ptrHash)
 end
 return ____exports

package/dist/functions/{character.d.ts → characters.d.ts}

@@ -30,6 +30,8 @@ export declare function characterGetsBlackHeartFromEternalHeart(character: Playe
  * is considered to starts with the D6, but this is not the case on a brand new save file).
  */
 export declare function characterStartsWithActiveItem(character: PlayerType): boolean;
+/** Helper function to get the numerical damage multiplier for a character. */
+export declare function getCharacterDamageMultiplier(character: PlayerType, hasWhoreOfBabylon?: boolean): float;
 /**
  * - Most characters have a 56 frame death animation (i.e. the "Death" animation).
  * - The Lost and Tainted Lost have a 38 frame death animation (i.e. the "LostDeath" animation).
@@ -46,4 +48,4 @@ export declare function getCharacterMaxHeartContainers(character: PlayerType): i
 export declare function getCharacterName(character: PlayerType): string;
 export declare function isModdedCharacter(character: PlayerType): boolean;
 export declare function isVanillaCharacter(character: PlayerType): boolean;
-//# sourceMappingURL=character.d.ts.map
+//# sourceMappingURL=characters.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"characters.d.ts","sourceRoot":"","sources":["../../src/functions/characters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAW1D;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,UAAU,GAAG,OAAO,CAExE;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,UAAU,GAAG,OAAO,CAEzE;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,CAAC,SAAS,EAAE,UAAU,GAAG,OAAO,CAE7E;AAED;;;;GAIG;AACH,wBAAgB,uCAAuC,CACrD,SAAS,EAAE,UAAU,GACpB,OAAO,CAET;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,SAAS,EAAE,UAAU,GAAG,OAAO,CAE5E;AAED,8EAA8E;AAC9E,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,UAAU,EACrB,iBAAiB,UAAQ,GACxB,KAAK,CAMP;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,SAAS,EAAE,UAAU,GAAG,MAAM,CAU5E;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,SAAS,EAAE,UAAU,GAAG,GAAG,CAsBzE;AAED,+FAA+F;AAC/F,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,UAAU,GAAG,MAAM,CAM9D;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,UAAU,GAAG,OAAO,CAEhE;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,UAAU,GAAG,OAAO,CAEjE"}

package/dist/functions/{character.lua → characters.lua}

@@ -3,6 +3,8 @@ local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitio
 local PlayerType = ____isaac_2Dtypescript_2Ddefinitions.PlayerType
 local ____constantsFirstLast = require("constantsFirstLast")
 local LAST_VANILLA_CHARACTER = ____constantsFirstLast.LAST_VANILLA_CHARACTER
+local ____characterDamageMultipliers = require("objects.characterDamageMultipliers")
+local CHARACTER_DAMAGE_MULTIPLIERS = ____characterDamageMultipliers.CHARACTER_DAMAGE_MULTIPLIERS
 local ____characterNames = require("objects.characterNames")
 local CHARACTER_NAMES = ____characterNames.CHARACTER_NAMES
 local ____charactersThatStartWithAnActiveItemSet = require("sets.charactersThatStartWithAnActiveItemSet")
@@ -54,6 +56,16 @@ end
 function ____exports.characterStartsWithActiveItem(self, character)
     return CHARACTERS_THAT_START_WITH_AN_ACTIVE_ITEM_SET:has(character)
 end
+--- Helper function to get the numerical damage multiplier for a character.
+function ____exports.getCharacterDamageMultiplier(self, character, hasWhoreOfBabylon)
+    if hasWhoreOfBabylon == nil then
+        hasWhoreOfBabylon = false
+    end
+    if character == PlayerType.EVE and hasWhoreOfBabylon then
+        return 1
+    end
+    return CHARACTER_DAMAGE_MULTIPLIERS[character]
+end
 --- - Most characters have a 56 frame death animation (i.e. the "Death" animation).
 -- - The Lost and Tainted Lost have a 38 frame death animation (i.e. the "LostDeath" animation).
 -- - Tainted Forgotten have a 20 frame death animation (i.e. the "ForgottenDeath" animation).

package/dist/functions/collectibles.d.ts

@@ -24,38 +24,51 @@ export declare function getCollectibleDevilHeartPrice(collectibleType: Collectib
  */
 export declare function getCollectibleGfxFilename(collectibleType: CollectibleType): string;
 /**
- * Mods often have to track variables relating to a collectible. Finding an index for these kinds of
- * data structures is difficult, since collectibles are respawned every time a player re-enters a
- * room, so the `PtrHash` will change. Instead, we use a 4-tuple of the room list index, the grid
- * index of the collectible in the room, the collectible's SubType, and the collectible's InitSeed.
+ * Mods may have to keep track of data relating to a collectible. Finding an index for these kinds
+ * of data structures is difficult, since collectibles are respawned every time a player re-enters a
+ * room (like all other pickups), so the `PtrHash` will change.
+ *
+ * Use this function to get a unique index for a collectible to use in these data structures.
+ *
+ * If your mod is upgraded, then you should use the `getPickupIndex` function instead, as it is more
+ * general purpose and less prone to error (but relies on stateful tracking of pickups as the run
+ * progresses).
+ *
+ * Collectibles are a special case of pickups: they cannot be pushed around. (They actually can be
+ * pushed, but usually will stay on the same grid index.) Thus, it is possible to generate a
+ * somewhat reliable non-stateful index for collectibles. We use a 4-tuple of the room list index,
+ * the grid index of the collectible in the room, the collectible's `SubType`, and the collectible's
+ * `InitSeed`.
  *
  * Collectibles that are shifted by Tainted Isaac's mechanic will have unique collectible indexes
- * because the SubType is different. (The collectible entities share the same InitSeed.)
+ * because the `SubType` is different. (The collectible entities share the same `InitSeed` and
+ * `PtrHash`.)
  *
  * Collectibles that are rolled (with e.g. a D6) will have unique collectible indexes because the
- * SubType and InitSeed are different. If you want to track collectibles independently of any
+ * `SubType` and `InitSeed` are different. If you want to track collectibles independently of any
  * rerolls, then you can use the `PtrHash` as an index instead. (The `PtrHash` will not persist
  * between rooms, however.)
  *
  * Note that:
  * - The grid index is a necessary part of the collectible index because Diplopia and Crooked Penny
- *   can cause two or more collectibles with the same SubType and InitSeed to exist in the same
+ *   can cause two or more collectibles with the same `SubType` and `InitSeed` to exist in the same
  *   room.
  * - This index will fail in the case where the player uses Diplopia or a successful Crooked Penny
  *   seven or more times in the same room, since that will cause two or more collectibles with the
- *   same grid index, SubType, and InitSeed to exist.
- * - The SubType is a necessary part of the collectible index because Tainted Isaac will
- *   continuously cause collectibles to morph into new sub-types with the same InitSeed.
+ *   same grid index, `SubType`, and `InitSeed` to exist. (More than seven is required in non-1x1
+ *   rooms.)
+ * - The `SubType` is a necessary part of the collectible index because Tainted Isaac will
+ *   continuously cause collectibles to morph into new sub-types with the same `InitSeed`.
  * - Using a collectible's position as part of the index is problematic, since players can push a
  *   pedestal. (Even using the grid index does not solve this problem, since it is possible in
  *   certain cases for collectibles to be spawned at a position that is not aligned with the grid,
  *   and the pedestal pushed to an adjacent tile, but this case should be extremely rare.)
  * - Mega Chests spawn two collectibles on the exact same position. However, both of them will have
- *   different InitSeeds, so this is not a problem for this indexing scheme.
+ *   a different `InitSeed`, so this is not a problem for this indexing scheme.
  * - The indexing scheme used is different for collectibles that are inside of a Treasure Room or
  *   Boss Room, in order to handle the case of the player seeing the same collectible again in a
- *   post-Ascent Treasure Room or Boss Room. A 5-tuple of stage, stage type, grid index, SubType,
- *   and InitSeed is used in this case. (Using the room list index or the room grid index is not
+ *   post-Ascent Treasure Room or Boss Room. A 5-tuple of stage, stage type, grid index, `SubType`,
+ *   and `InitSeed` is used in this case. (Using the room list index or the room grid index is not
  *   suitable for this purpose, since both of these values can change in the post-Ascent rooms.)
  *   Even though Treasure Rooms and Boss Rooms are grouped together in this scheme, there probably
  *   will not be collectibles with the same grid index, SubType, and InitSeed.

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":"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"}

package/dist/functions/collectibles.lua

@@ -182,38 +182,51 @@ function ____exports.getCollectibleGfxFilename(self, collectibleType)
     end
     return itemConfigItem.GfxFileName
 end
---- Mods often have to track variables relating to a collectible. Finding an index for these kinds of
--- data structures is difficult, since collectibles are respawned every time a player re-enters a
--- room, so the `PtrHash` will change. Instead, we use a 4-tuple of the room list index, the grid
--- index of the collectible in the room, the collectible's SubType, and the collectible's InitSeed.
+--- Mods may have to keep track of data relating to a collectible. Finding an index for these kinds
+-- of data structures is difficult, since collectibles are respawned every time a player re-enters a
+-- room (like all other pickups), so the `PtrHash` will change.
+-- 
+-- Use this function to get a unique index for a collectible to use in these data structures.
+-- 
+-- If your mod is upgraded, then you should use the `getPickupIndex` function instead, as it is more
+-- general purpose and less prone to error (but relies on stateful tracking of pickups as the run
+-- progresses).
+-- 
+-- Collectibles are a special case of pickups: they cannot be pushed around. (They actually can be
+-- pushed, but usually will stay on the same grid index.) Thus, it is possible to generate a
+-- somewhat reliable non-stateful index for collectibles. We use a 4-tuple of the room list index,
+-- the grid index of the collectible in the room, the collectible's `SubType`, and the collectible's
+-- `InitSeed`.
 -- 
 -- Collectibles that are shifted by Tainted Isaac's mechanic will have unique collectible indexes
--- because the SubType is different. (The collectible entities share the same InitSeed.)
+-- because the `SubType` is different. (The collectible entities share the same `InitSeed` and
+-- `PtrHash`.)
 -- 
 -- Collectibles that are rolled (with e.g. a D6) will have unique collectible indexes because the
--- SubType and InitSeed are different. If you want to track collectibles independently of any
+-- `SubType` and `InitSeed` are different. If you want to track collectibles independently of any
 -- rerolls, then you can use the `PtrHash` as an index instead. (The `PtrHash` will not persist
 -- between rooms, however.)
 -- 
 -- Note that:
 -- - The grid index is a necessary part of the collectible index because Diplopia and Crooked Penny
---   can cause two or more collectibles with the same SubType and InitSeed to exist in the same
+--   can cause two or more collectibles with the same `SubType` and `InitSeed` to exist in the same
 --   room.
 -- - This index will fail in the case where the player uses Diplopia or a successful Crooked Penny
 --   seven or more times in the same room, since that will cause two or more collectibles with the
---   same grid index, SubType, and InitSeed to exist.
--- - The SubType is a necessary part of the collectible index because Tainted Isaac will
---   continuously cause collectibles to morph into new sub-types with the same InitSeed.
+--   same grid index, `SubType`, and `InitSeed` to exist. (More than seven is required in non-1x1
+--   rooms.)
+-- - The `SubType` is a necessary part of the collectible index because Tainted Isaac will
+--   continuously cause collectibles to morph into new sub-types with the same `InitSeed`.
 -- - Using a collectible's position as part of the index is problematic, since players can push a
 --   pedestal. (Even using the grid index does not solve this problem, since it is possible in
 --   certain cases for collectibles to be spawned at a position that is not aligned with the grid,
 --   and the pedestal pushed to an adjacent tile, but this case should be extremely rare.)
 -- - Mega Chests spawn two collectibles on the exact same position. However, both of them will have
---   different InitSeeds, so this is not a problem for this indexing scheme.
+--   a different `InitSeed`, so this is not a problem for this indexing scheme.
 -- - The indexing scheme used is different for collectibles that are inside of a Treasure Room or
 --   Boss Room, in order to handle the case of the player seeing the same collectible again in a
---   post-Ascent Treasure Room or Boss Room. A 5-tuple of stage, stage type, grid index, SubType,
---   and InitSeed is used in this case. (Using the room list index or the room grid index is not
+--   post-Ascent Treasure Room or Boss Room. A 5-tuple of stage, stage type, grid index, `SubType`,
+--   and `InitSeed` is used in this case. (Using the room list index or the room grid index is not
 --   suitable for this purpose, since both of these values can change in the post-Ascent rooms.)
 --   Even though Treasure Rooms and Boss Rooms are grouped together in this scheme, there probably
 --   will not be collectibles with the same grid index, SubType, and InitSeed.

package/dist/functions/entities.d.ts

@@ -65,10 +65,10 @@ export declare function getClosestEntityTo<T extends AnyEntity>(referenceEntity:
 export declare function getEntities(entityType?: EntityType, variant?: number, subType?: number, ignoreFriendly?: boolean): Entity[];
 /**
  * Helper function to get all the fields on an entity. For example, this is useful for comparing it
- * to another entity later.
+ * to another entity later. (One option is to use the `logTableDifferences` function for this.)
  *
- * This function will only get fields that are equal to booleans, numbers, or strings, as comparing
- * other types is non-trivial.
+ * This function will only get fields that are equal to booleans, numbers, or strings, or Vectors,
+ * as comparing other types is non-trivial.
  */
 export declare function getEntityFields(entity: Entity): LuaMap<string, boolean | number | string>;
 /** Helper function to return a string containing the entity's type, variant, and sub-type. */

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

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

package/dist/functions/entities.lua

@@ -20,6 +20,9 @@ local isRNG = ____rng.isRNG
 local newRNG = ____rng.newRNG
 local ____types = require("functions.types")
 local isPrimitive = ____types.isPrimitive
+local ____vector = require("functions.vector")
+local isVector = ____vector.isVector
+local vectorToString = ____vector.vectorToString
 function setPrimitiveEntityFields(self, entity, metatable, entityFields)
     local propGetTable = metatable.__propget
     if propGetTable == nil then
@@ -30,6 +33,8 @@ function setPrimitiveEntityFields(self, entity, metatable, entityFields)
         local value = entity[indexKey]
         if isPrimitive(nil, value) then
             entityFields[indexKey] = value
+        elseif isVector(nil, value) then
+            entityFields[indexKey] = vectorToString(nil, value)
         end
     end
 end
@@ -180,10 +185,10 @@ function ____exports.getEntities(self, entityType, variant, subType, ignoreFrien
     return Isaac.FindByType(entityType, variant, subType, ignoreFriendly)
 end
 --- Helper function to get all the fields on an entity. For example, this is useful for comparing it
--- to another entity later.
+-- to another entity later. (One option is to use the `logTableDifferences` function for this.)
 -- 
--- This function will only get fields that are equal to booleans, numbers, or strings, as comparing
--- other types is non-trivial.
+-- This function will only get fields that are equal to booleans, numbers, or strings, or Vectors,
+-- as comparing other types is non-trivial.
 function ____exports.getEntityFields(self, entity)
     local entityFields = {}
     local metatable = getmetatable(entity)