isaacscript-common 9.16.1 → 9.17.0

package/dist/functions/playerHealth.d.ts

@@ -3,6 +3,14 @@
 import { HealthType } from "../enums/HealthType";
 import { PlayerHealth } from "../interfaces/PlayerHealth";
 export declare function addPlayerHealthType(player: EntityPlayer, healthType: HealthType, numHearts: int): void;
+/**
+ * Helper function to see if the provided player can pick up an eternal heart. (If a player already
+ * has an eternal heart and full heart containers, they are not able to pick up any additional
+ * eternal hearts.)
+ *
+ * This function's name matches the existing `EntityPlayer` methods.
+ */
+export declare function canPickEternalHearts(player: EntityPlayer): boolean;
 /**
  * Returns whether or not all of the player's soul-heart-type hearts are black hearts.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"playerHealth.d.ts","sourceRoot":"","sources":["../../src/functions/playerHealth.ts"],"names":[],"mappings":";;AAQA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAiB,MAAM,4BAA4B,CAAC;AAQzE,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,GAAG,GACb,IAAI,CA+CN;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAK1E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAKzE;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,YAAY,GAAG,GAAG,CAYtE;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,GAAG,CAK9D;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CA2ElE;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,UAAU,GACrB,GAAG,CAmDL;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,GAAG,CAKzD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,UAAU,CAoDnE;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,YAAY,GAAG,GAAG,CAqCrE;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,GAAG,CAK7D;AAED;;;;;;;;;GASG;AACH,wBAAgB,wCAAwC,CACtD,MAAM,EAAE,YAAY,GACnB,GAAG,CAML;AAED,sDAAsD;AACtD,wBAAgB,eAAe,IAAI,YAAY,CAc9C;AAED,wBAAgB,oCAAoC,CAClD,MAAM,EAAE,YAAY,GACnB,IAAI,CAQN;AAED,wBAAgB,oCAAoC,CAClD,MAAM,EAAE,YAAY,GACnB,IAAI,CAQN;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAMjE;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAwBhE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,YAAY,EACpB,YAAY,EAAE,YAAY,GACzB,IAAI,CAsHN;AAED;;;;;;;;;GASG;AACH,wBAAgB,sDAAsD,CACpE,MAAM,EAAE,YAAY,EACpB,YAAY,EAAE,KAAK,GAClB,OAAO,CAyBT"}
+{"version":3,"file":"playerHealth.d.ts","sourceRoot":"","sources":["../../src/functions/playerHealth.ts"],"names":[],"mappings":";;AAQA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAiB,MAAM,4BAA4B,CAAC;AAQzE,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,GAAG,GACb,IAAI,CA+CN;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAMlE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAK1E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAKzE;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,YAAY,GAAG,GAAG,CAYtE;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,GAAG,CAK9D;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CA2ElE;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,UAAU,GACrB,GAAG,CAmDL;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,GAAG,CAKzD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,UAAU,CAoDnE;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,YAAY,GAAG,GAAG,CAqCrE;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,GAAG,CAK7D;AAED;;;;;;;;;GASG;AACH,wBAAgB,wCAAwC,CACtD,MAAM,EAAE,YAAY,GACnB,GAAG,CAML;AAED,sDAAsD;AACtD,wBAAgB,eAAe,IAAI,YAAY,CAc9C;AAED,wBAAgB,oCAAoC,CAClD,MAAM,EAAE,YAAY,GACnB,IAAI,CAQN;AAED,wBAAgB,oCAAoC,CAClD,MAAM,EAAE,YAAY,GACnB,IAAI,CAQN;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAMjE;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAwBhE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,YAAY,EACpB,YAAY,EAAE,YAAY,GACzB,IAAI,CAsHN;AAED;;;;;;;;;GASG;AACH,wBAAgB,sDAAsD,CACpE,MAAM,EAAE,YAAY,EACpB,YAAY,EAAE,KAAK,GAClB,OAAO,CAyBT"}

package/dist/functions/playerHealth.lua

@@ -135,25 +135,25 @@ function ____exports.setPlayerHealth(self, player, playerHealth)
                 addAmount = 1
             end
             repeat
-                local ____switch71 = soulHeartType
-                local ____cond71 = ____switch71 == HeartSubType.SOUL
-                if ____cond71 then
+                local ____switch72 = soulHeartType
+                local ____cond72 = ____switch72 == HeartSubType.SOUL
+                if ____cond72 then
                     do
                         player:AddSoulHearts(addAmount)
                         soulHeartsRemaining = soulHeartsRemaining - addAmount
                         break
                     end
                 end
-                ____cond71 = ____cond71 or ____switch71 == HeartSubType.BLACK
-                if ____cond71 then
+                ____cond72 = ____cond72 or ____switch72 == HeartSubType.BLACK
+                if ____cond72 then
                     do
                         player:AddBlackHearts(addAmount)
                         soulHeartsRemaining = soulHeartsRemaining - addAmount
                         break
                     end
                 end
-                ____cond71 = ____cond71 or ____switch71 == HeartSubType.BONE
-                if ____cond71 then
+                ____cond72 = ____cond72 or ____switch72 == HeartSubType.BONE
+                if ____cond72 then
                     do
                         player:AddBoneHearts(addAmount)
                         break
@@ -271,6 +271,17 @@ function ____exports.addPlayerHealthType(self, player, healthType, numHearts)
         end
     until true
 end
+--- Helper function to see if the provided player can pick up an eternal heart. (If a player already
+-- has an eternal heart and full heart containers, they are not able to pick up any additional
+-- eternal hearts.)
+-- 
+-- This function's name matches the existing `EntityPlayer` methods.
+function ____exports.canPickEternalHearts(self, player)
+    local eternalHearts = player:GetEternalHearts()
+    local maxHearts = player:GetMaxHearts()
+    local heartLimit = player:GetHeartLimit()
+    return eternalHearts == 0 or maxHearts ~= heartLimit
+end
 --- Returns whether or not all of the player's soul-heart-type hearts are black hearts.
 -- 
 -- Note that this function does not consider red heart containers.
@@ -385,57 +396,57 @@ function ____exports.getPlayerHealth(self, player)
 end
 function ____exports.getPlayerHealthType(self, player, healthType)
     repeat
-        local ____switch28 = healthType
-        local ____cond28 = ____switch28 == HealthType.RED
-        if ____cond28 then
+        local ____switch29 = healthType
+        local ____cond29 = ____switch29 == HealthType.RED
+        if ____cond29 then
             do
                 return ____exports.getPlayerHearts(nil, player)
             end
         end
-        ____cond28 = ____cond28 or ____switch28 == HealthType.SOUL
-        if ____cond28 then
+        ____cond29 = ____cond29 or ____switch29 == HealthType.SOUL
+        if ____cond29 then
             do
                 return ____exports.getPlayerSoulHearts(nil, player)
             end
         end
-        ____cond28 = ____cond28 or ____switch28 == HealthType.ETERNAL
-        if ____cond28 then
+        ____cond29 = ____cond29 or ____switch29 == HealthType.ETERNAL
+        if ____cond29 then
             do
                 return player:GetEternalHearts()
             end
         end
-        ____cond28 = ____cond28 or ____switch28 == HealthType.BLACK
-        if ____cond28 then
+        ____cond29 = ____cond29 or ____switch29 == HealthType.BLACK
+        if ____cond29 then
             do
                 return ____exports.getPlayerBlackHearts(nil, player)
             end
         end
-        ____cond28 = ____cond28 or ____switch28 == HealthType.GOLDEN
-        if ____cond28 then
+        ____cond29 = ____cond29 or ____switch29 == HealthType.GOLDEN
+        if ____cond29 then
             do
                 return player:GetGoldenHearts()
             end
         end
-        ____cond28 = ____cond28 or ____switch28 == HealthType.BONE
-        if ____cond28 then
+        ____cond29 = ____cond29 or ____switch29 == HealthType.BONE
+        if ____cond29 then
             do
                 return player:GetBoneHearts()
             end
         end
-        ____cond28 = ____cond28 or ____switch28 == HealthType.ROTTEN
-        if ____cond28 then
+        ____cond29 = ____cond29 or ____switch29 == HealthType.ROTTEN
+        if ____cond29 then
             do
                 return player:GetRottenHearts()
             end
         end
-        ____cond28 = ____cond28 or ____switch28 == HealthType.BROKEN
-        if ____cond28 then
+        ____cond29 = ____cond29 or ____switch29 == HealthType.BROKEN
+        if ____cond29 then
             do
                 return player:GetBrokenHearts()
             end
         end
-        ____cond28 = ____cond28 or ____switch28 == HealthType.MAX_HEARTS
-        if ____cond28 then
+        ____cond29 = ____cond29 or ____switch29 == HealthType.MAX_HEARTS
+        if ____cond29 then
             do
                 return player:GetMaxHearts()
             end

package/dist/index.d.ts

@@ -607,6 +607,15 @@ export declare function calculateStageType(stage: LevelStage): StageType;
  */
 export declare function calculateStageTypeRepentance(stage: LevelStage): StageType;
 
