isaacscript-common 3.16.1 → 4.0.1-dev.0

package/functions/playerDataStructures.ts

@@ -0,0 +1,150 @@
+import { DefaultMap } from "../classes/DefaultMap";
+import { PlayerIndex } from "../types/PlayerIndex";
+import { getPlayerIndex } from "./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 function defaultMapGetPlayer<V, A extends unknown[]>(
+  map: DefaultMap<PlayerIndex, V, A>,
+  player: EntityPlayer,
+  ...extraArgs: A
+): V {
+  const playerIndex = getPlayerIndex(player);
+  return map.getAndSetDefault(playerIndex, ...extraArgs);
+}
+
+/**
+ * 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 function defaultMapSetPlayer<V>(
+  map: Map<PlayerIndex, V>,
+  player: EntityPlayer,
+  value: V,
+): void {
+  mapSetPlayer(map, player, value);
+}
+
+/**
+ * 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 function mapGetPlayer<V>(
+  map: Map<PlayerIndex, V>,
+  player: EntityPlayer,
+): V | undefined {
+  const playerIndex = getPlayerIndex(player);
+  return map.get(playerIndex);
+}
+
+/**
+ * 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 function mapHasPlayer<V>(
+  map: Map<PlayerIndex, V>,
+  player: EntityPlayer,
+): boolean {
+  const playerIndex = getPlayerIndex(player);
+  return map.has(playerIndex);
+}
+
+/**
+ * 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 function mapSetPlayer<V>(
+  map: Map<PlayerIndex, V>,
+  player: EntityPlayer,
+  value: V,
+): void {
+  const playerIndex = getPlayerIndex(player);
+  map.set(playerIndex, value);
+}
+
+/**
+ * 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 function setAddPlayer(
+  set: Set<PlayerIndex>,
+  player: EntityPlayer,
+): Set<PlayerIndex> {
+  const playerIndex = getPlayerIndex(player);
+  return set.add(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 function setDeletePlayer(
+  set: Set<PlayerIndex>,
+  player: EntityPlayer,
+): boolean {
+  const playerIndex = getPlayerIndex(player);
+  return set.delete(playerIndex);
+}
+
+/**
+ * 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 function setHasPlayer(
+  set: Set<PlayerIndex>,
+  player: EntityPlayer,
+): boolean {
+  const playerIndex = getPlayerIndex(player);
+  return set.has(playerIndex);
+}

package/functions/playerHealth.d.ts

@@ -12,6 +12,8 @@ export declare function addPlayerHealthType(player: EntityPlayer, healthType: He
  */
 export declare function getPlayerHealth(player: EntityPlayer): PlayerHealth;
 export declare function getPlayerHealthType(player: EntityPlayer, healthType: HealthType): int;
+/** Returns a `PlayerHealth` object with all 0s. */
+export declare function newPlayerHealth(): PlayerHealth;
 export declare function playerConvertBlackHeartsToSoulHearts(player: EntityPlayer): void;
 export declare function playerConvertSoulHeartsToBlackHearts(player: EntityPlayer): void;
 export declare function removeAllPlayerHealth(player: EntityPlayer): void;

package/functions/playerHealth.lua

@@ -3,19 +3,25 @@ local __TS__ArrayMap = ____lualib.__TS__ArrayMap
 local __TS__ArrayForEach = ____lualib.__TS__ArrayForEach
 local ____exports = {}
 local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local ActiveSlot = ____isaac_2Dtypescript_2Ddefinitions.ActiveSlot
+local CollectibleType = ____isaac_2Dtypescript_2Ddefinitions.CollectibleType
 local HeartSubType = ____isaac_2Dtypescript_2Ddefinitions.HeartSubType
 local PlayerType = ____isaac_2Dtypescript_2Ddefinitions.PlayerType
 local ____constants = require("constants")
 local MAX_PLAYER_HEART_CONTAINERS = ____constants.MAX_PLAYER_HEART_CONTAINERS
 local ____HealthType = require("enums.HealthType")
 local HealthType = ____HealthType.HealthType
