isaacscript-common 1.2.209 → 1.2.212

package/dist/features/deployJSONRoom.d.ts

@@ -14,12 +14,12 @@ import { JSONRoom } from "../types/JSONRoom";
  * const firstJSONRoom = customRooms.rooms.room[0];
  * deployJSONRoom(firstJSONRoom);
  * ```
- * @param rng Optional. Specifies the RNG object that will be used for spawning every entity in the
- * room. Default is `newRNG()`.
+ * @param seedOrRNG Optional. The `Seed` or `RNG` object to use. If an `RNG` object is provided, the
+ * `RNG.Next` method will be called. Default is `getRandomSeed()`.
  * @param verbose Optional. If specified, will write entries to the "log.txt" file that describe
  * what the function is doing. Default is false.
  */
-export declare function deployJSONRoom(jsonRoom: JSONRoom, rng?: RNG, verbose?: boolean): void;
+export declare function deployJSONRoom(jsonRoom: JSONRoom, seedOrRNG?: Seed | RNG, verbose?: boolean): void;
 /**
  * Helper function to deconstruct a vanilla room and set up a custom room in its place.
  * Specifically, this will clear the current room of all entities and grid entities, and then spawn
@@ -39,12 +39,12 @@ export declare function deployJSONRoom(jsonRoom: JSONRoom, rng?: RNG, verbose?:
  * const jsonRooms = customRooms.rooms.room;
  * deployRandomJSONRoom(jsonRooms);
  * ```
- * @param rng Optional. Specifies the RNG object that will be used for determining the random room.
- * After that, it is also used for spawning every entity in the room. Default is `newRNG()`.
+ * @param seedOrRNG Optional. The `Seed` or `RNG` object to use. If an `RNG` object is provided, the
+ * `RNG.Next` method will be called. Default is `getRandomSeed()`.
  * @param verbose Optional. If specified, will write entries to the "log.txt" file that describe
  * what the function is doing. Default is false.
  */
-export declare function deployRandomJSONRoom(jsonRooms: JSONRoom[], rng?: RNG, verbose?: boolean): void;
+export declare function deployRandomJSONRoom(jsonRooms: JSONRoom[], seedOrRNG?: Seed | RNG, verbose?: boolean): void;
 /**
  * Helper function to remove all naturally spawning entities and grid entities from a room. Notably,
  * this will not remove players (1), tears (2), familiars (3), lasers (7), knives (8),

package/dist/features/deployJSONRoom.lua

@@ -33,6 +33,8 @@ local getNPCs = ____npc.getNPCs
 local ____pickups = require("functions.pickups")
 local removeAllPickups = ____pickups.removeAllPickups
 local ____rng = require("functions.rng")
+local getRandomSeed = ____rng.getRandomSeed
+local isRNG = ____rng.isRNG
 local newRNG = ____rng.newRNG
 local ____roomData = require("functions.roomData")
 local getRoomListIndex = ____roomData.getRoomListIndex
@@ -234,6 +236,7 @@ function spawnNormalEntityForJSONRoom(self, entityType, variant, subType, x, y,
     local room = game:GetRoom()
     local roomType = room:GetType()
     local position = gridToPos(nil, x, y)
+    local seed = rng:Next()
     local entity
     if entityType == EntityType.ENTITY_PICKUP and variant == 100 then
         local options = roomType == RoomType.ROOM_ANGEL
@@ -241,12 +244,10 @@ function spawnNormalEntityForJSONRoom(self, entityType, variant, subType, x, y,
             nil,
             subType,
             position,
-            rng,
+            seed,
             options
         )
     else
-        rng:Next()
-        local seed = rng:GetSeed()
         entity = game:Spawn(
             entityType,
             variant,
@@ -403,14 +404,15 @@ function ____exports.deployJSONRoomInit(self, mod)
     saveDataManager(nil, "deployJSONRoom", v)
     mod:AddCallback(ModCallbacks.MC_POST_NEW_ROOM, postNewRoom)
 end
-function ____exports.deployJSONRoom(self, jsonRoom, rng, verbose)
-    if rng == nil then
-        rng = newRNG(nil)
+function ____exports.deployJSONRoom(self, jsonRoom, seedOrRNG, verbose)
+    if seedOrRNG == nil then
+        seedOrRNG = getRandomSeed(nil)
     end
     if verbose == nil then
         verbose = false
     end
     errorIfFeaturesNotInitialized(nil, FEATURE_NAME)
+    local rng = isRNG(nil, seedOrRNG) and seedOrRNG or newRNG(nil, seedOrRNG)
     if verbose then
         log("Starting to empty the room of entities and grid entities.")
     end
@@ -428,14 +430,15 @@ function ____exports.deployJSONRoom(self, jsonRoom, rng, verbose)
     fixPitGraphics(nil)
     fillRoomWithDecorations(nil)
 end
-function ____exports.deployRandomJSONRoom(self, jsonRooms, rng, verbose)
-    if rng == nil then
-        rng = newRNG(nil)
+function ____exports.deployRandomJSONRoom(self, jsonRooms, seedOrRNG, verbose)
+    if seedOrRNG == nil then
+        seedOrRNG = getRandomSeed(nil)
     end
     if verbose == nil then
         verbose = false
     end
     errorIfFeaturesNotInitialized(nil, FEATURE_NAME)
+    local rng = isRNG(nil, seedOrRNG) and seedOrRNG or newRNG(nil, seedOrRNG)
     local randomJSONRoom = getRandomJSONRoom(nil, jsonRooms, rng, verbose)
     if verbose then
         log((((((("Randomly chose JSON room " .. randomJSONRoom["$"].type) .. ".") .. randomJSONRoom["$"].variant) .. ".") .. randomJSONRoom["$"].subtype) .. " with name: ") .. randomJSONRoom["$"].name)

package/dist/functions/array.d.ts

@@ -43,20 +43,29 @@ export declare function getLastElement<T>(array: T[]): T;
  * Helper function to get a random element from the provided array.
  *
  * @param array The array to get an element from.
- * @param rng Optional. The RNG object used to select the random element. Default is `newRNG()`.
+ * @param seedOrRNG Optional. The `Seed` or `RNG` object to use. If an `RNG` object is provided, the
+ * `RNG.Next` method will be called. Default is `getRandomSeed()`.
  * @param exceptions Optional. An array of elements to skip over if selected.
  */
