isaacscript-common 47.2.0 → 47.4.0

package/dist/index.rollup.d.ts

@@ -74,6 +74,7 @@ import { RoomShape } from 'isaac-typescript-definitions';
 import { RoomTransitionAnim } from 'isaac-typescript-definitions';
 import { RoomType } from 'isaac-typescript-definitions';
 import type { SackSubType } from 'isaac-typescript-definitions';
+import { SeedEffect } from 'isaac-typescript-definitions';
 import type { SlotVariant } from 'isaac-typescript-definitions';
 import type { StageID } from 'isaac-typescript-definitions';
 import { StageType } from 'isaac-typescript-definitions';
@@ -979,6 +980,9 @@ export declare function angleToDirection(angleDegrees: int): Direction;
 /** Helper type to represent any class. (This is the same type as any class constructor.) */
 export declare type AnyClass = new () => object;
 
+/** Alias for the `anySeedEffectEnabled` function. */
+export declare function anyEasterEggEnabled(): boolean;
+
 /**
  * A type union that matches `Entity`, `EntityBomb`, `EntityEffect`, and so on.
  *
@@ -1051,6 +1055,11 @@ export declare function anyPlayerHoldingItem(): boolean;
  */
 export declare function anyPlayerIs(...matchingCharacters: PlayerType[]): boolean;
 
+/**
+ * Helper function to see if any seed effects (i.e. Easter Eggs) are enabled for the current run.
+ */
+export declare function anySeedEffectEnabled(): boolean;
+
 declare type Arr<N extends number, T extends unknown[] = []> = T["length"] extends N ? T : Arr<N, [...T, unknown]>;
 
 declare type Arr_2<N extends number, T extends unknown[] = []> = T["length"] extends N ? T : Arr_2<N, [...T, unknown]>;
@@ -1347,6 +1356,9 @@ export declare function canPlayerCrushRocks(player: EntityPlayer): boolean;
 /**
  * Helper function to see if the current run can unlock achievements. For example, if playing on a
  * set seed or in a victory lap, achievements are disabled.
+ *
+ * Under the hood, this is determined by spawning a Greed Donation Machine and then seeing if it
+ * exists before removing it.
  */
 export declare function canRunUnlockAchievements(): boolean;
 
@@ -7301,6 +7313,11 @@ export declare function getScreenTopLeftPos(): Readonly<Vector>;
 
 export declare function getScreenTopRightPos(): Readonly<Vector>;
 
