isaacscript-common 59.3.0 → 59.4.1

package/dist/index.rollup.d.ts

@@ -17005,6 +17005,16 @@ export declare function setRoomDisplayFlags(roomGridIndex: int | undefined, disp
  */
 export declare function setRoomUncleared(): void;
 
+/**
+ * Helper function to restart the run on a particular starting seed.
+ *
+ * Under the hood, this function executes the `seed` console command.
+ *
+ * @param startSeedOrStartSeedString Either the numerical start seed (e.g. 268365970) or the start
+ *                                 seed string (e.g. "AAJ2 8V9C").
+ */
+export declare function setRunSeed(startSeedOrStartSeedString: Seed | string): void;
+
 /** Helper function to set a seed to an RNG object using Blade's recommended shift index. */
 export declare function setSeed(rng: RNG, seed: Seed): void;
 

package/dist/isaacscript-common.lua

@@ -1,6 +1,6 @@
 --[[
 
-isaacscript-common 59.3.0
+isaacscript-common 59.4.1
 
 This is the "isaacscript-common" library, which was created with the IsaacScript tool.
 
@@ -22636,6 +22636,8 @@ local ____entitiesSpecific = require("src.functions.entitiesSpecific")
 local spawnSlot = ____entitiesSpecific.spawnSlot
 local ____log = require("src.functions.log")
 local log = ____log.log
+local ____types = require("src.functions.types")
+local isString = ____types.isString
 function ____exports.anySeedEffectEnabled(self)
     local seeds = game:GetSeeds()
     local numSeedEffects = seeds:CountSeedEffects()
@@ -22685,6 +22687,12 @@ function ____exports.restart(self, character)
     log((((("Restarting the run as " .. characterName) .. " (") .. tostring(character)) .. ") with a console command of: ") .. command)
     Isaac.ExecuteCommand(command)
 end
+function ____exports.setRunSeed(self, startSeedOrStartSeedString)
+    local startSeedString = isString(nil, startSeedOrStartSeedString) and startSeedOrStartSeedString or Seeds.Seed2String(startSeedOrStartSeedString)
+    local command = "seed " .. startSeedString
+    log("Restarting the run to set a seed with a console command of: " .. command)
+    Isaac.ExecuteCommand(command)
+end
 function ____exports.setUnseeded(self)
     local seeds = game:GetSeeds()
     seeds:Reset()
@@ -54628,13 +54636,17 @@ local DEFAULT_CHALLENGE_CHARACTER = ____challengeCharacters.DEFAULT_CHALLENGE_CH
 local ____challengeNames = require("src.objects.challengeNames")
 local CHALLENGE_NAMES = ____challengeNames.CHALLENGE_NAMES
 local DEFAULT_CHALLENGE_NAME = ____challengeNames.DEFAULT_CHALLENGE_NAME
+local ____log = require("src.functions.log")
+local log = ____log.log
 function ____exports.onAnyChallenge(self)
     local challenge = Isaac.GetChallenge()
     return challenge ~= Challenge.NULL
 end
 function ____exports.clearChallenge(self)
     if ____exports.onAnyChallenge(nil) then
-        Isaac.ExecuteCommand("challenge " .. tostring(Challenge.NULL))
+        local command = "challenge " .. tostring(Challenge.NULL)
+        log("Restarting the run to clear the current challenge with a console command of: " .. command)
+        Isaac.ExecuteCommand(command)
     end
 end
 function ____exports.getChallengeBoss(self, challenge)
@@ -54656,7 +54668,9 @@ function ____exports.onChallenge(self, ...)
 end
 function ____exports.setChallenge(self, challenge)
     if not ____exports.onChallenge(nil, challenge) then
-        Isaac.ExecuteCommand("challenge " .. tostring(challenge))
+        local command = "challenge " .. tostring(challenge)
+        log("Restarting the run to set a challenge with a console command of: " .. command)
+        Isaac.ExecuteCommand(command)
     end
 end
 return ____exports

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

@@ -1 +1 @@
-{"version":3,"file":"challenges.d.ts","sourceRoot":"","sources":["../../../src/functions/challenges.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAczD;;;;;;;GAOG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAIrC;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAK7D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,SAAS,GAAG,UAAU,CAKtE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAK7D;AAED,qEAAqE;AACrE,wBAAgB,cAAc,IAAI,OAAO,CAGxC;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,UAAU,EAAE,SAAS,EAAE,GAAG,OAAO,CAG/D;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAIvD"}
+{"version":3,"file":"challenges.d.ts","sourceRoot":"","sources":["../../../src/functions/challenges.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAezD;;;;;;;GAOG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAQrC;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAK7D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,SAAS,GAAG,UAAU,CAKtE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAK7D;AAED,qEAAqE;AACrE,wBAAgB,cAAc,IAAI,OAAO,CAGxC;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,UAAU,EAAE,SAAS,EAAE,GAAG,OAAO,CAG/D;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAQvD"}

package/dist/src/functions/challenges.lua

@@ -12,6 +12,8 @@ local DEFAULT_CHALLENGE_CHARACTER = ____challengeCharacters.DEFAULT_CHALLENGE_CH
 local ____challengeNames = require("src.objects.challengeNames")
 local CHALLENGE_NAMES = ____challengeNames.CHALLENGE_NAMES
 local DEFAULT_CHALLENGE_NAME = ____challengeNames.DEFAULT_CHALLENGE_NAME
+local ____log = require("src.functions.log")
+local log = ____log.log
 --- Helper function to see if the player is playing any challenge.
 function ____exports.onAnyChallenge(self)
     local challenge = Isaac.GetChallenge()
@@ -25,7 +27,9 @@ end
 -- Under the hood, this function executes the `challenge 0` console command.
 function ____exports.clearChallenge(self)
     if ____exports.onAnyChallenge(nil) then
-        Isaac.ExecuteCommand("challenge " .. tostring(Challenge.NULL))
+        local command = "challenge " .. tostring(Challenge.NULL)
+        log("Restarting the run to clear the current challenge with a console command of: " .. command)
+        Isaac.ExecuteCommand(command)
     end
 end
 --- Get the final boss of a challenge. This will only work for vanilla challenges.
@@ -68,7 +72,9 @@ end
 -- Under the hood, this function executes the `challenge 0` console command.
 function ____exports.setChallenge(self, challenge)
     if not ____exports.onChallenge(nil, challenge) then
-        Isaac.ExecuteCommand("challenge " .. tostring(challenge))
+        local command = "challenge " .. tostring(challenge)
+        log("Restarting the run to set a challenge with a console command of: " .. command)
+        Isaac.ExecuteCommand(command)
     end
 end
 return ____exports

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

@@ -45,6 +45,15 @@ export declare function onVictoryLap(): boolean;
  * You can optionally specify a `PlayerType` to restart the game as that character.
  */
 export declare function restart(character?: PlayerType): void;
+/**
+ * Helper function to restart the run on a particular starting seed.
+ *
+ * Under the hood, this function executes the `seed` console command.
+ *
+ * @param startSeedOrStartSeedString Either the numerical start seed (e.g. 268365970) or the start
+ *                                 seed string (e.g. "AAJ2 8V9C").
+ */
+export declare function setRunSeed(startSeedOrStartSeedString: Seed | string): void;
 /**
  * Helper function to change the run status to that of an unseeded run with a new random seed.
  *

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;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;;;GAGG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAGtC;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;AAUtC,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;;;GAGG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAGtC;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,SAAS,CAAC,EAAE,UAAU,GAAG,IAAI,CAkBpD;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,0BAA0B,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAQ1E;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAUlC"}

package/dist/src/functions/run.lua

@@ -20,6 +20,8 @@ local ____entitiesSpecific = require("src.functions.entitiesSpecific")
 local spawnSlot = ____entitiesSpecific.spawnSlot
 local ____log = require("src.functions.log")
 local log = ____log.log
+local ____types = require("src.functions.types")
+local isString = ____types.isString
 --- 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()
@@ -92,6 +94,18 @@ function ____exports.restart(self, character)
     log((((("Restarting the run as " .. characterName) .. " (") .. tostring(character)) .. ") with a console command of: ") .. command)
     Isaac.ExecuteCommand(command)
 end
+--- Helper function to restart the run on a particular starting seed.
+-- 
+-- Under the hood, this function executes the `seed` console command.
+-- 
+-- @param startSeedOrStartSeedString Either the numerical start seed (e.g. 268365970) or the start
+-- seed string (e.g. "AAJ2 8V9C").
+function ____exports.setRunSeed(self, startSeedOrStartSeedString)
+    local startSeedString = isString(nil, startSeedOrStartSeedString) and startSeedOrStartSeedString or Seeds.Seed2String(startSeedOrStartSeedString)
+    local command = "seed " .. startSeedString
+    log("Restarting the run to set a seed with a console command of: " .. command)
+    Isaac.ExecuteCommand(command)
+end
 --- Helper function to change the run status to that of an unseeded run with a new random seed.
 -- 
 -- This is useful to revert the behavior where playing on a set seed and restarting the game will

package/package.json

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

package/src/functions/challenges.ts

@@ -12,6 +12,7 @@ import {
   CHALLENGE_NAMES,
   DEFAULT_CHALLENGE_NAME,
 } from "../objects/challengeNames";
+import { log } from "./log";
 
 /**
  * Helper function to clear the current challenge, which will restart the run on a new random
@@ -23,7 +24,11 @@ import {
  */
 export function clearChallenge(): void {
   if (onAnyChallenge()) {
-    Isaac.ExecuteCommand(`challenge ${Challenge.NULL}`);
+    const command = `challenge ${Challenge.NULL}`;
+    log(
+      `Restarting the run to clear the current challenge with a console command of: ${command}`,
+    );
+    Isaac.ExecuteCommand(command);
   }
 }
 
@@ -92,6 +97,10 @@ export function onChallenge(...challenges: Challenge[]): boolean {
  */
 export function setChallenge(challenge: Challenge): void {
   if (!onChallenge(challenge)) {
-    Isaac.ExecuteCommand(`challenge ${challenge}`);
+    const command = `challenge ${challenge}`;
+    log(
+      `Restarting the run to set a challenge with a console command of: ${command}`,
+    );
+    Isaac.ExecuteCommand(command);
   }
 }

package/src/functions/run.ts

@@ -12,6 +12,7 @@ import { FIRST_CHARACTER } from "../core/constantsFirstLast";
 import { getCharacterName } from "./characters";
 import { spawnSlot } from "./entitiesSpecific";
 import { log } from "./log";
+import { isString } from "./types";
 
 /** Alias for the `anySeedEffectEnabled` function. */
 export function anyEasterEggEnabled(): boolean {
@@ -122,6 +123,24 @@ export function restart(character?: PlayerType): void {
   Isaac.ExecuteCommand(command);
 }
 
+/**
+ * Helper function to restart the run on a particular starting seed.
+ *
+ * Under the hood, this function executes the `seed` console command.
+ *
+ * @param startSeedOrStartSeedString Either the numerical start seed (e.g. 268365970) or the start
+ *                                 seed string (e.g. "AAJ2 8V9C").
+ */
+export function setRunSeed(startSeedOrStartSeedString: Seed | string): void {
+  const startSeedString = isString(startSeedOrStartSeedString)
+    ? startSeedOrStartSeedString
+    : Seeds.Seed2String(startSeedOrStartSeedString);
+
+  const command = `seed ${startSeedString}`;
+  log(`Restarting the run to set a seed with a console command of: ${command}`);
+  Isaac.ExecuteCommand(command);
+}
+
 /**
  * Helper function to change the run status to that of an unseeded run with a new random seed.
  *