isaacscript-common 1.2.193 → 1.2.196

package/dist/functions/player.lua

@@ -1,31 +1,23 @@
 local ____lualib = require("lualib_bundle")
+local __TS__ArraySome = ____lualib.__TS__ArraySome
 local Set = ____lualib.Set
 local __TS__New = ____lualib.__TS__New
-local __TS__ArraySome = ____lualib.__TS__ArraySome
 local __TS__ArrayFind = ____lualib.__TS__ArrayFind
-local __TS__ArrayPush = ____lualib.__TS__ArrayPush
 local __TS__ArrayMap = ____lualib.__TS__ArrayMap
+local __TS__ArrayPush = ____lualib.__TS__ArrayPush
 local Map = ____lualib.Map
 local __TS__Iterator = ____lualib.__TS__Iterator
 local __TS__ArrayFilter = ____lualib.__TS__ArrayFilter
 local __TS__ArrayEvery = ____lualib.__TS__ArrayEvery
 local ____exports = {}
-local getPlayerIndexCollectibleType, isTaintedModded, DEFAULT_COLLECTIBLE_TYPE, EXCLUDED_CHARACTERS
+local isTaintedModded
 local ____cachedClasses = require("cachedClasses")
 local game = ____cachedClasses.game
 local itemConfig = ____cachedClasses.itemConfig
 local ____constants = require("constants")
-local CHARACTERS_WITH_BLACK_HEART_FROM_ETERNAL_HEART = ____constants.CHARACTERS_WITH_BLACK_HEART_FROM_ETERNAL_HEART
-local CHARACTERS_WITH_FREE_DEVIL_DEALS = ____constants.CHARACTERS_WITH_FREE_DEVIL_DEALS
-local CHARACTERS_WITH_NO_RED_HEARTS = ____constants.CHARACTERS_WITH_NO_RED_HEARTS
-local CHARACTERS_WITH_NO_SOUL_HEARTS = ____constants.CHARACTERS_WITH_NO_SOUL_HEARTS
-local LOST_STYLE_PLAYER_TYPES = ____constants.LOST_STYLE_PLAYER_TYPES
 local MAX_VANILLA_CHARACTER = ____constants.MAX_VANILLA_CHARACTER
 local ____HealthType = require("enums.HealthType")
 local HealthType = ____HealthType.HealthType
-local ____characterNames = require("objects.characterNames")
-local CHARACTER_NAMES = ____characterNames.CHARACTER_NAMES
-local DEFAULT_CHARACTER_NAME = ____characterNames.DEFAULT_CHARACTER_NAME
 local ____array = require("functions.array")
 local getLastElement = ____array.getLastElement
 local sumArray = ____array.sumArray
@@ -33,92 +25,30 @@ local ____bitwise = require("functions.bitwise")
 local countSetBits = ____bitwise.countSetBits
 local getKBitOfN = ____bitwise.getKBitOfN
 local getNumBitsOfN = ____bitwise.getNumBitsOfN
+local ____character = require("functions.character")
+local getCharacterMaxHeartContainers = ____character.getCharacterMaxHeartContainers
+local getCharacterName = ____character.getCharacterName
 local ____collectibles = require("functions.collectibles")
 local getCollectibleMaxCharges = ____collectibles.getCollectibleMaxCharges
 local ____collectibleSet = require("functions.collectibleSet")
 local getCollectibleSet = ____collectibleSet.getCollectibleSet
+local ____playerIndex = require("functions.playerIndex")
+local getPlayerIndexVanilla = ____playerIndex.getPlayerIndexVanilla
+local getPlayers = ____playerIndex.getPlayers
 local ____utils = require("functions.utils")
 local ensureAllCases = ____utils.ensureAllCases
 local getEnumValues = ____utils.getEnumValues
 local ____repeat = ____utils["repeat"]