+/**
+ * Helper function to get the seed effects (i.e. Easter Eggs) that are enabled for the current run.
+ */
+export declare function getSeedEffects(): SeedEffect[];
+
 /**
  * Helper function to get all possible combinations of the given set. This includes the combination
  * of an empty set.

package/dist/isaacscript-common.lua

@@ -1,6 +1,6 @@
 --[[
 
-isaacscript-common 47.2.0
+isaacscript-common 47.4.0
 
 This is the "isaacscript-common" library, which was created with the IsaacScript tool.
 
@@ -20100,6 +20100,7 @@ local PillColor = ____isaac_2Dtypescript_2Ddefinitions.PillColor
 local PlayerForm = ____isaac_2Dtypescript_2Ddefinitions.PlayerForm
 local PocketItemSlot = ____isaac_2Dtypescript_2Ddefinitions.PocketItemSlot
 local RoomShape = ____isaac_2Dtypescript_2Ddefinitions.RoomShape
+local SeedEffect = ____isaac_2Dtypescript_2Ddefinitions.SeedEffect
 local SoundEffect = ____isaac_2Dtypescript_2Ddefinitions.SoundEffect
 local TrinketSlot = ____isaac_2Dtypescript_2Ddefinitions.TrinketSlot
 local ____HealthType = require("src.enums.HealthType")
@@ -20126,6 +20127,7 @@ ____exports.PILL_COLOR_VALUES = getEnumValues(nil, PillColor)
 ____exports.PLAYER_FORM_VALUES = getEnumValues(nil, PlayerForm)
 ____exports.POCKET_ITEM_SLOT_VALUES = getEnumValues(nil, PocketItemSlot)
 ____exports.ROOM_SHAPE_VALUES = getEnumValues(nil, RoomShape)
+____exports.SEED_EFFECTS = getEnumValues(nil, SeedEffect)
 ____exports.SERIALIZATION_BRAND_VALUES = getEnumValues(nil, SerializationBrand)
 ____exports.SOUND_EFFECT_VALUES = getEnumValues(nil, SoundEffect)
 ____exports.PLAYER_STAT_VALUES = getEnumValues(nil, PlayerStat)
@@ -22500,11 +22502,16 @@ end
 return ____exports
  end,
 ["src.functions.run"] = function(...) 
+local ____lualib = require("lualib_bundle")
+local __TS__ArrayFilter = ____lualib.__TS__ArrayFilter
 local ____exports = {}
 local ____isaac_2Dtypescript_2Ddefinitions = require("lua_modules.isaac-typescript-definitions.dist.src.index")
 local Challenge = ____isaac_2Dtypescript_2Ddefinitions.Challenge
 local Difficulty = ____isaac_2Dtypescript_2Ddefinitions.Difficulty
+local SeedEffect = ____isaac_2Dtypescript_2Ddefinitions.SeedEffect
 local SlotVariant = ____isaac_2Dtypescript_2Ddefinitions.SlotVariant
+local ____cachedEnumValues = require("src.arrays.cachedEnumValues")
+local SEED_EFFECTS = ____cachedEnumValues.SEED_EFFECTS
 local ____cachedClasses = require("src.core.cachedClasses")
 local game = ____cachedClasses.game
 local ____constants = require("src.core.constants")
@@ -22517,12 +22524,27 @@ local ____entitiesSpecific = require("src.functions.entitiesSpecific")
 local spawnSlot = ____entitiesSpecific.spawnSlot
 local ____log = require("src.functions.log")
 local log = ____log.log
+function ____exports.anySeedEffectEnabled(self)
+    local seeds = game:GetSeeds()
+    local numSeedEffects = seeds:CountSeedEffects()
+    return numSeedEffects > 0
+end
+function ____exports.anyEasterEggEnabled(self)
+    return ____exports.anySeedEffectEnabled(nil)
+end
 function ____exports.canRunUnlockAchievements(self)
     local greedDonationMachine = spawnSlot(nil, SlotVariant.GREED_DONATION_MACHINE, 0, VectorZero)
     local canUnlockAchievements = greedDonationMachine:Exists()
     greedDonationMachine:Remove()
     return canUnlockAchievements
 end
+function ____exports.getSeedEffects(self)
+    local seeds = game:GetSeeds()
+    return __TS__ArrayFilter(
+        SEED_EFFECTS,
+        function(____, seedEffect) return seedEffect ~= SeedEffect.NORMAL and seeds:HasSeedEffect(seedEffect) end
+    )
+end
 function ____exports.isGreedMode(self)
     return game.Difficulty == Difficulty.GREED or game.Difficulty == Difficulty.GREEDIER
 end

package/dist/src/arrays/cachedEnumValues.d.ts

@@ -1,4 +1,4 @@
-import { ActiveSlot, CacheFlag, ControllerIndex, DoorSlot, DoorSlotFlag, GridEntityType, GridEntityXMLType, ItemConfigCardType, ItemConfigTag, ItemPoolType, Keyboard, PillColor, PlayerForm, PocketItemSlot, RoomShape, SoundEffect, TrinketSlot } from "isaac-typescript-definitions";
+import { ActiveSlot, CacheFlag, ControllerIndex, DoorSlot, DoorSlotFlag, GridEntityType, GridEntityXMLType, ItemConfigCardType, ItemConfigTag, ItemPoolType, Keyboard, PillColor, PlayerForm, PocketItemSlot, RoomShape, SeedEffect, SoundEffect, TrinketSlot } from "isaac-typescript-definitions";
 import { HealthType } from "../enums/HealthType";
 import { PlayerStat } from "../enums/PlayerStat";
 import { SerializationBrand } from "../enums/private/SerializationBrand";
@@ -18,6 +18,7 @@ export declare const PILL_COLOR_VALUES: readonly PillColor[];
 export declare const PLAYER_FORM_VALUES: readonly PlayerForm[];
 export declare const POCKET_ITEM_SLOT_VALUES: readonly PocketItemSlot[];
 export declare const ROOM_SHAPE_VALUES: readonly RoomShape[];
+export declare const SEED_EFFECTS: readonly SeedEffect[];
 export declare const SERIALIZATION_BRAND_VALUES: readonly SerializationBrand[];
 export declare const SOUND_EFFECT_VALUES: readonly SoundEffect[];
 export declare const PLAYER_STAT_VALUES: readonly PlayerStat[];

package/dist/src/arrays/cachedEnumValues.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cachedEnumValues.d.ts","sourceRoot":"","sources":["../../../src/arrays/cachedEnumValues.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,UAAU,EACV,SAAS,EACT,eAAe,EACf,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,EACb,YAAY,EACZ,QAAQ,EACR,SAAS,EACT,UAAU,EACV,cAAc,EACd,SAAS,EACT,WAAW,EACX,WAAW,EACZ,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAGzE,eAAO,MAAM,kBAAkB,EAAE,SAAS,UAAU,EACzB,CAAC;AAE5B,eAAO,MAAM,iBAAiB,EAAE,SAAS,SAAS,EAA6B,CAAC;AAEhF,eAAO,MAAM,uBAAuB,EAAE,SAAS,eAAe,EAC9B,CAAC;AAEjC,eAAO,MAAM,qBAAqB,EAAE,SAAS,YAAY,EAC5B,CAAC;AAE9B,eAAO,MAAM,gBAAgB,EAAE,SAAS,QAAQ,EAA4B,CAAC;AAE7E,eAAO,MAAM,uBAAuB,EAAE,SAAS,cAAc,EAC9B,CAAC;AAEhC,eAAO,MAAM,2BAA2B,EAAE,SAAS,iBAAiB,EAClC,CAAC;AAEnC,eAAO,MAAM,sBAAsB,EAAE,SAAS,aAAa,EAC7B,CAAC;AAE/B,eAAO,MAAM,4BAA4B,EAAE,SAAS,kBAAkB,EACnC,CAAC;AAEpC,eAAO,MAAM,qBAAqB,EAAE,SAAS,YAAY,EAC5B,CAAC;AAE9B,eAAO,MAAM,eAAe,EAAE,SAAS,QAAQ,EAA4B,CAAC;AAE5E,eAAO,MAAM,kBAAkB,EAAE,SAAS,UAAU,EACzB,CAAC;AAE5B,eAAO,MAAM,iBAAiB,EAAE,SAAS,SAAS,EAA6B,CAAC;AAEhF,eAAO,MAAM,kBAAkB,EAAE,SAAS,UAAU,EACzB,CAAC;AAE5B,eAAO,MAAM,uBAAuB,EAAE,SAAS,cAAc,EAC9B,CAAC;AAEhC,eAAO,MAAM,iBAAiB,EAAE,SAAS,SAAS,EAA6B,CAAC;AAEhF,eAAO,MAAM,0BAA0B,EAAE,SAAS,kBAAkB,EACjC,CAAC;AAEpC,eAAO,MAAM,mBAAmB,EAAE,SAAS,WAAW,EAC1B,CAAC;AAE7B,eAAO,MAAM,kBAAkB,EAAE,SAAS,UAAU,EACzB,CAAC;AAE5B,eAAO,MAAM,mBAAmB,EAAE,SAAS,WAAW,EAC1B,CAAC"}
+{"version":3,"file":"cachedEnumValues.d.ts","sourceRoot":"","sources":["../../../src/arrays/cachedEnumValues.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,UAAU,EACV,SAAS,EACT,eAAe,EACf,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,EACb,YAAY,EACZ,QAAQ,EACR,SAAS,EACT,UAAU,EACV,cAAc,EACd,SAAS,EACT,UAAU,EACV,WAAW,EACX,WAAW,EACZ,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAGzE,eAAO,MAAM,kBAAkB,EAAE,SAAS,UAAU,EACzB,CAAC;AAE5B,eAAO,MAAM,iBAAiB,EAAE,SAAS,SAAS,EAA6B,CAAC;AAEhF,eAAO,MAAM,uBAAuB,EAAE,SAAS,eAAe,EAC9B,CAAC;AAEjC,eAAO,MAAM,qBAAqB,EAAE,SAAS,YAAY,EAC5B,CAAC;AAE9B,eAAO,MAAM,gBAAgB,EAAE,SAAS,QAAQ,EAA4B,CAAC;AAE7E,eAAO,MAAM,uBAAuB,EAAE,SAAS,cAAc,EAC9B,CAAC;AAEhC,eAAO,MAAM,2BAA2B,EAAE,SAAS,iBAAiB,EAClC,CAAC;AAEnC,eAAO,MAAM,sBAAsB,EAAE,SAAS,aAAa,EAC7B,CAAC;AAE/B,eAAO,MAAM,4BAA4B,EAAE,SAAS,kBAAkB,EACnC,CAAC;AAEpC,eAAO,MAAM,qBAAqB,EAAE,SAAS,YAAY,EAC5B,CAAC;AAE9B,eAAO,MAAM,eAAe,EAAE,SAAS,QAAQ,EAA4B,CAAC;AAE5E,eAAO,MAAM,kBAAkB,EAAE,SAAS,UAAU,EACzB,CAAC;AAE5B,eAAO,MAAM,iBAAiB,EAAE,SAAS,SAAS,EAA6B,CAAC;AAEhF,eAAO,MAAM,kBAAkB,EAAE,SAAS,UAAU,EACzB,CAAC;AAE5B,eAAO,MAAM,uBAAuB,EAAE,SAAS,cAAc,EAC9B,CAAC;AAEhC,eAAO,MAAM,iBAAiB,EAAE,SAAS,SAAS,EAA6B,CAAC;AAEhF,eAAO,MAAM,YAAY,EAAE,SAAS,UAAU,EAA8B,CAAC;AAE7E,eAAO,MAAM,0BAA0B,EAAE,SAAS,kBAAkB,EACjC,CAAC;AAEpC,eAAO,MAAM,mBAAmB,EAAE,SAAS,WAAW,EAC1B,CAAC;AAE7B,eAAO,MAAM,kBAAkB,EAAE,SAAS,UAAU,EACzB,CAAC;AAE5B,eAAO,MAAM,mBAAmB,EAAE,SAAS,WAAW,EAC1B,CAAC"}

package/dist/src/arrays/cachedEnumValues.lua

@@ -15,6 +15,7 @@ local PillColor = ____isaac_2Dtypescript_2Ddefinitions.PillColor
 local PlayerForm = ____isaac_2Dtypescript_2Ddefinitions.PlayerForm
 local PocketItemSlot = ____isaac_2Dtypescript_2Ddefinitions.PocketItemSlot
 local RoomShape = ____isaac_2Dtypescript_2Ddefinitions.RoomShape
+local SeedEffect = ____isaac_2Dtypescript_2Ddefinitions.SeedEffect
 local SoundEffect = ____isaac_2Dtypescript_2Ddefinitions.SoundEffect
 local TrinketSlot = ____isaac_2Dtypescript_2Ddefinitions.TrinketSlot
 local ____HealthType = require("src.enums.HealthType")
@@ -41,6 +42,7 @@ ____exports.PILL_COLOR_VALUES = getEnumValues(nil, PillColor)
 ____exports.PLAYER_FORM_VALUES = getEnumValues(nil, PlayerForm)
 ____exports.POCKET_ITEM_SLOT_VALUES = getEnumValues(nil, PocketItemSlot)
 ____exports.ROOM_SHAPE_VALUES = getEnumValues(nil, RoomShape)
+____exports.SEED_EFFECTS = getEnumValues(nil, SeedEffect)
 ____exports.SERIALIZATION_BRAND_VALUES = getEnumValues(nil, SerializationBrand)
 ____exports.SOUND_EFFECT_VALUES = getEnumValues(nil, SoundEffect)
 ____exports.PLAYER_STAT_VALUES = getEnumValues(nil, PlayerStat)

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

@@ -1,9 +1,23 @@
 import type { PlayerType } from "isaac-typescript-definitions";
+import { SeedEffect } from "isaac-typescript-definitions";
+/** Alias for the `anySeedEffectEnabled` function. */
+export declare function anyEasterEggEnabled(): boolean;
+/**
+ * Helper function to see if any seed effects (i.e. Easter Eggs) are enabled for the current run.
+ */
+export declare function anySeedEffectEnabled(): boolean;
 /**
  * Helper function to see if the current run can unlock achievements. For example, if playing on a
  * set seed or in a victory lap, achievements are disabled.
+ *
+ * Under the hood, this is determined by spawning a Greed Donation Machine and then seeing if it
+ * exists before removing it.
  */
 export declare function canRunUnlockAchievements(): boolean;
