isaacscript-common 9.0.1 → 9.2.0

package/dist/index.d.ts

@@ -6489,6 +6489,8 @@ export declare function logAllGridEntities(this: void, includeWalls: boolean, gr
 
 export declare function logArray<T>(this: void, array: T[] | readonly T[]): void;
 
+export declare function logCollectibleTypes(this: void, collectibleTypes: CollectibleType[]): void;
+
 export declare function logColor(this: void, color: Color): void;
 
 /** Helper function for printing out every damage flag that is turned on. Useful when debugging. */
@@ -7581,7 +7583,8 @@ export declare enum ModCallbackCustom {
     POST_PLAYER_CHANGE_TYPE = 57,
     /**
      * Fires from the `POST_PEFFECT_UPDATE` callback when a player's collectible count is higher than
-     * what it was on the previous frame or when a new active collectible is acquired.
+     * what it was on the previous frame, or when the active items change, or when the build is
+     * rerolled.
      *
      * When registering the callback, takes an optional second argument that will make the callback
      * only fire if the collectible matches the `CollectibleType` provided.
@@ -7596,7 +7599,8 @@ export declare enum ModCallbackCustom {
     POST_PLAYER_COLLECTIBLE_ADDED = 58,
     /**
      * Fires from the `POST_PEFFECT_UPDATE` callback when a player's collectible count is lower than
-     * what it was on the previous frame or when an active collectible is no longer present.
+     * what it was on the previous frame, or when the active items change, or when the build is
+     * rerolled.
      *
      * When registering the callback, takes an optional second argument that will make the callback
      * only fire if the collectible matches the `CollectibleType` provided.
@@ -8251,6 +8255,14 @@ export declare const ONE_BY_ONE_ROOM_GRID_SIZE = 135;
  */
 export declare function onFinalFloor(): boolean;
 
+/**
+ * Returns whether or not the player is on the first floor of the particular run.
+ *
+ * This is tricky to determine because we have to handle the cases of Downpour/Dross 1 not being the
+ * first floor and The Ascent.
+ */
+export declare function onFirstFloor(): boolean;
+
 export declare function onRepentanceStage(): boolean;
 
 /**
@@ -10859,12 +10871,6 @@ export declare function spawnCustomGridEntity(gridEntityTypeCustom: GridEntityTy
  * want to create a custom trapdoor that goes to a vanilla stage instead, use the
  * `spawnCustomTrapdoorToVanilla` helper function.
  *
- * Custom trapdoors can have one or more of the following attributes:
- *
- * - custom destination (or custom logic for after the player enters)
- * - custom graphics
- * - custom logic for opening/closing
- *
  * Under the hood, the custom trapdoor is represented by a decoration grid entity and is manually
  * respawned every time the player re-enters the room.
  *

package/dist/index.d.ts.map

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

package/dist/index.lua

@@ -551,14 +551,6 @@ do
         end
     end
 end
-do
-    local ____export = require("functions.dev")
-    for ____exportKey, ____exportValue in pairs(____export) do
-        if ____exportKey ~= "default" then
-            ____exports[____exportKey] = ____exportValue
-        end
-    end
-end
 do
     local ____export = require("functions.dimensions")
     for ____exportKey, ____exportValue in pairs(____export) do

package/package.json

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

package/src/callbacks/postPlayerCollectible.ts

@@ -5,15 +5,19 @@
 import {
   ActiveSlot,
   CollectibleType,
+  DamageFlag,
+  EntityType,
   ModCallback,
+  PlayerType,
 } from "isaac-typescript-definitions";
 import { DefaultMap } from "../classes/DefaultMap";
+import { runNextGameFrame } from "../features/runInNFrames";
 import { saveDataManager } from "../features/saveDataManager/exports";
 import { arrayEquals } from "../functions/array";
 import { getEnumValues } from "../functions/enums";
+import { hasFlag } from "../functions/flag";
 import {
   defaultMapGetPlayer,
-  mapGetPlayer,
   mapSetPlayer,
 } from "../functions/playerDataStructures";
 import { getPlayerCollectibleMap } from "../functions/players";
@@ -30,7 +34,7 @@ import {
 
 const v = {
   run: {
-    playersCollectibleCount: new Map<PlayerIndex, int>(),
+    playersCollectibleCount: new DefaultMap<PlayerIndex, int>(0),
     playersCollectibleMap: new DefaultMap<
       PlayerIndex,
       Map<CollectibleType, int>
@@ -45,7 +49,13 @@ const v = {
 export function postPlayerCollectibleCallbacksInit(mod: Mod): void {
   saveDataManager("postPlayerCollectible", v, hasSubscriptions);
 
+  mod.AddCallback(ModCallback.POST_USE_ITEM, useItemD4, CollectibleType.D4); // 3
   mod.AddCallback(ModCallback.POST_PEFFECT_UPDATE, postPEffectUpdate); // 4
+  mod.AddCallback(
+    ModCallback.ENTITY_TAKE_DMG,
+    entityTakeDmgPlayer,
+    EntityType.PLAYER,
+  ); // 11
 }
 
 function hasSubscriptions() {
@@ -55,37 +65,20 @@ function hasSubscriptions() {
   );
 }
 
-// ModCallback.POST_PEFFECT_UPDATE (4)
-function postPEffectUpdate(player: EntityPlayer) {
-  if (!hasSubscriptions()) {
-    return;
-  }
-
-  const oldCollectibleCount = mapGetPlayer(
-    v.run.playersCollectibleCount,
-    player,
-  );
-  const newCollectibleCount = player.GetCollectibleCount();
-  mapSetPlayer(v.run.playersCollectibleCount, player, newCollectibleCount);
-
-  if (oldCollectibleCount === undefined) {
-    return;
-  }
-
-  const difference = newCollectibleCount - oldCollectibleCount;
-
-  if (difference > 0) {
-    collectibleCountChanged(player, difference);
-  } else if (difference < 0) {
-    collectibleCountChanged(player, difference * -1);
-  } else if (difference === 0) {
-    checkActiveItemsChanged(player);
-  }
-}
-
-function collectibleCountChanged(
+/**
+ * This is called when the collectible count changes and in situations where the entire build is
+ * rerolled.
+ *
+ * Since getting a new player collectible map is expensive, we want to only run this function when
+ * necessary, and not on e.g. every frame. Unfortunately, this has the side effect of missing out on
+ * collectible changes from mods that add and remove a collectible on the same frame.
+ *
+ * @param player The player to update.
+ * @param numCollectiblesChanged Pass undefined for situations where the entire build was rerolled.
+ */
+function updateCollectibleMapAndFire(
   player: EntityPlayer,
-  numCollectiblesChanged: int,
+  numCollectiblesChanged: int | undefined,
 ) {
   const oldCollectibleMap = defaultMapGetPlayer(
     v.run.playersCollectibleMap,
@@ -94,13 +87,13 @@ function collectibleCountChanged(
   const newCollectibleMap = getPlayerCollectibleMap(player);
   mapSetPlayer(v.run.playersCollectibleMap, player, newCollectibleMap);
 
-  const collectibleTypeSet = new Set<CollectibleType>([
+  const collectibleTypesSet = new Set<CollectibleType>([
     ...oldCollectibleMap.keys(),
     ...newCollectibleMap.keys(),
   ]);
 
   let numFired = 0;
-  for (const collectibleType of collectibleTypeSet.values()) {
+  for (const collectibleType of collectibleTypesSet.values()) {
     const oldNum = oldCollectibleMap.get(collectibleType) ?? 0;
     const newNum = newCollectibleMap.get(collectibleType) ?? 0;
     const difference = newNum - oldNum;
@@ -122,9 +115,63 @@ function collectibleCountChanged(
   }
 }
 
+// ModCallback.POST_USE_ITEM (3)
+// CollectibleType.D4 (284)
+function useItemD4(
+  _collectibleType: CollectibleType,
+  _rng: RNG,
+  player: EntityPlayer,
+): boolean | undefined {
+  // This function is also triggered for:
+  // - D100
+  // - D Infinity copying D4 or D100
+  // - 1-pip dice room
+  // - 6-pip dice room
+  // - Reverse Wheel of Fortune copying 1-pip or 6-pip dice room
+  // - First getting Missing No.
+  // - Arriving on a new floor with Missing No.
+
+  // This function is not triggered for:
+  // - Tainted Eden getting hit (this is explicitly handled elsewhere)
+  // - Genesis (which is automatically handled by the collectibles being removed in the normal
+  //   `POST_PLAYER_COLLECTIBLE_REMOVED` callback)
+  updateCollectibleMapAndFire(player, undefined);
+
+  return undefined;
+}
+
+// ModCallback.POST_PEFFECT_UPDATE (4)
+function postPEffectUpdate(player: EntityPlayer) {
+  if (!hasSubscriptions()) {
+    return;
+  }
+
+  const oldCollectibleCount = defaultMapGetPlayer(
+    v.run.playersCollectibleCount,
+    player,
+  );
+  const newCollectibleCount = player.GetCollectibleCount();
+  mapSetPlayer(v.run.playersCollectibleCount, player, newCollectibleCount);
+
+  const difference = newCollectibleCount - oldCollectibleCount;
+
+  if (difference > 0) {
+    updateCollectibleMapAndFire(player, difference);
+  } else if (difference < 0) {
+    updateCollectibleMapAndFire(player, difference * -1);
+  } else if (difference === 0) {
+    checkActiveItemsChanged(player);
+  }
+}
+
 /**
- * The special case is when a player swaps their active item for another active item. In this
- * situation, their overall collectible count will not change. Thus, we explicitly check for this.
+ * Checking for collectible count will work to detect when a player swaps their active item for
+ * another active item. This is because the collectible count will decrement by 1 when the item is
+ * swapped onto the pedestal and the hold animation begins, and increment by 1 when the item is
+ * dequeued and the hold animation ends.
+ *
+ * However, we also want to explicitly check for the case where a mod swaps in a custom active
+ * collectible on the same frame, since doing so is cheap.
  */
 function checkActiveItemsChanged(player: EntityPlayer) {
   const activeItemMap = defaultMapGetPlayer(v.run.playersActiveItemMap, player);
@@ -143,48 +190,58 @@ function checkActiveItemsChanged(player: EntityPlayer) {
   }
 
   // For example, it is possible for the player to switch Schoolbag items, which will cause the
-  // collectibles in the array to be the same, but in a different order. Thus, sort both arrays
+  // collectibles in the array to be the same, but in a different order. Thus, we sort both arrays
   // before comparing them.
   oldCollectibleTypes.sort();
   newCollectibleTypes.sort();
 
   if (!arrayEquals(oldCollectibleTypes, newCollectibleTypes)) {
-    const collectibleTypeSet = new Set<CollectibleType>([
-      ...oldCollectibleTypes,
-      ...newCollectibleTypes,
-    ]);
-    activeItemsChanged(player, collectibleTypeSet);
+    // One or more active items have changed (with the player's total collectible count remaining
+    // the same).
+    updateCollectibleMapAndFire(player, undefined);
   }
 }
 
-/**
- * One or more active items have changed (with the player's total collectible count remaining the
- * same).
- */
-function activeItemsChanged(
-  player: EntityPlayer,
-  collectibleTypesSet: Set<CollectibleType>,
-) {
-  const oldCollectibleMap = defaultMapGetPlayer(
-    v.run.playersCollectibleMap,
-    player,
-  );
-  const newCollectibleMap = getPlayerCollectibleMap(player);
-  mapSetPlayer(v.run.playersCollectibleMap, player, newCollectibleMap);
+// ModCallback.ENTITY_TAKE_DMG (11)
+// EntityType.PLAYER (1)
+// We need to handle the case of Tainted Eden taking damage.
+function entityTakeDmgPlayer(
+  entity: Entity,
+  _amount: float,
+  damageFlags: BitFlags<DamageFlag>,
+  _source: EntityRef,
+  _countdownFrames: int,
+): boolean | undefined {
+  // Tainted Eden's mechanic does not apply if she e.g. uses Dull Razor.
+  if (hasFlag(damageFlags, DamageFlag.FAKE)) {
+    return undefined;
+  }
 
-  for (const collectibleType of collectibleTypesSet.values()) {
-    const oldNum = oldCollectibleMap.get(collectibleType) ?? 0;
-    const newNum = newCollectibleMap.get(collectibleType) ?? 0;
-    const difference = newNum - oldNum;
-    const increased = difference > 0;
-    const absoluteDifference = Math.abs(difference);
+  const player = entity.ToPlayer();
+  if (player === undefined) {
+    return undefined;
+  }
 
-    repeat(absoluteDifference, () => {
-      if (increased) {
-        postPlayerCollectibleAddedFire(player, collectibleType);
-      } else {
-        postPlayerCollectibleRemovedFire(player, collectibleType);
-      }
-    });
+  const character = player.GetPlayerType();
+  if (character !== PlayerType.EDEN_B) {
+    return undefined;
   }
+
+  // The items will only be rerolled after the damage is successfully applied.
+  const ptr = EntityPtr(player);
+  runNextGameFrame(() => {
+    const futureEntity = ptr.Ref;
+    if (futureEntity === undefined) {
+      return;
+    }
+
+    const futurePlayer = futureEntity.ToPlayer();
+    if (futurePlayer === undefined) {
+      return;
+    }
+
+    updateCollectibleMapAndFire(player, undefined);
+  });
+
+  return undefined;
 }

package/src/enums/ModCallbackCustom.ts

@@ -959,7 +959,8 @@ export enum ModCallbackCustom {
 
   /**
    * Fires from the `POST_PEFFECT_UPDATE` callback when a player's collectible count is higher than
-   * what it was on the previous frame or when a new active collectible is acquired.
+   * what it was on the previous frame, or when the active items change, or when the build is
+   * rerolled.
    *
    * When registering the callback, takes an optional second argument that will make the callback
    * only fire if the collectible matches the `CollectibleType` provided.
@@ -975,7 +976,8 @@ export enum ModCallbackCustom {
 
   /**
    * Fires from the `POST_PEFFECT_UPDATE` callback when a player's collectible count is lower than
-   * what it was on the previous frame or when an active collectible is no longer present.
+   * what it was on the previous frame, or when the active items change, or when the build is
+   * rerolled.
    *
    * When registering the callback, takes an optional second argument that will make the callback
    * only fire if the collectible matches the `CollectibleType` provided.

package/src/features/customTrapdoor/exports.ts

@@ -10,12 +10,6 @@ import { spawnCustomTrapdoorToDestination } from "./spawn";
  * want to create a custom trapdoor that goes to a vanilla stage instead, use the
  * `spawnCustomTrapdoorToVanilla` helper function.
  *
- * Custom trapdoors can have one or more of the following attributes:
- *
- * - custom destination (or custom logic for after the player enters)
- * - custom graphics
- * - custom logic for opening/closing
- *
  * Under the hood, the custom trapdoor is represented by a decoration grid entity and is manually
  * respawned every time the player re-enters the room.
  *

package/src/features/playerInventory.ts

@@ -1,4 +1,4 @@
-import { CollectibleType, ModCallback } from "isaac-typescript-definitions";
+import { CollectibleType } from "isaac-typescript-definitions";
 import { DefaultMap } from "../classes/DefaultMap";
 import { ModUpgraded } from "../classes/ModUpgraded";
 import { ModCallbackCustom } from "../enums/ModCallbackCustom";
@@ -9,13 +9,7 @@ import {
   getLastElement,
 } from "../functions/array";
 import { isActiveCollectible } from "../functions/collectibles";
-import { getCollectibleArray } from "../functions/collectibleSet";
-import {
-  defaultMapGetPlayer,
-  mapSetPlayer,
-} from "../functions/playerDataStructures";
-import { getAllPlayers, getPlayerIndex } from "../functions/playerIndex";
-import { repeat } from "../functions/utils";
+import { defaultMapGetPlayer } from "../functions/playerDataStructures";
 import { PlayerIndex } from "../types/PlayerIndex";
 import { saveDataManager } from "./saveDataManager/exports";
 
@@ -27,36 +21,14 @@ const v = {
       PlayerIndex,
       CollectibleType[],
       [player: EntityPlayer]
-    >((player: EntityPlayer) => newPlayerInventory(player)),
+    >(() => []),
   },
 };
 
-function newPlayerInventory(player: EntityPlayer) {
-  const inventory: CollectibleType[] = [];
-
-  for (const collectibleType of getCollectibleArray()) {
-    // We need to specify "true" as the second argument here to filter out things like Lilith's
-    // Incubus.
-    const numCollectibles = player.GetCollectibleNum(collectibleType, true);
-    repeat(numCollectibles, () => {
-      inventory.push(collectibleType);
-    });
-  }
-
-  return inventory;
-}
-
-function resetInventory(player: EntityPlayer) {
-  const inventory = newPlayerInventory(player);
-  mapSetPlayer(v.run.playersInventory, player, inventory);
-}
-
 /** @internal */
 export function playerInventoryInit(mod: ModUpgraded): void {
   saveDataManager(FEATURE_NAME, v);
 
-  mod.AddCallback(ModCallback.POST_USE_ITEM, useItemD4, CollectibleType.D4); // 3
-  mod.AddCallback(ModCallback.POST_GAME_STARTED, postGameStarted); // 15
   mod.AddCallbackCustom(
     ModCallbackCustom.POST_PLAYER_COLLECTIBLE_ADDED,
     postCollectibleAdded,
@@ -67,33 +39,6 @@ export function playerInventoryInit(mod: ModUpgraded): void {
   );
 }
 
-// ModCallback.POST_USE_ITEM (3)
-// CollectibleType.D4 (284)
-function useItemD4(
-  _collectibleType: CollectibleType,
-  _rng: RNG,
-  player: EntityPlayer,
-): boolean | undefined {
-  // This function is also triggered when the player uses D100, D Infinity, a 1-pip dice room, or a
-  // 6-pip dice room. (Genesis should be automatically handled by the
-  // `POST_PLAYER_COLLECTIBLE_REMOVED` callback.)
-  resetInventory(player);
-
-  return undefined;
-}
-
-// ModCallback.POST_GAME_STARTED (15)
-function postGameStarted() {
-  // We don't use the `POST_PLAYER_INIT` callback because some items are not given to the player at
-  // that point.
-  for (const player of getAllPlayers()) {
-    const playerIndex = getPlayerIndex(player);
-    if (!v.run.playersInventory.has(playerIndex)) {
-      resetInventory(player);
-    }
-  }
-}
-
 // ModCallbackCustom.POST_PLAYER_COLLECTIBLE_ADDED
 function postCollectibleAdded(
   player: EntityPlayer,
@@ -140,12 +85,11 @@ export function getPlayerInventory(
 
   const inventory = defaultMapGetPlayer(v.run.playersInventory, player, player);
 
-  const copiedInventory = copyArray(inventory);
   if (includeActiveCollectibles) {
-    return copiedInventory;
+    return copyArray(inventory);
   }
 
-  return copiedInventory.filter(
+  return inventory.filter(
     (collectibleType) => !isActiveCollectible(collectibleType),
   );
 }

package/src/features/saveDataManager/main.ts

@@ -6,6 +6,7 @@ import { SaveDataKey } from "../../enums/SaveDataKey";
 import { SerializationType } from "../../enums/SerializationType";
 import { deepCopy } from "../../functions/deepCopy";
 import { logError } from "../../functions/log";
+import { onFirstFloor } from "../../functions/stage";
 import { clearTable, iterateTableInOrder } from "../../functions/table";
 import { SaveData } from "../../interfaces/SaveData";
 import { loadFromDisk } from "./load";
@@ -49,6 +50,8 @@ function postPlayerInit() {
     );
   }
 
+  // We want to only load data once per run to handle the case of a player using Genesis, a second
+  // player joining the run, and so on.
   if (loadedDataOnThisRun) {
     return;
   }
@@ -86,7 +89,19 @@ function preGameExit() {
 
 // ModCallback.POST_NEW_LEVEL (18)
 function postNewLevel() {
+  if (mod === null) {
+    error(
+      `The mod for the ${SAVE_DATA_MANAGER_FEATURE_NAME} was not initialized.`,
+    );
+  }
+
   restoreDefaults(SaveDataKey.LEVEL);
+
+  // We save data to disk at the beginning of every floor (for the 2nd floor and beyond) to emulate
+  // what the game does internally. (This mitigates data loss in the event of a crash).
+  if (!onFirstFloor()) {
+    saveToDisk(mod, saveDataMap, saveDataConditionalFuncMap);
+  }
 }
 
 // ModCallbackCustom.POST_NEW_ROOM_EARLY

package/src/functions/debug.ts

@@ -1,4 +1,36 @@
+import { ModUpgraded } from "../classes/ModUpgraded";
+import { enableExtraConsoleCommands } from "../features/extraConsoleCommands/exports";
+import { removeFadeIn } from "../features/fadeInRemover";
+import { enableFastReset } from "../features/fastReset";
+import { saveDataManagerSetGlobal } from "../features/saveDataManager/exports";
+import * as logExports from "./log";
 import { log } from "./log";
+import * as logEntitiesExports from "./logEntities";
+
+/**
+ * Helper function to enable some IsaacScript features that are useful when developing a mod. They
+ * should not be enabled when your mod goes to production (i.e. when it is uploaded to the Steam
+ * Workshop).
+ *
+ * The list of development features that are enabled are as follows:
+ *
+ * - `saveDataManagerSetGlobal` - Sets your local variables registered with the save data manager as
+ *   global variables so you can access them from the in-game console.
+ * - `setLogFunctionsGlobal` - Sets the various log functions global so that you can access them
+ *   from the in-game console.
+ * - `enableExtraConsoleCommands` - Enables many extra in-game console commands that make warping
+ *   around easier (like e.g. `angel` to warp to the Angel Room).
+ * - `enableFastReset` - Makes it so that the r key resets the game instantaneously.
+ * - `removeFadeIn` - Removes the slow fade in that occurs at the beginning of the run, so that you
+ *   can immediately start playing or testing.
+ */
+export function enableDevFeatures(mod: ModUpgraded): void {
+  saveDataManagerSetGlobal();
+  setLogFunctionsGlobal();
+  enableExtraConsoleCommands(mod);
+  enableFastReset();
+  removeFadeIn();
+}
 
 /**
  * Helper function to get a stack trace.
@@ -37,6 +69,23 @@ export function isLuaDebugEnabled(): boolean {
   return _G.package !== undefined;
 }
 
+/**
+ * Converts every `isaacscript-common` function that begins with "log" to a global function.
+ *
+ * This is useful when printing out variables from the in-game debug console.
+ */
+export function setLogFunctionsGlobal(): void {
+  const globals = _G as Record<string, unknown>;
+
+  for (const [logFuncName, logFunc] of Object.entries(logExports)) {
+    globals[logFuncName] = logFunc;
+  }
+
+  for (const [logFuncName, logFunc] of Object.entries(logEntitiesExports)) {
+    globals[logFuncName] = logFunc;
+  }
+}
+
 /**
  * Helper function to print a stack trace to the "log.txt" file, similar to JavaScript's
  * `console.trace` function.

package/src/functions/log.ts

@@ -1,4 +1,5 @@
 import {
+  CollectibleType,
   DamageFlag,
   EntityFlag,
   GameStateFlag,
@@ -73,6 +74,20 @@ export function logArray<T>(this: void, array: T[] | readonly T[]): void {
   log(`Array: ${arrayString}`);
 }
 
+export function logCollectibleTypes(
+  this: void,
+  collectibleTypes: CollectibleType[],
+): void {
+  log("Collectibles:");
+
+  let i = 1;
+  for (const collectibleType of collectibleTypes) {
+    const collectibleName = getCollectibleName(collectibleType);
+    log(`${i}) ${collectibleName} (${collectibleType})`);
+    i++;
+  }
+}
+
 export function logColor(this: void, color: Color): void {
   log(
     `Color: R${color.R}, G${color.G}, B${color.B}, A${color.A}, RO${color.RO}, BO${color.BO}, GO${color.GO}`,
@@ -482,38 +497,3 @@ export function logVector(this: void, vector: Vector, round = false): void {
   const vectorString = vectorToString(vector, round);
   log(`Vector: ${vectorString}`);
 }
-
-/**
- * Converts every `isaacscript-common` function that begins with "log" to a global function.
- *
- * This is useful when printing out variables from the in-game debug console.
- */
-export function setLogFunctionsGlobal(): void {
-  const globals = _G as Record<string, unknown>;
-
-  globals["log"] = log;
-  globals["logArray"] = logArray;
-  globals["logColor"] = logColor;
-  globals["logDamageFlags"] = logDamageFlags;
-  globals["logEntityID"] = logEntityID;
-  globals["logEntityFlags"] = logEntityFlags;
-  globals["logError"] = logError;
-  globals["logFlags"] = logFlags;
-  globals["logGameStateFlags"] = logGameStateFlags;
-  globals["logKColor"] = logKColor;
-  globals["logLevelStateFlags"] = logLevelStateFlags;
-  globals["logMap"] = logMap;
-  globals["logPlayerEffects"] = logPlayerEffects;
-  globals["logPlayerHealth"] = logPlayerHealth;
-  globals["logProjectileFlags"] = logProjectileFlags;
-  globals["logRoom"] = logRoom;
-  globals["logSeedEffects"] = logSeedEffects;
-  globals["logSet"] = logSet;
-  globals["logSounds"] = logSounds;
-  globals["logTable"] = logTable;
-  globals["logTableDifferences"] = logTableDifferences;
-  globals["logTearFlags"] = logTearFlags;
-  globals["logUseFlags"] = logUseFlags;
-  globals["logUserdata"] = logUserdata;
-  globals["logVector"] = logVector;
-}