+local ____charge = require("functions.charge")
+local getTotalCharge = ____charge.getTotalCharge
+local ____enums = require("functions.enums")
+local getEnumValues = ____enums.getEnumValues
 local ____player = require("functions.player")
 local getPlayerBlackHearts = ____player.getPlayerBlackHearts
 local getPlayerHearts = ____player.getPlayerHearts
 local getPlayerSoulHearts = ____player.getPlayerSoulHearts
 local isCharacter = ____player.isCharacter
+local setActiveItem = ____player.setActiveItem
 local ____utils = require("functions.utils")
-local ensureAllCases = ____utils.ensureAllCases
 local ____repeat = ____utils["repeat"]
 function ____exports.removeAllPlayerHealth(self, player)
     local goldenHearts = player:GetGoldenHearts()
@@ -45,6 +51,17 @@ function ____exports.setPlayerHealth(self, player, playerHealth)
     local character = player:GetPlayerType()
     local subPlayer = player:GetSubPlayer()
     ____exports.removeAllPlayerHealth(nil, player)
+    local alabasterBoxes = {}
+    if player:HasCollectible(CollectibleType.ALABASTER_BOX) then
+        for ____, activeSlot in ipairs(getEnumValues(nil, ActiveSlot)) do
+            local activeItem = player:GetActiveItem()
+            if activeItem == CollectibleType.ALABASTER_BOX then
+                local totalCharge = getTotalCharge(nil, player, activeSlot)
+                setActiveItem(nil, player, CollectibleType.NULL, activeSlot)
+                alabasterBoxes[#alabasterBoxes + 1] = {activeSlot, totalCharge}
+            end
+        end
+    end
     if character == PlayerType.THE_SOUL and subPlayer ~= nil then
         subPlayer:AddMaxHearts(playerHealth.maxHearts, false)
     else
@@ -89,6 +106,17 @@ function ____exports.setPlayerHealth(self, player, playerHealth)
     elseif character == PlayerType.BETHANY_B then
         player:SetBloodCharge(playerHealth.bloodCharges)
     end
+    for ____, ____value in ipairs(alabasterBoxes) do
+        local activeSlot = ____value[1]
+        local totalCharge = ____value[2]
+        setActiveItem(
+            nil,
+            player,
+            CollectibleType.ALABASTER_BOX,
+            activeSlot,
+            totalCharge
+        )
+    end
 end
 function ____exports.addPlayerHealthType(self, player, healthType, numHearts)
     repeat
@@ -97,68 +125,63 @@ function ____exports.addPlayerHealthType(self, player, healthType, numHearts)
         if ____cond3 then
             do
                 player:AddHearts(numHearts)
-                return
+                break
             end
         end
         ____cond3 = ____cond3 or ____switch3 == HealthType.SOUL
         if ____cond3 then
             do
                 player:AddSoulHearts(numHearts)
-                return
+                break
             end
         end
         ____cond3 = ____cond3 or ____switch3 == HealthType.ETERNAL
         if ____cond3 then
             do
                 player:AddEternalHearts(numHearts)
-                return
+                break
             end
         end
         ____cond3 = ____cond3 or ____switch3 == HealthType.BLACK
         if ____cond3 then
             do
                 player:AddBlackHearts(numHearts)
-                return
+                break
             end
         end
         ____cond3 = ____cond3 or ____switch3 == HealthType.GOLDEN
         if ____cond3 then
             do
                 player:AddGoldenHearts(numHearts)
-                return
+                break
             end
         end
         ____cond3 = ____cond3 or ____switch3 == HealthType.BONE
         if ____cond3 then
             do
                 player:AddBoneHearts(numHearts)
-                return
+                break
             end
         end
         ____cond3 = ____cond3 or ____switch3 == HealthType.ROTTEN
         if ____cond3 then
             do
                 player:AddRottenHearts(numHearts)
-                return
+                break
             end
         end
         ____cond3 = ____cond3 or ____switch3 == HealthType.BROKEN
         if ____cond3 then
             do
                 player:AddBrokenHearts(numHearts)
-                return
+                break
             end
         end
         ____cond3 = ____cond3 or ____switch3 == HealthType.MAX_HEARTS
         if ____cond3 then
             do
                 player:AddMaxHearts(numHearts, false)
-                return
-            end
-        end
-        do
-            do
-                ensureAllCases(nil, healthType)
+                break
             end
         end
     until true
@@ -232,68 +255,79 @@ function ____exports.getPlayerHealth(self, player)
 end
 function ____exports.getPlayerHealthType(self, player, healthType)
     repeat
-        local ____switch25 = healthType
-        local ____cond25 = ____switch25 == HealthType.RED
-        if ____cond25 then
+        local ____switch24 = healthType
+        local ____cond24 = ____switch24 == HealthType.RED
+        if ____cond24 then
             do
                 return getPlayerHearts(nil, player)
             end
         end
-        ____cond25 = ____cond25 or ____switch25 == HealthType.SOUL
-        if ____cond25 then
+        ____cond24 = ____cond24 or ____switch24 == HealthType.SOUL
+        if ____cond24 then
             do
                 return getPlayerSoulHearts(nil, player)
             end
         end
-        ____cond25 = ____cond25 or ____switch25 == HealthType.ETERNAL
-        if ____cond25 then
+        ____cond24 = ____cond24 or ____switch24 == HealthType.ETERNAL
+        if ____cond24 then
             do
                 return player:GetEternalHearts()
             end
         end
-        ____cond25 = ____cond25 or ____switch25 == HealthType.BLACK
-        if ____cond25 then
+        ____cond24 = ____cond24 or ____switch24 == HealthType.BLACK
+        if ____cond24 then
             do
                 return getPlayerBlackHearts(nil, player)
             end
         end
-        ____cond25 = ____cond25 or ____switch25 == HealthType.GOLDEN
-        if ____cond25 then
+        ____cond24 = ____cond24 or ____switch24 == HealthType.GOLDEN
+        if ____cond24 then
             do
                 return player:GetGoldenHearts()
             end
         end
-        ____cond25 = ____cond25 or ____switch25 == HealthType.BONE
-        if ____cond25 then
+        ____cond24 = ____cond24 or ____switch24 == HealthType.BONE
+        if ____cond24 then
             do
                 return player:GetBoneHearts()
             end
         end
-        ____cond25 = ____cond25 or ____switch25 == HealthType.ROTTEN
-        if ____cond25 then
+        ____cond24 = ____cond24 or ____switch24 == HealthType.ROTTEN
+        if ____cond24 then
             do
                 return player:GetRottenHearts()
             end
         end
-        ____cond25 = ____cond25 or ____switch25 == HealthType.BROKEN
-        if ____cond25 then
+        ____cond24 = ____cond24 or ____switch24 == HealthType.BROKEN
+        if ____cond24 then
             do
                 return player:GetBrokenHearts()
             end
         end
-        ____cond25 = ____cond25 or ____switch25 == HealthType.MAX_HEARTS
-        if ____cond25 then
+        ____cond24 = ____cond24 or ____switch24 == HealthType.MAX_HEARTS
+        if ____cond24 then
             do
                 return player:GetMaxHearts()
             end
         end
-        do
-            do
-                return ensureAllCases(nil, healthType)
-            end
-        end
     until true
 end
+--- Returns a `PlayerHealth` object with all 0s.
+function ____exports.newPlayerHealth(self)
+    return {
+        maxHearts = 0,
+        hearts = 0,
+        eternalHearts = 0,
+        soulHearts = 0,
+        boneHearts = 0,
+        goldenHearts = 0,
+        rottenHearts = 0,
+        brokenHearts = 0,
+        soulCharges = 0,
+        bloodCharges = 0,
+        soulHeartTypes = {}
+    }
+end
 function ____exports.playerConvertBlackHeartsToSoulHearts(self, player)
     local playerHealth = ____exports.getPlayerHealth(nil, player)
     ____exports.removeAllPlayerHealth(nil, player)