+/**
+ * Helper function to get the seed effects (i.e. Easter Eggs) that are enabled for the current run.
+ */
+export declare function getSeedEffects(): SeedEffect[];
 /**
  * Helper function to check if the difficulty of the current run is equal to `Difficulty.GREED` or
  * `Difficulty.GREEDIER`.

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

@@ -1 +1 @@
-{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/functions/run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAa/D;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,OAAO,CAUlD;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,OAAO,CAKrC;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAMnC;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,SAAS,CAAC,EAAE,UAAU,GAAG,IAAI,CAkBpD;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAUlC"}
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/functions/run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAGL,UAAU,EAEX,MAAM,8BAA8B,CAAC;AAStC,qDAAqD;AACrD,wBAAgB,mBAAmB,IAAI,OAAO,CAE7C;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAK9C;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,IAAI,OAAO,CAUlD;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,UAAU,EAAE,CAO7C;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,OAAO,CAKrC;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAMnC;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,SAAS,CAAC,EAAE,UAAU,GAAG,IAAI,CAkBpD;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAUlC"}

package/dist/src/functions/run.lua

@@ -1,8 +1,13 @@
+local ____lualib = require("lualib_bundle")
+local __TS__ArrayFilter = ____lualib.__TS__ArrayFilter
 local ____exports = {}
 local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
 local Challenge = ____isaac_2Dtypescript_2Ddefinitions.Challenge
 local Difficulty = ____isaac_2Dtypescript_2Ddefinitions.Difficulty
+local SeedEffect = ____isaac_2Dtypescript_2Ddefinitions.SeedEffect
 local SlotVariant = ____isaac_2Dtypescript_2Ddefinitions.SlotVariant
+local ____cachedEnumValues = require("src.arrays.cachedEnumValues")
+local SEED_EFFECTS = ____cachedEnumValues.SEED_EFFECTS
 local ____cachedClasses = require("src.core.cachedClasses")
 local game = ____cachedClasses.game
 local ____constants = require("src.core.constants")
@@ -15,14 +20,35 @@ local ____entitiesSpecific = require("src.functions.entitiesSpecific")
 local spawnSlot = ____entitiesSpecific.spawnSlot
 local ____log = require("src.functions.log")
 local log = ____log.log
+--- Helper function to see if any seed effects (i.e. Easter Eggs) are enabled for the current run.
+function ____exports.anySeedEffectEnabled(self)
+    local seeds = game:GetSeeds()
+    local numSeedEffects = seeds:CountSeedEffects()
+    return numSeedEffects > 0
+end
+--- Alias for the `anySeedEffectEnabled` function.
+function ____exports.anyEasterEggEnabled(self)
+    return ____exports.anySeedEffectEnabled(nil)
+end
 --- Helper function to see if the current run can unlock achievements. For example, if playing on a
 -- set seed or in a victory lap, achievements are disabled.
+-- 
+-- Under the hood, this is determined by spawning a Greed Donation Machine and then seeing if it
+-- exists before removing it.
 function ____exports.canRunUnlockAchievements(self)
     local greedDonationMachine = spawnSlot(nil, SlotVariant.GREED_DONATION_MACHINE, 0, VectorZero)
     local canUnlockAchievements = greedDonationMachine:Exists()
     greedDonationMachine:Remove()
     return canUnlockAchievements
 end
+--- Helper function to get the seed effects (i.e. Easter Eggs) that are enabled for the current run.
+function ____exports.getSeedEffects(self)
+    local seeds = game:GetSeeds()
+    return __TS__ArrayFilter(
+        SEED_EFFECTS,
+        function(____, seedEffect) return seedEffect ~= SeedEffect.NORMAL and seeds:HasSeedEffect(seedEffect) end
+    )
+end
 --- Helper function to check if the difficulty of the current run is equal to `Difficulty.GREED` or
 -- `Difficulty.GREEDIER`.
 function ____exports.isGreedMode(self)

package/package.json

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

package/src/arrays/cachedEnumValues.ts

@@ -16,6 +16,7 @@ import {
   PlayerForm,
   PocketItemSlot,
   RoomShape,
+  SeedEffect,
   SoundEffect,
   TrinketSlot,
 } from "isaac-typescript-definitions";
@@ -67,6 +68,8 @@ export const POCKET_ITEM_SLOT_VALUES: readonly PocketItemSlot[] =
 
 export const ROOM_SHAPE_VALUES: readonly RoomShape[] = getEnumValues(RoomShape);
 
+export const SEED_EFFECTS: readonly SeedEffect[] = getEnumValues(SeedEffect);
+
 export const SERIALIZATION_BRAND_VALUES: readonly SerializationBrand[] =
   getEnumValues(SerializationBrand);
 

package/src/functions/run.ts

@@ -2,8 +2,10 @@ import type { PlayerType } from "isaac-typescript-definitions";
 import {
   Challenge,
   Difficulty,
+  SeedEffect,
   SlotVariant,
 } from "isaac-typescript-definitions";
+import { SEED_EFFECTS } from "../arrays/cachedEnumValues";
 import { game } from "../core/cachedClasses";
 import { VectorZero } from "../core/constants";
 import { FIRST_CHARACTER } from "../core/constantsFirstLast";
@@ -11,9 +13,27 @@ import { getCharacterName } from "./characters";
 import { spawnSlot } from "./entitiesSpecific";
 import { log } from "./log";
 
+/** Alias for the `anySeedEffectEnabled` function. */
+export function anyEasterEggEnabled(): boolean {
+  return anySeedEffectEnabled();
+}
+
+/**
+ * Helper function to see if any seed effects (i.e. Easter Eggs) are enabled for the current run.
+ */
+export function anySeedEffectEnabled(): boolean {
+  const seeds = game.GetSeeds();
+  const numSeedEffects = seeds.CountSeedEffects();
+
+  return numSeedEffects > 0;
+}
+
 /**
  * Helper function to see if the current run can unlock achievements. For example, if playing on a
  * set seed or in a victory lap, achievements are disabled.
+ *
+ * Under the hood, this is determined by spawning a Greed Donation Machine and then seeing if it
+ * exists before removing it.
  */
 export function canRunUnlockAchievements(): boolean {
   const greedDonationMachine = spawnSlot(
@@ -27,6 +47,18 @@ export function canRunUnlockAchievements(): boolean {
   return canUnlockAchievements;
 }
 
+/**
+ * Helper function to get the seed effects (i.e. Easter Eggs) that are enabled for the current run.
+ */
+export function getSeedEffects(): SeedEffect[] {
+  const seeds = game.GetSeeds();
+
+  return SEED_EFFECTS.filter(
+    (seedEffect) =>
+      seedEffect !== SeedEffect.NORMAL && seeds.HasSeedEffect(seedEffect),
+  );
+}
+
 /**
  * Helper function to check if the difficulty of the current run is equal to `Difficulty.GREED` or
  * `Difficulty.GREEDIER`.