-export declare function getRandomArrayElement<T>(array: T[] | readonly T[], rng?: RNG, exceptions?: T[] | readonly T[]): T;
+export declare function getRandomArrayElement<T>(array: T[] | readonly T[], seedOrRNG?: Seed | RNG, exceptions?: T[] | readonly T[]): T;
 /**
  * Helper function to get a random element from the provided array. Once the random element is
  * decided, it is then removed from the array (in-place).
  *
  * @param array The array to get an element from.
- * @param rng Optional. The RNG object used to select the random element. Default is `newRNG()`.
+ * @param seedOrRNG Optional. The `Seed` or `RNG` object to use. If an `RNG` object is provided, the
+ * `RNG.Next` method will be called. Default is `getRandomSeed()`.
  * @param exceptions Optional. An array of elements to skip over if selected.
  */
-export declare function getRandomArrayElementAndRemove<T>(array: T[], rng?: RNG, exceptions?: T[] | readonly T[]): T;
-export declare function getRandomArrayIndex<T>(array: T[] | readonly T[], rng?: RNG): int;
+export declare function getRandomArrayElementAndRemove<T>(array: T[], seedOrRNG?: Seed | RNG, exceptions?: T[] | readonly T[]): T;
+/**
+ * Helper function to get a random index from the provided array.
+ *
+ * @param array The array to get the index from.
+ * @param seedOrRNG Optional. The `Seed` or `RNG` object to use. If an `RNG` object is provided, the
+ * `RNG.Next` method will be called. Default is `getRandomSeed()`.
+ */
+export declare function getRandomArrayIndex<T>(array: T[] | readonly T[], seedOrRNG?: Seed | RNG): int;
 /**
  * Initializes an array with all elements containing the specified default value.
  *
@@ -74,17 +83,26 @@ export declare function initArray<T>(defaultValue: T, size: int): T[];
  * - the table has no keys (i.e. an "empty" table)
  */
 export declare function isArray(thing: unknown): boolean;
