isaacscript-common 10.2.2 → 11.0.1

package/dist/index.d.ts

@@ -4092,15 +4092,20 @@ export declare function getPlayerCollectiblesForCacheFlag(player: EntityPlayer,
 /** Helper function to get only the familiars that belong to a specific player. */
 export declare function getPlayerFamiliars(player: EntityPlayer): EntityFamiliar[];
 
+/**
+ * Helper function to get the player from a tear, laser, bomb, etc. Returns undefined if the entity
+ * does not correspond to any particular player.
+ *
+ * This function works by looking at the `Parent` and the `SpawnerEntity` fields (in that order).
+ */
+export declare function getPlayerFromEntity(entity: Entity): EntityPlayer | undefined;
+
 /**
  * Helper function to get the corresponding `EntityPlayer` object that corresponds to a
  * `PlayerIndex`.
  */
 export declare function getPlayerFromIndex(playerIndex: PlayerIndex): EntityPlayer | undefined;
 
-/** Helper function to get the player from a tear, laser, bomb, etc. */
-export declare function getPlayerFromTear(entity: Entity): EntityPlayer | undefined;
-
 /**
  * Helper function to get an object representing the player's health. You can use this in
  * combination with the `setPlayerHealth` function to restore the player's health back to a certain
@@ -6442,10 +6447,10 @@ export declare function isTear(variable: unknown): variable is EntityTear;
  * Helper function to check if a given tear is from a familiar (as opposed to e.g. a player). This
  * is determined by looking at the parent.
  *
- * For the special case of Incubus and Blood Babies, the spawner entity of the tear is always the
- * player. The parent of the tear is the player on frame 0 and it is the familiar on frame 1 and
- * onwards. For this reason, you can only use this function in the `POST_TEAR_INIT_VERY_LATE`
- * callback or on frame 1+.
+ * For the special case of Incubus and Blood Babies, the parent of the tear is always the player,
+ * but the spawner entity of the tear changes. On frame 0, the spawner entity is equal to the
+ * player, and on frame 1, the spawner entity is equal to the familiar. For this reason, you can
+ * only use this function in the `POST_TEAR_INIT_VERY_LATE` callback or on frame 1+.
  *
  * If this function is called on frame 0, it will throw a run-time error.
  */
@@ -6455,10 +6460,10 @@ export declare function isTearFromFamiliar(tear: EntityTear): boolean;
  * Helper function to check if a given tear is from a player (as opposed to e.g. a familiar). This
  * is determined by looking at the parent.
  *
- * For the special case of Incubus and Blood Babies, the spawner entity of the tear is always the
- * player. The parent of the tear is the player on frame 0 and it is the familiar on frame 1 and
- * onwards. For this reason, you can only use this function in the `POST_TEAR_INIT_VERY_LATE`
- * callback or on frame 1+.
+ * For the special case of Incubus and Blood Babies, the parent of the tear is always the player,
+ * but the spawner entity of the tear changes. On frame 0, the spawner entity is equal to the
+ * player, and on frame 1, the spawner entity is equal to the familiar. For this reason, you can
+ * only use this function in the `POST_TEAR_INIT_VERY_LATE` callback or on frame 1+.
  *
  * If this function is called on frame 0, it will throw a run-time error.
  */

package/dist/isaacscript-common.lua

@@ -1,6 +1,6 @@
 --[[
 
-isaacscript-common 10.2.2
+isaacscript-common 11.0.1
 
 This is the "isaacscript-common" library, which was created with the IsaacScript tool.
 
@@ -26300,8 +26300,11 @@ function ____exports.getPlayerCollectibleMap(self, player)
     end
     return collectibleMap
 end
---- Helper function to get the player from a tear, laser, bomb, etc.
-function ____exports.getPlayerFromTear(self, entity)
+--- Helper function to get the player from a tear, laser, bomb, etc. Returns undefined if the entity
+-- does not correspond to any particular player.
+-- 
+-- This function works by looking at the `Parent` and the `SpawnerEntity` fields (in that order).
+function ____exports.getPlayerFromEntity(self, entity)
     if entity.Parent ~= nil then
         local player = entity.Parent:ToPlayer()
         if player ~= nil then
@@ -26470,7 +26473,7 @@ function ____exports.isDamageFromPlayer(self, damageSource)
     if player ~= nil then
         return true
     end
-    local indirectPlayer = ____exports.getPlayerFromTear(nil, damageSource)
+    local indirectPlayer = ____exports.getPlayerFromEntity(nil, damageSource)
     return indirectPlayer ~= nil
 end
 --- Helper function for detecting when a player is Eden or Tainted Eden. Useful for situations where
@@ -39249,39 +39252,39 @@ end
 --- Helper function to check if a given tear is from a familiar (as opposed to e.g. a player). This
 -- is determined by looking at the parent.
 -- 
--- For the special case of Incubus and Blood Babies, the spawner entity of the tear is always the
--- player. The parent of the tear is the player on frame 0 and it is the familiar on frame 1 and
--- onwards. For this reason, you can only use this function in the `POST_TEAR_INIT_VERY_LATE`
--- callback or on frame 1+.
+-- For the special case of Incubus and Blood Babies, the parent of the tear is always the player,
+-- but the spawner entity of the tear changes. On frame 0, the spawner entity is equal to the
+-- player, and on frame 1, the spawner entity is equal to the familiar. For this reason, you can
+-- only use this function in the `POST_TEAR_INIT_VERY_LATE` callback or on frame 1+.
 -- 
 -- If this function is called on frame 0, it will throw a run-time error.
 function ____exports.isTearFromFamiliar(self, tear)
     if tear.FrameCount == 0 then
         error("Failed to check if the given tear was from a player since the tear's frame count was equal to 0. (The \"isTearFromFamiliar\" function must only be used in the \"POST_TEAR_INIT_VERY_LATE\" callback or on frame 1 and onwards.)")
     end
-    if tear.Parent == nil then
+    if tear.SpawnerEntity == nil then
         return false
     end
-    local familiar = tear.Parent:ToFamiliar()
+    local familiar = tear.SpawnerEntity:ToFamiliar()
     return familiar ~= nil
 end
 --- Helper function to check if a given tear is from a player (as opposed to e.g. a familiar). This
 -- is determined by looking at the parent.
 -- 
--- For the special case of Incubus and Blood Babies, the spawner entity of the tear is always the
--- player. The parent of the tear is the player on frame 0 and it is the familiar on frame 1 and
--- onwards. For this reason, you can only use this function in the `POST_TEAR_INIT_VERY_LATE`
--- callback or on frame 1+.
+-- For the special case of Incubus and Blood Babies, the parent of the tear is always the player,
+-- but the spawner entity of the tear changes. On frame 0, the spawner entity is equal to the
+-- player, and on frame 1, the spawner entity is equal to the familiar. For this reason, you can
+-- only use this function in the `POST_TEAR_INIT_VERY_LATE` callback or on frame 1+.
 -- 
 -- If this function is called on frame 0, it will throw a run-time error.
 function ____exports.isTearFromPlayer(self, tear)
     if tear.FrameCount == 0 then
         error("Failed to check if the given tear was from a player since the tear's frame count was equal to 0. (The \"isTearFromPlayer\" function must only be used in the \"POST_TEAR_INIT_VERY_LATE\" callback or on frame 1 and onwards.)")
     end
-    if tear.Parent == nil then
+    if tear.SpawnerEntity == nil then
         return false
     end
-    local player = tear.Parent:ToPlayer()
+    local player = tear.SpawnerEntity:ToPlayer()
     return player ~= nil
 end
 return ____exports
@@ -46947,7 +46950,7 @@ return ____exports
 ["package"] = function(...) 
 return {
     name = "isaacscript-common",
-    version = "10.2.2",
+    version = "11.0.1",
     description = "Helper functions and features for IsaacScript mods.",
     keywords = {"isaac", "rebirth", "afterbirth", "repentance"},
     homepage = "https://isaacscript.github.io/",

package/dist/package.lua

@@ -1,6 +1,6 @@
 return {
     name = "isaacscript-common",
-    version = "10.2.2",
+    version = "11.0.1",
     description = "Helper functions and features for IsaacScript mods.",
     keywords = {"isaac", "rebirth", "afterbirth", "repentance"},
     homepage = "https://isaacscript.github.io/",

package/dist/src/functions/players.d.ts

@@ -73,8 +73,13 @@ export declare function getPlayerCollectibleCount(player: EntityPlayer, ...colle
  * Note that this will filter out non-real collectibles like Lilith's Incubus.
  */
 export declare function getPlayerCollectibleMap(player: EntityPlayer): Map<CollectibleType, int>;
-/** Helper function to get the player from a tear, laser, bomb, etc. */
-export declare function getPlayerFromTear(entity: Entity): EntityPlayer | undefined;
+/**
+ * Helper function to get the player from a tear, laser, bomb, etc. Returns undefined if the entity
+ * does not correspond to any particular player.
+ *
+ * This function works by looking at the `Parent` and the `SpawnerEntity` fields (in that order).
+ */
+export declare function getPlayerFromEntity(entity: Entity): EntityPlayer | undefined;
 /**
  * Helper function to get the proper name of the player. Use this instead of the
  * `EntityPlayer.GetName` method because it accounts for Blue Baby, Lazarus II, and Tainted

package/dist/src/functions/players.d.ts.map

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

package/dist/src/functions/players.lua

@@ -244,8 +244,11 @@ function ____exports.getPlayerCollectibleMap(self, player)
     end
     return collectibleMap
 end
---- Helper function to get the player from a tear, laser, bomb, etc.
-function ____exports.getPlayerFromTear(self, entity)
+--- Helper function to get the player from a tear, laser, bomb, etc. Returns undefined if the entity
+-- does not correspond to any particular player.
+-- 
+-- This function works by looking at the `Parent` and the `SpawnerEntity` fields (in that order).
+function ____exports.getPlayerFromEntity(self, entity)
     if entity.Parent ~= nil then
         local player = entity.Parent:ToPlayer()
         if player ~= nil then
@@ -414,7 +417,7 @@ function ____exports.isDamageFromPlayer(self, damageSource)
     if player ~= nil then
         return true
     end
-    local indirectPlayer = ____exports.getPlayerFromTear(nil, damageSource)
+    local indirectPlayer = ____exports.getPlayerFromEntity(nil, damageSource)
     return indirectPlayer ~= nil
 end
 --- Helper function for detecting when a player is Eden or Tainted Eden. Useful for situations where

package/dist/src/functions/tears.d.ts

@@ -27,10 +27,10 @@ export declare function getTearsStat(fireDelay: float): float;
  * Helper function to check if a given tear is from a familiar (as opposed to e.g. a player). This
  * is determined by looking at the parent.
  *
- * For the special case of Incubus and Blood Babies, the spawner entity of the tear is always the
- * player. The parent of the tear is the player on frame 0 and it is the familiar on frame 1 and
- * onwards. For this reason, you can only use this function in the `POST_TEAR_INIT_VERY_LATE`
- * callback or on frame 1+.
+ * For the special case of Incubus and Blood Babies, the parent of the tear is always the player,
+ * but the spawner entity of the tear changes. On frame 0, the spawner entity is equal to the
+ * player, and on frame 1, the spawner entity is equal to the familiar. For this reason, you can
+ * only use this function in the `POST_TEAR_INIT_VERY_LATE` callback or on frame 1+.
  *
  * If this function is called on frame 0, it will throw a run-time error.
  */
@@ -39,10 +39,10 @@ export declare function isTearFromFamiliar(tear: EntityTear): boolean;
  * Helper function to check if a given tear is from a player (as opposed to e.g. a familiar). This
  * is determined by looking at the parent.
  *
- * For the special case of Incubus and Blood Babies, the spawner entity of the tear is always the
- * player. The parent of the tear is the player on frame 0 and it is the familiar on frame 1 and
- * onwards. For this reason, you can only use this function in the `POST_TEAR_INIT_VERY_LATE`
- * callback or on frame 1+.
+ * For the special case of Incubus and Blood Babies, the parent of the tear is always the player,
+ * but the spawner entity of the tear changes. On frame 0, the spawner entity is equal to the
+ * player, and on frame 1, the spawner entity is equal to the familiar. For this reason, you can
+ * only use this function in the `POST_TEAR_INIT_VERY_LATE` callback or on frame 1+.
  *
  * If this function is called on frame 0, it will throw a run-time error.
  */

package/dist/src/functions/tears.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tears.d.ts","sourceRoot":"","sources":["../../../src/functions/tears.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,KAAK,GAAG,IAAI,CAKzE;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,KAAK,GAAG,KAAK,CAEpD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,KAAK,GAAG,KAAK,CAEpD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAc5D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAc1D"}
+{"version":3,"file":"tears.d.ts","sourceRoot":"","sources":["../../../src/functions/tears.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,KAAK,GAAG,IAAI,CAKzE;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,KAAK,GAAG,KAAK,CAEpD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,KAAK,GAAG,KAAK,CAEpD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAgB5D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAgB1D"}

package/dist/src/functions/tears.lua

@@ -27,39 +27,39 @@ end
 --- Helper function to check if a given tear is from a familiar (as opposed to e.g. a player). This
 -- is determined by looking at the parent.
 -- 
--- For the special case of Incubus and Blood Babies, the spawner entity of the tear is always the
--- player. The parent of the tear is the player on frame 0 and it is the familiar on frame 1 and
--- onwards. For this reason, you can only use this function in the `POST_TEAR_INIT_VERY_LATE`
--- callback or on frame 1+.
+-- For the special case of Incubus and Blood Babies, the parent of the tear is always the player,
+-- but the spawner entity of the tear changes. On frame 0, the spawner entity is equal to the
+-- player, and on frame 1, the spawner entity is equal to the familiar. For this reason, you can
+-- only use this function in the `POST_TEAR_INIT_VERY_LATE` callback or on frame 1+.
 -- 
 -- If this function is called on frame 0, it will throw a run-time error.
 function ____exports.isTearFromFamiliar(self, tear)
     if tear.FrameCount == 0 then
         error("Failed to check if the given tear was from a player since the tear's frame count was equal to 0. (The \"isTearFromFamiliar\" function must only be used in the \"POST_TEAR_INIT_VERY_LATE\" callback or on frame 1 and onwards.)")
     end
-    if tear.Parent == nil then
+    if tear.SpawnerEntity == nil then
         return false
     end
-    local familiar = tear.Parent:ToFamiliar()
+    local familiar = tear.SpawnerEntity:ToFamiliar()
     return familiar ~= nil
 end
 --- Helper function to check if a given tear is from a player (as opposed to e.g. a familiar). This
 -- is determined by looking at the parent.
 -- 
--- For the special case of Incubus and Blood Babies, the spawner entity of the tear is always the
--- player. The parent of the tear is the player on frame 0 and it is the familiar on frame 1 and
--- onwards. For this reason, you can only use this function in the `POST_TEAR_INIT_VERY_LATE`
--- callback or on frame 1+.
+-- For the special case of Incubus and Blood Babies, the parent of the tear is always the player,
+-- but the spawner entity of the tear changes. On frame 0, the spawner entity is equal to the
+-- player, and on frame 1, the spawner entity is equal to the familiar. For this reason, you can
+-- only use this function in the `POST_TEAR_INIT_VERY_LATE` callback or on frame 1+.
 -- 
 -- If this function is called on frame 0, it will throw a run-time error.
 function ____exports.isTearFromPlayer(self, tear)
     if tear.FrameCount == 0 then
         error("Failed to check if the given tear was from a player since the tear's frame count was equal to 0. (The \"isTearFromPlayer\" function must only be used in the \"POST_TEAR_INIT_VERY_LATE\" callback or on frame 1 and onwards.)")
     end
-    if tear.Parent == nil then
+    if tear.SpawnerEntity == nil then
         return false
     end
-    local player = tear.Parent:ToPlayer()
+    local player = tear.SpawnerEntity:ToPlayer()
     return player ~= nil
 end
 return ____exports

package/package.json

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

package/src/functions/players.ts

@@ -264,8 +264,13 @@ export function getPlayerCollectibleMap(
   return collectibleMap;
 }
 
-/** Helper function to get the player from a tear, laser, bomb, etc. */
-export function getPlayerFromTear(entity: Entity): EntityPlayer | undefined {
+/**
+ * Helper function to get the player from a tear, laser, bomb, etc. Returns undefined if the entity
+ * does not correspond to any particular player.
+ *
+ * This function works by looking at the `Parent` and the `SpawnerEntity` fields (in that order).
+ */
+export function getPlayerFromEntity(entity: Entity): EntityPlayer | undefined {
   if (entity.Parent !== undefined) {
     const player = entity.Parent.ToPlayer();
     if (player !== undefined) {
@@ -498,7 +503,7 @@ export function isDamageFromPlayer(damageSource: Entity): boolean {
     return true;
   }
 
-  const indirectPlayer = getPlayerFromTear(damageSource);
+  const indirectPlayer = getPlayerFromEntity(damageSource);
   return indirectPlayer !== undefined;
 }
 

package/src/functions/tears.ts

@@ -36,10 +36,10 @@ export function getTearsStat(fireDelay: float): float {
  * Helper function to check if a given tear is from a familiar (as opposed to e.g. a player). This
  * is determined by looking at the parent.
  *
- * For the special case of Incubus and Blood Babies, the spawner entity of the tear is always the
- * player. The parent of the tear is the player on frame 0 and it is the familiar on frame 1 and
- * onwards. For this reason, you can only use this function in the `POST_TEAR_INIT_VERY_LATE`
- * callback or on frame 1+.
+ * For the special case of Incubus and Blood Babies, the parent of the tear is always the player,
+ * but the spawner entity of the tear changes. On frame 0, the spawner entity is equal to the
+ * player, and on frame 1, the spawner entity is equal to the familiar. For this reason, you can
+ * only use this function in the `POST_TEAR_INIT_VERY_LATE` callback or on frame 1+.
  *
  * If this function is called on frame 0, it will throw a run-time error.
  */
@@ -50,12 +50,14 @@ export function isTearFromFamiliar(tear: EntityTear): boolean {
     );
   }
 
-  // Normally, all tears have a parent, which is either the player or the familiar.
-  if (tear.Parent === undefined) {
+  // Normally, all tears have a spawner entity, which is either the player or the familiar.
+  if (tear.SpawnerEntity === undefined) {
     return false;
   }
 
-  const familiar = tear.Parent.ToFamiliar();
+  // We cannot use `tear.SpawnerType` to determine this, since it is baked in to be equal to
+  // `EntityType.PLAYER` regardless of whether the tear is from a player or familiar.
+  const familiar = tear.SpawnerEntity.ToFamiliar();
   return familiar !== undefined;
 }
 
@@ -63,10 +65,10 @@ export function isTearFromFamiliar(tear: EntityTear): boolean {
  * Helper function to check if a given tear is from a player (as opposed to e.g. a familiar). This
  * is determined by looking at the parent.
  *
- * For the special case of Incubus and Blood Babies, the spawner entity of the tear is always the
- * player. The parent of the tear is the player on frame 0 and it is the familiar on frame 1 and
- * onwards. For this reason, you can only use this function in the `POST_TEAR_INIT_VERY_LATE`
- * callback or on frame 1+.
+ * For the special case of Incubus and Blood Babies, the parent of the tear is always the player,
+ * but the spawner entity of the tear changes. On frame 0, the spawner entity is equal to the
+ * player, and on frame 1, the spawner entity is equal to the familiar. For this reason, you can
+ * only use this function in the `POST_TEAR_INIT_VERY_LATE` callback or on frame 1+.
  *
  * If this function is called on frame 0, it will throw a run-time error.
  */
@@ -77,11 +79,13 @@ export function isTearFromPlayer(tear: EntityTear): boolean {
     );
   }
 
-  // Normally, all tears have a parent, which is either the player or the familiar.
-  if (tear.Parent === undefined) {
+  // Normally, all tears have a spawner entity, which is either the player or the familiar.
+  if (tear.SpawnerEntity === undefined) {
     return false;
   }
 
-  const player = tear.Parent.ToPlayer();
+  // We cannot use `tear.SpawnerType` to determine this, since it is baked in to be equal to
+  // `EntityType.PLAYER` regardless of whether the tear is from a player or familiar.
+  const player = tear.SpawnerEntity.ToPlayer();
   return player !== undefined;
 }