+/**
+ * Helper function to see if the provided player can pick up an eternal heart. (If a player already
+ * has an eternal heart and full heart containers, they are not able to pick up any additional
+ * eternal hearts.)
+ *
+ * This function's name matches the existing `EntityPlayer` methods.
+ */
+export declare function canPickEternalHearts(player: EntityPlayer): boolean;
+
 /**
  * Helper function to determine if a player will destroy a rock/pot/skull if they walk over it.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacscript-common",
-  "version": "9.16.1",
+  "version": "9.17.0",
   "description": "Helper functions and features for IsaacScript mods.",
   "keywords": [
     "isaac",

package/src/functions/playerHealth.ts

@@ -68,6 +68,21 @@ export function addPlayerHealthType(
   }
 }
 
+/**
+ * Helper function to see if the provided player can pick up an eternal heart. (If a player already
+ * has an eternal heart and full heart containers, they are not able to pick up any additional
+ * eternal hearts.)
+ *
+ * This function's name matches the existing `EntityPlayer` methods.
+ */
+export function canPickEternalHearts(player: EntityPlayer): boolean {
+  const eternalHearts = player.GetEternalHearts();
+  const maxHearts = player.GetMaxHearts();
+  const heartLimit = player.GetHeartLimit();
+
+  return eternalHearts === 0 || maxHearts !== heartLimit;
+}
+
 /**
  * Returns whether or not all of the player's soul-heart-type hearts are black hearts.
  *