isaacscript-common 1.2.204 → 1.2.207

package/dist/functions/rng.d.ts

@@ -16,6 +16,8 @@ interface CopyRNGReturn {
  */
 export declare function copyRNG<R extends RNG | SerializedRNG, S extends SerializationType>(rng: R, serializationType: S): CopyRNGReturn[S];
 export declare function copyRNG<R extends RNG | SerializedRNG>(rng: R): CopyRNGReturn[SerializationType.NONE];
+/** Helper function to get the next seed value for the provided RNG object. */
+export declare function getNewSeed(rng: RNG): Seed;
 /**
  * Helper function to get a random `Seed` value to be used in spawning entities and so on. Use this
  * instead of calling the `Random` function directly since that can return a value of 0 and crash
@@ -42,4 +44,16 @@ export declare function newRNG(seed?: Seed): RNG;
  * RNG objects.
  */
 export declare function nextSeed(seed: Seed): Seed;
+/**
+ * Helper function to iterate over the provided object and set the seed for all of the values that
+ * are RNG objects equal to a particular seed.
+ */
+export declare function setAllRNGToSeed(object: unknown, seed: Seed): void;
+/**
+ * Helper function to iterate over the provided object and set the seed for all of the values that
+ * are RNG objects equal to the start seed for the current run.
+ */
+export declare function setAllRNGToStartSeed(object: unknown): 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;
 export {};

package/dist/functions/rng.lua

@@ -1,6 +1,9 @@
---[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
+local ____lualib = require("lualib_bundle")
+local __TS__ObjectValues = ____lualib.__TS__ObjectValues
 local ____exports = {}
 local RECOMMENDED_SHIFT_IDX, OBJECT_NAME
+local ____cachedClasses = require("cachedClasses")
+local game = ____cachedClasses.game
 local ____SerializationBrand = require("enums.private.SerializationBrand")
 local SerializationBrand = ____SerializationBrand.SerializationBrand
 local ____SerializationType = require("enums.SerializationType")
@@ -23,12 +26,15 @@ function ____exports.newRNG(self, seed)
     if seed == nil then
         seed = ____exports.getRandomSeed(nil)
     end
+    local rng = RNG()
+    ____exports.setSeed(nil, rng, seed)
+    return rng
+end
+function ____exports.setSeed(self, rng, seed)
     if seed == 0 then
-        error("You cannot initialize an RNG object with a seed of 0, or the game will crash.")
+        error("You cannot set an RNG object to a seed of 0, or the game will crash.")
     end
-    local rng = RNG()
     rng:SetSeed(seed, RECOMMENDED_SHIFT_IDX)
-    return rng
 end
 RECOMMENDED_SHIFT_IDX = 35
 local KEYS = {"seed"}
@@ -86,6 +92,10 @@ function ____exports.copyRNG(self, rng, serializationType)
         end
     until true
 end
+function ____exports.getNewSeed(self, rng)
+    rng:Next()
+    return rng:GetSeed()
+end
 function ____exports.isSerializedRNG(self, object)
     local objectType = type(object)
     if objectType ~= "table" then
@@ -103,4 +113,21 @@ function ____exports.nextSeed(self, seed)
     rng:Next()
     return rng:GetSeed()
 end
+function ____exports.setAllRNGToSeed(self, object, seed)
+    local objectType = type(object)
+    if objectType ~= "table" then
+        error("Failed to iterate over the object containing RNG objects since the type of the provided object was: " .. objectType)
+    end
+    local ____table = object
+    for ____, value in ipairs(__TS__ObjectValues(____table)) do
+        if ____exports.isRNG(nil, value) then
+            ____exports.setSeed(nil, value, seed)
+        end
+    end
+end
+function ____exports.setAllRNGToStartSeed(self, object)
+    local seeds = game:GetSeeds()
+    local startSeed = seeds:GetStartSeed()
+    ____exports.setAllRNGToSeed(nil, object, startSeed)
+end
 return ____exports

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacscript-common",
-  "version": "1.2.204",
+  "version": "1.2.207",
   "description": "Helper functions for IsaacScript mods",
   "keywords": [
     "isaac",