-function ____exports.getAllPlayers(self)
-    local numPlayers = game:GetNumPlayers()
-    local players = {}
-    do
-        local i = 0
-        while i < numPlayers do
-            local player = Isaac.GetPlayer(i)
-            __TS__ArrayPush(players, player)
-            i = i + 1
-        end
-    end
-    return players
-end
-function ____exports.getCharacterMaxHeartContainers(self, character)
-    if character == PlayerType.PLAYER_KEEPER then
-        return 3
-    end
-    if character == PlayerType.PLAYER_THEFORGOTTEN then
-        return 6
-    end
-    if character == PlayerType.PLAYER_THESOUL then
-        return 6
-    end
-    if character == PlayerType.PLAYER_KEEPER_B then
-        return 2
-    end
-    return 12
-end
 function ____exports.getCharacters(self)
-    local players = ____exports.getPlayers(nil)
+    local players = getPlayers(nil)
     return __TS__ArrayMap(
         players,
         function(____, player) return player:GetPlayerType() end
     )
 end
-function ____exports.getPlayerIndex(self, player, differentiateForgottenAndSoul)
-    if differentiateForgottenAndSoul == nil then
-        differentiateForgottenAndSoul = false
-    end
-    local playerToUse = player
-    local isSubPlayer = player:IsSubPlayer()
-    if isSubPlayer then
-        local playerParent = ____exports.getSubPlayerParent(nil, player)
-        if playerParent ~= nil then
-            playerToUse = playerParent
-        end
-    end
-    local collectibleType = getPlayerIndexCollectibleType(nil, player, differentiateForgottenAndSoul)
-    local collectibleRNG = playerToUse:GetCollectibleRNG(collectibleType)
-    local seed = collectibleRNG:GetSeed()
-    return seed
-end
-function getPlayerIndexCollectibleType(self, player, differentiateForgottenAndSoul)
-    local character = player:GetPlayerType()
-    repeat
-        local ____switch73 = character
-        local ____cond73 = ____switch73 == PlayerType.PLAYER_THESOUL
-        if ____cond73 then
-            do
-                return differentiateForgottenAndSoul and CollectibleType.COLLECTIBLE_SPOON_BENDER or DEFAULT_COLLECTIBLE_TYPE
-            end
-        end
-        ____cond73 = ____cond73 or ____switch73 == PlayerType.PLAYER_LAZARUS2_B
-        if ____cond73 then
-            do
-                return CollectibleType.COLLECTIBLE_INNER_EYE
-            end
-        end
-        do
-            do
-                return DEFAULT_COLLECTIBLE_TYPE
-            end
-        end
-    until true
-end
 function ____exports.getPlayerMaxHeartContainers(self, player)
     local character = player:GetPlayerType()
-    local characterMaxHeartContainers = ____exports.getCharacterMaxHeartContainers(nil, character)
+    local characterMaxHeartContainers = getCharacterMaxHeartContainers(nil, character)
     if character == PlayerType.PLAYER_MAGDALENE and player:HasCollectible(CollectibleType.COLLECTIBLE_BIRTHRIGHT) then
         local extraMaxHeartContainersFromBirthright = 6
         return characterMaxHeartContainers + extraMaxHeartContainersFromBirthright
@@ -132,42 +62,6 @@ function ____exports.getPlayerMaxHeartContainers(self, player)
     end
     return characterMaxHeartContainers
 end
-function ____exports.getPlayers(self, performCharacterExclusions)
-    if performCharacterExclusions == nil then
-        performCharacterExclusions = false
-    end
-    local players = ____exports.getAllPlayers(nil)
-    local nonChildPlayers = __TS__ArrayFilter(
-        players,
-        function(____, player) return not ____exports.isChildPlayer(nil, player) end
-    )
-    local nonChildPlayersFiltered = __TS__ArrayFilter(
-        nonChildPlayers,
-        function(____, player)
-            local character = player:GetPlayerType()
-            return not EXCLUDED_CHARACTERS:has(character)
-        end
-    )
-    return performCharacterExclusions and nonChildPlayersFiltered or nonChildPlayers
-end
-function ____exports.getSubPlayerParent(self, subPlayer)
-    local subPlayerPtrHash = GetPtrHash(subPlayer)
-    local players = ____exports.getPlayers(nil)
-    return __TS__ArrayFind(
-        players,
-        function(____, player)
-            local thisPlayerSubPlayer = player:GetSubPlayer()
-            if thisPlayerSubPlayer == nil then
-                return false
-            end
-            local thisPlayerSubPlayerPtrHash = GetPtrHash(thisPlayerSubPlayer)
-            return thisPlayerSubPlayerPtrHash == subPlayerPtrHash
-        end
-    )
-end
-function ____exports.isChildPlayer(self, player)
-    return player.Parent ~= nil
-end
 function ____exports.isKeeper(self, player)
     local character = player:GetPlayerType()
     return character == PlayerType.PLAYER_KEEPER or character == PlayerType.PLAYER_KEEPER_B
