isaacscript-common 2.3.0 → 2.3.1

package/functions/player.lua

@@ -0,0 +1,611 @@
+local ____lualib = require("lualib_bundle")
+local Set = ____lualib.Set
+local __TS__New = ____lualib.__TS__New
+local __TS__ArraySome = ____lualib.__TS__ArraySome
+local __TS__ArrayFind = ____lualib.__TS__ArrayFind
+local __TS__ArrayMap = ____lualib.__TS__ArrayMap
+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 isTaintedModded
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local ActiveSlot = ____isaac_2Dtypescript_2Ddefinitions.ActiveSlot
+local CacheFlag = ____isaac_2Dtypescript_2Ddefinitions.CacheFlag
+local Challenge = ____isaac_2Dtypescript_2Ddefinitions.Challenge
+local CollectibleType = ____isaac_2Dtypescript_2Ddefinitions.CollectibleType
+local NullItemID = ____isaac_2Dtypescript_2Ddefinitions.NullItemID
+local PlayerForm = ____isaac_2Dtypescript_2Ddefinitions.PlayerForm
+local PlayerType = ____isaac_2Dtypescript_2Ddefinitions.PlayerType
+local TrinketType = ____isaac_2Dtypescript_2Ddefinitions.TrinketType
+local ____cachedClasses = require("cachedClasses")
+local game = ____cachedClasses.game
+local itemConfig = ____cachedClasses.itemConfig
+local ____HealthType = require("enums.HealthType")
+local HealthType = ____HealthType.HealthType
+local ____array = require("functions.array")
+local getLastElement = ____array.getLastElement
+local sumArray = ____array.sumArray
+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 isVanillaCharacter = ____character.isVanillaCharacter
+local ____collectibles = require("functions.collectibles")
+local getCollectibleMaxCharges = ____collectibles.getCollectibleMaxCharges
+local ____collectibleSet = require("functions.collectibleSet")
+local getCollectibleSet = ____collectibleSet.getCollectibleSet
+local ____enums = require("functions.enums")
+local getEnumValues = ____enums.getEnumValues
+local ____playerIndex = require("functions.playerIndex")
+local getPlayerIndexVanilla = ____playerIndex.getPlayerIndexVanilla
+local getPlayers = ____playerIndex.getPlayers
+local ____tears = require("functions.tears")
+local addTearsStat = ____tears.addTearsStat
+local ____utils = require("functions.utils")
+local ensureAllCases = ____utils.ensureAllCases
+local ____repeat = ____utils["repeat"]
+function ____exports.getCharacters(self)
+    local players = getPlayers(nil)
+    return __TS__ArrayMap(
+        players,
+        function(____, player) return player:GetPlayerType() end
+    )
+end
+function ____exports.getPlayerMaxHeartContainers(self, player)
+    local character = player:GetPlayerType()
+    local characterMaxHeartContainers = getCharacterMaxHeartContainers(nil, character)
+    if character == PlayerType.MAGDALENE and player:HasCollectible(CollectibleType.BIRTHRIGHT) then
+        local extraMaxHeartContainersFromBirthright = 6
+        return characterMaxHeartContainers + extraMaxHeartContainersFromBirthright
+    end
+    if ____exports.isKeeper(nil, player) then
+        local numMothersKisses = player:GetTrinketMultiplier(TrinketType.MOTHERS_KISS)
+        local hasGreedsGullet = player:HasCollectible(CollectibleType.GREEDS_GULLET)
+        local coins = player:GetNumCoins()
+        local greedsGulletCoinContainers = hasGreedsGullet and math.floor(coins / 25) or 0
+        return characterMaxHeartContainers + numMothersKisses + greedsGulletCoinContainers
+    end
+    return characterMaxHeartContainers
+end
+function ____exports.isCharacter(self, player, ...)
+    local characters = {...}
+    local characterSet = __TS__New(Set, characters)
+    local character = player:GetPlayerType()
+    return characterSet:has(character)
+end
+function ____exports.isKeeper(self, player)
+    local character = player:GetPlayerType()
+    return character == PlayerType.KEEPER or character == PlayerType.KEEPER_B
+end
+function ____exports.isModdedPlayer(self, player)
+    return not ____exports.isVanillaPlayer(nil, player)
+end
+function isTaintedModded(self, player)
+    local character = player:GetPlayerType()
+    local name = player:GetName()
+    local taintedCharacter = Isaac.GetPlayerTypeByName(name, true)
+    return character == taintedCharacter
+end
+function ____exports.isVanillaPlayer(self, player)
+    local character = player:GetPlayerType()
+    return isVanillaCharacter(nil, character)
+end
+local STAT_CACHE_FLAGS_SET = __TS__New(Set, {
+    CacheFlag.DAMAGE,
+    CacheFlag.FIRE_DELAY,
+    CacheFlag.SHOT_SPEED,
+    CacheFlag.RANGE,
+    CacheFlag.SPEED,
+    CacheFlag.LUCK
+})
+function ____exports.addCollectibleCostume(self, player, collectibleType)
+    local itemConfigItem = itemConfig:GetCollectible(collectibleType)
+    if itemConfigItem == nil then
+        return
+    end
+    player:AddCostume(itemConfigItem, false)
+end
+function ____exports.addStat(self, player, cacheFlag, amount)
+    if not STAT_CACHE_FLAGS_SET:has(cacheFlag) then
+        error("You cannot add a stat to a player with the cache flag of: " .. tostring(cacheFlag))
+    end
+    repeat
+        local ____switch6 = cacheFlag
+        local ____cond6 = ____switch6 == CacheFlag.DAMAGE
+        if ____cond6 then
+            do
+                player.Damage = player.Damage + amount
+                break
+            end
+        end
+        ____cond6 = ____cond6 or ____switch6 == CacheFlag.FIRE_DELAY
+        if ____cond6 then
+            do
+                addTearsStat(nil, player, amount)
+                break
+            end
+        end
+        ____cond6 = ____cond6 or ____switch6 == CacheFlag.SHOT_SPEED
+        if ____cond6 then
+            do
+                player.ShotSpeed = player.ShotSpeed + amount
+                break
+            end
+        end
+        ____cond6 = ____cond6 or ____switch6 == CacheFlag.RANGE
+        if ____cond6 then
+            do
+                player.TearHeight = player.TearHeight + amount
+                break
+            end
+        end
+        ____cond6 = ____cond6 or ____switch6 == CacheFlag.SPEED
+        if ____cond6 then
+            do
+                player.MoveSpeed = player.MoveSpeed + amount
+                break
+            end
+        end
+        ____cond6 = ____cond6 or ____switch6 == CacheFlag.LUCK
+        if ____cond6 then
+            do
+                player.Luck = player.Luck + amount
+                break
+            end
+        end
+        do
+            do
+                break
+            end
+        end
+    until true
+end
+function ____exports.addTrinketCostume(self, player, trinketType)
+    local itemConfigTrinket = itemConfig:GetTrinket(trinketType)
+    if itemConfigTrinket == nil then
+        return
+    end
+    player:AddCostume(itemConfigTrinket, false)
+end
+function ____exports.anyPlayerHasCollectible(self, collectibleType)
+    local players = getPlayers(nil)
+    return __TS__ArraySome(
+        players,
+        function(____, player) return player:HasCollectible(collectibleType) end
+    )
+end
+function ____exports.anyPlayerHasTrinket(self, trinketType)
+    local players = getPlayers(nil)
+    return __TS__ArraySome(
+        players,
+        function(____, player) return player:HasTrinket(trinketType) end
+    )
+end
+function ____exports.anyPlayerIs(self, ...)
+    local matchingCharacters = {...}
+    local matchingCharacterSet = __TS__New(Set, matchingCharacters)
+    local characters = ____exports.getCharacters(nil)
+    return __TS__ArraySome(
+        characters,
+        function(____, character) return matchingCharacterSet:has(character) end
+    )
+end
+function ____exports.canPlayerCrushRocks(self, player)
+    local effects = player:GetEffects()
+    return player:HasCollectible(CollectibleType.LEO) or player:HasCollectible(CollectibleType.THUNDER_THIGHS) or effects:HasCollectibleEffect(CollectibleType.MEGA_MUSH) or player:HasPlayerForm(PlayerForm.STOMPY)
+end
+function ____exports.getActiveItemSlot(self, player, collectibleType)
+    local activeSlots = getEnumValues(nil, ActiveSlot)
+    return __TS__ArrayFind(
+        activeSlots,
+        function(____, activeSlot)
+            local activeItem = player:GetActiveItem(activeSlot)
+            return activeItem == collectibleType
+        end
+    )
+end
+function ____exports.getAzazelBrimstoneDistance(self, playerOrTearHeight)
+    local tearHeight = tonumber(playerOrTearHeight)
+    if tearHeight == nil then
+        local player = playerOrTearHeight
+        tearHeight = player.TearHeight
+    end
+    return 32 - 2.5 * tearHeight
+end
+function ____exports.getClosestPlayer(self, position)
+    local closestPlayer = nil
+    local closestDistance = math.huge
+    for ____, player in ipairs(getPlayers(nil)) do
+        local distance = position:Distance(player.Position)
+        if distance < closestDistance then
+            closestPlayer = player
+            closestDistance = distance
+        end
+    end
+    if closestPlayer == nil then
+        error("Failed to find the closest player.")
+    end
+    return closestPlayer
+end
+function ____exports.getEffectsList(self, player)
+    local effects = player:GetEffects()
+    local effectsList = effects:GetEffectsList()
+    local effectArray = {}
+    do
+        local i = 0
+        while i < effectsList.Size do
+            local effect = effectsList:Get(i)
+            if effect ~= nil then
+                effectArray[#effectArray + 1] = effect
+            end
+            i = i + 1
+        end
+    end
+    return effectArray
+end
+function ____exports.getFinalPlayer(self)
+    local players = getPlayers(nil)
+    local lastPlayer = getLastElement(nil, players)
+    if lastPlayer == nil then
+        error("Failed to get the final player since there were 0 players.")
+    end
+    return lastPlayer
+end
+function ____exports.getNewestPlayer(self)
+    local newestPlayer = nil
+    local lowestFrame = math.huge
+    for ____, player in ipairs(getPlayers(nil)) do
+        if player.FrameCount < lowestFrame then
+            newestPlayer = player
+            lowestFrame = player.FrameCount
+        end
+    end
+    if newestPlayer == nil then
+        error("Failed to find the newest player.")
+    end
+    return newestPlayer
+end
+function ____exports.getPlayerAvailableHeartSlots(self, player)
+    local maxHeartContainers = ____exports.getPlayerMaxHeartContainers(nil, player)
+    local effectiveMaxHearts = player:GetEffectiveMaxHearts()
+    local normalAndBoneHeartContainers = effectiveMaxHearts / 2
+    local soulHearts = player:GetSoulHearts()
+    local soulHeartContainers = math.ceil(soulHearts / 2)
+    local totalHeartContainers = normalAndBoneHeartContainers + soulHeartContainers
+    local brokenHearts = player:GetBrokenHearts()
+    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 = getPlayers(nil)
+    return __TS__ArrayFind(
+        players,
+        function(____, player) return player.Position:Distance(position) <= distance end
+    )
+end
+function ____exports.getPlayerCollectibleCount(self, player, ...)
+    local collectibleTypes = {...}
+    local numCollectibles = 0
+    for ____, collectibleType in ipairs(collectibleTypes) do
+        numCollectibles = numCollectibles + player:GetCollectibleNum(collectibleType, true)
+    end
+    return numCollectibles
+end
+function ____exports.getPlayerCollectibleMap(self, player)
+    local collectibleSet = getCollectibleSet(nil)
+    local collectibleMap = __TS__New(Map)
+    for ____, collectibleType in __TS__Iterator(collectibleSet:values()) do
+        local collectibleNum = player:GetCollectibleNum(collectibleType, true)
+        if collectibleNum > 0 then
+            collectibleMap:set(collectibleType, collectibleNum)
+        end
+    end
+    return collectibleMap
+end
+function ____exports.getPlayerHearts(self, player)
+    local rottenHearts = player:GetRottenHearts()
+    local hearts = player:GetHearts()
+    return hearts - rottenHearts * 2
+end
+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
+    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 ____exports.isModdedPlayer(nil, player) and player:GetName() or getCharacterName(nil, character)
+end
+function ____exports.getPlayerNumHitsRemaining(self, player)
+    local hearts = player:GetHearts()
+    local soulHearts = player:GetSoulHearts()
+    local boneHearts = player:GetBoneHearts()
+    local eternalHearts = player:GetEternalHearts()
+    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 = getPlayers(nil)
+    return __TS__ArrayFilter(
+        players,
+        function(____, player)
+            local character = player:GetPlayerType()
+            return charactersSet:has(character)
+        end
+    )
+end
+function ____exports.getPlayersWithCollectible(self, ...)
+    local collectibleTypes = {...}
+    local players = getPlayers(nil)
+    return __TS__ArrayFilter(
+        players,
+        function(____, player) return __TS__ArrayEvery(
+            collectibleTypes,
+            function(____, collectibleType) return player:HasCollectible(collectibleType) end
+        ) end
+    )
+end
+function ____exports.getPlayersWithTrinket(self, ...)
+    local trinketTypes = {...}
+    local players = getPlayers(nil)
+    return __TS__ArrayFilter(
+        players,
+        function(____, player) return __TS__ArrayEvery(
+            trinketTypes,
+            function(____, trinketType) return player:HasTrinket(trinketType) end
+        ) end
+    )
+end
+function ____exports.getTaintedMagdaleneNonTemporaryMaxHearts(self, player)
+    local maxHearts = player:GetMaxHearts()
+    local hasBirthright = player:HasCollectible(CollectibleType.BIRTHRIGHT)
+    local maxNonTemporaryMaxHearts = hasBirthright and 6 or 4
+    return math.min(maxHearts, maxNonTemporaryMaxHearts)
+end
+function ____exports.getTotalPlayerCollectibles(self, collectibleType)
+    local players = getPlayers(nil)
+    local numCollectiblesArray = __TS__ArrayMap(
+        players,
+        function(____, player) return player:GetCollectibleNum(collectibleType) end
+    )
+    return sumArray(nil, numCollectiblesArray)
+end
+function ____exports.hasLostCurse(self, player)
+    local effects = player:GetEffects()
+    return effects:HasNullEffect(NullItemID.LOST_CURSE)
+end
+function ____exports.hasOpenActiveItemSlot(self, player)
+    if ____exports.isCharacter(nil, player, PlayerType.THE_SOUL_B) then
+        return false
+    end
+    local activeItemPrimary = player:GetActiveItem(ActiveSlot.PRIMARY)
+    local activeItemSecondary = player:GetActiveItem(ActiveSlot.SECONDARY)
+    local hasSchoolbag = player:HasCollectible(CollectibleType.SCHOOLBAG)
+    if hasSchoolbag then
+        return activeItemPrimary == CollectibleType.NULL or activeItemSecondary == CollectibleType.NULL
+    end
+    return activeItemPrimary == CollectibleType.NULL
+end
+function ____exports.isActiveSlotEmpty(self, player, activeSlot)
+    local activeCollectibleType = player:GetActiveItem(activeSlot)
+    return activeCollectibleType == CollectibleType.NULL
+end
+function ____exports.isBethany(self, player)
+    local character = player:GetPlayerType()
+    return character == PlayerType.BETHANY or character == PlayerType.BETHANY_B
+end
+function ____exports.isEden(self, player)
+    local character = player:GetPlayerType()
+    return character == PlayerType.EDEN or character == PlayerType.EDEN_B
+end
+function ____exports.isFirstPlayer(self, player)
+    return getPlayerIndexVanilla(nil, player) == 0
+end
+function ____exports.isJacobOrEsau(self, player)
+    local character = player:GetPlayerType()
+    return character == PlayerType.JACOB or character == PlayerType.ESAU
+end
+function ____exports.isLost(self, player)
+    local character = player:GetPlayerType()
+    return character == PlayerType.THE_LOST or character == PlayerType.THE_LOST_B
+end
+function ____exports.isTainted(self, player)
+    local character = player:GetPlayerType()
+    local ____isVanillaPlayer_result_0
+    if ____exports.isVanillaPlayer(nil, player) then
+        ____isVanillaPlayer_result_0 = character >= PlayerType.ISAAC_B
+    else
+        ____isVanillaPlayer_result_0 = isTaintedModded(nil, player)
+    end
+    return ____isVanillaPlayer_result_0
+end
+function ____exports.isTaintedLazarus(self, player)
+    local character = player:GetPlayerType()
+    return character == PlayerType.LAZARUS_B or character == PlayerType.LAZARUS_2_B
+end
+function ____exports.playerAddCollectible(self, player, ...)
+    local collectibleTypes = {...}
+    for ____, collectibleType in ipairs(collectibleTypes) do
+        player:AddCollectible(collectibleType)
+    end
+end
+function ____exports.playerHasCollectible(self, player, ...)
+    local collectibleTypes = {...}
+    return __TS__ArraySome(
+        collectibleTypes,
+        function(____, collectibleType) return player:HasCollectible(collectibleType) end
+    )
+end
+function ____exports.removeCollectibleCostume(self, player, collectibleType)
+    local itemConfigItem = itemConfig:GetCollectible(collectibleType)
+    if itemConfigItem == nil then
+        return
+    end
+    player:RemoveCostume(itemConfigItem)
+end
+function ____exports.removeDeadEyeMultiplier(self, player)
+    ____repeat(
+        nil,
+        100,
+        function()
+            player:ClearDeadEyeCharge()
+        end
+    )
+end
+function ____exports.removeTrinketCostume(self, player, trinketType)
+    local itemConfigTrinket = itemConfig:GetTrinket(trinketType)
+    if itemConfigTrinket == nil then
+        return
+    end
+    player:RemoveCostume(itemConfigTrinket)
+end
+function ____exports.setActiveItem(self, player, collectibleType, activeSlot, charge, keepInPools)
+    if keepInPools == nil then
+        keepInPools = false
+    end
+    local itemPool = game:GetItemPool()
+    local primaryCollectibleType = player:GetActiveItem(ActiveSlot.PRIMARY)
+    local primaryCharge = player:GetActiveCharge(ActiveSlot.PRIMARY)
+    local secondaryCollectibleType = player:GetActiveItem(ActiveSlot.SECONDARY)
+    if charge == nil then
+        charge = getCollectibleMaxCharges(nil, collectibleType)
+    end
+    if not keepInPools then
+        itemPool:RemoveCollectible(collectibleType)
+    end
+    repeat
+        local ____switch113 = activeSlot
+        local ____cond113 = ____switch113 == ActiveSlot.PRIMARY
+        if ____cond113 then
+            do
+                if primaryCollectibleType ~= CollectibleType.NULL then
+                    player:RemoveCollectible(primaryCollectibleType)
+                end
+                player:AddCollectible(collectibleType, charge, false)
+                break
+            end
+        end
+        ____cond113 = ____cond113 or ____switch113 == ActiveSlot.SECONDARY
+        if ____cond113 then
+            do
+                if primaryCollectibleType ~= CollectibleType.NULL then
+                    player:RemoveCollectible(primaryCollectibleType)
+                end
+                if secondaryCollectibleType ~= CollectibleType.NULL then
+                    player:RemoveCollectible(secondaryCollectibleType)
+                end
+                player:AddCollectible(secondaryCollectibleType, charge, false)
+                if primaryCollectibleType ~= CollectibleType.NULL then
+                    player:AddCollectible(primaryCollectibleType, primaryCharge, false)
+                end
+                break
+            end
+        end
+        ____cond113 = ____cond113 or ____switch113 == ActiveSlot.POCKET
+        if ____cond113 then
+            do
+                player:SetPocketActiveItem(collectibleType, activeSlot, keepInPools)
+                player:SetActiveCharge(charge, activeSlot)
+                break
+            end
+        end
+        ____cond113 = ____cond113 or ____switch113 == ActiveSlot.POCKET_SINGLE_USE
+        if ____cond113 then
+            do
+                player:SetPocketActiveItem(collectibleType, activeSlot, keepInPools)
+                break
+            end
+        end
+        do
+            do
+                ensureAllCases(nil, activeSlot)
+            end
+        end
+    until true
+end
+function ____exports.setBlindfold(self, player, enabled, modifyCostume)
+    if modifyCostume == nil then
+        modifyCostume = true
+    end
+    local character = player:GetPlayerType()
+    local challenge = Isaac.GetChallenge()
+    if enabled then
+        game.Challenge = Challenge.SOLAR_SYSTEM
+        player:ChangePlayerType(character)
+        game.Challenge = challenge
+        if not modifyCostume then
+            player:TryRemoveNullCostume(NullItemID.BLINDFOLD)
+        end
+    else
+        game.Challenge = Challenge.NULL
+        player:ChangePlayerType(character)
+        game.Challenge = challenge
+        if modifyCostume then
+            player:TryRemoveNullCostume(NullItemID.BLINDFOLD)
+        end
+    end
+end
+function ____exports.useActiveItemTemp(self, player, collectibleType)
+    player:UseActiveItem(
+        collectibleType,
+        false,
+        false,
+        true,
+        false,
+        -1
+    )
+end
+return ____exports

package/functions/playerDataStructures.d.ts

@@ -0,0 +1,92 @@
+/// <reference types="isaac-typescript-definitions" />
+import { DefaultMap } from "../classes/DefaultMap";
+import { PlayerIndex } from "../types/PlayerIndex";
+/**
+ * Helper function to make using default maps with an index of `PlayerIndex` easier. Use this
+ * instead of the `DefaultMap.getAndSetDefault` method if you have a default map of this type.
+ *
+ * For example:
+ *
+ * ```ts
+ * const v = {
+ *   run: {
+ *     playersSpeedBoost: new DefaultMap<PlayerIndex, int>(0),
+ *   },
+ * };
+ *
+ * function evaluateCacheSpeed(player: EntityPlayer) {
+ *   player.MoveSpeed = defaultMapGetPlayer(v.run.playersSpeedBoost, player);
+ * }
+ * ```
+ */
+export declare function defaultMapGetPlayer<V, A extends unknown[]>(map: DefaultMap<PlayerIndex, V, A>, player: EntityPlayer, ...extraArgs: A): V;
+/**
+ * Helper function to make using maps with an index of `PlayerIndex` easier. Use this instead of the
+ * `Map.set` method if you have a map of this type.
+ *
+ * Since `Map` and `DefaultMap` set values in the same way, this function is simply an alias for the
+ * `mapSetPlayer` helper function.
+ */
+export declare function defaultMapSetPlayer<V>(map: Map<PlayerIndex, V>, player: EntityPlayer, value: V): void;
+/**
+ * Helper function to make using maps with an index of `PlayerIndex` easier. Use this instead of the
+ * `Map.get` method if you have a map of this type.
+ *
+ * For example:
+ *
+ * ```ts
+ * const v = {
+ *   run: {
+ *     playersSpeedBoost: new Map<PlayerIndex, int>(),
+ *   },
+ * };
+ *
+ * function incrementSpeedBoost(player: EntityPlayer) {
+ *   const oldSpeedBoost = mapGetPlayer(v.run.playersSpeedBoost, player);
+ *   const newSpeedBoost = oldSpeedBoost + 0.1;
+ *   mapSetPlayer(v.run.playersSpeedBoost, player);
+ * }
+ * ```
+ */
+export declare function mapGetPlayer<V>(map: Map<PlayerIndex, V>, player: EntityPlayer): V | undefined;
+/**
+ * Helper function to make using maps with an index of `PlayerIndex` easier. Use this instead of the
+ * `Map.has` method if you have a map of this type.
+ */
+export declare function mapHasPlayer<V>(map: Map<PlayerIndex, V>, player: EntityPlayer): boolean;
+/**
+ * Helper function to make using maps with an index of `PlayerIndex` easier. Use this instead of the
+ * `Map.set` method if you have a map of this type.
+ *
+ * For example:
+ *
+ * ```ts
+ * const v = {
+ *   run: {
+ *     playersSpeedBoost: new Map<PlayerIndex, int>(),
+ *   },
+ * };
+ *
+ * function incrementSpeedBoost(player: EntityPlayer) {
+ *   const oldSpeedBoost = mapGetPlayer(v.run.playersSpeedBoost, player);
+ *   const newSpeedBoost = oldSpeedBoost + 0.1;
+ *   mapSetPlayer(v.run.playersSpeedBoost, player);
+ * }
+ * ```
+ */
+export declare function mapSetPlayer<V>(map: Map<PlayerIndex, V>, player: EntityPlayer, value: V): void;
+/**
+ * Helper function to make using sets with an type of `PlayerIndex` easier. Use this instead of the
+ * `Set.add` method if you have a set of this type.
+ */
+export declare function setAddPlayer(set: Set<PlayerIndex>, player: EntityPlayer): Set<PlayerIndex>;
+/**
+ * Helper function to make using sets with an type of `PlayerIndex` easier. Use this instead of the
+ * `Set.delete` method if you have a set of this type.
+ */
+export declare function setDeletePlayer(set: Set<PlayerIndex>, player: EntityPlayer): boolean;
+/**
+ * Helper function to make using sets with an type of `PlayerIndex` easier. Use this instead of the
+ * `Set.has` method if you have a set of this type.
+ */
+export declare function setHasPlayer(set: Set<PlayerIndex>, player: EntityPlayer): boolean;