isaacscript-common 12.1.1 → 12.3.0

package/dist/index.d.ts

@@ -10422,7 +10422,8 @@ export declare enum SaveDataKey {
  * Note that when the player uses Glowing Hour Glass, the save data manager will automatically
  * restore any variables on a "run" or "level" object with a backup that was created when the room
  * was entered. Thus, you should not have to explicitly program support for Glowing Hour Glass into
- * your mod features that use the save data manager.
+ * your mod features that use the save data manager. If this is undesired for your specific
+ * use-case, then add a key of `__ignoreGlowingHourGlass: true` to your "run" or "level" object.
  *
  * @param key The name of the file or feature that is submitting data to be managed by the save data
  *            manager. The save data manager will throw an error if the key is already registered.
@@ -10764,6 +10765,13 @@ export declare function setDoorDisplay(textCallback: (door: GridEntityDoor) => s
  */
 export declare function setEffectDisplay(textCallback: (effect: EntityEffect) => string): void;
 
+/**
+ * Helper function to make an entity flash red like it is taking damage. This is useful when you
+ * want to make it appear as if an entity is taking damage without actually dealing any damage to
+ * it.
+ */
+export declare function setEntityDamageFlash(entity: Entity): void;
+
 /**
  * Helper function to set the position of every entity in the room based on a map of positions. If
  * an entity is found that does not have matching element in the provided map, then that entity will

package/dist/isaacscript-common.lua

@@ -1,6 +1,6 @@
 --[[
 
-isaacscript-common 12.1.1
+isaacscript-common 12.3.0
 
 This is the "isaacscript-common" library, which was created with the IsaacScript tool.
 
@@ -20380,6 +20380,16 @@ function ____exports.removeEntities(self, entities, cap)
     end
     return entitiesRemoved
 end
+--- From DeadInfinity.
+local DAMAGE_FLASH_COLOR = Color(
+    0.5,
+    0.5,
+    0.5,
+    1,
+    200 / 255,
+    0 / 255,
+    0 / 255
+)
 --- Helper function to count the number of entities in room. Use this over the vanilla
 -- `Isaac.CountEntities` method to avoid having to specify a spawner and to handle ignoring charmed
 -- enemies.
@@ -20672,6 +20682,12 @@ function ____exports.rerollEnemy(self, entity)
     end
     return filteredNewEntities[1]
 end
+--- Helper function to make an entity flash red like it is taking damage. This is useful when you
+-- want to make it appear as if an entity is taking damage without actually dealing any damage to
+-- it.
+function ____exports.setEntityDamageFlash(self, entity)
+    entity:SetColor(DAMAGE_FLASH_COLOR, 2, 0)
+end
 function ____exports.setEntityRandomColor(self, entity)
     local rng = newRNG(nil, entity.InitSeed)
     local r = getRandom(nil, rng)
@@ -26934,6 +26950,7 @@ ____exports.SAVE_DATA_MANAGER_FEATURE_NAME = "save data manager"
 --- When the Glowing Hour Glass is used, certain save data keys will automatically be restored to a
 -- backup.
 ____exports.SAVE_DATA_MANAGER_GLOWING_HOUR_GLASS_BACKUP_KEYS = {SaveDataKey.RUN, SaveDataKey.LEVEL}
+____exports.SAVE_DATA_MANAGER_GLOWING_HOUR_GLASS_IGNORE_KEY = "__ignoreGlowingHourGlass"
 return ____exports
  end,
 ["src.features.saveDataManager.serializationBrands"] = function(...) 
@@ -31657,6 +31674,7 @@ local ____constants = require("src.features.saveDataManager.constants")
 local SAVE_DATA_MANAGER_DEBUG = ____constants.SAVE_DATA_MANAGER_DEBUG
 local SAVE_DATA_MANAGER_FEATURE_NAME = ____constants.SAVE_DATA_MANAGER_FEATURE_NAME
 local SAVE_DATA_MANAGER_GLOWING_HOUR_GLASS_BACKUP_KEYS = ____constants.SAVE_DATA_MANAGER_GLOWING_HOUR_GLASS_BACKUP_KEYS
+local SAVE_DATA_MANAGER_GLOWING_HOUR_GLASS_IGNORE_KEY = ____constants.SAVE_DATA_MANAGER_GLOWING_HOUR_GLASS_IGNORE_KEY
 local ____load = require("src.features.saveDataManager.load")
 local loadFromDisk = ____load.loadFromDisk
 local ____maps = require("src.features.saveDataManager.maps")
@@ -31724,9 +31742,14 @@ function makeGlowingHourGlassBackup(self)
                     if childTable == nil then
                         goto __continue18
                     end
+                    local childTableLuaMap = childTable
+                    if childTableLuaMap[SAVE_DATA_MANAGER_GLOWING_HOUR_GLASS_IGNORE_KEY] ~= nil then
+                        goto __continue18
+                    end
                     local saveDataGlowingHourGlass = saveDataGlowingHourGlassMap[subscriberName]
                     if saveDataGlowingHourGlass == nil then
                         saveDataGlowingHourGlass = {}
+                        saveDataGlowingHourGlassMap[subscriberName] = saveDataGlowingHourGlass
                     end
                     local copiedChildTable = deepCopy(nil, childTable)
                     saveDataGlowingHourGlass[saveDataKey] = copiedChildTable
@@ -31746,19 +31769,19 @@ function restoreGlowingHourGlassBackup(self)
                 do
                     local childTable = saveData[saveDataKey]
                     if childTable == nil then
-                        goto __continue24
+                        goto __continue25
                     end
                     local saveDataGlowingHourGlass = saveDataGlowingHourGlassMap[subscriberName]
                     if saveDataGlowingHourGlass == nil then
-                        goto __continue24
+                        goto __continue25
                     end
                     local childTableBackup = saveDataGlowingHourGlass[saveDataKey]
                     if childTableBackup == nil then
-                        goto __continue24
+                        goto __continue25
                     end
                     merge(nil, childTable, childTableBackup, subscriberName .. "__glowingHourGlass")
                 end
-                ::__continue24::
+                ::__continue25::
             end
         end,
         SAVE_DATA_MANAGER_DEBUG
@@ -31933,7 +31956,8 @@ local saveDataMap = ____maps.saveDataMap
 -- Note that when the player uses Glowing Hour Glass, the save data manager will automatically
 -- restore any variables on a "run" or "level" object with a backup that was created when the room
 -- was entered. Thus, you should not have to explicitly program support for Glowing Hour Glass into
--- your mod features that use the save data manager.
+-- your mod features that use the save data manager. If this is undesired for your specific
+-- use-case, then add a key of `__ignoreGlowingHourGlass: true` to your "run" or "level" object.
 -- 
 -- @param key The name of the file or feature that is submitting data to be managed by the save data
 -- manager. The save data manager will throw an error if the key is already registered.
@@ -47036,7 +47060,7 @@ return ____exports
 ["package"] = function(...) 
 return {
     name = "isaacscript-common",
-    version = "12.1.1",
+    version = "12.3.0",
     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 = "12.1.1",
+    version = "12.3.0",
     description = "Helper functions and features for IsaacScript mods.",
     keywords = {"isaac", "rebirth", "afterbirth", "repentance"},
     homepage = "https://isaacscript.github.io/",

package/dist/src/features/saveDataManager/constants.d.ts

@@ -7,4 +7,5 @@ export declare const SAVE_DATA_MANAGER_FEATURE_NAME = "save data manager";
  * backup.
  */
 export declare const SAVE_DATA_MANAGER_GLOWING_HOUR_GLASS_BACKUP_KEYS: SaveDataKey[];
+export declare const SAVE_DATA_MANAGER_GLOWING_HOUR_GLASS_IGNORE_KEY = "__ignoreGlowingHourGlass";
 //# sourceMappingURL=constants.d.ts.map

package/dist/src/features/saveDataManager/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/features/saveDataManager/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD,yEAAyE;AACzE,eAAO,MAAM,uBAAuB,SAAmB,CAAC;AAExD,eAAO,MAAM,8BAA8B,sBAAsB,CAAC;AAElE;;;GAGG;AACH,eAAO,MAAM,gDAAgD,eAG5D,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/features/saveDataManager/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD,yEAAyE;AACzE,eAAO,MAAM,uBAAuB,SAAmB,CAAC;AAExD,eAAO,MAAM,8BAA8B,sBAAsB,CAAC;AAElE;;;GAGG;AACH,eAAO,MAAM,gDAAgD,eAG5D,CAAC;AAEF,eAAO,MAAM,+CAA+C,6BAChC,CAAC"}

package/dist/src/features/saveDataManager/constants.lua

@@ -7,4 +7,5 @@ ____exports.SAVE_DATA_MANAGER_FEATURE_NAME = "save data manager"
 --- When the Glowing Hour Glass is used, certain save data keys will automatically be restored to a
 -- backup.
 ____exports.SAVE_DATA_MANAGER_GLOWING_HOUR_GLASS_BACKUP_KEYS = {SaveDataKey.RUN, SaveDataKey.LEVEL}
+____exports.SAVE_DATA_MANAGER_GLOWING_HOUR_GLASS_IGNORE_KEY = "__ignoreGlowingHourGlass"
 return ____exports

package/dist/src/features/saveDataManager/exports.d.ts

@@ -79,7 +79,8 @@ import { SaveData } from "../../interfaces/SaveData";
  * Note that when the player uses Glowing Hour Glass, the save data manager will automatically
  * restore any variables on a "run" or "level" object with a backup that was created when the room
  * was entered. Thus, you should not have to explicitly program support for Glowing Hour Glass into
- * your mod features that use the save data manager.
+ * your mod features that use the save data manager. If this is undesired for your specific
+ * use-case, then add a key of `__ignoreGlowingHourGlass: true` to your "run" or "level" object.
  *
  * @param key The name of the file or feature that is submitting data to be managed by the save data
  *            manager. The save data manager will throw an error if the key is already registered.

package/dist/src/features/saveDataManager/exports.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"exports.d.ts","sourceRoot":"","sources":["../../../../src/features/saveDataManager/exports.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAKtD,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAarD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8FG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,GAAG,EAAE,KAAK,EACpD,GAAG,EAAE,MAAM,EAAE,qEAAqE;AAClF,CAAC,EAAE,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE,KAAK,CAAC,EACnC,eAAe,CAAC,EAAE,MAAM,OAAO,GAC9B,IAAI,CAAC;AACR,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EAAE,kEAAkE;AAC/E,CAAC,EAAE,QAAQ,EACX,eAAe,EAAE,KAAK,GACrB,IAAI,CAAC;AA+CR;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAG1C;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAG1C;AAQD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAK/C;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,MAAM,EACX,cAAc,EAAE,WAAW,GAC1B,IAAI,CAiBN"}
+{"version":3,"file":"exports.d.ts","sourceRoot":"","sources":["../../../../src/features/saveDataManager/exports.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAKtD,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAarD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+FG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,GAAG,EAAE,KAAK,EACpD,GAAG,EAAE,MAAM,EAAE,qEAAqE;AAClF,CAAC,EAAE,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE,KAAK,CAAC,EACnC,eAAe,CAAC,EAAE,MAAM,OAAO,GAC9B,IAAI,CAAC;AACR,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EAAE,kEAAkE;AAC/E,CAAC,EAAE,QAAQ,EACX,eAAe,EAAE,KAAK,GACrB,IAAI,CAAC;AA+CR;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAG1C;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAG1C;AAQD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAK/C;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,MAAM,EACX,cAAc,EAAE,WAAW,GAC1B,IAAI,CAiBN"}

package/dist/src/features/saveDataManager/exports.lua

@@ -98,7 +98,8 @@ local saveDataMap = ____maps.saveDataMap
 -- Note that when the player uses Glowing Hour Glass, the save data manager will automatically
 -- restore any variables on a "run" or "level" object with a backup that was created when the room
 -- was entered. Thus, you should not have to explicitly program support for Glowing Hour Glass into
--- your mod features that use the save data manager.
+-- your mod features that use the save data manager. If this is undesired for your specific
+-- use-case, then add a key of `__ignoreGlowingHourGlass: true` to your "run" or "level" object.
 -- 
 -- @param key The name of the file or feature that is submitting data to be managed by the save data
 -- manager. The save data manager will throw an error if the key is already registered.

package/dist/src/features/saveDataManager/main.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../../../src/features/saveDataManager/main.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAGxD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAMtD,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AA0BrD,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI,CAelE;AAiKD,wBAAgB,sBAAsB,CACpC,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,QAAQ,EAClB,WAAW,EAAE,WAAW,GACvB,IAAI,CA4CN;AAiBD,wBAAgB,wBAAwB,IAAI,IAAI,CAM/C;AAED,wBAAgB,wBAAwB,IAAI,IAAI,CAM/C"}
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../../../src/features/saveDataManager/main.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAGxD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAMtD,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AA2BrD,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI,CAelE;AA6KD,wBAAgB,sBAAsB,CACpC,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,QAAQ,EAClB,WAAW,EAAE,WAAW,GACvB,IAAI,CA4CN;AAiBD,wBAAgB,wBAAwB,IAAI,IAAI,CAM/C;AAED,wBAAgB,wBAAwB,IAAI,IAAI,CAM/C"}

package/dist/src/features/saveDataManager/main.lua

@@ -27,6 +27,7 @@ local ____constants = require("src.features.saveDataManager.constants")
 local SAVE_DATA_MANAGER_DEBUG = ____constants.SAVE_DATA_MANAGER_DEBUG
 local SAVE_DATA_MANAGER_FEATURE_NAME = ____constants.SAVE_DATA_MANAGER_FEATURE_NAME
 local SAVE_DATA_MANAGER_GLOWING_HOUR_GLASS_BACKUP_KEYS = ____constants.SAVE_DATA_MANAGER_GLOWING_HOUR_GLASS_BACKUP_KEYS
+local SAVE_DATA_MANAGER_GLOWING_HOUR_GLASS_IGNORE_KEY = ____constants.SAVE_DATA_MANAGER_GLOWING_HOUR_GLASS_IGNORE_KEY
 local ____load = require("src.features.saveDataManager.load")
 local loadFromDisk = ____load.loadFromDisk
 local ____maps = require("src.features.saveDataManager.maps")
@@ -94,9 +95,14 @@ function makeGlowingHourGlassBackup(self)
                     if childTable == nil then
                         goto __continue18
                     end
+                    local childTableLuaMap = childTable
+                    if childTableLuaMap[SAVE_DATA_MANAGER_GLOWING_HOUR_GLASS_IGNORE_KEY] ~= nil then
+                        goto __continue18
+                    end
                     local saveDataGlowingHourGlass = saveDataGlowingHourGlassMap[subscriberName]
                     if saveDataGlowingHourGlass == nil then
                         saveDataGlowingHourGlass = {}
+                        saveDataGlowingHourGlassMap[subscriberName] = saveDataGlowingHourGlass
                     end
                     local copiedChildTable = deepCopy(nil, childTable)
                     saveDataGlowingHourGlass[saveDataKey] = copiedChildTable
@@ -116,19 +122,19 @@ function restoreGlowingHourGlassBackup(self)
                 do
                     local childTable = saveData[saveDataKey]
                     if childTable == nil then
-                        goto __continue24
+                        goto __continue25
                     end
                     local saveDataGlowingHourGlass = saveDataGlowingHourGlassMap[subscriberName]
                     if saveDataGlowingHourGlass == nil then
-                        goto __continue24
+                        goto __continue25
                     end
                     local childTableBackup = saveDataGlowingHourGlass[saveDataKey]
                     if childTableBackup == nil then
-                        goto __continue24
+                        goto __continue25
                     end
                     merge(nil, childTable, childTableBackup, subscriberName .. "__glowingHourGlass")
                 end
-                ::__continue24::
+                ::__continue25::
             end
         end,
         SAVE_DATA_MANAGER_DEBUG

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

@@ -151,6 +151,12 @@ export declare function removeEntities<T extends AnyEntity>(entities: T[], cap?:
  *          rerolled entity.
  */
 export declare function rerollEnemy(entity: Entity): Entity | undefined;
+/**
+ * Helper function to make an entity flash red like it is taking damage. This is useful when you
+ * want to make it appear as if an entity is taking damage without actually dealing any damage to
+ * it.
+ */
+export declare function setEntityDamageFlash(entity: Entity): void;
 export declare function setEntityRandomColor(entity: Entity): void;
 /**
  * Helper function to spawn an entity. Use this instead of the `Isaac.Spawn` method if you do not

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

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

package/dist/src/functions/entities.lua

@@ -59,6 +59,16 @@ function ____exports.removeEntities(self, entities, cap)
     end
     return entitiesRemoved
 end
+--- From DeadInfinity.
+local DAMAGE_FLASH_COLOR = Color(
+    0.5,
+    0.5,
+    0.5,
+    1,
+    200 / 255,
+    0 / 255,
+    0 / 255
+)
 --- Helper function to count the number of entities in room. Use this over the vanilla
 -- `Isaac.CountEntities` method to avoid having to specify a spawner and to handle ignoring charmed
 -- enemies.
@@ -351,6 +361,12 @@ function ____exports.rerollEnemy(self, entity)
     end
     return filteredNewEntities[1]
 end
+--- Helper function to make an entity flash red like it is taking damage. This is useful when you
+-- want to make it appear as if an entity is taking damage without actually dealing any damage to
+-- it.
+function ____exports.setEntityDamageFlash(self, entity)
+    entity:SetColor(DAMAGE_FLASH_COLOR, 2, 0)
+end
 function ____exports.setEntityRandomColor(self, entity)
     local rng = newRNG(nil, entity.InitSeed)
     local r = getRandom(nil, rng)

package/package.json

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

package/src/features/saveDataManager/constants.ts

@@ -13,3 +13,6 @@ export const SAVE_DATA_MANAGER_GLOWING_HOUR_GLASS_BACKUP_KEYS = [
   SaveDataKey.RUN,
   SaveDataKey.LEVEL,
 ];
+
+export const SAVE_DATA_MANAGER_GLOWING_HOUR_GLASS_IGNORE_KEY =
+  "__ignoreGlowingHourGlass";

package/src/features/saveDataManager/exports.ts

@@ -95,7 +95,8 @@ import {
  * Note that when the player uses Glowing Hour Glass, the save data manager will automatically
  * restore any variables on a "run" or "level" object with a backup that was created when the room
  * was entered. Thus, you should not have to explicitly program support for Glowing Hour Glass into
- * your mod features that use the save data manager.
+ * your mod features that use the save data manager. If this is undesired for your specific
+ * use-case, then add a key of `__ignoreGlowingHourGlass: true` to your "run" or "level" object.
  *
  * @param key The name of the file or feature that is submitting data to be managed by the save data
  *            manager. The save data manager will throw an error if the key is already registered.

package/src/features/saveDataManager/main.ts

@@ -13,6 +13,7 @@ import {
   SAVE_DATA_MANAGER_DEBUG,
   SAVE_DATA_MANAGER_FEATURE_NAME,
   SAVE_DATA_MANAGER_GLOWING_HOUR_GLASS_BACKUP_KEYS,
+  SAVE_DATA_MANAGER_GLOWING_HOUR_GLASS_IGNORE_KEY,
 } from "./constants";
 import { loadFromDisk } from "./load";
 import {
@@ -144,10 +145,22 @@ function makeGlowingHourGlassBackup() {
           continue;
         }
 
+        // Ignore child tables that the end-user has explicitly annotated.
+        const childTableLuaMap = childTable as LuaMap<AnyNotNil, unknown>;
+        if (
+          childTableLuaMap.has(SAVE_DATA_MANAGER_GLOWING_HOUR_GLASS_IGNORE_KEY)
+        ) {
+          continue;
+        }
+
         let saveDataGlowingHourGlass =
           saveDataGlowingHourGlassMap.get(subscriberName);
         if (saveDataGlowingHourGlass === undefined) {
           saveDataGlowingHourGlass = new LuaMap<string, unknown>() as SaveData;
+          saveDataGlowingHourGlassMap.set(
+            subscriberName,
+            saveDataGlowingHourGlass,
+          );
         }
 
         const copiedChildTable = deepCopy(childTable);

package/src/functions/entities.ts

@@ -9,6 +9,17 @@ import { isRNG, newRNG } from "./rng";
 import { asNumber, isPrimitive } from "./types";
 import { isVector, vectorToString } from "./vector";
 
+/** From DeadInfinity. */
+const DAMAGE_FLASH_COLOR: Readonly<Color> = Color(
+  0.5,
+  0.5,
+  0.5,
+  1.0,
+  200 / 255,
+  0 / 255,
+  0 / 255,
+);
+
 /**
  * Helper function to count the number of entities in room. Use this over the vanilla
  * `Isaac.CountEntities` method to avoid having to specify a spawner and to handle ignoring charmed
@@ -404,6 +415,15 @@ export function rerollEnemy(entity: Entity): Entity | undefined {
   return filteredNewEntities[0];
 }
 
+/**
+ * Helper function to make an entity flash red like it is taking damage. This is useful when you
+ * want to make it appear as if an entity is taking damage without actually dealing any damage to
+ * it.
+ */
+export function setEntityDamageFlash(entity: Entity): void {
+  entity.SetColor(DAMAGE_FLASH_COLOR, 2, 0);
+}
+
 export function setEntityRandomColor(entity: Entity): void {
   const rng = newRNG(entity.InitSeed);