@@ -185,8 +79,6 @@ end
 function ____exports.isVanillaCharacter(self, player)
     return not ____exports.isModdedCharacter(nil, player)
 end
-DEFAULT_COLLECTIBLE_TYPE = CollectibleType.COLLECTIBLE_SAD_ONION
-EXCLUDED_CHARACTERS = __TS__New(Set, {PlayerType.PLAYER_ESAU, PlayerType.PLAYER_THESOUL_B})
 function ____exports.addCollectibleCostume(self, player, collectibleType)
     local itemConfigItem = itemConfig:GetCollectible(collectibleType)
     if itemConfigItem == nil then
@@ -202,14 +94,14 @@ function ____exports.addTrinketCostume(self, player, trinketType)
     player:AddCostume(itemConfigTrinket, false)
 end
 function ____exports.anyPlayerHasCollectible(self, collectibleType)
-    local players = ____exports.getPlayers(nil)
+    local players = getPlayers(nil)
     return __TS__ArraySome(
         players,
         function(____, player) return player:HasCollectible(collectibleType) end
     )
 end
 function ____exports.anyPlayerHasTrinket(self, trinketType)
-    local players = ____exports.getPlayers(nil)
+    local players = getPlayers(nil)
     return __TS__ArraySome(
         players,
         function(____, player) return player:HasTrinket(trinketType) end
@@ -228,19 +120,6 @@ function ____exports.canPlayerCrushRocks(self, player)
     local effects = player:GetEffects()
     return player:HasCollectible(CollectibleType.COLLECTIBLE_LEO) or player:HasCollectible(CollectibleType.COLLECTIBLE_THUNDER_THIGHS) or effects:HasCollectibleEffect(CollectibleType.COLLECTIBLE_MEGA_MUSH) or player:HasPlayerForm(PlayerForm.PLAYERFORM_STOMPY)
 end
-function ____exports.canTakeFreeDevilDeals(self, player)
-    local character = player:GetPlayerType()
-    return CHARACTERS_WITH_FREE_DEVIL_DEALS:has(character)
-end
-function ____exports.characterCanHaveRedHearts(self, character)
-    return not CHARACTERS_WITH_NO_RED_HEARTS:has(character)
-end
-function ____exports.characterCanHaveSoulHearts(self, character)
-    return not CHARACTERS_WITH_NO_SOUL_HEARTS:has(character)
-end
-function ____exports.characterGetsBlackHeartFromEternalHeart(self, character)
-    return CHARACTERS_WITH_BLACK_HEART_FROM_ETERNAL_HEART:has(character)
-end
 function ____exports.getActiveItemSlot(self, player, collectibleType)
     local activeSlots = getEnumValues(nil, ActiveSlot)
     return __TS__ArrayFind(
@@ -259,22 +138,10 @@ function ____exports.getAzazelBrimstoneDistance(self, playerOrTearHeight)
     end
     return 32 - 2.5 * tearHeight
 end
-function ____exports.getBlackHearts(self, player)
-    local blackHeartsBitmask = player:GetBlackHearts()
-    local blackHeartBits = countSetBits(nil, blackHeartsBitmask)
-    return blackHeartBits * 2
-end
-function ____exports.getCharacterName(self, character)
-    if character >= PlayerType.NUM_PLAYER_TYPES then
-        return "unknown"
-    end
-    local characterName = CHARACTER_NAMES[character]
-    return characterName == nil and DEFAULT_CHARACTER_NAME or characterName
-end
 function ____exports.getClosestPlayer(self, position)
     local closestPlayer = nil
     local closestDistance = math.huge
-    for ____, player in ipairs(____exports.getPlayers(nil)) do
+    for ____, player in ipairs(getPlayers(nil)) do
         local distance = position:Distance(player.Position)
         if distance < closestDistance then
             closestPlayer = player
@@ -286,16 +153,6 @@ function ____exports.getClosestPlayer(self, position)
     end
     return closestPlayer
 end
-function ____exports.getDeathAnimationName(self, player)
-    local character = player:GetPlayerType()
-    if LOST_STYLE_PLAYER_TYPES:has(character) then
-        return "LostDeath"
-    end
-    if character == PlayerType.PLAYER_THEFORGOTTEN_B then
-        return "ForgottenDeath"
-    end
-    return "Death"
-end
 function ____exports.getEffectsList(self, player)
     local effects = player:GetEffects()
     local effectsList = effects:GetEffectsList()
@@ -313,59 +170,13 @@ function ____exports.getEffectsList(self, player)
     return effectArray
 end
 function ____exports.getFinalPlayer(self)
-    local players = ____exports.getPlayers(nil)
+    local players = getPlayers(nil)
     return getLastElement(nil, players)
 end
-function ____exports.getHearts(self, player)
-    local rottenHearts = player:GetRottenHearts()
-    local hearts = player:GetHearts()
-    return hearts - rottenHearts * 2
-end
-function ____exports.getLastHeart(self, player)
-    local hearts = player:GetHearts()
-    local effectiveMaxHearts = player:GetEffectiveMaxHearts()
-    local soulHearts = player:GetSoulHearts()
-    local blackHearts = player:GetBlackHearts()
-    local eternalHearts = player:GetEternalHearts()
-    local boneHearts = player:GetBoneHearts()
-    local rottenHearts = player:GetRottenHearts()
-    local soulHeartSlots = soulHearts / 2
-    local lastHeartIndex = boneHearts + soulHeartSlots - 1
-    local isLastHeartBone = player:IsBoneHeart(lastHeartIndex)
-    if isLastHeartBone then
-        local isLastContainerEmpty = hearts <= effectiveMaxHearts - 2
-        if isLastContainerEmpty then
-            return HealthType.BONE
-        end
-        if rottenHearts > 0 then
-            return HealthType.ROTTEN
-        end
-        if eternalHearts > 0 then
-            return HealthType.ETERNAL
-        end
-        return HealthType.RED
-    end
-    if soulHearts > 0 then
-        local numBits = getNumBitsOfN(nil, blackHearts)
-        local finalBit = getKBitOfN(nil, numBits - 1, blackHearts)
-        local isBlack = finalBit == 1
-        if isBlack then
-            return HealthType.BLACK
-        end
-        return HealthType.SOUL
-    end
-    if eternalHearts > 0 then
-        return HealthType.ETERNAL
-    end
-    if rottenHearts > 0 then
-        return HealthType.ROTTEN
-    end
-    return HealthType.RED
-end
 function ____exports.getNewestPlayer(self)
     local newestPlayer = nil
     local lowestFrame = math.huge
-    for ____, player in ipairs(____exports.getPlayers(nil)) do
+    for ____, player in ipairs(getPlayers(nil)) do
         if player.FrameCount < lowestFrame then
             newestPlayer = player
             lowestFrame = player.FrameCount
@@ -387,8 +198,13 @@ function ____exports.getPlayerAvailableHeartSlots(self, player)
     local totalOccupiedHeartSlots = totalHeartContainers + brokenHearts
     return maxHeartContainers - totalOccupiedHeartSlots
 end
+function ____exports.getPlayerBlackHearts(self, player)
+    local blackHeartsBitmask = player:GetBlackHearts()
+    local blackHeartBits = countSetBits(nil, blackHeartsBitmask)
+    return blackHeartBits * 2
+end
 function ____exports.getPlayerCloserThan(self, position, distance)
-    local players = ____exports.getPlayers(nil)
+    local players = getPlayers(nil)
     return __TS__ArrayFind(
         players,
         function(____, player) return player.Position:Distance(position) <= distance end
@@ -405,32 +221,55 @@ function ____exports.getPlayerCollectibleMap(self, player)
     end
     return collectibleMap
 end
-function ____exports.getPlayerFromIndex(self, playerIndex)
-    local players = ____exports.getPlayers(nil)
-    return __TS__ArrayFind(
-        players,
-        function(____, player) return ____exports.getPlayerIndex(nil, player) == playerIndex end
-    )
+function ____exports.getPlayerHearts(self, player)
+    local rottenHearts = player:GetRottenHearts()
+    local hearts = player:GetHearts()
+    return hearts - rottenHearts * 2
 end
-function ____exports.getPlayerIndexVanilla(self, playerToFind)
-    local numPlayers = game:GetNumPlayers()
-    local playerToFindHash = GetPtrHash(playerToFind)
-    do
-        local i = 0
-        while i < numPlayers do
-            local player = Isaac.GetPlayer(i)
-            local playerHash = GetPtrHash(player)
-            if playerHash == playerToFindHash then
-                return i
-            end
-            i = i + 1
+function ____exports.getPlayerLastHeart(self, player)
+    local hearts = player:GetHearts()
+    local effectiveMaxHearts = player:GetEffectiveMaxHearts()
+    local soulHearts = player:GetSoulHearts()
+    local blackHearts = player:GetBlackHearts()
+    local eternalHearts = player:GetEternalHearts()
+    local boneHearts = player:GetBoneHearts()
+    local rottenHearts = player:GetRottenHearts()
+    local soulHeartSlots = soulHearts / 2
+    local lastHeartIndex = boneHearts + soulHeartSlots - 1
+    local isLastHeartBone = player:IsBoneHeart(lastHeartIndex)
+    if isLastHeartBone then
+        local isLastContainerEmpty = hearts <= effectiveMaxHearts - 2
+        if isLastContainerEmpty then
+            return HealthType.BONE
+        end
+        if rottenHearts > 0 then
+            return HealthType.ROTTEN
+        end
+        if eternalHearts > 0 then
+            return HealthType.ETERNAL
         end
+        return HealthType.RED
     end
-    return nil
+    if soulHearts > 0 then
+        local numBits = getNumBitsOfN(nil, blackHearts)
+        local finalBit = getKBitOfN(nil, numBits - 1, blackHearts)
+        local isBlack = finalBit == 1
+        if isBlack then
+            return HealthType.BLACK
+        end
+        return HealthType.SOUL
+    end
+    if eternalHearts > 0 then
+        return HealthType.ETERNAL
+    end
+    if rottenHearts > 0 then
+        return HealthType.ROTTEN
+    end
+    return HealthType.RED
 end
 function ____exports.getPlayerName(self, player)
     local character = player:GetPlayerType()
-    return character >= PlayerType.NUM_PLAYER_TYPES and player:GetName() or ____exports.getCharacterName(nil, character)
+    return character >= PlayerType.NUM_PLAYER_TYPES and player:GetName() or getCharacterName(nil, character)
 end
 function ____exports.getPlayerNumHitsRemaining(self, player)
     local hearts = player:GetHearts()
@@ -440,10 +279,15 @@ function ____exports.getPlayerNumHitsRemaining(self, player)
     local rottenHearts = player:GetRottenHearts()
     return hearts + soulHearts + boneHearts + eternalHearts - rottenHearts
 end
+function ____exports.getPlayerSoulHearts(self, player)
+    local soulHearts = player:GetSoulHearts()
+    local blackHearts = ____exports.getPlayerBlackHearts(nil, player)
+    return soulHearts - blackHearts
+end
 function ____exports.getPlayersOfType(self, ...)
     local characters = {...}
     local charactersSet = __TS__New(Set, characters)
-    local players = ____exports.getPlayers(nil)
+    local players = getPlayers(nil)
     return __TS__ArrayFilter(
         players,
         function(____, player)
@@ -454,7 +298,7 @@ function ____exports.getPlayersOfType(self, ...)
 end
 function ____exports.getPlayersWithCollectible(self, ...)
     local collectibleTypes = {...}
-    local players = ____exports.getPlayers(nil)
+    local players = getPlayers(nil)
     return __TS__ArrayFilter(
         players,
         function(____, player) return __TS__ArrayEvery(
@@ -463,11 +307,6 @@ function ____exports.getPlayersWithCollectible(self, ...)
         ) end
     )
 end
-function ____exports.getSoulHearts(self, player)
-    local soulHearts = player:GetSoulHearts()
-    local blackHearts = ____exports.getBlackHearts(nil, player)
-    return soulHearts - blackHearts
-end
 function ____exports.getTaintedMagdaleneNonTemporaryMaxHearts(self, player)
     local maxHearts = player:GetMaxHearts()
     local hasBirthright = player:HasCollectible(CollectibleType.COLLECTIBLE_BIRTHRIGHT)
@@ -475,7 +314,7 @@ function ____exports.getTaintedMagdaleneNonTemporaryMaxHearts(self, player)
     return math.min(maxHearts, maxNonTemporaryMaxHearts)
 end
 function ____exports.getTotalPlayerCollectibles(self, collectibleType)
-    local players = ____exports.getPlayers(nil)
+    local players = getPlayers(nil)
     local numCollectiblesArray = __TS__ArrayMap(
         players,
         function(____, player) return player:GetCollectibleNum(collectibleType) end
@@ -484,7 +323,7 @@ function ____exports.getTotalPlayerCollectibles(self, collectibleType)
 end
 function ____exports.hasLostCurse(self, player)
     local effects = player:GetEffects()
-    return effects:HasNullEffect(NullItemID.ID_LOST_CURSE)
+    return effects:HasNullEffect(112)
 end
 function ____exports.hasOpenActiveItemSlot(self, player)
     local character = player:GetPlayerType()
@@ -512,7 +351,7 @@ function ____exports.isEden(self, player)
     return character == PlayerType.PLAYER_EDEN or character == PlayerType.PLAYER_EDEN_B
 end
 function ____exports.isFirstPlayer(self, player)
-    return ____exports.getPlayerIndexVanilla(nil, player) == 0
+    return getPlayerIndexVanilla(nil, player) == 0
 end
 function ____exports.isJacobOrEsau(self, player)
     local character = player:GetPlayerType()
@@ -574,9 +413,9 @@ function ____exports.setActiveItem(self, player, collectibleType, activeSlot, ch
         itemPool:RemoveCollectible(collectibleType)
     end
     repeat
-        local ____switch126 = activeSlot
-        local ____cond126 = ____switch126 == ActiveSlot.SLOT_PRIMARY
-        if ____cond126 then
+        local ____switch90 = activeSlot
+        local ____cond90 = ____switch90 == ActiveSlot.SLOT_PRIMARY
+        if ____cond90 then
             do
                 if primaryCollectibleType ~= CollectibleType.COLLECTIBLE_NULL then
                     player:RemoveCollectible(primaryCollectibleType)
@@ -585,8 +424,8 @@ function ____exports.setActiveItem(self, player, collectibleType, activeSlot, ch
                 break
             end
         end
-        ____cond126 = ____cond126 or ____switch126 == ActiveSlot.SLOT_SECONDARY
-        if ____cond126 then
+        ____cond90 = ____cond90 or ____switch90 == ActiveSlot.SLOT_SECONDARY
+        if ____cond90 then
             do
                 if primaryCollectibleType ~= CollectibleType.COLLECTIBLE_NULL then
                     player:RemoveCollectible(primaryCollectibleType)
@@ -601,16 +440,16 @@ function ____exports.setActiveItem(self, player, collectibleType, activeSlot, ch
                 break
             end
         end
-        ____cond126 = ____cond126 or ____switch126 == ActiveSlot.SLOT_POCKET
-        if ____cond126 then
+        ____cond90 = ____cond90 or ____switch90 == ActiveSlot.SLOT_POCKET
+        if ____cond90 then
             do
                 player:SetPocketActiveItem(collectibleType, activeSlot, keepInPools)
                 player:SetActiveCharge(charge, activeSlot)
                 break
             end
         end
-        ____cond126 = ____cond126 or ____switch126 == ActiveSlot.SLOT_POCKET2
-        if ____cond126 then
+        ____cond90 = ____cond90 or ____switch90 == ActiveSlot.SLOT_POCKET2
+        if ____cond90 then
             do
                 player:SetPocketActiveItem(collectibleType, activeSlot, keepInPools)
                 break
@@ -634,14 +473,14 @@ function ____exports.setBlindfold(self, player, enabled, modifyCostume)
         player:ChangePlayerType(character)
         game.Challenge = challenge
         if not modifyCostume then
-            player:TryRemoveNullCostume(NullItemID.ID_BLINDFOLD)
+            player:TryRemoveNullCostume(14)
         end
     else
         game.Challenge = Challenge.CHALLENGE_NULL
         player:ChangePlayerType(character)
         game.Challenge = challenge
         if modifyCostume then
-            player:TryRemoveNullCostume(NullItemID.ID_BLINDFOLD)
+            player:TryRemoveNullCostume(14)
         end
     end
 end

package/dist/functions/playerDataStructures.lua

@@ -2,8 +2,8 @@ local ____lualib = require("lualib_bundle")
 local Map = ____lualib.Map
 local Set = ____lualib.Set
 local ____exports = {}
-local ____player = require("functions.player")
-local getPlayerIndex = ____player.getPlayerIndex
+local ____playerIndex = require("functions.playerIndex")
+local getPlayerIndex = ____playerIndex.getPlayerIndex
 function ____exports.defaultMapGetPlayer(self, map, player, ...)
     local playerIndex = getPlayerIndex(nil, player)
     return map:getAndSetDefault(playerIndex, ...)

package/dist/functions/playerHealth.lua

@@ -7,9 +7,9 @@ local MAX_PLAYER_HEART_CONTAINERS = ____constants.MAX_PLAYER_HEART_CONTAINERS
 local ____HealthType = require("enums.HealthType")
 local HealthType = ____HealthType.HealthType
 local ____player = require("functions.player")
-local getBlackHearts = ____player.getBlackHearts
-local getHearts = ____player.getHearts
-local getSoulHearts = ____player.getSoulHearts
+local getPlayerBlackHearts = ____player.getPlayerBlackHearts
+local getPlayerHearts = ____player.getPlayerHearts
+local getPlayerSoulHearts = ____player.getPlayerSoulHearts
 local ____utils = require("functions.utils")
 local ensureAllCases = ____utils.ensureAllCases
 local ____repeat = ____utils["repeat"]
@@ -90,7 +90,7 @@ function ____exports.getPlayerHealth(self, player)
     local character = player:GetPlayerType()
     local soulHeartTypes = {}
     local maxHearts = player:GetMaxHearts()
-    local hearts = getHearts(nil, player)
+    local hearts = getPlayerHearts(nil, player)
     local soulHearts = player:GetSoulHearts()
     local boneHearts = player:GetBoneHearts()
     local goldenHearts = player:GetGoldenHearts()
@@ -154,13 +154,13 @@ function ____exports.getPlayerHealthType(self, player, healthType)
         local ____cond25 = ____switch25 == HealthType.RED
         if ____cond25 then
             do
-                return getHearts(nil, player)
+                return getPlayerHearts(nil, player)
             end
         end
         ____cond25 = ____cond25 or ____switch25 == HealthType.SOUL
         if ____cond25 then
             do
-                return getSoulHearts(nil, player)
+                return getPlayerSoulHearts(nil, player)
             end
         end
         ____cond25 = ____cond25 or ____switch25 == HealthType.ETERNAL
@@ -172,7 +172,7 @@ function ____exports.getPlayerHealthType(self, player, healthType)
         ____cond25 = ____cond25 or ____switch25 == HealthType.BLACK
         if ____cond25 then
             do
-                return getBlackHearts(nil, player)
+                return getPlayerBlackHearts(nil, player)
             end
         end
         ____cond25 = ____cond25 or ____switch25 == HealthType.GOLDEN

package/dist/functions/playerIndex.d.ts

@@ -0,0 +1,67 @@
+/// <reference types="isaac-typescript-definitions" />
+import { PlayerIndex } from "../types/PlayerIndex";
+/**
+ * Helper function to get every player with no restrictions, by using `Game.GetNumPlayers` and
+ * `Isaac.GetPlayer`.
+ *
+ * This function is almost never what you want to use. For most purposes, use the `getPlayers`
+ * helper function instead to get a filtered list of players.
+ */
+export declare function getAllPlayers(): EntityPlayer[];
+export declare function getPlayerFromIndex(playerIndex: PlayerIndex): EntityPlayer | undefined;
+/**
+ * Mods often have to track variables relating to the player. In naive mods, information will only
+ * be stored about the first player. However, in order to be robust, mods must handle up to 4
+ * players playing at the same time. This means that information must be stored on a map data
+ * structure. Finding a good index for these types of map data structures is difficult:
+ *
+ * - We cannot use the index from `Isaac.GetPlayer(i)` since this fails in the case where there are
+ *   two players and the first player leaves the run.
+ * - We cannot use `EntityPlayer.ControllerIndex` as an index because it fails in the case of Jacob
+ *   & Esau or Tainted Forgotten. It also fails in the case of a player changing their controls
+ *   mid-run.
+ * - We cannot use `EntityPlayer.GetData().index` because it does not persist across saving and
+ *   continuing.
+ * - We cannot use `GetPtrHash()` as an index because it does not persist across exiting and
+ *   relaunching the game.
+ * - We cannot use `EntityPlayer.InitSeed` because it is not consistent with additional players
+ *   beyond the first.
+ *
+ * Instead, we use the `EntityPlayer.GetCollectibleRNG` method with an arbitrary value of Sad Onion
+ * (1). This works even if the player does not have any Sad Onions.
+ *
+ * Since the RNG value is the same for both Tainted Lazarus and Dead Tainted Lazarus, we revert to
+ * using the RNG of The Inner Eye (2) for Dead Tainted Lazarus.
+ *
+ * Note that by default, this returns the same index for both The Forgotten and The Soul. (Even
+ * though they are technically different characters, they share the same inventory and InitSeed.) If
+ * this is not desired, pass true for the `differentiateForgottenAndSoul` argument, and the RNG of
+ * Spoon Bender (3) will be used for The Soul.
+ */
+export declare function getPlayerIndex(player: EntityPlayer, differentiateForgottenAndSoul?: boolean): PlayerIndex;
+/**
+ * Helper function to return the index of this player with respect to the output of the
+ * `Isaac.GetPlayer` method.
+ */
+export declare function getPlayerIndexVanilla(playerToFind: EntityPlayer): int | undefined;
+/**
+ * This function always excludes players with a non-undefined parent, since they are not real
+ * players. (e.g. the Strawman Keeper)
+ *
+ * If this is not desired, use the `getAllPlayers` helper function instead.
+ *
+ * @param performCharacterExclusions Whether or not to exclude characters that are not directly
+ * controlled by the player (i.e. Esau & Tainted Soul). Default is false.
+ */
+export declare function getPlayers(performCharacterExclusions?: boolean): EntityPlayer[];
+/**
+ * Helper function to get a parent `EntityPlayer` object for a given `EntitySubPlayer` object. This
+ * is useful because calling the `EntityPlayer.GetSubPlayer` method on a sub-player object will
+ * return undefined.
+ */
+export declare function getSubPlayerParent(subPlayer: EntitySubPlayer): EntityPlayer | undefined;
+/**
+ * Some players are "child" players, meaning that they have a non-undefined Parent property.
+ * (For example, the Strawman Keeper.)
+ */
+export declare function isChildPlayer(player: EntityPlayer): boolean;