+/** Checks if an array is in the provided 2-dimensional array. */
 export declare function isArrayInArray<T>(arrayToMatch: T[] | readonly T[], parentArray: Array<T[] | readonly T[]>): boolean;
 /**
  * Shallow copies and shuffles the array using the Fisher-Yates algorithm. Returns the copied array.
  *
  * From: https://stackoverflow.com/questions/2450954/how-to-randomize-shuffle-a-javascript-array
+ *
+ * @param originalArray The array to shuffle.
+ * @param seedOrRNG Optional. The `Seed` or `RNG` object to use. If an `RNG` object is provided, the
+ * `RNG.Next` method will be called. Default is `getRandomSeed()`.
  */
-export declare function shuffleArray<T>(originalArray: T[] | readonly T[], rng?: RNG): T[];
+export declare function shuffleArray<T>(originalArray: T[] | readonly T[], seedOrRNG?: Seed | RNG): T[];
 /**
  * Shuffles the provided array in-place using the Fisher-Yates algorithm.
  *
  * From: https://stackoverflow.com/questions/2450954/how-to-randomize-shuffle-a-javascript-array
+ *
+ * @param array The array to shuffle.
+ * @param seedOrRNG Optional. The `Seed` or `RNG` object to use. If an `RNG` object is provided, the
+ * `RNG.Next` method will be called. Default is `getRandomSeed()`.
  */
-export declare function shuffleArrayInPlace<T>(array: T[], rng?: RNG): void;
+export declare function shuffleArrayInPlace<T>(array: T[], seedOrRNG?: Seed | RNG): void;
 export declare function sumArray(array: number[] | readonly number[]): number;

package/dist/functions/array.lua

@@ -12,27 +12,27 @@ local ____exports = {}
 local ____random = require("functions.random")
 local getRandomInt = ____random.getRandomInt
 local ____rng = require("functions.rng")
-local newRNG = ____rng.newRNG
+local getRandomSeed = ____rng.getRandomSeed
 local ____utils = require("functions.utils")
 local ____repeat = ____utils["repeat"]
-function ____exports.getRandomArrayIndex(self, array, rng)
-    if rng == nil then
-        rng = newRNG(nil)
+function ____exports.getRandomArrayIndex(self, array, seedOrRNG)
+    if seedOrRNG == nil then
+        seedOrRNG = getRandomSeed(nil)
     end
     if #array == 0 then
         error("Failed to get a random array index since the provided array is empty.")
     end
-    return getRandomInt(nil, 0, #array - 1, rng)
+    return getRandomInt(nil, 0, #array - 1, seedOrRNG)
 end
-function ____exports.shuffleArrayInPlace(self, array, rng)
-    if rng == nil then
-        rng = newRNG(nil)
+function ____exports.shuffleArrayInPlace(self, array, seedOrRNG)
+    if seedOrRNG == nil then
+        seedOrRNG = getRandomSeed(nil)
     end
     local currentIndex = #array
     local randomIndex
     while currentIndex > 0 do
         currentIndex = currentIndex - 1
-        randomIndex = ____exports.getRandomArrayIndex(nil, array, rng)
+        randomIndex = ____exports.getRandomArrayIndex(nil, array, seedOrRNG)
         local ____temp_0 = {array[randomIndex + 1], array[currentIndex + 1]}
         array[currentIndex + 1] = ____temp_0[1]
         array[randomIndex + 1] = ____temp_0[2]
@@ -115,9 +115,9 @@ end
 function ____exports.getLastElement(self, array)
     return array[#array]
 end
-function ____exports.getRandomArrayElement(self, array, rng, exceptions)
-    if rng == nil then
-        rng = newRNG(nil)
+function ____exports.getRandomArrayElement(self, array, seedOrRNG, exceptions)
+    if seedOrRNG == nil then
+        seedOrRNG = getRandomSeed(nil)
     end
     if exceptions == nil then
         exceptions = {}
@@ -130,17 +130,17 @@ function ____exports.getRandomArrayElement(self, array, rng, exceptions)
         array,
         table.unpack(exceptions)
     )
-    local randomIndex = ____exports.getRandomArrayIndex(nil, arrayWithoutExceptions, rng)
+    local randomIndex = ____exports.getRandomArrayIndex(nil, arrayWithoutExceptions, seedOrRNG)
     return arrayWithoutExceptions[randomIndex + 1]
 end
-function ____exports.getRandomArrayElementAndRemove(self, array, rng, exceptions)
-    if rng == nil then
-        rng = newRNG(nil)
+function ____exports.getRandomArrayElementAndRemove(self, array, seedOrRNG, exceptions)
+    if seedOrRNG == nil then
+        seedOrRNG = getRandomSeed(nil)
     end
     if exceptions == nil then
         exceptions = {}
     end
-    local randomArrayElement = ____exports.getRandomArrayElement(nil, array, rng, exceptions)
+    local randomArrayElement = ____exports.getRandomArrayElement(nil, array, seedOrRNG, exceptions)
     ____exports.arrayRemoveInPlace(nil, array, randomArrayElement)
     return randomArrayElement
 end
@@ -192,12 +192,12 @@ function ____exports.isArrayInArray(self, arrayToMatch, parentArray)
         function(____, element) return ____exports.arrayEquals(nil, element, arrayToMatch) end
     )
 end
-function ____exports.shuffleArray(self, originalArray, rng)
-    if rng == nil then
-        rng = newRNG(nil)
+function ____exports.shuffleArray(self, originalArray, seedOrRNG)
+    if seedOrRNG == nil then
+        seedOrRNG = getRandomSeed(nil)
     end
     local array = ____exports.copyArray(nil, originalArray)
-    ____exports.shuffleArrayInPlace(nil, array, rng)
+    ____exports.shuffleArrayInPlace(nil, array, seedOrRNG)
     return array
 end
 function ____exports.sumArray(self, array)

package/dist/functions/cards.d.ts

@@ -43,24 +43,27 @@ export declare function getMaxCards(): int;
  * - any objects like Dice Shard
  * - any modded cards.
  *
- * @param rng Optional. The RNG object with which to select the random card. Default is `newRNG()`.
+ * @param seedOrRNG Optional. The `Seed` or `RNG` object to use. If an `RNG` object is provided, the
+ * `RNG.Next` method will be called. Default is `getRandomSeed()`.
  * @param exceptions Optional. An array of cards to not select.
  */
-export declare function getRandomCard(rng?: RNG, exceptions?: Card[]): Card;
+export declare function getRandomCard(seedOrRNG?: Seed | RNG, exceptions?: Card[]): Card;
 /**
  * @param cardType The card type that represents the pool of cards to select from.
- * @param rng Optional. The RNG object with which to select the random card. Default is `newRNG()`.
+ * @param seedOrRNG Optional. The `Seed` or `RNG` object to use. If an `RNG` object is provided, the
+ * `RNG.Next` method will be called. Default is `getRandomSeed()`.
  * @param exceptions Optional. An array of cards to not select.
  */
-export declare function getRandomCardOfType(cardType: CardType, rng?: RNG, exceptions?: Card[]): Card;
+export declare function getRandomCardOfType(cardType: CardType, seedOrRNG?: Seed | RNG, exceptions?: Card[]): Card;
 /**
  * Has an equal chance of returning any rune (e.g. Rune of Hagalaz, Blank Rune, Black Rune, Soul of
  * Isaac, etc.). This will never return a Rune Shard.
  *
- * @param rng Optional. The RNG object with which to select the random rune. Default is `newRNG()`.
+ * @param seedOrRNG Optional. The `Seed` or `RNG` object to use. If an `RNG` object is provided, the
+ * `RNG.Next` method will be called. Default is `getRandomSeed()`.
  * @param exceptions Optional. An array of runes to not select.
  */
-export declare function getRandomRune(rng?: RNG, exceptions?: Card[]): Card;
+export declare function getRandomRune(seedOrRNG?: Seed | RNG, exceptions?: Card[]): Card;
 /**
  * Returns true for cards that have the following card type:
  * - CardType.TAROT

package/dist/functions/cards.lua

@@ -21,7 +21,7 @@ local DEFAULT_CARD_TYPE = ____cardTypes.DEFAULT_CARD_TYPE
 local ____math = require("functions.math")
 local range = ____math.range
 local ____rng = require("functions.rng")
-local newRNG = ____rng.newRNG
+local getRandomSeed = ____rng.getRandomSeed
 local ____set = require("functions.set")
 local addSetsToSet = ____set.addSetsToSet
 local getRandomSetElement = ____set.getRandomSetElement
@@ -100,35 +100,35 @@ function ____exports.getCardName(self, card)
     end
     return DEFAULT_CARD_NAME
 end
-function ____exports.getRandomCard(self, rng, exceptions)
-    if rng == nil then
-        rng = newRNG(nil)
+function ____exports.getRandomCard(self, seedOrRNG, exceptions)
+    if seedOrRNG == nil then
+        seedOrRNG = getRandomSeed(nil)
     end
     if exceptions == nil then
         exceptions = {}
     end
-    return getRandomSetElement(nil, CARD_SET, rng, exceptions)
+    return getRandomSetElement(nil, CARD_SET, seedOrRNG, exceptions)
 end
-function ____exports.getRandomCardOfType(self, cardType, rng, exceptions)
-    if rng == nil then
-        rng = newRNG(nil)
+function ____exports.getRandomCardOfType(self, cardType, seedOrRNG, exceptions)
+    if seedOrRNG == nil then
+        seedOrRNG = getRandomSeed(nil)
     end
     if exceptions == nil then
         exceptions = {}
     end
     local cardSet = ____exports.getCardsOfType(nil, cardType)
-    return getRandomSetElement(nil, cardSet, rng, exceptions)
+    return getRandomSetElement(nil, cardSet, seedOrRNG, exceptions)
 end
-function ____exports.getRandomRune(self, rng, exceptions)
-    if rng == nil then
-        rng = newRNG(nil)
+function ____exports.getRandomRune(self, seedOrRNG, exceptions)
+    if seedOrRNG == nil then
+        seedOrRNG = getRandomSeed(nil)
     end
     if exceptions == nil then
         exceptions = {}
     end
     local runesSet = ____exports.getCardsOfType(nil, CardType.RUNE)
     runesSet:delete(Card.RUNE_SHARD)
-    return getRandomSetElement(nil, runesSet, rng, exceptions)
+    return getRandomSetElement(nil, runesSet, seedOrRNG, exceptions)
 end
 function ____exports.isCard(self, card)
     return CARD_SET:has(card)

package/dist/functions/familiars.lua

@@ -54,7 +54,7 @@ function ____exports.checkFamiliar(self, player, collectibleType, numTargetFamil
         nil,
         numFamiliarsToSpawn,
         function()
-            collectibleRNG:Next()
+            local seed = collectibleRNG:Next()
             local familiar = game:Spawn(
                 EntityType.ENTITY_FAMILIAR,
                 familiarVariant,
@@ -62,7 +62,7 @@ function ____exports.checkFamiliar(self, player, collectibleType, numTargetFamil
                 Vector.Zero,
                 player,
                 familiarSubTypeToUse,
-                collectibleRNG:GetSeed()
+                seed
             ):ToFamiliar()
             if familiar ~= nil then
                 familiar.Player = player

package/dist/functions/jsonRoom.d.ts

@@ -9,4 +9,4 @@ export declare function getJSONRoomsOfSubType(jsonRooms: JSONRoom[], subType: in
  * properly account for each room weight using the algorithm from:
  * https://stackoverflow.com/questions/1761626/weighted-random-numbers
  */
-export declare function getRandomJSONRoom(jsonRooms: JSONRoom[], rng?: RNG, verbose?: boolean): JSONRoom;
+export declare function getRandomJSONRoom(jsonRooms: JSONRoom[], seedOrRNG?: Seed | RNG, verbose?: boolean): JSONRoom;

package/dist/functions/jsonRoom.lua

@@ -10,7 +10,7 @@ local log = ____log.log
 local ____random = require("functions.random")
 local getRandomFloat = ____random.getRandomFloat
 local ____rng = require("functions.rng")
-local newRNG = ____rng.newRNG
+local getRandomSeed = ____rng.getRandomSeed
 function getTotalWeightOfJSONRooms(self, jsonRooms)
     local weights = __TS__ArrayMap(
         jsonRooms,
@@ -66,9 +66,9 @@ function ____exports.getJSONRoomsOfSubType(self, jsonRooms, subType)
         end
     )
 end
-function ____exports.getRandomJSONRoom(self, jsonRooms, rng, verbose)
-    if rng == nil then
-        rng = newRNG(nil)
+function ____exports.getRandomJSONRoom(self, jsonRooms, seedOrRNG, verbose)
+    if seedOrRNG == nil then
+        seedOrRNG = getRandomSeed(nil)
     end
     if verbose == nil then
         verbose = false
@@ -77,7 +77,7 @@ function ____exports.getRandomJSONRoom(self, jsonRooms, rng, verbose)
     if verbose then
         log("Total weight of the JSON rooms provided: " .. tostring(totalWeight))
     end
-    local chosenWeight = getRandomFloat(nil, 0, totalWeight, rng)
+    local chosenWeight = getRandomFloat(nil, 0, totalWeight, seedOrRNG)
     if verbose then
         log("Randomly chose weight for JSON room: " .. tostring(chosenWeight))
     end

package/dist/functions/random.d.ts

@@ -1,39 +1,27 @@
 /// <reference types="isaac-typescript-definitions" />
 /**
  * This returns a random float between 0 and 1. It is inclusive on the low end, but exclusive on
- * the high end. (This is because the `RNG.RandomFloat` method can return a value of 0.999, but it
- * will never return a value of exactly 1.)
+ * the high end. (This is because the `RNG.RandomFloat` method will never return a value of exactly
+ * 1.)
  *
- * Note that this function will invoke the `Next` method on the `RNG` object before returning the
- * random number.
+ * @param seedOrRNG Optional. The `Seed` or `RNG` object to use. If an `RNG` object is provided, the
+ * `RNG.Next` method will be called. Default is `getRandomSeed()`.
  */
-export declare function getRandom(rng?: RNG): float;
+export declare function getRandom(seedOrRNG?: Seed | RNG): float;
 /**
- * This returns a random float between min and max. It is inclusive on the low end, but exclusive on
- * the high end. (This is because the `RNG.RandomFloat` method can return a value of 0.999, but it
- * will never return a value of exactly 1.)
- *
- * Note that this function will invoke the `Next` method on the `RNG` object before returning the
- * random number.
+ * This returns a random float between min and max.
  *
  * Example:
  * ```ts
  * const realNumberBetweenOneAndThree = getRandomFloat(1, 3);
  * ```
+ *
+ * @param min The lower bound for the random number (inclusive).
+ * @param max The upper bound for the random number (exclusive).
+ * @param seedOrRNG Optional. The `Seed` or `RNG` object to use. If an `RNG` object is provided, the
+ * `RNG.Next` method will be called. Default is `getRandomSeed()`.
  */
-export declare function getRandomFloat(min: int, max: int, rng?: RNG): float;
-/**
- * This returns a random float between min and max. It is inclusive on the low end, but exclusive on
- * the high end. (This is because the `RNG.RandomFloat` method can return a value of 0.999, but it
- * will never return a value of exactly 1.)
- */
-export declare function getRandomFloatFromSeed(min: int, max: int, seed: Seed): float;
-/**
- * This returns a random float between 0 and 1. It is inclusive on the low end, but exclusive on
- * the high end. (This is because the `RNG.RandomFloat` method can return a value of 0.999, but it
- * will never return a value of exactly 1.)
- */
-export declare function getRandomFromSeed(seed: Seed): float;
+export declare function getRandomFloat(min: int, max: int, seedOrRNG?: Seed | RNG): float;
 /**
  * This returns a random integer between min and max. It is inclusive on both ends.
  *
@@ -44,7 +32,10 @@ export declare function getRandomFromSeed(seed: Seed): float;
  * ```ts
  * const oneTwoOrThree = getRandomInt(1, 3);
  * ```
+ *
+ * @param min The lower bound for the random number (inclusive).
+ * @param max The upper bound for the random number (inclusive).
+ * @param seedOrRNG Optional. The `Seed` or `RNG` object to use. If an `RNG` object is provided, the
+ * `RNG.Next` method will be called. Default is `getRandomSeed()`.
  */
-export declare function getRandomInt(min: int, max: int, rng?: RNG): int;
-/** This returns a random integer between min and max. It is inclusive on both ends. */
-export declare function getRandomIntFromSeed(min: int, max: int, seed: Seed): int;
+export declare function getRandomInt(min: int, max: int, seedOrRNG?: Seed | RNG): int;

package/dist/functions/random.lua

@@ -1,16 +1,19 @@
 --[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
 local ____exports = {}
 local ____rng = require("functions.rng")
+local getRandomSeed = ____rng.getRandomSeed
+local isRNG = ____rng.isRNG
 local newRNG = ____rng.newRNG
-function ____exports.getRandom(self, rng)
-    if rng == nil then
-        rng = newRNG(nil)
+function ____exports.getRandom(self, seedOrRNG)
+    if seedOrRNG == nil then
+        seedOrRNG = getRandomSeed(nil)
     end
+    local rng = isRNG(nil, seedOrRNG) and seedOrRNG or newRNG(nil, seedOrRNG)
     return rng:RandomFloat()
 end
-function ____exports.getRandomFloat(self, min, max, rng)
-    if rng == nil then
-        rng = newRNG(nil)
+function ____exports.getRandomFloat(self, min, max, seedOrRNG)
+    if seedOrRNG == nil then
+        seedOrRNG = getRandomSeed(nil)
     end
     if min > max then
         local oldMin = min
@@ -18,20 +21,13 @@ function ____exports.getRandomFloat(self, min, max, rng)
         min = oldMax
         max = oldMin
     end
-    return min + ____exports.getRandom(nil, rng) * (max - min)
+    return min + ____exports.getRandom(nil, seedOrRNG) * (max - min)
 end
-function ____exports.getRandomFloatFromSeed(self, min, max, seed)
-    local rng = newRNG(nil, seed)
-    return ____exports.getRandomFloat(nil, min, max, rng)
-end
-function ____exports.getRandomFromSeed(self, seed)
-    local rng = newRNG(nil, seed)
-    return ____exports.getRandom(nil, rng)
-end
-function ____exports.getRandomInt(self, min, max, rng)
-    if rng == nil then
-        rng = newRNG(nil)
+function ____exports.getRandomInt(self, min, max, seedOrRNG)
+    if seedOrRNG == nil then
+        seedOrRNG = getRandomSeed(nil)
     end
+    local rng = isRNG(nil, seedOrRNG) and seedOrRNG or newRNG(nil, seedOrRNG)
     if min > max then
         local oldMin = min
         local oldMax = max
@@ -40,8 +36,4 @@ function ____exports.getRandomInt(self, min, max, rng)
     end
     return rng:RandomInt(max - min + 1) + min
 end
-function ____exports.getRandomIntFromSeed(self, min, max, seed)
-    local rng = newRNG(nil, seed)
-    return ____exports.getRandomInt(nil, min, max, rng)
-end
 return ____exports

package/dist/functions/set.d.ts

@@ -25,10 +25,11 @@ export declare function deleteSetsFromSet<T>(mainSet: Set<T>, ...setsToRemove: A
  * Helper function to get a random element from the provided set.
  *
  * @param set The set to get an element from.
- * @param rng Optional. The RNG object used to select the random element. Default is `newRNG()`.
+ * @param seedOrRNG Optional. The `Seed` or `RNG` object to use. If an `RNG` object is provided, the
+ * `RNG.Next` method will be called. Default is `getRandomSeed()`.
  * @param exceptions Optional. An array of elements to skip over if selected.
  */
-export declare function getRandomSetElement<T>(set: Set<T> | ReadonlySet<T>, rng?: RNG, exceptions?: T[] | readonly T[]): T;
+export declare function getRandomSetElement<T>(set: Set<T> | ReadonlySet<T>, seedOrRNG?: Seed | RNG, exceptions?: T[] | readonly T[]): T;
 /**
  * Helper function to get a sorted array based on the contents of a set.
  *

package/dist/functions/set.lua

@@ -8,7 +8,7 @@ local ____exports = {}
 local ____array = require("functions.array")
 local getRandomArrayElement = ____array.getRandomArrayElement
 local ____rng = require("functions.rng")
-local newRNG = ____rng.newRNG
+local getRandomSeed = ____rng.getRandomSeed
 function ____exports.getSortedSetValues(self, set)
     local values = set:values()
     local array = {__TS__Spread(values)}
@@ -48,14 +48,14 @@ function ____exports.deleteSetsFromSet(self, mainSet, ...)
         end
     end
 end
-function ____exports.getRandomSetElement(self, set, rng, exceptions)
-    if rng == nil then
-        rng = newRNG(nil)
+function ____exports.getRandomSetElement(self, set, seedOrRNG, exceptions)
+    if seedOrRNG == nil then
+        seedOrRNG = getRandomSeed(nil)
     end
     if exceptions == nil then
         exceptions = {}
     end
     local array = ____exports.getSortedSetValues(nil, set)
-    return getRandomArrayElement(nil, array, rng, exceptions)
+    return getRandomArrayElement(nil, array, seedOrRNG, exceptions)
 end
 return ____exports

package/dist/functions/spawnCollectible.d.ts

@@ -7,13 +7,14 @@
  *
  * @param collectibleType The collectible type to spawn.
  * @param position The position to spawn the collectible at.
- * @param rng Optional. Default is `newRNG()`.
+ * @param seedOrRNG Optional. The `Seed` or `RNG` object to use. If an `RNG` object is provided, the
+ * `RNG.Next` method will be called. Default is `getRandomSeed()`.
  * @param options Optional. Set to true to make the collectible a "There's Options" style
  * collectible. Default is false.
  * @param forceFreeItem Optional. Set to true to disable the logic that gives the item a price for
  * Tainted Keeper. Default is false.
  */
-export declare function spawnCollectible(collectibleType: CollectibleType | int, position: Vector, rng?: RNG, options?: boolean, forceFreeItem?: boolean): EntityPickup;
+export declare function spawnCollectible(collectibleType: CollectibleType | int, position: Vector, seedOrRNG?: Seed | RNG, options?: boolean, forceFreeItem?: boolean): EntityPickup;
 /**
  * Helper function to spawn an empty collectible. Doing this is tricky since spawning a collectible
  * with `CollectibleType.COLLECTIBLE_NULL` will result in spawning a collectible with a random type
@@ -21,5 +22,9 @@ export declare function spawnCollectible(collectibleType: CollectibleType | int,
  *
  * Instead, this function arbitrarily spawns a collectible with
  * `CollectibleType.COLLECTIBLE_SAD_ONION`, and then converts it to an empty pedestal afterward.
+ *
+ * @param position The position to spawn the empty collectible at.
+ * @param seedOrRNG The `Seed` or `RNG` object to use. If an `RNG` object is provided, the
+ * `RNG.Next` method will be called. Default is `getRandomSeed()`.
  */
-export declare function spawnEmptyCollectible(position: Vector, rng?: RNG): EntityPickup;
+export declare function spawnEmptyCollectible(position: Vector, seedOrRNG?: Seed | RNG): EntityPickup;

package/dist/functions/spawnCollectible.lua

@@ -12,10 +12,11 @@ local setCollectibleEmpty = ____collectibles.setCollectibleEmpty
 local ____player = require("functions.player")
 local anyPlayerIs = ____player.anyPlayerIs
 local ____rng = require("functions.rng")
-local newRNG = ____rng.newRNG
-function ____exports.spawnCollectible(self, collectibleType, position, rng, options, forceFreeItem)
-    if rng == nil then
-        rng = newRNG(nil)
+local getRandomSeed = ____rng.getRandomSeed
+local isRNG = ____rng.isRNG
+function ____exports.spawnCollectible(self, collectibleType, position, seedOrRNG, options, forceFreeItem)
+    if seedOrRNG == nil then
+        seedOrRNG = getRandomSeed(nil)
     end
     if options == nil then
         options = false
@@ -23,8 +24,7 @@ function ____exports.spawnCollectible(self, collectibleType, position, rng, opti
     if forceFreeItem == nil then
         forceFreeItem = false
     end
-    rng:Next()
-    local seed = rng:GetSeed()
+    local seed = isRNG(nil, seedOrRNG) and seedOrRNG:Next() or seedOrRNG
     local collectible = game:Spawn(
         EntityType.ENTITY_PICKUP,
         100,
@@ -49,15 +49,15 @@ function ____exports.spawnCollectible(self, collectibleType, position, rng, opti
     end
     return collectible
 end
-function ____exports.spawnEmptyCollectible(self, position, rng)
-    if rng == nil then
-        rng = newRNG(nil)
+function ____exports.spawnEmptyCollectible(self, position, seedOrRNG)
+    if seedOrRNG == nil then
+        seedOrRNG = getRandomSeed(nil)
     end
     local collectible = ____exports.spawnCollectible(
         nil,
         CollectibleType.COLLECTIBLE_SAD_ONION,
         position,
-        rng,
+        seedOrRNG,
         false,
         true
     )

package/package.json

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